* {
- widows: 2 !important;
- orphans: 2 !important;
+ widows: 4 !important;
+ orphans: 4 !important;
}
body, h1, h2, h3, h4, h5, h6, pre, li, div {
background-color: white;
margin:0 auto;
font-family: "liberation sans", "Myriad ", "Bitstream Vera Sans", "Lucida Grande", "Luxi Sans", "Trebuchet MS", helvetica, verdana, arial, sans-serif;
- font-size:12px;
- max-width:55em;
- color:black;
+ font-size: 14px;
+ max-width: 770px;
+ color: black;
}
body.toc_embeded {
object.toc, iframe.toc {
/*for web hosting system only*/
- border-style:none;
- position:fixed;
- width:290px;
- height:99.99%;
- top:0;
- left:0;
+ border-style: none;
+ position: fixed;
+ width: 290px;
+ height: 99.99%;
+ top: 0;
+ left: 0;
z-index: 100;
- border-style:none;
+ border-style: none;
border-right:1px solid #999;
}
iframe.notoc {
border-style:none;
border: none;
- padding: 0em;
+ padding: 0px;
position:fixed;
width: 21px;
height: 29px;
top: 0px;
left:0;
overflow: hidden;
- margin: 0em;
+ margin: 0px;
margin-left: -3px;
}
/* End hide web menu */
body.desktop .book > .toc {
display:block;
width:24em;
- height:99%;
+ height:99.99%;
position:fixed;
overflow:auto;
top:0px;
left:0px;
- padding-left:1em;
+/* padding-left:1em; */
background-color:#EEEEEE;
+ font-size: 12px;
+}
+
+body.pdf {
+ max-width: 100%;
}
.toc {
}
div.section {
- padding-top:1em;
+ page-break-inside: avoid;
}
-p, div.para, div.formalpara {
- padding-top:0px;
- margin-top:0.3em;
- padding-bottom:0px;
- margin-bottom:1em;
+p, div.para {
+ padding-top: 0px;
+ margin-top: 0.3em;
+ padding-bottom: 0px;
+ margin-bottom: 1em;
+}
+
+div.formalpara {
+ padding-top: 0px;
+ margin-top: 1em;
+ padding-bottom: 0px;
+ margin-bottom: 1em;
+}
+
+.varlistentry div.para {
+ page-break-before: avoid;
+
}
/*Links*/
}
a:link {
- text-decoration:none;
+ text-decoration: none;
border-bottom: 1px dotted ;
color:#3366cc;
}
+body.pdf a:link {
+ word-wrap: break-word;
+}
+
a:visited {
text-decoration:none;
border-bottom: 1px dotted ;
/*headings*/
h1, h2, h3, h4, h5, h6 {
color: #336699;
- margin-top: 0em;
- margin-bottom: 0em;
+ margin-top: 0px;
+ margin-bottom: 0px;
background-color: transparent;
+ margin-bottom: 0px;
+ margin-top: 20px;
page-break-inside: avoid;
page-break-after: avoid;
+ word-wrap: break-word;
}
h1 {
- font-size:2.0em;
+ font-size: 22px;
}
.titlepage h1.title {
- font-size: 3.0em;
- padding-top: 1em;
text-align:left;
}
.book > .titlepage h1.title {
- text-align:center;
+ text-align: center;
}
-.article > .titlepage h1.title {
- text-align:center;
+.article > .titlepage h1.title,
+.article > .titlepage h2.title {
+ text-align: center;
}
.set .titlepage > div > div > h1.title {
- text-align:center;
+ text-align: center;
}
-.producttitle {
- margin-top: 0em;
- margin-bottom: 0em;
- font-size: 3.0em;
+.part > .titlepage h1.title {
+ text-align: center;
+ font-size: 24px;
+}
+
+div.producttitle {
+ margin-top: 0px;
+ margin-bottom: 20px;
+ font-size: 48px;
font-weight: bold;
- background: #003d6e url(../images/h1-bg.png) top left repeat-x;
- color: white;
+/* background: #003d6e url(../images/h1-bg.png) top left repeat-x; */
+ color: #336699;
text-align: center;
- padding: 0.7em;
+ padding-top: 12px;
}
.titlepage .corpauthor {
}
.section h1.title {
- font-size: 1.6em;
- padding: 0em;
+ font-size: 18px;
+ padding: 0px;
color: #336699;
text-align: left;
background: white;
}
h2 {
- font-size:1.6em;
+ font-size: 20px;
+ margin-top: 30px;
}
-h2.subtitle, h3.subtitle {
+.book div.subtitle, .book h2.subtitle, .book h3.subtitle {
margin-top: 1em;
margin-bottom: 1em;
- font-size: 1.4em;
+ font-size: 18px;
text-align: center;
}
-.preface > div > div > div > h2.title {
+div.subtitle {
+ color: #336699;
+ font-weight: bold;
+}
+
+h1.legalnotice {
+ font-size: 24px;
+}
+
+.preface > div > div > div > h2.title,
+.preface > div > div > div > h1.title {
margin-top: 1em;
- font-size: 2.0em;
+ font-size: 24px;
}
.appendix h2 {
- margin-top: 1em;
- font-size: 2.0em;
+ font-size: 24px;
}
h3 {
- font-size:1.3em;
- padding-top:0em;
- padding-bottom:0em;
+ font-size: 14px;
+ padding-top:0px;
+ padding-bottom: 0px;
+ margin-bottom: 0px;
}
h4 {
- font-size:1.1em;
- padding-top:0em;
- padding-bottom:0em;
+ font-size: 14px;
+ padding-top:0px;
+ padding-bottom:0px;
}
h5 {
- font-size:1em;
+ font-size: 14px;
}
h6 {
- font-size:1em;
-}
-
-h5.formalpara {
- font-size:1em;
- margin-top:2em;
- margin-bottom:.8em;
+ font-size: 14px;
+ margin-bottom: 0px;
}
.abstract h6 {
margin-top:1em;
margin-bottom:.5em;
- font-size:2em;
+ font-size: 24px;
+}
+
+.index > div > div > div > h2.title {
+ font-size: 24px;
+}
+
+.chapter > div > div > div > h2.title {
+ font-size: 24px;
+}
+
+.section > div > div > div > h2.title {
+ font-size: 21px;
+}
+
+.section > div > div > div > h3.title {
+ font-size: 17px;
}
/*element rules*/
border-style:none;
border-top: 1px dotted #ccc;
width:100%;
- margin-top: 3em;
}
/* web site rules */
ul.languages, .languages li {
display:inline;
- padding:0em;
+ padding:0px;
}
.languages li a {
- padding:0em .5em;
+ padding:0px .5em;
text-decoration: none;
}
}
a.version {
- font-size:2em;
+ font-size: 20px;
text-decoration:none;
width:100%;
display:block;
- padding:1em 0em .2em 0em;
+ padding:1em 0px .2em 0px;
clear:both;
}
a.version:before {
content:"Version";
- font-size:smaller;
+ font-size: smaller;
}
a.version:visited, a.version:link {
position:absolute;
left:170px;
top:0px;
- font-size:smaller;
+ font-size: smaller;
}
.books .pdf:link, .books .pdf:visited {
.products li a {
width:300px;
- padding:.5em 0em;
+ padding:.5em 0px;
}
.products ul {
.revhistory table {
background-color:transparent;
border-color:#fff;
- padding:0em;
+ padding:0px;
margin: 0;
border-collapse:collapse;
border-style:none;
.revhistory td {
text-align :left;
- padding:0em;
+ padding:0px;
border: none;
border-top: 1px solid #fff;
font-weight: bold;
text-align: center;
}
-h3.author {
- margin: 0em;
- padding: 0em;
- padding-top: 1em;
+div.author div.author,
+div.translator div.translator,
+div.othercredit div.othercredit,
+div.editor div.editor,
+div.contrib div.contrib {
+ margin: 0px;
+ padding: 0px;
+ margin-top: 12px;
+ font-size: 14px;
+ font-weight: bold;
+ color: #336699;
}
-.authorgroup h4 {
- padding: 0em;
- margin: 0em;
- padding-top: 1em;
- margin-top: 1em;
+div.editedby {
+ margin-top: 15px;
+ margin-bottom: -0.8em;
}
-.author,
-.editor,
-.translator,
-.othercredit,
-.contrib {
+div.authorgroup .author,
+div.authorgroup.editor,
+div.authorgroup.translator,
+div.authorgroup.othercredit,
+div.authorgroup.contrib {
display: block;
+ font-size: 14px;
+ page-break-inside: avoid;
}
.revhistory .author {
.othercredit {
- margin:0em;
- padding:0em;
+ margin:0px;
+ padding:0px;
}
.releaseinfo {
padding-left: 2.6em;
}
-.answer label, .question label {
+.answer .label, .question .label {
float:left;
font-weight:bold;
}
}
.perl_Comment {
- color: #FF00FF;
+ color: #888888;
}
dt {
font-weight:bold;
- margin-bottom:0em;
- padding-bottom:0em;
+ margin-bottom:0px;
+ padding-bottom:0px;
}
dd {
- margin:0em;
+ margin:0px;
margin-left:2em;
- padding-top:0em;
+ padding-top:0px;
padding-bottom: 1em;
}
li {
- padding-top:0px;
- margin-top:0em;
- padding-bottom:0px;
- margin-bottom:0.4em;
+ padding-top: 0px;
+ margin-top: 0px;
+ padding-bottom: 0px;
+/* margin-bottom: 16px; */
}
li p, li div.para {
padding-top:0px;
- margin-top:0em;
+ margin-top:0px;
padding-bottom:0px;
margin-bottom:0.3em;
}
img {
display:block;
margin: 2em 0;
+ max-width: 100%;
}
-.inlinemediaobject, .inlinemediaobject img {
+.inlinemediaobject,
+.inlinemediaobject img,
+.inlinemediaobject object {
display:inline;
- margin:0em;
+ margin:0px;
+ overflow: hidden;
}
-.figure img {
+.figure img,
+.mediaobject img {
display:block;
margin:0;
page-break-inside: avoid;
}
.figure .title {
- margin:0em;
+ margin:0px;
margin-bottom:2em;
padding:0px;
}
}
.prompt {
- padding:0em .3em;
+ padding:0px .3em;
}
/*user interface styles*/
.guibutton, .guilabel {
font-family: "liberation mono", "bitstream vera mono", "dejavu mono", monospace;
font-weight: bold;
- white-space: nowrap;
}
.example {
background-color: #ffffff;
border-left: 3px solid #aaaaaa;
- padding-top: 1em;
+ padding-top: 1px;
+ padding-bottom: 0.1em;
+ padding-left: 1em;
+}
+
+.equation {
+ border-left: 3px solid #aaaaaa;
+ background-color: #ffffff;
+ padding-top: 1px;
padding-bottom: 0.1em;
+ padding-left: 1em;
}
-.example h6 {
- padding-left: 10px;
+.equation-contents {
+ margin-left: 4em;
+}
+
+div.title {
+ margin-bottom: 1em;
+ font-weight: 14px;
+ font-weight: bold;
+ color: #336699;
+ page-break-inside: avoid;
+ page-break-after: avoid;
+ word-wrap: break-word;
}
.example-contents {
- padding-left: 10px;
background-color: #ffffff;
}
font-weight: inherit;
}
+.toc H1 {
+ font-weight: bold;
+}
+
+
+div.programlisting {
+ white-space: pre-wrap; /* css-3 */
+ white-space: -moz-pre-wrap !important; /* Mozilla, since 1999 */
+ white-space: -pre-wrap; /* Opera 4-6 */
+ white-space: -o-pre-wrap; /* Opera 7 */
+ word-wrap: break-word; /* Internet Explorer 5.5+ */
+}
+
pre {
font-family:"liberation mono", "bitstream vera mono", "dejavu mono", monospace;
display:block;
background-color: #f5f5f5;
color: #000000;
- border: 1px solid #aaaaaa;
- margin-bottom: 0.3em;
+/* border: 1px solid #aaaaaa; */
+ margin-bottom: 1em;
padding:.5em 1em;
white-space: pre-wrap; /* css-3 */
white-space: -moz-pre-wrap !important; /* Mozilla, since 1999 */
white-space: -o-pre-wrap; /* Opera 7 */
word-wrap: break-word; /* Internet Explorer 5.5+ */
font-size: 0.9em;
+ border-style:none;
+ box-shadow: 0 2px 5px #AAAAAA inset;
+ -moz-box-shadow: 0 2px 5px #AAAAAA inset;
+ -webkit-box-shadow: 0 2px 5px #AAAAAA inset;
+ -o-box-shadow: 0 2px 5px #AAAAAA inset;
+}
+
+body.pdf pre {
+ border: 1px solid #AAAAAA;
+ box-shadow: none;
+ -moz-box-shadow: none;
+ -webkit-box-shadow: none;
+ -o-box-shadow: none;
}
+
pre .replaceable,
pre .keycap {
}
code {
font-family:"liberation mono", "bitstream vera mono", "dejavu mono", monospace;
-/* white-space: nowrap;*/
white-space: pre-wrap;
word-wrap: break-word;
font-weight:bold;
word-wrap: break-word; /* Internet Explorer 5.5+ */
}
+code.email {
+ font-weight: normal;
+ font-family: "liberation sans", "Myriad ", "Bitstream Vera Sans", "Lucida Grande", "Luxi Sans", "Trebuchet MS", helvetica, verdana, arial, sans-serif;
+
+}
+
/*Notifications*/
div.warning:before {
content:url(../images/warning.png);
div.warning, div.note, div.important {
color: black;
- margin: 0em;
- padding: 0em;
+ margin: 0px;
+ padding: 0px;
background: none;
background-color: white;
margin-bottom: 1em;
page-break-inside: avoid;
}
-div.warning h2, div.note h2,div.important h2 {
- margin: 0em;
- padding: 0em;
+div.admonition_header p {
+ margin: 0px;
+ padding: 0px;
color: #eeeeec;
padding-top: 0px;
padding-bottom: 0px;
height: 1.4em;
line-height: 1.4em;
- font-size: 1.4em;
+ font-size: 17px;
display:inline;
}
div.admonition_header {
clear: both;
- margin: 0em;
- padding: 0em;
- margin-top: -3.3em;
+ margin: 0px;
+ padding: 0px;
+ margin-top: -40px;
padding-left: 58px;
- line-height: 1.0em;
- font-size: 1.0em;
+ line-height: 1.0px;
+ font-size: 1.0px;
}
div.warning div.admonition_header {
div.warning p, div.warning div.para,
div.note p, div.note div.para,
div.important p, div.important div.para {
- padding: 0em;
- margin: 0em;
+ padding: 0px;
+ margin: 0px;
}
div.admonition {
border: none;
border-left: 1px solid #aaaaaa;
border-right: 1px solid #aaaaaa;
- padding:0em;
- margin:0em;
+ padding:0px;
+ margin:0px;
padding-top: 1.5em;
padding-bottom: 1em;
padding-left: 2em;
display:block;
height:45px;
padding-bottom:1em;
- margin:0em;
+ margin:0px;
}
#title a.left{
#title a.left img{
border:none;
float:left;
- margin:0em;
+ margin:0px;
margin-top:.7em;
}
#title a.right img {
border:none;
float:right;
- margin:0em;
+ margin:0px;
margin-top:.7em;
}
}
table {
- border:1px solid #6c614b;
+ border: 1px solid #444;
width:100%;
border-collapse:collapse;
+ table-layout: fixed;
+ word-wrap: break-word;
}
-table.simplelist, .calloutlist table {
+table.blockquote,
+table.simplelist,
+.calloutlist table {
border-style: none;
}
background-color:#f5f5f5;
}
+tr:nth-child(even) {
+ background-color: #eeeeee;
+
+}
+
+
table th p:first-child, table td p:first-child, table li p:first-child,
table th div.para:first-child, table td div.para:first-child, table li div.para:first-child {
- margin-top:0em;
- padding-top:0em;
+ margin-top:0px;
+ padding-top:0px;
display:inline;
}
th, td {
border-style:none;
vertical-align: top;
- border: 1px solid #000;
+/* border: 1px solid #000; */
}
-.simplelist th, .simplelist td {
+.blockquote td,
+.simplelist th,
+.simplelist td {
border: none;
}
table table td {
border-bottom:1px dotted #aaa;
background-color:white;
- padding:.6em 0em;
+ padding:.6em 0px;
}
table table {
span.book {
margin-top:4em;
display:block;
- font-size:11pt;
+ font-size: 11pt;
}
span.book a{
}
span.chapter {
display:block;
- margin-top:0.5em;
}
table.simplelist td, .calloutlist table td {
border-style: none;
}
+
+table.lt-4-cols.lt-7-rows td {
+ border: none;
+}
+/*to simplify layout*/
+
+
+table.lt-4-cols.gt-14-rows tr:nth-child(odd) {
+ background-color: #fafafa;
+}
+/* to keep simple but stripe rows */
+
+
+.gt-8-cols td {
+ border-left: 1px solid #ccc;
+}
+
+.gt-8-cols td:first-child {
+ border-left: 0;
+}
+/* to apply vertical lines to differentiate columns*/
+
/*Breadcrumbs*/
#breadcrumbs ul li.first:before {
content:" ";
color:#333;
}
+dl {
+ margin-top: 0px;
+ margin-left: 28px;
+}
+
+.toc dl {
+ margin-left: 10px;
+}
+
/*index*/
.glossary h3,
.index h3 {
- font-size: 2em;
+ font-size: 20px;
color:#aaa;
- margin:0em;
+ margin:0px;
}
.indexdiv {
.index dl dl dt {
color:#777;
font-weight:normal;
- padding-top:0em;
+ padding-top:0px;
}
.index dl dl dt:before {
/*changes*/
.footnote {
- font-size: .7em;
- margin:0em;
- color:#222;
+ font-size: 10px;
+ margin: 0px;
+ color: #222;
+}
+
+.footnotes {
+ margin-bottom: 60px;
}
table .footnote {
}
sup {
- color:#999;
- margin:0em;
- padding:0em;
- line-height: .4em;
- font-size: 1em;
- padding-left:0em;
+ margin:0px;
+ padding:0px;
+ font-size: 10px;
+ padding-left:0px;
}
.footnote {
}
.footnote sup {
- color:#e3dcc0;
- position:absolute;
+ color: black;
left: .4em;
}
+.footnote a:link,
+.footnote a:visited {
+ text-decoration:none;
+ border: none;
+}
+
+.footnote .para sup {
+/* position:absolute; */
+ vertical-align:text-bottom;
+}
+
+a.footnote {
+ padding-right: 0.5em;
+ text-decoration:none;
+ border: none;
+}
+
.footnote sup a:link,
.footnote sup a:visited {
color:#92917d;
}
.footnote p,.footnote div.para {
- padding-left:2em;
+ padding-left:1em;
}
.footnote a:link,
-.footnote a:visited {
+.footnote a:visited before{
color:#00537c;
}
}
/**/
+.pdf-break {
+ page-break-before: always;
+}
+
+div.legalnotice {
+ page-break-before: always;
+}
+
+div.abstract {
+ page-break-before: always;
+/* page-break-after: always;*/
+}
+
div.chapter {
- margin-top:3em;
- page-break-inside: avoid;
+ page-break-before: always;
}
-div.preface {
+
+div.titlepage {
page-break-inside: avoid;
+ page-break-after: avoid;
+}
+
+div.preface, div.part {
+ page-break-before: always;
+}
+
+div.appendix {
+ page-break-before: always;
}
div.section {
- margin-top:1em;
page-break-inside: auto;
+ page-break-before: auto;
+ page-break-after: auto;
+}
+
+
+dt.varlistentry {
+ page-break-inside: avoid;
+ page-break-after: avoid;
+}
+
+dd {
+ page-break-before: avoid;
}
div.note .replaceable,
{
}
-ul li p:last-child, ul li div.para:last-child {
- margin-bottom:0em;
- padding-bottom:0em;
+ul li p:last-child, ul li para:last-child {
+ margin-bottom:0px;
+ padding-bottom:0px;
}
/*document navigation*/
.docnav {
list-style:none;
- margin:0em;
- padding:0em;
+ margin:0px;
+ padding:0px;
position:relative;
width:100%;
padding-bottom:2em;
padding-top:1em;
+ height:2.5em;
+ line-height:2.5em;
+/*
border-top:1px dotted #ccc;
+ background-color: rgba(240, 240, 240, 0.9);
+-webkitbox-shadow: 0px .15em .5em rgba(0,0,0,0.2);
+ -moz-box-shadow: 0px .15em .5em rgba(0,0,0,0.2);
+ box-shadow: 0px .15em .5em rgba(0,0,0,0.2);
+*/
}
.docnav li {
list-style:none;
- margin:0em;
- padding:0em;
+ margin:0px;
+ padding:0px;
display:inline;
- font-size:.8em;
+ font-size: 14px;
}
.docnav li:before {
.docnav li.previous, .docnav li.next {
position:absolute;
- top:1em;
+ top:1.5em;
}
.docnav li.up, .docnav li.home {
- margin:0em 1.5em;
+ margin:0px 1.5em;
+}
+
+.docnav.top li.home {
+ color: #336699;
+ font-size: 22pt;
+ font-weight: bold;
}
+
.docnav li.previous {
left:0px;
text-align:left;
}
.docnav li.previous strong, .docnav li.next strong {
- height:22px;
- display:block;
+ height: 17px;
+ display: block;
}
.docnav {
}
.docnav li.next a strong {
- background: url(../images/stock-go-forward.png) top right no-repeat;
+ background: url(../images/stock-go-forward.png) right 120% no-repeat;
padding-top:3px;
padding-bottom:4px;
padding-right:28px;
- font-size:1.2em;
}
.docnav li.previous a strong {
- background: url(../images/stock-go-back.png) top left no-repeat;
+ background: url(../images/stock-go-back.png) left 120% no-repeat;
padding-top:3px;
padding-bottom:4px;
padding-left:28px;
padding-right:0.5em;
- font-size:1.2em;
}
.docnav li.home a strong {
background: url(../images/stock-home.png) top left no-repeat;
padding:5px;
padding-left:28px;
- font-size:1.2em;
}
.docnav li.up a strong {
background: url(../images/stock-go-up.png) top left no-repeat;
padding:5px;
padding-left:28px;
- font-size:1.2em;
}
.docnav a:link, .docnav a:visited {
}
.docnav a {
- max-width: 10em;
+ max-width: 10px;
overflow:hidden;
}
/* Reports */
.reports ul {
list-style:none;
- margin:0em;
- padding:0em;
+ margin:0px;
+ padding:0px;
}
.reports li{
- margin:0em;
- padding:0em;
+ margin:0px;
+ padding:0px;
}
.reports li.odd {
background-color: #eeeeee;
- margin:0em;
- padding:0em;
+ margin:0px;
+ padding:0px;
}
.reports dl {
display:inline;
- margin:0em;
- padding:0em;
+ margin:0px;
+ padding:0px;
float:right;
margin-right: 17em;
margin-top:-1.3em;
.reports dt {
display:inline;
- margin:0em;
- padding:0em;
+ margin:0px;
+ padding:0px;
}
.reports dd {
display:inline;
- margin:0em;
- padding:0em;
+ margin:0px;
+ padding:0px;
padding-right:.5em;
}
.reports h2, .reports h3{
display:inline;
padding-right:.5em;
- font-size:10pt;
+ font-size: 14px;
font-weight:normal;
}
float:right;
width:16em;
background:#c00 url(../images/shine.png) top left repeat-x;
- margin:0em;
+ margin:0px;
margin-top:-1.3em;
- padding:0em;
+ padding:0px;
border:none;
}
/*uniform*/
body.results, body.reports {
max-width:57em ;
- padding:0em;
+ padding:0px;
}
/*Progress Bar*/
.results ul {
list-style:none;
- margin:0em;
- padding:0em;
+ margin:0px;
+ padding:0px;
}
.results li{
- margin:0em;
- padding:0em;
+ margin:0px;
+ padding:0px;
}
.results li.odd {
background-color: #eeeeee;
- margin:0em;
- padding:0em;
+ margin:0px;
+ padding:0px;
}
.results dl {
display:inline;
- margin:0em;
- padding:0em;
+ margin:0px;
+ padding:0px;
float:right;
margin-right: 17em;
margin-top:-1.3em;
.results dt {
display:inline;
- margin:0em;
- padding:0em;
+ margin:0px;
+ padding:0px;
}
.results dd {
display:inline;
- margin:0em;
- padding:0em;
+ margin:0px;
+ padding:0px;
padding-right:.5em;
}
.results h2, .results h3 {
display:inline;
padding-right:.5em;
- font-size:10pt;
+ font-size: 14px;
font-weight:normal;
}
float:right;
width:16em;
background:#c00 url(../images/shine.png) top left repeat-x;
- margin:0em;
+ margin:0px;
margin-top:-1.3em;
- padding:0em;
+ padding:0px;
border:none;
}
background-color: transparent;
margin-top: 1em;
margin-bottom: 1em;
- font-size: 1.4em;
+ font-size: 20px;
font-weight: bold;
text-align: center;
}
}
.toc dd {
- padding-bottom: 0em;
+ padding-bottom: 0px;
margin-bottom: 1em;
padding-left: 1.3em;
- margin-left: 0em;
+ margin-left: 0px;
}
div.toc > dl > dt {
- padding-bottom: 0em;
- margin-bottom: 0em;
+ padding-bottom: 0px;
+ margin-bottom: 0px;
margin-top: 1em;
}
}
.calloutlist img, .callout {
- padding: 0em;
- margin: 0em;
+ padding: 0px;
+ margin: 0px;
width: 12pt;
display: inline;
vertical-align: middle;
}
+li.step > a:first-child {
+ display: block;
+}
+
.stepalternatives {
list-style-image: none;
- list-style-type: none;
+ list-style-type: upper-alpha;
+}
+.task {
+/* page-break-inside: avoid; */
}
@import url("common.css");
@import url("overrides.css");
@import url("lang.css");
+
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
<svg
+ xmlns:dc="http://purl.org/dc/elements/1.1/"
+ xmlns:cc="http://creativecommons.org/ns#"
+ xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
- version="1.0"
- width="363"
- height="318"
+ version="1.1"
+ width="253.10916"
+ height="195.16167"
id="svg2"
style="enable-background:new">
<defs
id="linearGradient3607"
xlink:href="#linearGradient3770"
gradientUnits="userSpaceOnUse"
- gradientTransform="matrix(0.8697037,0.5377184,-5.0885591e-2,2.0041935,-132.86485,4079.057)" />
+ gradientTransform="matrix(0.8697037,0.5377184,-0.05088559,2.0041935,-132.86485,4079.057)" />
<linearGradient
x1="579.61249"
y1="-2053.46"
id="linearGradient3609"
xlink:href="#linearGradient3770"
gradientUnits="userSpaceOnUse"
- gradientTransform="matrix(0.8697037,0.5377184,-5.0885591e-2,2.0041935,-132.86485,4082.0622)" />
+ gradientTransform="matrix(0.8697037,0.5377184,-0.05088559,2.0041935,-132.86485,4082.0622)" />
<linearGradient
x1="579.61249"
y1="-2053.46"
id="linearGradient3611"
xlink:href="#linearGradient3770"
gradientUnits="userSpaceOnUse"
- gradientTransform="matrix(0.8697037,0.5377184,-5.0885591e-2,2.0041935,-132.86485,4085.0674)" />
+ gradientTransform="matrix(0.8697037,0.5377184,-0.05088559,2.0041935,-132.86485,4085.0674)" />
<linearGradient
x1="579.61249"
y1="-2053.46"
id="linearGradient3613"
xlink:href="#linearGradient3770"
gradientUnits="userSpaceOnUse"
- gradientTransform="matrix(0.8697037,0.5377184,-5.0885591e-2,2.0041935,-132.86485,4088.0726)" />
+ gradientTransform="matrix(0.8697037,0.5377184,-0.05088559,2.0041935,-132.86485,4088.0726)" />
<radialGradient
cx="308.00009"
cy="237.60178"
id="linearGradient3216"
xlink:href="#linearGradient3210"
gradientUnits="userSpaceOnUse"
- gradientTransform="matrix(0.9919329,0,0,0.9919329,1.4358062,0.4522511)" />
+ gradientTransform="matrix(0.9919329,0,0,0.9919329,-57.187787,-52.294514)" />
<linearGradient
x1="282.13562"
y1="198.85522"
y2="220.4299"
id="linearGradient3224"
xlink:href="#linearGradient3218"
- gradientUnits="userSpaceOnUse" />
+ gradientUnits="userSpaceOnUse"
+ gradientTransform="translate(-58.623593,-52.746766)" />
<linearGradient
x1="282.13562"
y1="198.85522"
id="linearGradient6356"
xlink:href="#linearGradient3218"
gradientUnits="userSpaceOnUse"
- gradientTransform="translate(0,3.1983471)" />
+ gradientTransform="translate(-58.623593,-49.548418)" />
<filter
+ color-interpolation-filters="sRGB"
id="filter6426">
<feGaussianBlur
- id="feGaussianBlur6428"
stdDeviation="1.3718847"
- inkscape:collect="always" />
+ id="feGaussianBlur6428" />
</filter>
<linearGradient
x1="313.12421"
xlink:href="#linearGradient6430"
gradientUnits="userSpaceOnUse" />
<filter
- height="1.2099621"
+ x="-0.049464952"
y="-0.10498104"
width="1.0989299"
- x="-0.049464952"
+ height="1.2099621"
+ color-interpolation-filters="sRGB"
id="filter6542">
<feGaussianBlur
- id="feGaussianBlur6544"
stdDeviation="2.6872547"
- inkscape:collect="always" />
+ id="feGaussianBlur6544" />
</filter>
<filter
+ color-interpolation-filters="sRGB"
id="filter6596">
<feGaussianBlur
- id="feGaussianBlur6598"
stdDeviation="1.7274814"
- inkscape:collect="always" />
+ id="feGaussianBlur6598" />
</filter>
<linearGradient
x1="180"
xlink:href="#linearGradient3218"
gradientUnits="userSpaceOnUse" />
<filter
+ color-interpolation-filters="sRGB"
id="filter6626">
<feBlend
- id="feBlend6628"
in2="BackgroundImage"
mode="multiply"
- inkscape:collect="always" />
+ id="feBlend6628" />
</filter>
</defs>
<path
- d="M 192.86534,56.061481 C 192.36173,56.001958 177.04791,71.601258 169.88288,78.655471 C 176.27757,76.632509 187.258,72.858149 188.75784,73.035772 C 190.25845,73.213382 198.81453,79.323493 203.90158,82.70395 C 200.45634,74.408167 193.36963,56.121106 192.86534,56.061481 z M 256.56564,75.679414 C 256.19703,75.470177 226.37543,82.344843 212.67149,85.374045 C 220.32408,85.916589 233.75821,86.605813 234.85605,87.228257 C 235.95576,87.851868 236.78146,95.293021 237.53092,99.511345 C 243.45051,92.092902 256.93475,75.888665 256.56564,75.679414 z M 125.42293,59.592937 C 124.97638,59.705437 130.08281,78.06997 132.18928,86.449319 C 134.88117,82.633972 139.1244,75.81667 140.45346,75.481547 C 141.78428,75.14601 154.86419,77.615692 162.3432,78.86324 C 150.84856,72.862022 125.86977,59.480312 125.42293,59.592937 z M 290.22827,111.27313 C 290.13546,110.99458 257.1852,106.5389 242.18642,104.38604 C 248.17919,107.28669 258.97529,112.18749 259.25143,113.01669 C 259.52792,113.84738 252.26311,119.75777 248.38968,123.20613 C 261.40772,119.49699 290.32106,111.5521 290.22827,111.27313 z M 125.48113,90.005528 C 110.30347,88.587271 77.076206,85.20923 76.857612,85.45104 C 76.63901,85.692911 100.20589,99.814697 110.77468,106.3235 C 108.73772,102.17566 104.66761,94.929258 105.31915,94.208612 C 105.96936,93.48931 118.45677,91.365927 125.48113,90.005528 z M 247.14367,128.41486 C 249.1807,132.56293 253.25058,139.80912 252.59919,140.52974 C 251.94886,141.24904 239.46162,143.37243 232.43729,144.7328 C 247.61504,146.15105 280.8422,149.52911 281.06077,149.2873 C 281.27943,149.04544 257.71247,134.92365 247.14367,128.41486 z M 107.57689,111.87714 C 94.559095,115.58622 65.645568,123.53114 65.738468,123.81028 C 65.83118,124.08875 98.781509,128.54433 113.78023,130.6972 C 107.78763,127.79653 96.991334,122.89566 96.715376,122.06653 C 96.438807,121.23574 103.70368,115.32544 107.57689,111.87714 z M 225.72916,148.289 C 223.03722,152.10435 218.79412,158.92166 217.46494,159.2568 C 216.13407,159.59235 203.05422,157.12265 195.57518,155.87511 C 207.06981,161.87632 232.0487,175.2581 232.49567,175.14539 C 232.94189,175.03294 227.83555,156.66839 225.72916,148.289 z M 118.43579,135.57189 C 112.51623,142.99034 99.032017,159.19458 99.401191,159.40382 C 99.769581,159.61299 129.59124,152.73839 143.29535,149.70918 C 135.64251,149.16662 122.20862,148.4774 121.11055,147.85492 C 120.01096,147.23135 119.18522,139.79024 118.43579,135.57189 z M 186.08383,156.42778 C 179.68914,158.45076 168.70875,162.2251 167.2089,162.04747 C 165.70846,161.86983 157.15205,155.75978 152.06515,152.37921 C 155.51037,160.67499 162.59724,178.96218 163.10148,179.02172 C 163.6049,179.08114 178.91889,163.48205 186.08383,156.42778 z"
- transform="matrix(1,0,0,1.0406634,0,-1.2796452)"
+ d="m 192.86534,56.061481 c -0.50361,-0.05952 -15.81743,15.539777 -22.98246,22.59399 6.39469,-2.022962 17.37512,-5.797322 18.87496,-5.619699 1.50061,0.17761 10.05669,6.287721 15.14374,9.668178 -3.44524,-8.295783 -10.53195,-26.582844 -11.03624,-26.642469 z m 63.7003,19.617933 c -0.36861,-0.209237 -30.19021,6.665429 -43.89415,9.694631 7.65259,0.542544 21.08672,1.231768 22.18456,1.854212 1.09971,0.623611 1.92541,8.064764 2.67487,12.283088 5.91959,-7.418443 19.40383,-23.62268 19.03472,-23.831931 z M 125.42293,59.592937 c -0.44655,0.1125 4.65988,18.477033 6.76635,26.856382 2.69189,-3.815347 6.93512,-10.632649 8.26418,-10.967772 1.33082,-0.335537 14.41073,2.134145 21.88974,3.381693 -11.49464,-6.001218 -36.47343,-19.382928 -36.92027,-19.270303 z m 164.80534,51.680193 c -0.0928,-0.27855 -33.04307,-4.73423 -48.04185,-6.88709 5.99277,2.90065 16.78887,7.80145 17.06501,8.63065 0.27649,0.83069 -6.98832,6.74108 -10.86175,10.18944 13.01804,-3.70914 41.93138,-11.65403 41.83859,-11.933 z M 125.48113,90.005528 C 110.30347,88.587271 77.076206,85.20923 76.857612,85.45104 c -0.218602,0.241871 23.348278,14.363657 33.917068,20.87246 -2.03696,-4.14784 -6.10707,-11.394242 -5.45553,-12.114888 0.65021,-0.719302 13.13762,-2.842685 20.16198,-4.203084 z m 121.66254,38.409332 c 2.03703,4.14807 6.10691,11.39426 5.45552,12.11488 -0.65033,0.7193 -13.13757,2.84269 -20.1619,4.20306 15.17775,1.41825 48.40491,4.79631 48.62348,4.5545 0.21866,-0.24186 -23.3483,-14.36365 -33.9171,-20.87244 z M 107.57689,111.87714 c -13.017795,3.70908 -41.931322,11.654 -41.838422,11.93314 0.09271,0.27847 33.043041,4.73405 48.041762,6.88692 -5.9926,-2.90067 -16.788896,-7.80154 -17.064854,-8.63067 -0.276569,-0.83079 6.988304,-6.74109 10.861514,-10.18939 z M 225.72916,148.289 c -2.69194,3.81535 -6.93504,10.63266 -8.26422,10.9678 -1.33087,0.33555 -14.41072,-2.13415 -21.88976,-3.38169 11.49463,6.00121 36.47352,19.38299 36.92049,19.27028 0.44622,-0.11245 -4.66012,-18.477 -6.76651,-26.85639 z M 118.43579,135.57189 c -5.91956,7.41845 -19.403773,23.62269 -19.034599,23.83193 0.36839,0.20917 30.190049,-6.66543 43.894159,-9.69464 -7.65284,-0.54256 -21.08673,-1.23178 -22.1848,-1.85426 -1.09959,-0.62357 -1.92533,-8.06468 -2.67476,-12.28303 z m 67.64804,20.85589 c -6.39469,2.02298 -17.37508,5.79732 -18.87493,5.61969 -1.50044,-0.17764 -10.05685,-6.28769 -15.14375,-9.66826 3.44522,8.29578 10.53209,26.58297 11.03633,26.64251 0.50342,0.0594 15.81741,-15.53967 22.98235,-22.59394 z"
+ transform="matrix(1,0,0,1.0406634,-58.623593,-54.026411)"
id="path6546"
style="opacity:0.35096154;fill:url(#linearGradient6600);fill-opacity:1;filter:url(#filter6596)" />
<path
- d="M 192.86534,56.061481 C 192.36173,56.001958 177.04791,71.601258 169.88288,78.655471 C 176.27757,76.632509 187.258,72.858149 188.75784,73.035772 C 190.25845,73.213382 198.81453,79.323493 203.90158,82.70395 C 200.45634,74.408167 193.36963,56.121106 192.86534,56.061481 z M 256.56564,75.679414 C 256.19703,75.470177 226.37543,82.344843 212.67149,85.374045 C 220.32408,85.916589 233.75821,86.605813 234.85605,87.228257 C 235.95576,87.851868 236.78146,95.293021 237.53092,99.511345 C 243.45051,92.092902 256.93475,75.888665 256.56564,75.679414 z M 125.42293,59.592937 C 124.97638,59.705437 130.08281,78.06997 132.18928,86.449319 C 134.88117,82.633972 139.1244,75.81667 140.45346,75.481547 C 141.78428,75.14601 154.86419,77.615692 162.3432,78.86324 C 150.84856,72.862022 125.86977,59.480312 125.42293,59.592937 z M 290.22827,111.27313 C 290.13546,110.99458 257.1852,106.5389 242.18642,104.38604 C 248.17919,107.28669 258.97529,112.18749 259.25143,113.01669 C 259.52792,113.84738 252.26311,119.75777 248.38968,123.20613 C 261.40772,119.49699 290.32106,111.5521 290.22827,111.27313 z M 125.48113,90.005528 C 110.30347,88.587271 77.076206,85.20923 76.857612,85.45104 C 76.63901,85.692911 100.20589,99.814697 110.77468,106.3235 C 108.73772,102.17566 104.66761,94.929258 105.31915,94.208612 C 105.96936,93.48931 118.45677,91.365927 125.48113,90.005528 z M 247.14367,128.41486 C 249.1807,132.56293 253.25058,139.80912 252.59919,140.52974 C 251.94886,141.24904 239.46162,143.37243 232.43729,144.7328 C 247.61504,146.15105 280.8422,149.52911 281.06077,149.2873 C 281.27943,149.04544 257.71247,134.92365 247.14367,128.41486 z M 107.57689,111.87714 C 94.559095,115.58622 65.645568,123.53114 65.738468,123.81028 C 65.83118,124.08875 98.781509,128.54433 113.78023,130.6972 C 107.78763,127.79653 96.991334,122.89566 96.715376,122.06653 C 96.438807,121.23574 103.70368,115.32544 107.57689,111.87714 z M 225.72916,148.289 C 223.03722,152.10435 218.79412,158.92166 217.46494,159.2568 C 216.13407,159.59235 203.05422,157.12265 195.57518,155.87511 C 207.06981,161.87632 232.0487,175.2581 232.49567,175.14539 C 232.94189,175.03294 227.83555,156.66839 225.72916,148.289 z M 118.43579,135.57189 C 112.51623,142.99034 99.032017,159.19458 99.401191,159.40382 C 99.769581,159.61299 129.59124,152.73839 143.29535,149.70918 C 135.64251,149.16662 122.20862,148.4774 121.11055,147.85492 C 120.01096,147.23135 119.18522,139.79024 118.43579,135.57189 z M 186.08383,156.42778 C 179.68914,158.45076 168.70875,162.2251 167.2089,162.04747 C 165.70846,161.86983 157.15205,155.75978 152.06515,152.37921 C 155.51037,160.67499 162.59724,178.96218 163.10148,179.02172 C 163.6049,179.08114 178.91889,163.48205 186.08383,156.42778 z"
+ d="m 134.24175,3.3147155 c -0.50361,-0.05952 -15.81743,15.5397765 -22.98246,22.5939895 6.39469,-2.022962 17.37512,-5.797322 18.87496,-5.619699 1.50061,0.17761 10.05669,6.287721 15.14374,9.668178 C 141.83275,21.661401 134.74604,3.3743405 134.24175,3.3147155 z m 63.7003,19.6179325 c -0.36861,-0.209237 -30.19021,6.665429 -43.89415,9.694631 7.65259,0.542544 21.08672,1.231768 22.18456,1.854212 1.09971,0.623611 1.92541,8.064764 2.67487,12.283088 5.91959,-7.418443 19.40383,-23.62268 19.03472,-23.831931 z M 66.799337,6.8461715 c -0.44655,0.1125 4.65988,18.4770325 6.76635,26.8563815 2.69189,-3.815347 6.93512,-10.632649 8.26418,-10.967772 1.33082,-0.335537 14.41073,2.134145 21.889743,3.381693 C 92.224967,20.115256 67.246177,6.7335465 66.799337,6.8461715 z M 231.60468,58.526364 c -0.0928,-0.27855 -33.04307,-4.73423 -48.04185,-6.88709 5.99277,2.90065 16.78887,7.80145 17.06501,8.63065 0.27649,0.83069 -6.98832,6.74108 -10.86175,10.18944 13.01804,-3.70914 41.93138,-11.65403 41.83859,-11.933 z M 66.857537,37.258762 c -15.17766,-1.418257 -48.404924,-4.796298 -48.623518,-4.554488 -0.218602,0.241871 23.348278,14.363657 33.917068,20.87246 -2.03696,-4.14784 -6.10707,-11.394242 -5.45553,-12.114888 0.65021,-0.719302 13.13762,-2.842685 20.16198,-4.203084 z M 188.52008,75.668094 c 2.03703,4.14807 6.10691,11.39426 5.45552,12.11488 -0.65033,0.7193 -13.13757,2.84269 -20.1619,4.20306 15.17775,1.41825 48.40491,4.79631 48.62348,4.5545 0.21866,-0.24186 -23.3483,-14.36365 -33.9171,-20.87244 z M 48.953297,59.130374 c -13.017795,3.70908 -41.9313217,11.654 -41.8384217,11.93314 0.09271,0.27847 33.0430407,4.73405 48.0417617,6.88692 -5.9926,-2.90067 -16.788896,-7.80154 -17.064854,-8.63067 -0.276569,-0.83079 6.988304,-6.74109 10.861514,-10.18939 z m 118.152273,36.41186 c -2.69194,3.81535 -6.93504,10.632656 -8.26422,10.967796 -1.33087,0.33555 -14.41072,-2.13415 -21.88976,-3.38169 11.49463,6.00121 36.47352,19.38299 36.92049,19.27028 0.44622,-0.11245 -4.66012,-18.477 -6.76651,-26.856386 z M 59.812197,82.825124 c -5.91956,7.41845 -19.403773,23.622686 -19.034599,23.831926 0.36839,0.20917 30.190049,-6.665426 43.894159,-9.694636 -7.65284,-0.54256 -21.08673,-1.23178 -22.1848,-1.85426 -1.09959,-0.62357 -1.92533,-8.06468 -2.67476,-12.28303 z m 67.648043,20.855886 c -6.39469,2.02298 -17.37508,5.79732 -18.87493,5.61969 -1.50044,-0.17764 -10.056853,-6.28769 -15.143753,-9.668256 3.44522,8.295776 10.532093,26.582966 11.036333,26.642506 0.50342,0.0594 15.81741,-15.53967 22.98235,-22.59394 z"
id="path3766"
- style="opacity:1;fill:url(#linearGradient3216);fill-opacity:1" />
+ style="fill:url(#linearGradient3216);fill-opacity:1" />
<g
- transform="matrix(1.2433595,-5.6480692e-2,-8.5186357e-3,1.1425318,-55.4332,-219.33549)"
+ transform="matrix(1.2433595,-0.05648069,-0.00851864,1.1425318,-114.05679,-272.08226)"
id="g3512"
style="enable-background:new">
<g
- transform="matrix(0.7599177,-1.1926916e-2,0,0.7500728,246.58115,378.18196)"
+ transform="matrix(0.7599177,-0.01192692,0,0.7500728,246.58115,378.18196)"
id="g3514">
<g
transform="matrix(2.8294915,-0.5196682,1.922722,2.7658074,-1390.7458,-622.14861)"
id="g3516">
<path
- d="M 191.25,92.09375 C 191.04408,92.103424 190.8485,92.112778 190.65625,92.15625 L 129.21875,107.4375 L 114.875,97.78125 L 114.75,111.625 C 114.72317,115.22359 114.67135,116.89138 116.65625,118.1875 L 166.96875,152.28125 C 167.11015,152.39644 167.26105,152.49407 167.40625,152.59375 C 167.71234,152.80388 168.03774,152.99013 168.375,153.125 C 168.43585,153.14933 168.50027,153.16578 168.5625,153.1875 C 169.41417,153.51124 170.34383,153.61414 171.125,153.4375 L 243.65625,136.9375 C 244.42526,136.76361 244.89932,136.35162 245.0625,135.8125 C 245.22566,135.27339 245.08145,134.58978 244.5625,133.9375 L 195.3125,93.90625 C 194.79354,93.253937 193.99666,92.718422 193.15625,92.40625 C 192.52593,92.17214 191.86777,92.064728 191.25,92.09375 z"
- transform="matrix(0.3165905,8.4742567e-2,-0.2518713,0.3747611,270.47662,187.97058)"
+ d="m 191.25,92.09375 c -0.20592,0.0097 -0.4015,0.01903 -0.59375,0.0625 L 129.21875,107.4375 114.875,97.78125 114.75,111.625 c -0.0268,3.59859 -0.0786,5.26638 1.90625,6.5625 l 50.3125,34.09375 c 0.1414,0.11519 0.2923,0.21282 0.4375,0.3125 0.30609,0.21013 0.63149,0.39638 0.96875,0.53125 0.0608,0.0243 0.12527,0.0408 0.1875,0.0625 0.85167,0.32374 1.78133,0.42664 2.5625,0.25 l 72.53125,-16.5 c 0.76901,-0.17389 1.24307,-0.58588 1.40625,-1.125 0.16316,-0.53911 0.0189,-1.22272 -0.5,-1.875 l -49.25,-40.03125 c -0.51896,-0.652313 -1.31584,-1.187828 -2.15625,-1.5 -0.63032,-0.23411 -1.28848,-0.341522 -1.90625,-0.3125 z"
+ transform="matrix(0.3165905,0.08474257,-0.2518713,0.3747611,270.47662,187.97058)"
id="path5539"
style="opacity:0.5;fill:#000000;fill-opacity:1;filter:url(#filter6542)" />
<path
- d="M 281.53626,237.15326 L 309.04792,236.5462 C 309.33518,236.5462 309.59444,236.6623 309.78189,236.8505 C 309.96933,237.03871 310.08496,237.29903 310.08496,237.58747 L 315.59103,256.77195 C 315.59103,257.06038 315.4754,257.32069 315.28796,257.5089 C 315.10051,257.69711 314.84125,257.81322 314.55399,257.81322 L 287.42625,257.85531 C 286.85174,257.85531 286.38922,257.3909 286.38922,256.81404 L 280.49923,238.19453 C 280.49923,237.61766 280.96175,237.15326 281.53626,237.15326 z"
+ d="m 281.53626,237.15326 27.51166,-0.60706 c 0.28726,0 0.54652,0.1161 0.73397,0.3043 0.18744,0.18821 0.30307,0.44853 0.30307,0.73697 l 5.50607,19.18448 c 0,0.28843 -0.11563,0.54874 -0.30307,0.73695 -0.18745,0.18821 -0.44671,0.30432 -0.73397,0.30432 l -27.12774,0.0421 c -0.57451,0 -1.03703,-0.46441 -1.03703,-1.04127 l -5.88999,-18.61951 c 0,-0.57687 0.46252,-1.04127 1.03703,-1.04127 z"
id="path3518"
style="fill:#8d0000;fill-opacity:1" />
<path
- d="M 293.04884,250.57475 L 317.14147,250.11423 C 315.07369,251.81667 313.3993,254.18879 313.41979,256.35148 L 288.81484,256.43251 C 286.0145,256.29145 290.73785,250.22017 293.04884,250.57475 z"
+ d="m 293.04884,250.57475 24.09263,-0.46052 c -2.06778,1.70244 -3.74217,4.07456 -3.72168,6.23725 l -24.60495,0.081 c -2.80034,-0.14106 1.92301,-6.21234 4.234,-5.85776 z"
id="path3520"
style="fill:url(#linearGradient3605);fill-opacity:1" />
<g
- transform="matrix(0.4446532,4.8226295e-2,-0.1333755,0.1962764,116.26445,175.89592)"
+ transform="matrix(0.4446532,0.0482263,-0.1333755,0.1962764,116.26445,175.89592)"
id="g3522">
<path
- d="M 473.62579,276.25731 L 523.62044,263.93981"
+ d="m 473.62579,276.25731 49.99465,-12.3175"
id="path3524"
- style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:url(#linearGradient3607);stroke-width:0.731525;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+ style="fill:none;stroke:url(#linearGradient3607);stroke-width:0.731525;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none" />
<path
- d="M 473.62579,279.2625 L 523.62044,266.945"
+ d="M 473.62579,279.2625 523.62044,266.945"
id="path3526"
- style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:url(#linearGradient3609);stroke-width:0.731525;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+ style="fill:none;stroke:url(#linearGradient3609);stroke-width:0.731525;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none" />
<path
- d="M 473.62579,282.26769 L 523.62044,269.95019"
+ d="m 473.62579,282.26769 49.99465,-12.3175"
id="path3528"
- style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:url(#linearGradient3611);stroke-width:0.731525;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+ style="fill:none;stroke:url(#linearGradient3611);stroke-width:0.731525;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none" />
<path
- d="M 473.62579,285.27287 L 523.62044,272.95537"
+ d="m 473.62579,285.27287 49.99465,-12.3175"
id="path3530"
- style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:url(#linearGradient3613);stroke-width:0.731525;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
+ style="fill:none;stroke:url(#linearGradient3613);stroke-width:0.731525;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none" />
</g>
<path
- d="M 297.97117,252.53831 C 301.52552,259.77574 299.81365,262.75273 299.81365,262.75273 C 302.15674,261.43854 303.80178,259.85198 304.40731,257.85976 C 306.10363,259.91709 307.68732,262.00721 311.02425,263.58697 C 311.02425,263.58697 308.17102,256.67636 306.99795,252.72547 L 297.97117,252.53831 z"
+ d="m 297.97117,252.53831 c 3.55435,7.23743 1.84248,10.21442 1.84248,10.21442 2.34309,-1.31419 3.98813,-2.90075 4.59366,-4.89297 1.69632,2.05733 3.28001,4.14745 6.61694,5.72721 0,0 -2.85323,-6.91061 -4.0263,-10.8615 l -9.02678,-0.18716 z"
id="path3532"
style="fill:#0093d9;fill-opacity:1;stroke-width:2" />
<path
- d="M 284.57789,231.78049 L 311.35381,231.98057 C 312.03942,231.98057 312.59137,232.53252 312.59137,233.21812 L 319.65855,249.0056 C 319.65855,249.6912 319.1066,250.24315 318.42099,250.24315 L 291.3756,249.90132 L 283.34033,233.01804 C 283.34033,232.33244 283.89228,231.78049 284.57789,231.78049 z"
+ d="m 284.57789,231.78049 26.77592,0.20008 c 0.68561,0 1.23756,0.55195 1.23756,1.23755 l 7.06718,15.78748 c 0,0.6856 -0.55195,1.23755 -1.23756,1.23755 l -27.04539,-0.34183 -8.03527,-16.88328 c 0,-0.6856 0.55195,-1.23755 1.23756,-1.23755 z"
id="path3534"
style="fill:url(#linearGradient6436);fill-opacity:1" />
<path
- d="M 280.11847,237.40712 L 283.64185,232.23159 L 291.38621,249.98696 C 288.0188,251.30318 284.32556,257.42055 287.8134,257.83795 C 286.90613,257.86075 286.55779,257.58155 286.41124,257.06853 L 279.07531,240.02171 C 278.77336,239.36777 279.20359,238.75346 280.11847,237.40712 z"
+ d="m 280.11847,237.40712 3.52338,-5.17553 7.74436,17.75537 c -3.36741,1.31622 -7.06065,7.43359 -3.57281,7.85099 -0.90727,0.0228 -1.25561,-0.2564 -1.40216,-0.76942 l -7.33593,-17.04682 c -0.30195,-0.65394 0.12828,-1.26825 1.04316,-2.61459 z"
id="path3536"
style="fill:#bc0000;fill-opacity:1" />
<path
- d="M 284.81403,231.70142 L 310.76827,231.67318 C 311.23825,231.67318 311.61659,232.05154 311.61659,232.52151 C 311.84112,239.11592 297.48249,247.99953 290.73174,248.61015 L 283.9657,232.54975 C 283.9657,232.07978 284.34405,231.70142 284.81403,231.70142 z"
+ d="m 284.81403,231.70142 25.95424,-0.0282 c 0.46998,0 0.84832,0.37836 0.84832,0.84833 0.22453,6.59441 -14.1341,15.47802 -20.88485,16.08864 l -6.76604,-16.0604 c 0,-0.46997 0.37835,-0.84833 0.84833,-0.84833 z"
id="path3538"
- style="opacity:1;fill:url(#radialGradient3615);fill-opacity:1" />
+ style="fill:url(#radialGradient3615);fill-opacity:1" />
<path
- d="M 300.57764,261.77315 C 303.1027,260.28877 303.97263,258.02948 304.52297,256.35635 C 304.65197,259.11437 310.6776,263.74511 310.02721,262.13276 C 307.93208,256.93882 307.56927,253.43259 306.81477,253.24246 C 305.71856,252.96623 300.52066,253.10078 299.04126,253.01887 C 300.12656,255.20315 300.84486,257.48247 300.57764,261.77315 z"
+ d="m 300.57764,261.77315 c 2.52506,-1.48438 3.39499,-3.74367 3.94533,-5.4168 0.129,2.75802 6.15463,7.38876 5.50424,5.77641 -2.09513,-5.19394 -2.45794,-8.70017 -3.21244,-8.8903 -1.09621,-0.27623 -6.29411,-0.14168 -7.77351,-0.22359 1.0853,2.18428 1.8036,4.4636 1.53638,8.75428 z"
id="path3540"
style="opacity:0.79901961;fill:url(#radialGradient3617);fill-opacity:1;stroke-width:2" />
<path
- d="M 319.47279,249.25686 C 319.47279,249.94246 319.11267,250.24441 318.42706,250.24441 L 291.96418,250.69265 L 291.35826,249.84959 C 298.49858,249.63625 310.11914,249.64123 319.47279,249.25686 z"
+ d="m 319.47279,249.25686 c 0,0.6856 -0.36012,0.98755 -1.04573,0.98755 l -26.46288,0.44824 -0.60592,-0.84306 c 7.14032,-0.21334 18.76088,-0.20836 28.11453,-0.59273 z"
id="path3542"
style="fill:#a70000;fill-opacity:1" />
</g>
</g>
</g>
<path
- d="M 73.023896,203.62637 L 76.373856,203.62637 C 79.077336,203.62637 81.722056,203.39128 83.896596,202.86234 C 88.421976,201.68691 93.593856,198.51325 93.593856,191.16685 C 93.593856,186.70023 91.654406,183.64411 89.009696,181.99852 C 86.188676,180.23538 82.427306,179.64766 78.313316,179.64766 L 61.916116,179.64766 L 61.916116,181.35203 C 67.087986,181.70466 67.205536,181.82221 67.205536,185.1134 L 67.205536,215.5588 C 67.205536,218.84999 67.087986,218.96754 61.916116,219.32017 L 61.916116,221.02454 L 79.253656,221.02454 L 79.253656,219.32017 C 73.200216,218.96754 73.023896,218.84999 73.023896,215.5588 L 73.023896,203.62637 M 73.023896,183.8792 C 73.023896,182.2336 73.670386,181.70466 77.490516,181.70466 C 83.543956,181.70466 87.246556,185.17218 87.246556,191.57824 C 87.246556,198.92465 82.427306,201.56937 77.372976,201.56937 C 73.905466,201.56937 73.023896,201.45183 73.023896,199.27729 L 73.023896,183.8792 M 131.78952,220.31743 L 131.78952,218.61306 C 127.7343,218.3192 127.38167,218.20165 127.38167,215.20432 L 127.38167,191.16685 L 126.97027,190.81422 L 117.74317,192.2835 L 117.74317,193.75278 L 119.97648,194.04664 C 121.50453,194.28173 121.85716,194.57558 121.85716,196.69135 L 121.85716,209.9149 C 121.85716,211.5605 121.68085,212.85347 121.38699,213.44118 C 120.03525,216.14466 117.21423,217.84903 114.15812,217.84903 C 110.74938,217.84903 108.22221,215.73326 108.22221,211.1491 L 108.22221,191.16685 L 107.81081,190.81422 L 98.583716,192.2835 L 98.583716,193.75278 L 100.81703,194.04664 C 102.34508,194.28173 102.69771,194.57558 102.69771,196.69135 L 102.69771,212.20698 C 102.69771,218.96568 106.69416,221.02268 111.04324,221.02268 C 116.0388,221.02268 120.09403,217.61394 121.79839,216.79115 L 122.38611,220.31743 L 131.78952,220.31743 M 140.94387,221.02268 L 143.29472,218.7306 C 145.35171,219.90603 147.82012,221.02268 152.22796,221.02268 C 160.04454,221.02268 166.86202,217.2613 166.86202,205.27196 C 166.86202,201.62815 166.09799,190.81422 155.51916,190.81422 C 151.05254,190.81422 147.58502,193.69401 145.41049,194.98698 L 145.41049,177.06173 L 144.99909,176.7091 L 135.77199,178.17838 L 135.77199,179.64766 L 138.0053,179.88275 C 139.53335,180.05906 139.88598,180.35292 139.88598,182.58623 L 139.88598,220.55251 L 140.94387,221.02268 M 145.41049,201.45183 C 145.41049,199.98255 145.52803,199.0422 145.9982,198.10186 C 147.40871,195.28084 149.87711,193.98787 153.1683,193.98787 C 155.57792,193.98787 160.74981,195.39839 160.74981,205.62459 C 160.74981,214.26397 158.10509,218.96569 152.28673,218.96569 C 149.17186,218.96569 146.87977,217.37886 145.82189,214.44029 C 145.46926,213.38241 145.41049,212.14821 145.41049,210.7377 L 145.41049,201.45183 M 182.78609,177.06173 L 182.37469,176.7091 L 173.1476,178.17838 L 173.1476,179.64766 L 175.3809,179.88275 C 176.90896,180.05906 177.26159,180.35292 177.26159,182.58623 L 177.26159,215.20432 C 177.26159,218.20165 177.08527,218.3192 172.85374,218.61306 L 172.85374,220.31743 L 187.19394,220.31743 L 187.19394,218.61306 C 183.02118,218.3192 182.78609,218.20165 182.78609,215.20432 L 182.78609,177.06173 M 192.2242,192.2835 L 192.2242,193.75278 L 194.45751,194.04664 C 195.98556,194.28173 196.33819,194.57558 196.33819,196.69135 L 196.33819,215.20432 C 196.33819,218.20165 196.16187,218.3192 191.93034,218.61306 L 191.93034,220.31743 L 206.27055,220.31743 L 206.27055,218.61306 C 202.09778,218.3192 201.8627,218.20165 201.8627,215.20432 L 201.8627,191.16685 L 201.45129,190.81422 L 192.2242,192.2835 M 199.04167,178.29592 C 196.92591,178.29592 195.45662,179.82398 195.45662,181.93975 C 195.45662,183.99674 196.92591,185.46603 199.04167,185.46603 C 201.21621,185.46603 202.56795,183.99674 202.62672,181.93975 C 202.62672,179.82398 201.21621,178.29592 199.04167,178.29592 M 226.74113,217.96657 C 219.74735,217.96657 218.10174,210.67892 218.10174,205.15442 C 218.10174,196.3975 221.56926,192.87121 225.62448,192.87121 C 228.32795,192.87121 230.03233,194.81067 231.20775,197.98432 C 231.56038,198.92466 231.91301,199.51237 233.02966,199.51237 C 234.20509,199.51237 236.49717,198.74834 236.49717,196.51504 C 236.49717,193.81156 232.61826,190.81422 226.27096,190.81422 C 215.57459,190.81422 211.98953,198.39573 211.98953,206.21231 C 211.98953,216.02711 216.80878,221.02268 225.62448,221.02268 C 229.73846,221.02268 235.26298,218.84814 236.90857,212.55961 L 235.2042,211.73681 C 233.38229,215.8508 231.03143,217.96657 226.74113,217.96657 M 260.38109,211.91313 C 260.38109,216.6736 256.73727,217.9078 254.44519,217.9078 C 250.80137,217.9078 249.03822,215.32186 249.03822,211.85435 C 249.03822,209.0921 250.3312,207.68159 253.62239,206.44739 C 255.97324,205.56582 259.08812,204.44917 260.38109,203.62637 L 260.38109,211.91313 M 265.67051,198.6308 C 265.67051,195.22207 264.90647,190.81422 256.03201,190.81422 C 249.39086,190.81422 244.1602,194.28173 244.1602,197.51415 C 244.1602,199.39483 246.33474,200.2764 247.4514,200.2764 C 248.68559,200.2764 249.03822,199.62992 249.33208,198.6308 C 250.62505,194.28173 253.03468,192.87121 255.38553,192.87121 C 257.67761,192.87121 260.38109,194.04665 260.38109,198.74835 L 260.38109,201.21674 C 258.91181,202.7448 253.21098,204.21408 248.56805,205.68336 C 244.33652,206.97633 243.10232,209.9149 243.10232,212.67715 C 243.10232,217.085 246.04089,221.02268 251.56539,221.02268 C 255.20921,220.90514 258.44164,218.7306 260.32232,217.4964 C 261.14512,219.67094 262.08546,221.02268 264.14246,221.02268 C 266.31699,221.02268 268.84416,220.3762 271.07747,219.25954 L 270.72485,217.84903 C 269.90205,218.02534 268.60908,218.14289 267.72751,217.9078 C 266.66962,217.67272 265.67051,216.55606 265.67051,212.85347 L 265.67051,198.6308 M 304.03238,200.15886 C 304.03238,194.22296 300.79995,190.81422 295.39299,190.81422 C 291.04392,190.81422 288.34043,192.92999 284.69661,195.28084 L 283.87381,190.81422 L 275.11688,192.2835 L 275.11688,193.75278 L 277.35019,194.04664 C 278.87824,194.28173 279.23087,194.57558 279.23087,196.69135 L 279.23087,215.20432 C 279.23087,218.20165 279.05456,218.3192 274.82302,218.61306 L 274.82302,220.31743 L 289.16323,220.31743 L 289.16323,218.61306 C 284.99047,218.3192 284.75538,218.20165 284.75538,215.20432 L 284.75538,201.45183 C 284.75538,199.98255 284.87292,199.15975 285.34309,198.2194 C 286.57729,195.92733 289.222,193.98787 292.33688,193.98787 C 296.33333,193.98787 298.50787,196.22118 298.50787,201.33429 L 298.50787,215.20432 C 298.50787,218.20165 298.33155,218.3192 294.10002,218.61306 L 294.10002,220.31743 L 308.44023,220.31743 L 308.44023,218.61306 C 304.26747,218.3192 304.03238,218.20165 304.03238,215.20432 L 304.03238,200.15886"
+ d="m 14.400303,150.8796 3.34996,0 c 2.70348,0 5.3482,-0.23509 7.52274,-0.76403 4.52538,-1.17543 9.69726,-4.34909 9.69726,-11.69549 0,-4.46662 -1.93945,-7.52274 -4.58416,-9.16833 -2.82102,-1.76314 -6.58239,-2.35086 -10.69638,-2.35086 l -16.3971997,0 0,1.70437 c 5.17187,0.35263 5.28942,0.47018 5.28942,3.76137 l 0,30.4454 c 0,3.29119 -0.11755,3.40874 -5.28942,3.76137 l 0,1.70437 17.3375397,0 0,-1.70437 c -6.05344,-0.35263 -6.22976,-0.47018 -6.22976,-3.76137 l 0,-11.93243 m 0,-19.74717 c 0,-1.6456 0.64649,-2.17454 4.46662,-2.17454 6.05344,0 9.75604,3.46752 9.75604,9.87358 0,7.34641 -4.81925,9.99113 -9.87358,9.99113 -3.46751,0 -4.34908,-0.11754 -4.34908,-2.29208 l 0,-15.39809 m 58.765624,36.43823 0,-1.70437 c -4.05522,-0.29386 -4.40785,-0.41141 -4.40785,-3.40874 l 0,-24.03747 -0.4114,-0.35263 -9.2271,1.46928 0,1.46928 2.23331,0.29386 c 1.52805,0.23509 1.88068,0.52894 1.88068,2.64471 l 0,13.22355 c 0,1.6456 -0.17631,2.93857 -0.47017,3.52628 -1.35174,2.70348 -4.17276,4.40785 -7.22887,4.40785 -3.40874,0 -5.93591,-2.11577 -5.93591,-6.69993 l 0,-19.98225 -0.4114,-0.35263 -9.227094,1.46928 0,1.46928 2.233314,0.29386 c 1.52805,0.23509 1.88068,0.52894 1.88068,2.64471 l 0,15.51563 c 0,6.7587 3.99645,8.8157 8.34553,8.8157 4.99556,0 9.05079,-3.40874 10.75515,-4.23153 l 0.58772,3.52628 9.40341,0 m 9.15435,0.70525 2.35085,-2.29208 c 2.05699,1.17543 4.5254,2.29208 8.93324,2.29208 7.816583,0 14.634063,-3.76138 14.634063,-15.75072 0,-3.64381 -0.76403,-14.45774 -11.342863,-14.45774 -4.46662,0 -7.93414,2.87979 -10.10867,4.17276 l 0,-17.92525 -0.4114,-0.35263 -9.2271,1.46928 0,1.46928 2.23331,0.23509 c 1.52805,0.17631 1.88068,0.47017 1.88068,2.70348 l 0,37.96628 1.05789,0.47017 m 4.46662,-19.57085 c 0,-1.46928 0.11754,-2.40963 0.58771,-3.34997 1.41051,-2.82102 3.87891,-4.11399 7.1701,-4.11399 2.40962,0 7.581513,1.41052 7.581513,11.63672 0,8.63938 -2.644723,13.3411 -8.463083,13.3411 -3.11487,0 -5.40696,-1.58683 -6.46484,-4.5254 -0.35263,-1.05788 -0.4114,-2.29208 -0.4114,-3.70259 l 0,-9.28587 m 37.375603,-24.3901 -0.4114,-0.35263 -9.22709,1.46928 0,1.46928 2.2333,0.23509 c 1.52806,0.17631 1.88069,0.47017 1.88069,2.70348 l 0,32.61809 c 0,2.99733 -0.17632,3.11488 -4.40785,3.40874 l 0,1.70437 14.3402,0 0,-1.70437 c -4.17276,-0.29386 -4.40785,-0.41141 -4.40785,-3.40874 l 0,-38.14259 m 9.43811,15.22177 0,1.46928 2.23331,0.29386 c 1.52805,0.23509 1.88068,0.52894 1.88068,2.64471 l 0,18.51297 c 0,2.99733 -0.17632,3.11488 -4.40785,3.40874 l 0,1.70437 14.34021,0 0,-1.70437 c -4.17277,-0.29386 -4.40785,-0.41141 -4.40785,-3.40874 l 0,-24.03747 -0.41141,-0.35263 -9.22709,1.46928 m 6.81747,-13.98758 c -2.11576,0 -3.58505,1.52806 -3.58505,3.64383 0,2.05699 1.46929,3.52628 3.58505,3.52628 2.17454,0 3.52628,-1.46929 3.58505,-3.52628 0,-2.11577 -1.41051,-3.64383 -3.58505,-3.64383 m 27.69946,39.67065 c -6.99378,0 -8.63939,-7.28765 -8.63939,-12.81215 0,-8.75692 3.46752,-12.28321 7.52274,-12.28321 2.70347,0 4.40785,1.93946 5.58327,5.11311 0.35263,0.94034 0.70526,1.52805 1.82191,1.52805 1.17543,0 3.46751,-0.76403 3.46751,-2.99733 0,-2.70348 -3.87891,-5.70082 -10.22621,-5.70082 -10.69637,0 -14.28143,7.58151 -14.28143,15.39809 0,9.8148 4.81925,14.81037 13.63495,14.81037 4.11398,0 9.6385,-2.17454 11.28409,-8.46307 l -1.70437,-0.8228 c -1.82191,4.11399 -4.17277,6.22976 -8.46307,6.22976 m 33.63996,-6.05344 c 0,4.76047 -3.64382,5.99467 -5.9359,5.99467 -3.64382,0 -5.40697,-2.58594 -5.40697,-6.05345 0,-2.76225 1.29298,-4.17276 4.58417,-5.40696 2.35085,-0.88157 5.46573,-1.99822 6.7587,-2.82102 l 0,8.28676 m 5.28942,-13.28233 c 0,-3.40873 -0.76404,-7.81658 -9.6385,-7.81658 -6.64115,0 -11.87181,3.46751 -11.87181,6.69993 0,1.88068 2.17454,2.76225 3.2912,2.76225 1.23419,0 1.58682,-0.64648 1.88068,-1.6456 1.29297,-4.34907 3.7026,-5.75959 6.05345,-5.75959 2.29208,0 4.99556,1.17544 4.99556,5.87714 l 0,2.46839 c -1.46928,1.52806 -7.17011,2.99734 -11.81304,4.46662 -4.23153,1.29297 -5.46573,4.23154 -5.46573,6.99379 0,4.40785 2.93857,8.34553 8.46307,8.34553 3.64382,-0.11754 6.87625,-2.29208 8.75693,-3.52628 0.8228,2.17454 1.76314,3.52628 3.82014,3.52628 2.17453,0 4.7017,-0.64648 6.93501,-1.76314 l -0.35262,-1.41051 c -0.8228,0.17631 -2.11577,0.29386 -2.99734,0.0588 -1.05789,-0.23508 -2.057,-1.35174 -2.057,-5.05433 l 0,-14.22267 m 38.36187,1.52806 c 0,-5.9359 -3.23243,-9.34464 -8.63939,-9.34464 -4.34907,0 -7.05256,2.11577 -10.69638,4.46662 l -0.8228,-4.46662 -8.75693,1.46928 0,1.46928 2.23331,0.29386 c 1.52805,0.23509 1.88068,0.52894 1.88068,2.64471 l 0,18.51297 c 0,2.99733 -0.17631,3.11488 -4.40785,3.40874 l 0,1.70437 14.34021,0 0,-1.70437 c -4.17276,-0.29386 -4.40785,-0.41141 -4.40785,-3.40874 l 0,-13.75249 c 0,-1.46928 0.11754,-2.29208 0.58771,-3.23243 1.2342,-2.29207 3.87891,-4.23153 6.99379,-4.23153 3.99645,0 6.17099,2.23331 6.17099,7.34642 l 0,13.87003 c 0,2.99733 -0.17632,3.11488 -4.40785,3.40874 l 0,1.70437 14.34021,0 0,-1.70437 c -4.17276,-0.29386 -4.40785,-0.41141 -4.40785,-3.40874 l 0,-15.04546"
id="text2427"
- style="font-size:58.77133179px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;fill:url(#linearGradient3224);fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Utopia;-inkscape-font-specification:Utopia" />
+ style="font-size:58.77133179px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;fill:url(#linearGradient3224);fill-opacity:1;stroke:none;font-family:Utopia;-inkscape-font-specification:Utopia" />
<text
- x="271.64307"
- y="247.77698"
+ x="213.01947"
+ y="195.03021"
id="text2432"
xml:space="preserve"
- style="font-size:13.46161938px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:end;line-height:125%;writing-mode:lr-tb;text-anchor:end;fill:#888a85;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;font-family:Liberation Sans;-inkscape-font-specification:Liberation Sans"><tspan
- x="271.64307"
- y="247.77698"
+ style="font-size:13.46161938px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:end;line-height:125%;writing-mode:lr-tb;text-anchor:end;fill:#888a85;fill-opacity:1;stroke:none;font-family:Liberation Sans;-inkscape-font-specification:Liberation Sans"><tspan
+ x="213.01947"
+ y="195.03021"
id="tspan2434"
style="font-size:13.46161938px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:end;line-height:125%;letter-spacing:0.44818318;writing-mode:lr-tb;text-anchor:end;fill:#888a85;font-family:Liberation Sans;-inkscape-font-specification:Liberation Sans">BOOK PUBLISHING TOOL</tspan></text>
<path
- d="M 73.023896,206.82472 L 76.373856,206.82472 C 79.077336,206.82472 81.722056,206.58963 83.896596,206.06069 C 88.421976,204.88526 93.593856,201.7116 93.593856,194.3652 C 93.593856,189.89858 91.654406,186.84246 89.009696,185.19687 C 86.188676,183.43373 82.427306,182.84601 78.313316,182.84601 L 61.916116,182.84601 L 61.916116,184.55038 C 67.087986,184.90301 67.205536,185.02056 67.205536,188.31175 L 67.205536,218.75715 C 67.205536,222.04834 67.087986,222.16589 61.916116,222.51852 L 61.916116,224.22289 L 79.253656,224.22289 L 79.253656,222.51852 C 73.200216,222.16589 73.023896,222.04834 73.023896,218.75715 L 73.023896,206.82472 M 73.023896,187.07755 C 73.023896,185.43195 73.670386,184.90301 77.490516,184.90301 C 83.543956,184.90301 87.246556,188.37053 87.246556,194.77659 C 87.246556,202.123 82.427306,204.76772 77.372976,204.76772 C 73.905466,204.76772 73.023896,204.65018 73.023896,202.47564 L 73.023896,187.07755 M 131.78952,223.51578 L 131.78952,221.81141 C 127.7343,221.51755 127.38167,221.4 127.38167,218.40267 L 127.38167,194.3652 L 126.97027,194.01257 L 117.74317,195.48185 L 117.74317,196.95113 L 119.97648,197.24499 C 121.50453,197.48008 121.85716,197.77393 121.85716,199.8897 L 121.85716,213.11325 C 121.85716,214.75885 121.68085,216.05182 121.38699,216.63953 C 120.03525,219.34301 117.21423,221.04738 114.15812,221.04738 C 110.74938,221.04738 108.22221,218.93161 108.22221,214.34745 L 108.22221,194.3652 L 107.81081,194.01257 L 98.583716,195.48185 L 98.583716,196.95113 L 100.81703,197.24499 C 102.34508,197.48008 102.69771,197.77393 102.69771,199.8897 L 102.69771,215.40533 C 102.69771,222.16403 106.69416,224.22103 111.04324,224.22103 C 116.0388,224.22103 120.09403,220.81229 121.79839,219.9895 L 122.38611,223.51578 L 131.78952,223.51578 M 140.94387,224.22103 L 143.29472,221.92895 C 145.35171,223.10438 147.82012,224.22103 152.22796,224.22103 C 160.04454,224.22103 166.86202,220.45965 166.86202,208.47031 C 166.86202,204.8265 166.09799,194.01257 155.51916,194.01257 C 151.05254,194.01257 147.58502,196.89236 145.41049,198.18533 L 145.41049,180.26008 L 144.99909,179.90745 L 135.77199,181.37673 L 135.77199,182.84601 L 138.0053,183.0811 C 139.53335,183.25741 139.88598,183.55127 139.88598,185.78458 L 139.88598,223.75086 L 140.94387,224.22103 M 145.41049,204.65018 C 145.41049,203.1809 145.52803,202.24055 145.9982,201.30021 C 147.40871,198.47919 149.87711,197.18622 153.1683,197.18622 C 155.57792,197.18622 160.74981,198.59674 160.74981,208.82294 C 160.74981,217.46232 158.10509,222.16404 152.28673,222.16404 C 149.17186,222.16404 146.87977,220.57721 145.82189,217.63864 C 145.46926,216.58076 145.41049,215.34656 145.41049,213.93605 L 145.41049,204.65018 M 182.78609,180.26008 L 182.37469,179.90745 L 173.1476,181.37673 L 173.1476,182.84601 L 175.3809,183.0811 C 176.90896,183.25741 177.26159,183.55127 177.26159,185.78458 L 177.26159,218.40267 C 177.26159,221.4 177.08527,221.51755 172.85374,221.81141 L 172.85374,223.51578 L 187.19394,223.51578 L 187.19394,221.81141 C 183.02118,221.51755 182.78609,221.4 182.78609,218.40267 L 182.78609,180.26008 M 192.2242,195.48185 L 192.2242,196.95113 L 194.45751,197.24499 C 195.98556,197.48008 196.33819,197.77393 196.33819,199.8897 L 196.33819,218.40267 C 196.33819,221.4 196.16187,221.51755 191.93034,221.81141 L 191.93034,223.51578 L 206.27055,223.51578 L 206.27055,221.81141 C 202.09778,221.51755 201.8627,221.4 201.8627,218.40267 L 201.8627,194.3652 L 201.45129,194.01257 L 192.2242,195.48185 M 199.04167,181.49427 C 196.92591,181.49427 195.45662,183.02233 195.45662,185.1381 C 195.45662,187.19509 196.92591,188.66438 199.04167,188.66438 C 201.21621,188.66438 202.56795,187.19509 202.62672,185.1381 C 202.62672,183.02233 201.21621,181.49427 199.04167,181.49427 M 226.74113,221.16492 C 219.74735,221.16492 218.10174,213.87727 218.10174,208.35277 C 218.10174,199.59585 221.56926,196.06956 225.62448,196.06956 C 228.32795,196.06956 230.03233,198.00902 231.20775,201.18267 C 231.56038,202.12301 231.91301,202.71072 233.02966,202.71072 C 234.20509,202.71072 236.49717,201.94669 236.49717,199.71339 C 236.49717,197.00991 232.61826,194.01257 226.27096,194.01257 C 215.57459,194.01257 211.98953,201.59408 211.98953,209.41066 C 211.98953,219.22546 216.80878,224.22103 225.62448,224.22103 C 229.73846,224.22103 235.26298,222.04649 236.90857,215.75796 L 235.2042,214.93516 C 233.38229,219.04915 231.03143,221.16492 226.74113,221.16492 M 260.38109,215.11148 C 260.38109,219.87195 256.73727,221.10615 254.44519,221.10615 C 250.80137,221.10615 249.03822,218.52021 249.03822,215.0527 C 249.03822,212.29045 250.3312,210.87994 253.62239,209.64574 C 255.97324,208.76417 259.08812,207.64752 260.38109,206.82472 L 260.38109,215.11148 M 265.67051,201.82915 C 265.67051,198.42042 264.90647,194.01257 256.03201,194.01257 C 249.39086,194.01257 244.1602,197.48008 244.1602,200.7125 C 244.1602,202.59318 246.33474,203.47475 247.4514,203.47475 C 248.68559,203.47475 249.03822,202.82827 249.33208,201.82915 C 250.62505,197.48008 253.03468,196.06956 255.38553,196.06956 C 257.67761,196.06956 260.38109,197.245 260.38109,201.9467 L 260.38109,204.41509 C 258.91181,205.94315 253.21098,207.41243 248.56805,208.88171 C 244.33652,210.17468 243.10232,213.11325 243.10232,215.8755 C 243.10232,220.28335 246.04089,224.22103 251.56539,224.22103 C 255.20921,224.10349 258.44164,221.92895 260.32232,220.69475 C 261.14512,222.86929 262.08546,224.22103 264.14246,224.22103 C 266.31699,224.22103 268.84416,223.57455 271.07747,222.45789 L 270.72485,221.04738 C 269.90205,221.22369 268.60908,221.34124 267.72751,221.10615 C 266.66962,220.87107 265.67051,219.75441 265.67051,216.05182 L 265.67051,201.82915 M 304.03238,203.35721 C 304.03238,197.42131 300.79995,194.01257 295.39299,194.01257 C 291.04392,194.01257 288.34043,196.12834 284.69661,198.47919 L 283.87381,194.01257 L 275.11688,195.48185 L 275.11688,196.95113 L 277.35019,197.24499 C 278.87824,197.48008 279.23087,197.77393 279.23087,199.8897 L 279.23087,218.40267 C 279.23087,221.4 279.05456,221.51755 274.82302,221.81141 L 274.82302,223.51578 L 289.16323,223.51578 L 289.16323,221.81141 C 284.99047,221.51755 284.75538,221.4 284.75538,218.40267 L 284.75538,204.65018 C 284.75538,203.1809 284.87292,202.3581 285.34309,201.41775 C 286.57729,199.12568 289.222,197.18622 292.33688,197.18622 C 296.33333,197.18622 298.50787,199.41953 298.50787,204.53264 L 298.50787,218.40267 C 298.50787,221.4 298.33155,221.51755 294.10002,221.81141 L 294.10002,223.51578 L 308.44023,223.51578 L 308.44023,221.81141 C 304.26747,221.51755 304.03238,221.4 304.03238,218.40267 L 304.03238,203.35721"
+ d="m 14.400303,154.07795 3.34996,0 c 2.70348,0 5.3482,-0.23509 7.52274,-0.76403 4.52538,-1.17543 9.69726,-4.34909 9.69726,-11.69549 0,-4.46662 -1.93945,-7.52274 -4.58416,-9.16833 -2.82102,-1.76314 -6.58239,-2.35086 -10.69638,-2.35086 l -16.3971997,0 0,1.70437 c 5.17187,0.35263 5.28942,0.47018 5.28942,3.76137 l 0,30.4454 c 0,3.29119 -0.11755,3.40874 -5.28942,3.76137 l 0,1.70437 17.3375397,0 0,-1.70437 c -6.05344,-0.35263 -6.22976,-0.47018 -6.22976,-3.76137 l 0,-11.93243 m 0,-19.74717 c 0,-1.6456 0.64649,-2.17454 4.46662,-2.17454 6.05344,0 9.75604,3.46752 9.75604,9.87358 0,7.34641 -4.81925,9.99113 -9.87358,9.99113 -3.46751,0 -4.34908,-0.11754 -4.34908,-2.29208 l 0,-15.39809 m 58.765624,36.43823 0,-1.70437 c -4.05522,-0.29386 -4.40785,-0.41141 -4.40785,-3.40874 l 0,-24.03747 -0.4114,-0.35263 -9.2271,1.46928 0,1.46928 2.23331,0.29386 c 1.52805,0.23509 1.88068,0.52894 1.88068,2.64471 l 0,13.22355 c 0,1.6456 -0.17631,2.93857 -0.47017,3.52628 -1.35174,2.70348 -4.17276,4.40785 -7.22887,4.40785 -3.40874,0 -5.93591,-2.11577 -5.93591,-6.69993 l 0,-19.98225 -0.4114,-0.35263 -9.227094,1.46928 0,1.46928 2.233314,0.29386 c 1.52805,0.23509 1.88068,0.52894 1.88068,2.64471 l 0,15.51563 c 0,6.7587 3.99645,8.8157 8.34553,8.8157 4.99556,0 9.05079,-3.40874 10.75515,-4.23153 l 0.58772,3.52628 9.40341,0 m 9.15435,0.70525 2.35085,-2.29208 c 2.05699,1.17543 4.5254,2.29208 8.93324,2.29208 7.816583,0 14.634063,-3.76138 14.634063,-15.75072 0,-3.64381 -0.76403,-14.45774 -11.342863,-14.45774 -4.46662,0 -7.93414,2.87979 -10.10867,4.17276 l 0,-17.92525 -0.4114,-0.35263 -9.2271,1.46928 0,1.46928 2.23331,0.23509 c 1.52805,0.17631 1.88068,0.47017 1.88068,2.70348 l 0,37.96628 1.05789,0.47017 m 4.46662,-19.57085 c 0,-1.46928 0.11754,-2.40963 0.58771,-3.34997 1.41051,-2.82102 3.87891,-4.11399 7.1701,-4.11399 2.40962,0 7.581513,1.41052 7.581513,11.63672 0,8.63938 -2.644723,13.3411 -8.463083,13.3411 -3.11487,0 -5.40696,-1.58683 -6.46484,-4.5254 -0.35263,-1.05788 -0.4114,-2.29208 -0.4114,-3.70259 l 0,-9.28587 m 37.375603,-24.3901 -0.4114,-0.35263 -9.22709,1.46928 0,1.46928 2.2333,0.23509 c 1.52806,0.17631 1.88069,0.47017 1.88069,2.70348 l 0,32.61809 c 0,2.99733 -0.17632,3.11488 -4.40785,3.40874 l 0,1.70437 14.3402,0 0,-1.70437 c -4.17276,-0.29386 -4.40785,-0.41141 -4.40785,-3.40874 l 0,-38.14259 m 9.43811,15.22177 0,1.46928 2.23331,0.29386 c 1.52805,0.23509 1.88068,0.52894 1.88068,2.64471 l 0,18.51297 c 0,2.99733 -0.17632,3.11488 -4.40785,3.40874 l 0,1.70437 14.34021,0 0,-1.70437 c -4.17277,-0.29386 -4.40785,-0.41141 -4.40785,-3.40874 l 0,-24.03747 -0.41141,-0.35263 -9.22709,1.46928 m 6.81747,-13.98758 c -2.11576,0 -3.58505,1.52806 -3.58505,3.64383 0,2.05699 1.46929,3.52628 3.58505,3.52628 2.17454,0 3.52628,-1.46929 3.58505,-3.52628 0,-2.11577 -1.41051,-3.64383 -3.58505,-3.64383 m 27.69946,39.67065 c -6.99378,0 -8.63939,-7.28765 -8.63939,-12.81215 0,-8.75692 3.46752,-12.28321 7.52274,-12.28321 2.70347,0 4.40785,1.93946 5.58327,5.11311 0.35263,0.94034 0.70526,1.52805 1.82191,1.52805 1.17543,0 3.46751,-0.76403 3.46751,-2.99733 0,-2.70348 -3.87891,-5.70082 -10.22621,-5.70082 -10.69637,0 -14.28143,7.58151 -14.28143,15.39809 0,9.8148 4.81925,14.81037 13.63495,14.81037 4.11398,0 9.6385,-2.17454 11.28409,-8.46307 l -1.70437,-0.8228 c -1.82191,4.11399 -4.17277,6.22976 -8.46307,6.22976 m 33.63996,-6.05344 c 0,4.76047 -3.64382,5.99467 -5.9359,5.99467 -3.64382,0 -5.40697,-2.58594 -5.40697,-6.05345 0,-2.76225 1.29298,-4.17276 4.58417,-5.40696 2.35085,-0.88157 5.46573,-1.99822 6.7587,-2.82102 l 0,8.28676 m 5.28942,-13.28233 c 0,-3.40873 -0.76404,-7.81658 -9.6385,-7.81658 -6.64115,0 -11.87181,3.46751 -11.87181,6.69993 0,1.88068 2.17454,2.76225 3.2912,2.76225 1.23419,0 1.58682,-0.64648 1.88068,-1.6456 1.29297,-4.34907 3.7026,-5.75959 6.05345,-5.75959 2.29208,0 4.99556,1.17544 4.99556,5.87714 l 0,2.46839 c -1.46928,1.52806 -7.17011,2.99734 -11.81304,4.46662 -4.23153,1.29297 -5.46573,4.23154 -5.46573,6.99379 0,4.40785 2.93857,8.34553 8.46307,8.34553 3.64382,-0.11754 6.87625,-2.29208 8.75693,-3.52628 0.8228,2.17454 1.76314,3.52628 3.82014,3.52628 2.17453,0 4.7017,-0.64648 6.93501,-1.76314 l -0.35262,-1.41051 c -0.8228,0.17631 -2.11577,0.29386 -2.99734,0.0588 -1.05789,-0.23508 -2.057,-1.35174 -2.057,-5.05433 l 0,-14.22267 m 38.36187,1.52806 c 0,-5.9359 -3.23243,-9.34464 -8.63939,-9.34464 -4.34907,0 -7.05256,2.11577 -10.69638,4.46662 l -0.8228,-4.46662 -8.75693,1.46928 0,1.46928 2.23331,0.29386 c 1.52805,0.23509 1.88068,0.52894 1.88068,2.64471 l 0,18.51297 c 0,2.99733 -0.17631,3.11488 -4.40785,3.40874 l 0,1.70437 14.34021,0 0,-1.70437 c -4.17276,-0.29386 -4.40785,-0.41141 -4.40785,-3.40874 l 0,-13.75249 c 0,-1.46928 0.11754,-2.29208 0.58771,-3.23243 1.2342,-2.29207 3.87891,-4.23153 6.99379,-4.23153 3.99645,0 6.17099,2.23331 6.17099,7.34642 l 0,13.87003 c 0,2.99733 -0.17632,3.11488 -4.40785,3.40874 l 0,1.70437 14.34021,0 0,-1.70437 c -4.17276,-0.29386 -4.40785,-0.41141 -4.40785,-3.40874 l 0,-15.04546"
id="path6354"
- style="font-size:58.77133179px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;opacity:0.49038463;fill:url(#linearGradient6356);fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;filter:url(#filter6426);font-family:Utopia;-inkscape-font-specification:Utopia" />
+ style="font-size:58.77133179px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;writing-mode:lr-tb;text-anchor:start;opacity:0.49038463;fill:url(#linearGradient6356);fill-opacity:1;stroke:none;filter:url(#filter6426);font-family:Utopia;-inkscape-font-specification:Utopia" />
<g
+ transform="translate(-58.623593,-52.746766)"
id="layer1" />
<g
+ transform="translate(-58.623593,-52.746766)"
id="layer2"
style="filter:url(#filter6626)" />
</svg>
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Preface</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="index.html" title="SystemTap Beginners Guide" /><link rel="next" href="pr01s02.html" title="2. We Need Feedback!" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="index.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="pr01s02.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="preface" id="SystemTap_Beginners_Guide-Preface" lang="en-US"><div class="titlepage"><div><div><h1 class="title">Preface</h1></div></div></div><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">Preface</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="index.html" title="SystemTap Beginners Guide" /><link rel="next" href="pr01s02.html" title="2. We Need Feedback!" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="index.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="pr01s02.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="preface" lang="en-US"><div class="titlepage"><div><div><h1 class="title"><a id="SystemTap_Beginners_Guide-Preface"></a>Preface</h1></div></div></div><div class="para">
- </div><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h2 class="title"
id="idp35045504">1. Document Conventions</h2></div></div></div><div class="para">
+ </div><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h2 class="title"
><a id="idm246922603856"></a>1. Document Conventions</h2></div></div></div><div class="para">
This manual uses several conventions to highlight certain words and phrases and draw attention to specific pieces of information.
</div><div class="para">
- In PDF and paper editions, this manual uses typefaces drawn from the <a href="https://fedorahosted.org/liberation-fonts/">Liberation Fonts</a> set. The Liberation Fonts set is also used in HTML editions if the set is installed on your system. If not, alternative but equivalent typefaces are displayed. Note: Red Hat Enterprise Linux 5 and later includes the Liberation Fonts set by default.
- </div><div class="section"><div class="titlepage"><div><div><h3 class="title"
id="idp49732512">1.1. Typographic Conventions</h3></div></div></div><div class="para">
+ In PDF and paper editions, this manual uses typefaces drawn from the <a href="https://fedorahosted.org/liberation-fonts/">Liberation Fonts</a> set. The Liberation Fonts set is also used in HTML editions if the set is installed on your system. If not, alternative but equivalent typefaces are displayed. Note: Red Hat Enterprise Linux 5 and later include the Liberation Fonts set by default.
+ </div><div class="section"><div class="titlepage"><div><div><h3 class="title"
><a id="idm246917943776"></a>1.1. Typographic Conventions</h3></div></div></div><div class="para">
Four typographic conventions are used to call attention to specific words and phrases. These conventions, and the circumstances they apply to, are as follows.
</div><div class="para">
<code class="literal">Mono-spaced Bold</code>
</div><div class="para">
- Used to highlight system input, including shell commands, file names and paths. Also used to highlight keycaps and key combinations. For example:
+ Used to highlight system input, including shell commands, file names and paths. Also used to highlight keys and key combinations. For example:
</div><div class="blockquote"><blockquote class="blockquote"><div class="para">
To see the contents of the file <code class="filename">my_next_bestselling_novel</code> in your current working directory, enter the <code class="command">cat my_next_bestselling_novel</code> command at the shell prompt and press <span class="keycap"><strong>Enter</strong></span> to execute the command.
</div></blockquote></div><div class="para">
- The above includes a file name, a shell command and a keycap, all presented in mono-spaced bold and all distinguishable thanks to context.
+ The above includes a file name, a shell command and a key, all presented in mono-spaced bold and all distinguishable thanks to context.
</div><div class="para">
- Key combinations can be distinguished from keycaps by the hyphen connecting each part of a key combination. For example:
+ Key combinations can be distinguished from an individual key by the plus sign that connects each part of a key combination. For example:
</div><div class="blockquote"><blockquote class="blockquote"><div class="para">
Press <span class="keycap"><strong>Enter</strong></span> to execute the command.
</div><div class="para">
- Press <span class="keycap"><strong>Ctrl</strong></span>+<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>F2</strong></span> to switch to the first virtual terminal. Press <span class="keycap"><strong>Ctrl</strong></span>+<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>F1</strong></span> to return to your X-Windows session.
+ Press <span class="keycap"><strong>Ctrl</strong></span>+<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>F2</strong></span> to switch to a virtual terminal.
</div></blockquote></div><div class="para">
- The first paragraph highlights the particular keycap to press. The second highlights two key combinations (each a set of three keycaps with each set pressed simultaneously).
+ The first example highlights a particular key to press. The second example highlights a key combination: a set of three keys pressed simultaneously.
</div><div class="para">
If source code is discussed, class names, methods, functions, variable names and returned values mentioned within a paragraph will be presented as above, in <code class="literal">mono-spaced bold</code>. For example:
</div><div class="blockquote"><blockquote class="blockquote"><div class="para">
</div></blockquote></div><div class="para">
<span class="application"><strong>Proportional Bold</strong></span>
</div><div class="para">
- This denotes words or phrases encountered on a system, including application names; dialog box text; labeled buttons; check-box and radio button labels; menu titles and sub-menu titles. For example:
+ This denotes words or phrases encountered on a system, including application names; dialog-box text; labeled buttons; check-box and radio-button labels; menu titles and submenu titles. For example:
</div><div class="blockquote"><blockquote class="blockquote"><div class="para">
- Choose <span class="guimenu"><strong>System</strong></span> → <span class="guisubmenu"><strong>Preferences</strong></span> → <span class="guimenuitem"><strong>Mouse</strong></span> from the main menu bar to launch <span class="application"><strong>Mouse Preferences</strong></span>. In the <span class="guilabel"><strong>Buttons</strong></span> tab, click the <span class="guilabel"><strong>Left-handed mouse</strong></span> check box and click <span class="guibutton"><strong>Close</strong></span> to switch the primary mouse button from the left to the right (making the mouse suitable for use in the left hand).
+ Choose <span class="guimenu"><strong>System</strong></span> → <span class="guisubmenu"><strong>Preferences</strong></span> → <span class="guimenuitem"><strong>Mouse</strong></span> from the main menu bar to launch <span class="application"><strong>Mouse Preferences</strong></span>. In the <span class="guilabel"><strong>Buttons</strong></span> tab, select the <span class="guilabel"><strong>Left-handed mouse</strong></span> check box and click <span class="guibutton"><strong>Close</strong></span> to switch the primary mouse button from the left to the right (making the mouse suitable for use in the left hand).
</div><div class="para">
To insert a special character into a <span class="application"><strong>gedit</strong></span> file, choose <span class="guimenu"><strong>Applications</strong></span> → <span class="guisubmenu"><strong>Accessories</strong></span> → <span class="guimenuitem"><strong>Character Map</strong></span> from the main menu bar. Next, choose <span class="guimenu"><strong>Search</strong></span> → <span class="guimenuitem"><strong>Find…</strong></span> from the <span class="application"><strong>Character Map</strong></span> menu bar, type the name of the character in the <span class="guilabel"><strong>Search</strong></span> field and click <span class="guibutton"><strong>Next</strong></span>. The character you sought will be highlighted in the <span class="guilabel"><strong>Character Table</strong></span>. Double-click this highlighted character to place it in the <span class="guilabel"><strong>Text to copy</strong></span> field and then click the <span class="guibutton"><strong>Copy</strong></span> button. Now switch back to your document and choose <span class="guimenu"><strong>Edit</strong></span> → <span class="guimenuitem"><strong>Paste</strong></span> from the <span class="application"><strong>gedit</strong></span> menu bar.
</div></blockquote></div><div class="para">
</div><div class="para">
To see the version of a currently installed package, use the <code class="command">rpm -q <em class="replaceable"><code>package</code></em></code> command. It will return a result as follows: <code class="command"><em class="replaceable"><code>package-version-release</code></em></code>.
</div></blockquote></div><div class="para">
- Note the words in bold italics above — username, domain.name, file-system, package, version and release. Each word is a placeholder, either for text you enter when issuing a command or for text displayed by the system.
+ Note the words in bold italics above: username, domain.name, file-system, package, version and release. Each word is a placeholder, either for text you enter when issuing a command or for text displayed by the system.
</div><div class="para">
Aside from standard usage for presenting the title of a work, italics denotes the first use of a new and important term. For example:
</div><div class="blockquote"><blockquote class="blockquote"><div class="para">
Publican is a <em class="firstterm">DocBook</em> publishing system.
- </div></blockquote></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"
id="idp50742544">1.2. Pull-quote Conventions</h3></div></div></div><div class="para">
+ </div></blockquote></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"
><a id="idm246878025616"></a>1.2. Pull-quote Conventions</h3></div></div></div><div class="para">
Terminal output and source code listings are set off visually from the surrounding text.
</div><div class="para">
Output sent to a terminal is set in <code class="computeroutput">mono-spaced roman</code> and presented thus:
</div><pre class="screen">books Desktop documentation drafts mss photos stuff svn
books_tests Desktop1 downloads images notes scripts svgs</pre><div class="para">
Source-code listings are also set in <code class="computeroutput">mono-spaced roman</code> but add syntax highlighting as follows:
- </div><pre class="programlisting">package org.<span class="perl_Function">jboss</span>.<span class="perl_Function">book</span>.<span class="perl_Function">jca</span>.<span class="perl_Function">ex1</span>;
+ </div><pre xml:lang="en-US" class="programlisting" lang="en-US">package org.<span class="perl_Function">jboss</span>.<span class="perl_Function">book</span>.<span class="perl_Function">jca</span>.<span class="perl_Function">ex1</span>;
<span class="perl_Keyword">import</span> javax.naming.InitialContext;
System.<span class="perl_Function">out</span>.<span class="perl_Function">println</span>(<span class="perl_String">"Echo.echo('Hello') = "</span> + echo.<span class="perl_Function">echo</span>(<span class="perl_String">"Hello"</span>));
}
-}</pre></div><div class="section"><div class="titlepage"><div><div><h3 class="title"
id="idp30437968">1.3. Notes and Warnings</h3></div></div></div><div class="para">
+}</pre></div><div class="section"><div class="titlepage"><div><div><h3 class="title"
><a id="idm246930165456"></a>1.3. Notes and Warnings</h3></div></div></div><div class="para">
Finally, we use three visual styles to draw attention to information that might otherwise be overlooked.
- </div><div
class="note"><div class="admonition_header"><h2>Note</h2></div><div class="admonition"><div class="para">
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="note"><div class="admonition_header"><p><strong>Note</strong></p></div><div class="admonition"><div class="para">
Notes are tips, shortcuts or alternative approaches to the task at hand. Ignoring a note should have no negative consequences, but you might miss out on a trick that makes your life easier.
- </div></div></div><div
class="important"><div class="admonition_header"><h2>Important</h2></div><div class="admonition"><div class="para">
- Important boxes detail things that are easily missed: configuration changes that only apply to the current session, or services that need restarting before an update will apply. Ignoring a box labeled 'Important' will not cause data loss but may cause irritation and frustration.
- </div></div></div><div
class="warning"><div class="admonition_header"><h2>Warning</h2></div><div class="admonition"><div class="para">
+ </div></div></div><div
xmlns:d="http://docbook.org/ns/docbook" class="important"><div class="admonition_header"><p><strong>Important</strong></p></div><div class="admonition"><div class="para">
+ Important boxes detail things that are easily missed: configuration changes that only apply to the current session, or services that need restarting before an update will apply. Ignoring a box labeled “Important” will not cause data loss but may cause irritation and frustration.
+ </div></div></div><div
xmlns:d="http://docbook.org/ns/docbook" class="warning"><div class="admonition_header"><p><strong>Warning</strong></p></div><div class="admonition"><div class="para">
Warnings should not be ignored. Ignoring warnings will most likely cause data loss.
- </div></div></div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="index.html"><strong>Prev</strong>SystemTap Beginners Guide</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="pr01s02.html"><strong>Next</strong>2. We Need Feedback!</a></li></ul></body></html>
+ </div></div></div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="index.html"><strong>Prev</strong>SystemTap Beginners Guide</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="pr01s02.html"><strong>Next</strong>2. We Need Feedback!</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Appendix A. Revision History</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="references.html" title="Chapter 7. References" /><link rel="next" href="ix01.html" title="Index" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="references.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="ix01.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="appendix" id="appe-Publican-Revision_History" lang="en-US"><div class="titlepage"><div><div><h1 class="title">Revision History</h1></div></div></div><div class="para">
- <div class="revhistory"><table border="0" width="100%" summary="Revision history"><tr><th align="left" valign="top" colspan="3"><strong>Revision History</strong></th></tr><tr><td align="left">Revision 2.0-1</td><td align="left">Mon Jul 20 2009</td><td align="left"><span class="author"><span class="firstname">Don</span> <span class="surname">Domingo</span></span></td></tr><tr><td align="left" colspan="3">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">Appendix A. Revision History</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="references.html" title="Chapter 7. References" /><link rel="next" href="ix01.html" title="Index" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="references.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="ix01.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="appendix" lang="en-US"><div class="titlepage"><div><div><h1 class="title"><a id="appe-Publican-Revision_History"></a>Appendix A. Revision History</h1></div></div></div><div xmlns:d="http://docbook.org/ns/docbook" class="para"><p></p>
+ <div class="revhistory"><table summary="Revision History"><tr><th align="left" valign="top" colspan="3"><strong>Revision History</strong></th></tr><tr><td align="left">Revision 2.0-1</td><td align="left">Mon Jul 20 2009</td><td align="left"><span class="author"><span class="firstname">Don</span> <span class="surname">Domingo</span></span></td></tr><tr><td align="left" colspan="3">
<table border="0" summary="Simple list" class="simplelist"><tr><td>includes 5.4 minor updates and additional script "dropwatch.stp"</td></tr></table>
</td></tr><tr><td align="left">Revision 1.0-1</td><td align="left">Wed Jun 17 2009</td><td align="left"><span class="author"><span class="firstname">Don</span> <span class="surname">Domingo</span></span></td></tr><tr><td align="left" colspan="3">
</td></tr></table></div>
- </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="references.html"><strong>Prev</strong>Chapter 7. References</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="ix01.html"><strong>Next</strong>Index</a></li></ul></body></html>
+ </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="references.html"><strong>Prev</strong>Chapter 7. References</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="ix01.html"><strong>Next</strong>Index</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>3.5. Array Operations in SystemTap</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="understanding-how-systemtap-works.html" title="Chapter 3. Understanding How SystemTap Works" /><link rel="prev" href="associativearrays.html" title="3.4. Associative Arrays" /><link rel="next" href="arrayops-readvalues.html" title="3.5.2. Reading Values From Arrays" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="associativearrays.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="arrayops-readvalues.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="arrayoperators" lang="en-US"><div class="titlepage"><div><div><h2 class="title" id="arrayoperators">3.5. Array Operations in SystemTap</h2></div></div></div><a id="idp31035760" class="indexterm"></a><a id="idp22639312" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">3.5. Array Operations in SystemTap</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="understanding-how-systemtap-works.html" title="Chapter 3. Understanding How SystemTap Works" /><link rel="prev" href="associativearrays.html" title="3.4. Associative Arrays" /><link rel="next" href="arrayops-readvalues.html" title="3.5.2. Reading Values From Arrays" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="associativearrays.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="arrayops-readvalues.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h2 class="title"><a id="arrayoperators"></a>3.5. Array Operations in SystemTap</h2></div></div></div><a id="idm246913137504" class="indexterm"></a><a id="idm246927890784" class="indexterm"></a><div class="para">
This section enumerates some of the most commonly used array operations in SystemTap.
- </div><div class="section"
id="arrayops-assignvalue"><div class="titlepage"><div><div><h3 class="title" id="arrayops-assignvalue">3.5.1. Assigning an Associated Value</h3></div></div></div><a id="idp29864192" class="indexterm"></a><a id="idp17298896" class="indexterm"></a><a id="idp21597904" class="indexterm"></a><div class="para">
+ </div><div class="section"
><div class="titlepage"><div><div><h3 class="title"><a id="arrayops-assignvalue"></a>3.5.1. Assigning an Associated Value</h3></div></div></div><a id="idm246868947296" class="indexterm"></a><a id="idm246868945888" class="indexterm"></a><a id="idm246922899168" class="indexterm"></a><div class="para">
Use <code class="command">=</code> to set an associated value to indexed unique pairs, as in:
</div><pre class="screen"><em class="replaceable"><code>array_name</code></em>[<em class="replaceable"><code>index_expression</code></em>] = <em class="replaceable"><code>value</code></em></pre><div class="para">
<a class="xref" href="associativearrays.html#arraysimplestexample">Example 3.13, “Basic Array Statements”</a> shows a very basic example of how to set an explicit associated value to a unique key. You can also use a handler function as both your <code class="command"><em class="replaceable"><code>index_expression</code></em></code> and <code class="command"><em class="replaceable"><code>value</code></em></code>. For example, you can use arrays to set a timestamp as the associated value to a process name (which you wish to use as your unique key), as in:
- </div><a id="id
p17319440" class="indexterm"></a><a id="idp15383728" class="indexterm"></a><a id="idp21947536" class="indexterm"></a><a id="idp45670288" class="indexterm"></a><a id="idp31843520" class="indexterm"></a><a id="idp13888896" class="indexterm"></a><div class="example" id="arrays-timestampprocessname"><h6>Example 3.14. Associating Timestamps to Process Names</h6><div class="example-contents"><pre class="programlisting">foo[tid()] = gettimeofday_s()</pre></div></div><br class="example-break" /><div class="para">
- Whenever an event invokes the statement in <a class="xref" href="arrayoperators.html#arrays-timestampprocessname">Example 3.14, “Associating Timestamps to Process Names”</a>, SystemTap returns the appropriate <code class="command">tid()</code> value (i.e. the ID of a thread, which is then used as the unique key). At the same time, SystemTap also uses the function <code class="command">gettimeofday_s()</code> to set the corresponding timestamp as the associated value to the unique key defined by the function <code class="command">tid()</code>. This creates an array composed of key pairs containing thread IDs and timestamps.
+ </div><a id="id
m246923047584" class="indexterm"></a><a id="idm246927092016" class="indexterm"></a><a id="idm246924551824" class="indexterm"></a><a id="idm246920787472" class="indexterm"></a><a id="idm246873373440" class="indexterm"></a><a id="idm246928973024" class="indexterm"></a><div class="example"><a id="arrays-timestampprocessname"></a><p class="title"><strong>Example 3.14. Associating Timestamps to Process Names</strong></p><div class="example-contents"><pre class="programlisting">foo[tid()] = gettimeofday_s()</pre></div></div><br class="example-break" /><div class="para">
+ Whenever an event invokes the statement in <a class="xref" href="arrayoperators.html#arrays-timestampprocessname">Example 3.14, “Associating Timestamps to Process Names”</a>, SystemTap returns the appropriate <code class="command">tid()</code> value (that is, the ID of a thread, which is then used as the unique key). At the same time, SystemTap also uses the function <code class="command">gettimeofday_s()</code> to set the corresponding timestamp as the associated value to the unique key defined by the function <code class="command">tid()</code>. This creates an array composed of key pairs containing thread IDs and timestamps.
</div><div class="para">
In this same example, if <code class="command">tid()</code> returns a value that is already defined in the array <code class="command">foo</code>, the operator will discard the original associated value to it, and replace it with the current timestamp from <code class="command">gettimeofday_s()</code>.
- </div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="associativearrays.html"><strong>Prev</strong>3.4. Associative Arrays</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="arrayops-readvalues.html"><strong>Next</strong>3.5.2. Reading Values From Arrays</a></li></ul></body></html>
+ </div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="associativearrays.html"><strong>Prev</strong>3.4. Associative Arrays</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="arrayops-readvalues.html"><strong>Next</strong>3.5.2. Reading Values From Arrays</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>3.5.7. Computing for Statistical Aggregates</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="arrayoperators.html" title="3.5. Array Operations in SystemTap" /><link rel="prev" href="arrayops-conditionals.html" title="3.5.6. Using Arrays in Conditional Statements" /><link rel="next" href="understanding-tapsets.html" title="3.6. Tapsets" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-conditionals.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="understanding-tapsets.html"><strong>Next</strong></a></li></ul><div class="section" id="arrayops-aggregates"><div class="titlepage"><div><div><h3 class="title" id="arrayops-aggregates">3.5.7. Computing for Statistical Aggregates</h3></div></div></div><a id="idp32314224" class="indexterm"></a><a id="idp39676864" class="indexterm"></a><a id="idp23175792" class="indexterm"></a><a id="idp23177200" class="indexterm"></a><a id="idp31572512" class="indexterm"></a><div class="para">
- Statistical aggregates are used to collect statistics on numerical values where it is important to accumulate new data quickly and in large volume (i.e. storing only aggregated stream statistics). Statistical aggregates can be used in global variables or as elements in an array.
- </div><a id="idp30697904" class="indexterm"></a><a id="idp51594464" class="indexterm"></a><a id="idp51723056" class="indexterm"></a><a id="idp52170496" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">3.5.7. Computing for Statistical Aggregates</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="arrayoperators.html" title="3.5. Array Operations in SystemTap" /><link rel="prev" href="arrayops-conditionals.html" title="3.5.6. Using Arrays in Conditional Statements" /><link rel="next" href="understanding-tapsets.html" title="3.6. Tapsets" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="arrayops-conditionals.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="understanding-tapsets.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="arrayops-aggregates"></a>3.5.7. Computing for Statistical Aggregates</h3></div></div></div><a id="idm246927153888" class="indexterm"></a><a id="idm246920848784" class="indexterm"></a><a id="idm246881908944" class="indexterm"></a><a id="idm246881907536" class="indexterm"></a><a id="idm246917193792" class="indexterm"></a><div class="para">
+ Statistical aggregates are used to collect statistics on numerical values where it is important to accumulate new data quickly and in large volume (that is, storing only aggregated stream statistics). Statistical aggregates can be used in global variables or as elements in an array.
+ </div><a id="idm246917191344" class="indexterm"></a><a id="idm246928741888" class="indexterm"></a><a id="idm246873333184" class="indexterm"></a><a id="idm246873331328" class="indexterm"></a><div class="para">
To add value to a statistical aggregate, use the operator <code class="command"><<< <em class="replaceable"><code>value</code></em></code>.
- </div><div class="example"
id="simpleaggregates"><h6>Example 3.21. stat-aggregates.stp</h6><div class="example-contents"><pre class="programlisting">global reads
+ </div><div class="example"
><a id="simpleaggregates"></a><p class="title"><strong>Example 3.21. stat-aggregates.stp</strong></p><div class="example-contents"><pre class="programlisting">global reads
probe vfs.read
{
- reads[execname()] <<< count
-}</pre></div></div><br class="example-break" /><a id="id
p48070672" class="indexterm"></a><a id="idp51958704" class="indexterm"></a><a id="idp15102640" class="indexterm"></a><a id="idm9052320" class="indexterm"></a><div class="para">
- In <a class="xref" href="arrayops-aggregates.html#simpleaggregates">Example 3.21, “stat-aggregates.stp”</a>, the operator <code class="command"><<< count</code> <span class="emphasis"><em>stores</em></span> the amount returned by <code class="literal">count</code> to to the associated value of the corresponding <code class="command">execname()</code> in the <code class="literal">reads</code> array. Remember, these values are <span class="emphasis"><em>stored</em></span>; they are not added to the associated values of each unique key, nor are they used to replace the current associated values. In a manner of speaking, think of it as having each unique key (<code class="command">execname()</code>) having multiple associated values, accumulating with each probe handler run.
- </div><div
class="note"><div class="admonition_header"><h2>Note</h2></div><div class="admonition"><div class="para">
+ reads[execname()] <<< $count
+}</pre></div></div><br class="example-break" /><a id="id
m246917987968" class="indexterm"></a><a id="idm246873151232" class="indexterm"></a><a id="idm246926768784" class="indexterm"></a><a id="idm246926766896" class="indexterm"></a><div class="para">
+ In <a class="xref" href="arrayops-aggregates.html#simpleaggregates">Example 3.21, “stat-aggregates.stp”</a>, the operator <code class="command"><<< $count</code> <span class="emphasis"><em>stores</em></span> the amount returned by <code class="literal">$count</code> to the associated value of the corresponding <code class="command">execname()</code> in the <code class="literal">reads</code> array. Remember, these values are <span class="emphasis"><em>stored</em></span>; they are not added to the associated values of each unique key, nor are they used to replace the current associated values. In a manner of speaking, think of it as having each unique key (<code class="command">execname()</code>) having multiple associated values, accumulating with each probe handler run.
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="note"><div class="admonition_header"><p><strong>Note</strong></p></div><div class="admonition"><div class="para">
In the context of <a class="xref" href="arrayops-aggregates.html#simpleaggregates">Example 3.21, “stat-aggregates.stp”</a>, <code class="literal">count</code> returns the amount of data read by the returned <code class="command">execname()</code> to the virtual file system.
- </div></div></div><a id="id
p27213504" class="indexterm"></a><a id="idp50721536" class="indexterm"></a><a id="idp27606304" class="indexterm"></a><a id="idp40143520" class="indexterm"></a><a id="idp15105776" class="indexterm"></a><div class="para">
+ </div></div></div><a id="id
m246917554080" class="indexterm"></a><a id="idm246917552224" class="indexterm"></a><a id="idm246928592496" class="indexterm"></a><a id="idm246875152400" class="indexterm"></a><a id="idm246875150544" class="indexterm"></a><div class="para">
To extract data collected by statistical aggregates, use the syntax format <code class="command">@<em class="replaceable"><code>extractor</code></em>(<em class="replaceable"><code>variable/array index expression</code></em>)</code>. <code class="command"><em class="replaceable"><code>extractor</code></em></code> can be any of the following integer extractors:
- </div><div class="variablelist"><dl
><dt class="varlistentry"><span class="term">count</span></dt><dd><a id="idm10151312" class="indexterm"></a><a id="idp59448320" class="indexterm"></a><a id="idp14738928" class="indexterm"></a><a id="idp63387792" class="indexterm"></a><div class="para">
+ </div><div class="variablelist"><dl
class="variablelist"><dt><span class="term">count</span></dt><dd><a id="idm246917833840" class="indexterm"></a><a id="idm246917831984" class="indexterm"></a><a id="idm246929084608" class="indexterm"></a><a id="idm246929082752" class="indexterm"></a><div class="para">
Returns the number of all values stored into the variable/array index expression. Given the sample probe in <a class="xref" href="arrayops-aggregates.html#simpleaggregates">Example 3.21, “stat-aggregates.stp”</a>, the expression <code class="command">@count(reads[execname()])</code> will return <span class="emphasis"><em>how many values are stored</em></span> in each unique key in array <code class="literal">reads</code>.
- </div></dd><dt
class="varlistentry"><span class="term">sum</span></dt><dd><a id="idm10162576" class="indexterm"></a><a id="idm10160720" class="indexterm"></a><a id="idp64033264" class="indexterm"></a><a id="idp31541808" class="indexterm"></a><div class="para">
+ </div></dd><dt
><span class="term">sum</span></dt><dd><a id="idm246873352256" class="indexterm"></a><a id="idm246873350400" class="indexterm"></a><a id="idm246875834736" class="indexterm"></a><a id="idm246875832880" class="indexterm"></a><div class="para">
Returns the sum of all values stored into the variable/array index expression. Again, given sample probe in <a class="xref" href="arrayops-aggregates.html#simpleaggregates">Example 3.21, “stat-aggregates.stp”</a>, the expression <code class="command">@sum(reads[execname()])</code> will return <span class="emphasis"><em>the total of all values stored</em></span> in each unique key in array <code class="literal">reads</code>.
- </div></dd><dt
class="varlistentry"><span class="term">min</span></dt><dd><a id="idp14997840" class="indexterm"></a><a id="idp38632288" class="indexterm"></a><a id="idp38634144" class="indexterm"></a><a id="idp20157872" class="indexterm"></a><div class="para">
+ </div></dd><dt
><span class="term">min</span></dt><dd><a id="idm246920628960" class="indexterm"></a><a id="idm246920627104" class="indexterm"></a><a id="idm246907783152" class="indexterm"></a><a id="idm246907781296" class="indexterm"></a><div class="para">
Returns the smallest among all the values stored in the variable/array index expression.
- </div></dd><dt
class="varlistentry"><span class="term">max</span></dt><dd><a id="idp21588560" class="indexterm"></a><a id="idp30575120" class="indexterm"></a><a id="idp30576976" class="indexterm"></a><a id="idp30173328" class="indexterm"></a><div class="para">
+ </div></dd><dt
><span class="term">max</span></dt><dd><a id="idm246928898832" class="indexterm"></a><a id="idm246928896976" class="indexterm"></a><a id="idm246917973792" class="indexterm"></a><a id="idm246911957600" class="indexterm"></a><div class="para">
Returns the largest among all the values stored in the variable/array index expression.
- </div></dd><dt
class="varlistentry"><span class="term">avg</span></dt><dd><a id="idp50194608" class="indexterm"></a><a id="idp25242768" class="indexterm"></a><a id="idp48186608" class="indexterm"></a><a id="idp48188464" class="indexterm"></a><div class="para">
+ </div></dd><dt
><span class="term">avg</span></dt><dd><a id="idm246918189296" class="indexterm"></a><a id="idm246877757520" class="indexterm"></a><a id="idm246877755664" class="indexterm"></a><a id="idm246877989120" class="indexterm"></a><div class="para">
Returns the average of all values stored in the variable/array index expression.
</div></dd></dl></div><div class="para">
When using statistical aggregates, you can also build array constructs that use multiple index expressions (to a maximum of 5). This is helpful in capturing additional contextual information during a probe. For example:
- </div><div class="example"
id="multiplearrayindices"><h6>Example 3.22. Multiple Array Indexes</h6><div class="example-contents"><pre class="programlisting">global reads
+ </div><div class="example"
><a id="multiplearrayindices"></a><p class="title"><strong>Example 3.22. Multiple Array Indexes</strong></p><div class="example-contents"><pre class="programlisting">global reads
probe vfs.read
{
reads[execname(),pid()] <<< 1
}</pre></div></div><br class="example-break" /><div class="para">
In <a class="xref" href="arrayops-aggregates.html#multiplearrayindices">Example 3.22, “Multiple Array Indexes”</a>, the first probe tracks how many times each process performs a VFS read. What makes this different from earlier examples is that this array associates a performed read to both a process name <span class="emphasis"><em>and</em></span> its corresponding process ID.
</div><div class="para">
- The second probe in <a class="xref" href="arrayops-aggregates.html#multiplearrayindices">Example 3.22, “Multiple Array Indexes”</a> demonstrates how to process and print the information collected by the array <code class="literal">reads</code>. Note how the <code class="command">foreach</code> statement uses the same number of variables (i.e. <code class="literal">var1</code> and <code class="literal">var2</code>) contained in the first instance of the array <code class="literal">reads</code> from the first probe.
- </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-conditionals.html"><strong>Prev</strong>3.5.6. Using Arrays in Conditional Statements</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="understanding-tapsets.html"><strong>Next</strong>3.6. Tapsets</a></li></ul></body></html>
+ The second probe in <a class="xref" href="arrayops-aggregates.html#multiplearrayindices">Example 3.22, “Multiple Array Indexes”</a> demonstrates how to process and print the information collected by the array <code class="literal">reads</code>. Note how the <code class="command">foreach</code> statement uses the same number of variables (that is, <code class="literal">var1</code> and <code class="literal">var2</code>) contained in the first instance of the array <code class="literal">reads</code> from the first probe.
+ </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-conditionals.html"><strong>Prev</strong>3.5.6. Using Arrays in Conditional Statements</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="understanding-tapsets.html"><strong>Next</strong>3.6. Tapsets</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>3.5.6. Using Arrays in Conditional Statements</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="arrayoperators.html" title="3.5. Array Operations in SystemTap" /><link rel="prev" href="arrayops-deleting.html" title="3.5.5. Clearing/Deleting Arrays and Array Elements" /><link rel="next" href="arrayops-aggregates.html" title="3.5.7. Computing for Statistical Aggregates" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-deleting.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="arrayops-aggregates.html"><strong>Next</strong></a></li></ul><div class="section" id="arrayops-conditionals"><div class="titlepage"><div><div><h3 class="title" id="arrayops-conditionals">3.5.6. Using Arrays in Conditional Statements</h3></div></div></div><a id="idp34349456" class="indexterm"></a><a id="idp24410384" class="indexterm"></a><a id="idp41309920" class="indexterm"></a><a id="idp41311328" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">3.5.6. Using Arrays in Conditional Statements</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="arrayoperators.html" title="3.5. Array Operations in SystemTap" /><link rel="prev" href="arrayops-deleting.html" title="3.5.5. Clearing/Deleting Arrays and Array Elements" /><link rel="next" href="arrayops-aggregates.html" title="3.5.7. Computing for Statistical Aggregates" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="arrayops-deleting.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="arrayops-aggregates.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="arrayops-conditionals"></a>3.5.6. Using Arrays in Conditional Statements</h3></div></div></div><a id="idm246876835664" class="indexterm"></a><a id="idm246920852816" class="indexterm"></a><a id="idm246920851408" class="indexterm"></a><a id="idm246920673616" class="indexterm"></a><div class="para">
You can also use associative arrays in <code class="command">if</code> statements. This is useful if you want to execute a subroutine once a value in the array matches a certain condition. Consider the following example:
- </div><div class="example"
id="simplevfsreadprintif"><h6>Example 3.19. vfsreads-print-if-1kb.stp</h6><div class="example-contents"><pre class="programlisting">global reads
+ </div><div class="example"
><a id="simplevfsreadprintif"></a><p class="title"><strong>Example 3.19. vfsreads-print-if-1kb.stp</strong></p><div class="example-contents"><pre class="programlisting">global reads
probe vfs.read
{
reads[execname()] ++
printf("%s : %dB \n", count, reads[count])
}</pre></div></div><br class="example-break" /><div class="para">
Every three seconds, <a class="xref" href="arrayops-conditionals.html#simplevfsreadprintif">Example 3.19, “vfsreads-print-if-1kb.stp”</a> prints out a list of all processes, along with how many times each process performed a VFS read. If the associated value of a process name is equal or greater than 1024, the <code class="command">if</code> statement in the script converts and prints it out in <code class="command">kB</code>.
- </div><div class="formalpara"><h5 class="formalpara" id="idp21599504">Testing for Membership</h5><a id="idp14594512" class="indexterm"></a><a id="idp14596368" class="indexterm"></a><a id="idp41937376" class="indexterm"></a><a id="idp36657392" class="indexterm"></a><a id="idp15252096" class="indexterm"></a>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">Testing for Membership</div><a id="idm246928509440" class="indexterm"></a><a id="idm246928507584" class="indexterm"></a><a id="idm246927762928" class="indexterm"></a><a id="idm246926490208" class="indexterm"></a><a id="idm246913065472" class="indexterm"></a>
You can also test whether a specific unique key is a member of an array. Further, membership in an array can be used in <code class="command">if</code> statements, as in:
</div><pre class="screen">if([<em class="replaceable"><code>index_expression</code></em>] in <em class="replaceable"><code>array_name</code></em>) <em class="replaceable"><code>statement</code></em></pre><div class="para">
To illustrate this, consider the following example:
- </div><div class="example"
id="simplesimplevfsreadprintifmember"><h6>Example 3.20. vfsreads-stop-on-stapio2.stp</h6><div class="example-contents"><pre class="programlisting">global reads
+ </div><div class="example"
><a id="simplesimplevfsreadprintifmember"></a><p class="title"><strong>Example 3.20. vfsreads-stop-on-stapio2.stp</strong></p><div class="example-contents"><pre class="programlisting">global reads
probe vfs.read
{
}
}</pre></div></div><br class="example-break" /><div class="para">
The <code class="command">if(["stapio"] in reads)</code> statement instructs the script to print <code class="computeroutput">stapio read detected, exiting</code> once the unique key <code class="command">stapio</code> is added to the array <code class="command">reads</code>.
- </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-deleting.html"><strong>Prev</strong>3.5.5. Clearing/Deleting Arrays and Array Elements</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="arrayops-aggregates.html"><strong>Next</strong>3.5.7. Computing for Statistical Aggregates</a></li></ul></body></html>
+ </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-deleting.html"><strong>Prev</strong>3.5.5. Clearing/Deleting Arrays and Array Elements</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="arrayops-aggregates.html"><strong>Next</strong>3.5.7. Computing for Statistical Aggregates</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>3.5.5. Clearing/Deleting Arrays and Array Elements</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="arrayoperators.html" title="3.5. Array Operations in SystemTap" /><link rel="prev" href="arrayops-foreach.html" title="3.5.4. Processing Multiple Elements in an Array" /><link rel="next" href="arrayops-conditionals.html" title="3.5.6. Using Arrays in Conditional Statements" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-foreach.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="arrayops-conditionals.html"><strong>Next</strong></a></li></ul><div class="section" id="arrayops-deleting"><div class="titlepage"><div><div><h3 class="title" id="arrayops-deleting">3.5.5. Clearing/Deleting Arrays and Array Elements</h3></div></div></div><a id="idp40350544" class="indexterm"></a><a id="idp40351952" class="indexterm"></a><a id="idp50007392" class="indexterm"></a><a id="idp59045584" class="indexterm"></a><a id="idp64699776" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">3.5.5. Clearing/Deleting Arrays and Array Elements</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="arrayoperators.html" title="3.5. Array Operations in SystemTap" /><link rel="prev" href="arrayops-foreach.html" title="3.5.4. Processing Multiple Elements in an Array" /><link rel="next" href="arrayops-conditionals.html" title="3.5.6. Using Arrays in Conditional Statements" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="arrayops-foreach.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="arrayops-conditionals.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="arrayops-deleting"></a>3.5.5. Clearing/Deleting Arrays and Array Elements</h3></div></div></div><a id="idm246875840176" class="indexterm"></a><a id="idm246875838768" class="indexterm"></a><a id="idm246928611616" class="indexterm"></a><a id="idm246928610208" class="indexterm"></a><a id="idm246921022592" class="indexterm"></a><div class="para">
Sometimes, you may need to clear the associated values in array elements, or reset an entire array for re-use in another probe. <a class="xref" href="arrayops-foreach.html#simplevfsreadprint">Example 3.17, “cumulative-vfsreads.stp”</a> in <a class="xref" href="arrayops-foreach.html">Section 3.5.4, “Processing Multiple Elements in an Array”</a> allows you to track how the number of VFS reads per process grows over time, but it does not show you the number of VFS reads each process makes per 3-second period.
- </div><a id="id
p31457632" class="indexterm"></a><a id="idp25141216" class="indexterm"></a><a id="idp61390096" class="indexterm"></a><a id="idp49027728" class="indexterm"></a><div class="para">
+ </div><a id="id
m246881943616" class="indexterm"></a><a id="idm246907841152" class="indexterm"></a><a id="idm246873559344" class="indexterm"></a><a id="idm246883014960" class="indexterm"></a><div class="para">
To do that, you will need to clear the values accumulated by the array. You can accomplish this using the <code class="command">delete</code> operator to delete elements in an array, or an entire array. Consider the following example:
- </div><a id="id
p27621984" class="indexterm"></a><a id="idp22447280" class="indexterm"></a><a id="idm9806256" class="indexterm"></a><a id="idp22444912" class="indexterm"></a><div class="example" id="simplevfsreadprintnotcumulative"><h6>Example 3.18. noncumulative-vfsreads.stp</h6><div class="example-contents"><pre class="programlisting">global reads
+ </div><a id="id
m246929411696" class="indexterm"></a><a id="idm246929409840" class="indexterm"></a><a id="idm246875134272" class="indexterm"></a><a id="idm246911932240" class="indexterm"></a><div class="example"><a id="simplevfsreadprintnotcumulative"></a><p class="title"><strong>Example 3.18. noncumulative-vfsreads.stp</strong></p><div class="example-contents"><pre class="programlisting">global reads
probe vfs.read
{
reads[execname()] ++
delete reads
}</pre></div></div><br class="example-break" /><div class="para">
In <a class="xref" href="arrayops-deleting.html#simplevfsreadprintnotcumulative">Example 3.18, “noncumulative-vfsreads.stp”</a>, the second probe prints the number of VFS reads each process made <span class="emphasis"><em>within the probed 3-second period only</em></span>. The <code class="command">delete reads</code> statement clears the <code class="command">reads</code> array within the probe.
- </div><div
class="note"><div class="admonition_header"><h2>Note</h2></div><div class="admonition"><a id="idp23209920" class="indexterm"></a><a id="idp40203328" class="indexterm"></a><a id="idp40915104" class="indexterm"></a><a id="idp14108144" class="indexterm"></a><div class="para">
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="note"><div class="admonition_header"><p><strong>Note</strong></p></div><div class="admonition"><a id="idm246924551136" class="indexterm"></a><a id="idm246924549280" class="indexterm"></a><a id="idm246920888304" class="indexterm"></a><a id="idm246882975984" class="indexterm"></a><div class="para">
You can have multiple array operations within the same probe. Using the examples from <a class="xref" href="arrayops-foreach.html">Section 3.5.4, “Processing Multiple Elements in an Array”</a> and <a class="xref" href="arrayops-deleting.html">Section 3.5.5, “Clearing/Deleting Arrays and Array Elements”</a> , you can track the number of VFS reads each process makes per 3-second period <span class="emphasis"><em>and</em></span> tally the cumulative VFS reads of those same processes. Consider the following example:
</div><pre class="screen">global reads, totalreads
printf("%s : %d \n", total, totalreads[total])
}</pre><div class="para">
In this example, the arrays <code class="command">reads</code> and <code class="command">totalreads</code> track the same information, and are printed out in a similar fashion. The only difference here is that <code class="command">reads</code> is cleared every 3-second period, whereas <code class="command">totalreads</code> keeps growing.
- </div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-foreach.html"><strong>Prev</strong>3.5.4. Processing Multiple Elements in an Array</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="arrayops-conditionals.html"><strong>Next</strong>3.5.6. Using Arrays in Conditional Statements</a></li></ul></body></html>
+ </div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-foreach.html"><strong>Prev</strong>3.5.4. Processing Multiple Elements in an Array</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="arrayops-conditionals.html"><strong>Next</strong>3.5.6. Using Arrays in Conditional Statements</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>3.5.4. Processing Multiple Elements in an Array</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="arrayoperators.html" title="3.5. Array Operations in SystemTap" /><link rel="prev" href="arrayops-increment.html" title="3.5.3. Incrementing Associated Values" /><link rel="next" href="arrayops-deleting.html" title="3.5.5. Clearing/Deleting Arrays and Array Elements" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-increment.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="arrayops-deleting.html"><strong>Next</strong></a></li></ul><div class="section" id="arrayops-foreach"><div class="titlepage"><div><div><h3 class="title" id="arrayops-foreach">3.5.4. Processing Multiple Elements in an Array</h3></div></div></div><a id="idp38183904" class="indexterm"></a><a id="idp22114048" class="indexterm"></a><a id="idp31997168" class="indexterm"></a><a id="idp51591904" class="indexterm"></a><a id="idp24211024" class="indexterm"></a><a id="idp24212432" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">3.5.4. Processing Multiple Elements in an Array</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="arrayoperators.html" title="3.5. Array Operations in SystemTap" /><link rel="prev" href="arrayops-increment.html" title="3.5.3. Incrementing Associated Values" /><link rel="next" href="arrayops-deleting.html" title="3.5.5. Clearing/Deleting Arrays and Array Elements" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="arrayops-increment.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="arrayops-deleting.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="arrayops-foreach"></a>3.5.4. Processing Multiple Elements in an Array</h3></div></div></div><a id="idm246883062688" class="indexterm"></a><a id="idm246928950192" class="indexterm"></a><a id="idm246922761568" class="indexterm"></a><a id="idm246922760160" class="indexterm"></a><a id="idm246868998080" class="indexterm"></a><a id="idm246868996672" class="indexterm"></a><div class="para">
Once you've collected enough information in an array, you will need to retrieve and process all elements in that array to make it useful. Consider <a class="xref" href="arrayops-increment.html#simplesimplevfsread">Example 3.16, “vfsreads.stp”</a>: the script collects information about how many VFS reads each process performs, but does not specify what to do with it. The obvious means for making <a class="xref" href="arrayops-increment.html#simplesimplevfsread">Example 3.16, “vfsreads.stp”</a> useful is to print the key pairs in the array <code class="command">reads</code>, but how?
- </div><a id="id
p44314320" class="indexterm"></a><a id="idp13848928" class="indexterm"></a><a id="idp15246176" class="indexterm"></a><a id="idp40353664" class="indexterm"></a><a id="idp23377632" class="indexterm"></a><a id="idp44944688" class="indexterm"></a><a id="idp40105536" class="indexterm"></a><div class="para">
+ </div><a id="id
m246917511920" class="indexterm"></a><a id="idm246911928672" class="indexterm"></a><a id="idm246876559088" class="indexterm"></a><a id="idm246868921264" class="indexterm"></a><a id="idm246878024208" class="indexterm"></a><a id="idm246878022352" class="indexterm"></a><a id="idm246922927232" class="indexterm"></a><div class="para">
The best way to process all key pairs in an array (as an iteration) is to use the <code class="command">foreach</code> statement. Consider the following example:
- </div><a id="id
p42344608" class="indexterm"></a><a id="idp52173056" class="indexterm"></a><a id="idp21404592" class="indexterm"></a><a id="idp59453472" class="indexterm"></a><a id="idp33667392" class="indexterm"></a><div class="example" id="simplevfsreadprint"><h6>Example 3.17. cumulative-vfsreads.stp</h6><div class="example-contents"><pre class="programlisting">global reads
+ </div><a id="id
m246876083472" class="indexterm"></a><a id="idm246929082256" class="indexterm"></a><a id="idm246929080400" class="indexterm"></a><a id="idm246876579200" class="indexterm"></a><a id="idm246913061904" class="indexterm"></a><div class="example"><a id="simplevfsreadprint"></a><p class="title"><strong>Example 3.17. cumulative-vfsreads.stp</strong></p><div class="example-contents"><pre class="programlisting">global reads
probe vfs.read
{
reads[execname()] ++
In the second probe of <a class="xref" href="arrayops-foreach.html#simplevfsreadprint">Example 3.17, “cumulative-vfsreads.stp”</a>, the <code class="command">foreach</code> statement uses the variable <code class="command">count</code> to reference each iteration of a unique key in the array <code class="command">reads</code>. The <code class="command">reads[count]</code> array statement in the same probe retrieves the associated value of each unique key.
</div><div class="para">
Given what we know about the first probe in <a class="xref" href="arrayops-foreach.html#simplevfsreadprint">Example 3.17, “cumulative-vfsreads.stp”</a>, the script prints VFS-read statistics every 3 seconds, displaying names of processes that performed a VFS-read along with a corresponding VFS-read count.
- </div><a id="id
p14560320" class="indexterm"></a><a id="idp52168304" class="indexterm"></a><a id="idp18043024" class="indexterm"></a><a id="idp14740576" class="indexterm"></a><a id="idp44902944" class="indexterm"></a><a id="idp33643584" class="indexterm"></a><a id="idp24309072" class="indexterm"></a><a id="idp50723264" class="indexterm"></a><div class="para">
+ </div><a id="id
m246929078528" class="indexterm"></a><a id="idm246929629776" class="indexterm"></a><a id="idm246927778848" class="indexterm"></a><a id="idm246927776992" class="indexterm"></a><a id="idm246926748464" class="indexterm"></a><a id="idm246913124608" class="indexterm"></a><a id="idm246917080576" class="indexterm"></a><a id="idm246875755824" class="indexterm"></a><div class="para">
Now, remember that the <code class="command">foreach</code> statement in <a class="xref" href="arrayops-foreach.html#simplevfsreadprint">Example 3.17, “cumulative-vfsreads.stp”</a> prints <span class="emphasis"><em>all</em></span> iterations of process names in the array, and in no particular order. You can instruct the script to process the iterations in a particular order by using <code class="command">+</code> (ascending) or <code class="command">-</code> (descending). In addition, you can also limit the number of iterations the script needs to process with the <code class="command">limit <em class="replaceable"><code>value</code></em></code> option.
</div><div class="para">
For example, consider the following replacement probe:
foreach (count in reads- limit 10)
printf("%s : %d \n", count, reads[count])
}</pre><div class="para">
- This <code class="command">foreach</code> statement instructs the script to process the elements in the array <code class="command">reads</code> in descending order (of associated value). The <code class="command">limit 10</code> option instructs the <code class="command">foreach</code> to only process the first ten iterations (i.e. print the first 10, starting with the highest value).
- </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-increment.html"><strong>Prev</strong>3.5.3. Incrementing Associated Values</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="arrayops-deleting.html"><strong>Next</strong>3.5.5. Clearing/Deleting Arrays and Array Elements</a></li></ul></body></html>
+ This <code class="command">foreach</code> statement instructs the script to process the elements in the array <code class="command">reads</code> in descending order (of associated value). The <code class="command">limit 10</code> option instructs the <code class="command">foreach</code> to only process the first ten iterations (that is, print the first 10, starting with the highest value).
+ </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-increment.html"><strong>Prev</strong>3.5.3. Incrementing Associated Values</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="arrayops-deleting.html"><strong>Next</strong>3.5.5. Clearing/Deleting Arrays and Array Elements</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>3.5.3. Incrementing Associated Values</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="arrayoperators.html" title="3.5. Array Operations in SystemTap" /><link rel="prev" href="arrayops-readvalues.html" title="3.5.2. Reading Values From Arrays" /><link rel="next" href="arrayops-foreach.html" title="3.5.4. Processing Multiple Elements in an Array" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-readvalues.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="arrayops-foreach.html"><strong>Next</strong></a></li></ul><div class="section" id="arrayops-increment"><div class="titlepage"><div><div><h3 class="title" id="arrayops-increment">3.5.3. Incrementing Associated Values</h3></div></div></div><a id="idm10357120" class="indexterm"></a><a id="idp43360160" class="indexterm"></a><a id="idp43361568" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">3.5.3. Incrementing Associated Values</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="arrayoperators.html" title="3.5. Array Operations in SystemTap" /><link rel="prev" href="arrayops-readvalues.html" title="3.5.2. Reading Values From Arrays" /><link rel="next" href="arrayops-foreach.html" title="3.5.4. Processing Multiple Elements in an Array" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="arrayops-readvalues.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="arrayops-foreach.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="arrayops-increment"></a>3.5.3. Incrementing Associated Values</h3></div></div></div><a id="idm246926766544" class="indexterm"></a><a id="idm246926765136" class="indexterm"></a><a id="idm246917787680" class="indexterm"></a><div class="para">
Use <code class="command">++</code> to increment the associated value of a unique key in an array, as in:
</div><pre class="screen"><em class="replaceable"><code>array_name</code></em>[<em class="replaceable"><code>index_expression</code></em>] ++</pre><div class="para">
Again, you can also use a handler function for your <code class="command"><em class="replaceable"><code>index_expression</code></em></code>. For example, if you wanted to tally how many times a specific process performed a read to the virtual file system (using the event <code class="command">vfs.read</code>), you can use the following probe:
- </div><a id="id
p17223040" class="indexterm"></a><a id="idp15243104" class="indexterm"></a><a id="idp22804912" class="indexterm"></a><a id="idp53390336" class="indexterm"></a><a id="idp23153424" class="indexterm"></a><div class="example" id="simplesimplevfsread"><h6>Example 3.16. vfsreads.stp</h6><div class="example-contents"><pre class="programlisting">probe vfs.read
+ </div><a id="id
m246881909472" class="indexterm"></a><a id="idm246921048288" class="indexterm"></a><a id="idm246928127008" class="indexterm"></a><a id="idm246907770384" class="indexterm"></a><a id="idm246928609232" class="indexterm"></a><div class="example"><a id="simplesimplevfsread"></a><p class="title"><strong>Example 3.16. vfsreads.stp</strong></p><div class="example-contents"><pre class="programlisting">probe vfs.read
{
reads[execname()] ++
}</pre></div></div><br class="example-break" /><div class="para">
- In <a class="xref" href="arrayops-increment.html#simplesimplevfsread">Example 3.16, “vfsreads.stp”</a>, the first time that the probe returns the process name <code class="command">gnome-terminal</code> (i.e. the first time <code class="command">gnome-terminal</code> performs a VFS read), that process name is set as the unique key <code class="literal">gnome-terminal</code> with an associated value of 1. The next time that the probe returns the process name <code class="command">gnome-terminal</code>, SystemTap increments the associated value of <code class="literal">gnome-terminal</code> by 1. SystemTap performs this operation for <span class="emphasis"><em>all</em></span> process names as the probe returns them.
- </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-readvalues.html"><strong>Prev</strong>3.5.2. Reading Values From Arrays</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="arrayops-foreach.html"><strong>Next</strong>3.5.4. Processing Multiple Elements in an Array</a></li></ul></body></html>
+ In <a class="xref" href="arrayops-increment.html#simplesimplevfsread">Example 3.16, “vfsreads.stp”</a>, the first time that the probe returns the process name <code class="command">gnome-terminal</code> (that is, the first time <code class="command">gnome-terminal</code> performs a VFS read), that process name is set as the unique key <code class="literal">gnome-terminal</code> with an associated value of 1. The next time that the probe returns the process name <code class="command">gnome-terminal</code>, SystemTap increments the associated value of <code class="literal">gnome-terminal</code> by 1. SystemTap performs this operation for <span class="emphasis"><em>all</em></span> process names as the probe returns them.
+ </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-readvalues.html"><strong>Prev</strong>3.5.2. Reading Values From Arrays</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="arrayops-foreach.html"><strong>Next</strong>3.5.4. Processing Multiple Elements in an Array</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>3.5.2. Reading Values From Arrays</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="arrayoperators.html" title="3.5. Array Operations in SystemTap" /><link rel="prev" href="arrayoperators.html" title="3.5. Array Operations in SystemTap" /><link rel="next" href="arrayops-increment.html" title="3.5.3. Incrementing Associated Values" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayoperators.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="arrayops-increment.html"><strong>Next</strong></a></li></ul><div class="section" id="arrayops-readvalues"><div class="titlepage"><div><div><h3 class="title" id="arrayops-readvalues">3.5.2. Reading Values From Arrays</h3></div></div></div><a id="idp25483008" class="indexterm"></a><a id="idp62873600" class="indexterm"></a><a id="idp63954480" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">3.5.2. Reading Values From Arrays</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="arrayoperators.html" title="3.5. Array Operations in SystemTap" /><link rel="prev" href="arrayoperators.html" title="3.5. Array Operations in SystemTap" /><link rel="next" href="arrayops-increment.html" title="3.5.3. Incrementing Associated Values" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="arrayoperators.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="arrayops-increment.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="arrayops-readvalues"></a>3.5.2. Reading Values From Arrays</h3></div></div></div><a id="idm246928031056" class="indexterm"></a><a id="idm246928029648" class="indexterm"></a><a id="idm246881985072" class="indexterm"></a><div class="para">
You can also read values from an array the same way you would read the value of a variable. To do so, include the <code class="command"><em class="replaceable"><code>array_name</code></em>[<em class="replaceable"><code>index_expression</code></em>]</code> statement as an element in a mathematical expression. For example:
- </div><a id="id
p61830224" class="indexterm"></a><a id="idp40868848" class="indexterm"></a><a id="idp37246112" class="indexterm"></a><a id="idp28309904" class="indexterm"></a><a id="idp15095008" class="indexterm"></a><a id="idp21587008" class="indexterm"></a><a id="idp36652592" class="indexterm"></a><a id="idp38184336" class="indexterm"></a><a id="idp40872224" class="indexterm"></a><a id="idp28945808" class="indexterm"></a><div class="example" id="arrayreadingvaluesfrom"><h6>Example 3.15. Using Array Values in Simple Computations</h6><div class="example-contents"><pre class="screen">delta = gettimeofday_s() - foo[tid()]</pre></div></div><br class="example-break" /><div class="para">
+ </div><a id="id
m246922845056" class="indexterm"></a><a id="idm246895706512" class="indexterm"></a><a id="idm246895673760" class="indexterm"></a><a id="idm246913095776" class="indexterm"></a><a id="idm246929876656" class="indexterm"></a><a id="idm246913183344" class="indexterm"></a><a id="idm246912183136" class="indexterm"></a><a id="idm246912181280" class="indexterm"></a><a id="idm246877800016" class="indexterm"></a><a id="idm246922933136" class="indexterm"></a><div class="example"><a id="arrayreadingvaluesfrom"></a><p class="title"><strong>Example 3.15. Using Array Values in Simple Computations</strong></p><div class="example-contents"><pre class="screen">delta = gettimeofday_s() - foo[tid()]</pre></div></div><br class="example-break" /><div class="para">
This example assumes that the array <code class="command">foo</code> was built using the construct in <a class="xref" href="arrayoperators.html#arrays-timestampprocessname">Example 3.14, “Associating Timestamps to Process Names”</a> (from <a class="xref" href="arrayoperators.html#arrayops-assignvalue">Section 3.5.1, “Assigning an Associated Value”</a>). This sets a timestamp that will serve as a <span class="emphasis"><em>reference point</em></span>, to be used in computing for <code class="literal">delta</code>.
</div><div class="para">
The construct in <a class="xref" href="arrayops-readvalues.html#arrayreadingvaluesfrom">Example 3.15, “Using Array Values in Simple Computations”</a> computes a value for the variable <code class="literal">delta</code> by subtracting the associated value of the key <code class="literal">tid()</code> from the current <code class="command">gettimeofday_s()</code>. The construct does this by <span class="emphasis"><em>reading</em></span> the value of <code class="literal">tid()</code> from the array. This particular construct is useful for determining the time between two events, such as the start and completion of a read operation.
- </div><a id="id
p63403824" class="indexterm"></a><a id="idp63973616" class="indexterm"></a><a id="idp22033808" class="indexterm"></a><a id="idp23925328" class="indexterm"></a><div class="note"><div class="admonition_header"><h2>Note</h2></div><div class="admonition"><div class="para">
+ </div><a id="id
m246914364576" class="indexterm"></a><a id="idm246871566976" class="indexterm"></a><a id="idm246877324992" class="indexterm"></a><a id="idm246929487520" class="indexterm"></a><div xmlns:d="http://docbook.org/ns/docbook" class="note"><div class="admonition_header"><p><strong>Note</strong></p></div><div class="admonition"><div class="para">
If the <code class="command"><em class="replaceable"><code>index_expression</code></em></code> cannot find the unique key, it returns a value of 0 (for numerical operations, such as <a class="xref" href="arrayops-readvalues.html#arrayreadingvaluesfrom">Example 3.15, “Using Array Values in Simple Computations”</a>) or a null/empty string value (for string operations) by default.
- </div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayoperators.html"><strong>Prev</strong>3.5. Array Operations in SystemTap</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="arrayops-increment.html"><strong>Next</strong>3.5.3. Incrementing Associated Values</a></li></ul></body></html>
+ </div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayoperators.html"><strong>Prev</strong>3.5. Array Operations in SystemTap</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="arrayops-increment.html"><strong>Next</strong>3.5.3. Incrementing Associated Values</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>3.4. Associative Arrays</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="understanding-how-systemtap-works.html" title="Chapter 3. Understanding How SystemTap Works" /><link rel="prev" href="commandlineargssect.html" title="3.3.4. Command-Line Arguments" /><link rel="next" href="arrayoperators.html" title="3.5. Array Operations in SystemTap" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="commandlineargssect.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="arrayoperators.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="associativearrays" lang="en-US"><div class="titlepage"><div><div><h2 class="title" id="associativearrays">3.4. Associative Arrays</h2></div></div></div><a id="idp50060752" class="indexterm"></a><a id="idp35539456" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">3.4. Associative Arrays</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="understanding-how-systemtap-works.html" title="Chapter 3. Understanding How SystemTap Works" /><link rel="prev" href="commandlineargssect.html" title="3.3.4. Command-Line Arguments" /><link rel="next" href="arrayoperators.html" title="3.5. Array Operations in SystemTap" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="commandlineargssect.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="arrayoperators.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h2 class="title"><a id="associativearrays"></a>3.4. Associative Arrays</h2></div></div></div><a id="idm246869039056" class="indexterm"></a><a id="idm246922625696" class="indexterm"></a><div class="para">
SystemTap also supports the use of associative arrays. While an ordinary variable represents a single value, associative arrays can represent a collection of values. Simply put, an associative array is a collection of unique keys; each key in the array has a value associated with it.
- </div><a id="id
p62383024" class="indexterm"></a><a id="idp50100032" class="indexterm"></a><a id="idp20724864" class="indexterm"></a><a id="idp35225952" class="indexterm"></a><a id="idp31300944" class="indexterm"></a><a id="idp17201136" class="indexterm"></a><a id="idp36391872" class="indexterm"></a><a id="idp24306688" class="indexterm"></a><div class="para">
+ </div><a id="id
m246882052976" class="indexterm"></a><a id="idm246920731952" class="indexterm"></a><a id="idm246928990560" class="indexterm"></a><a id="idm246881942256" class="indexterm"></a><a id="idm246869005232" class="indexterm"></a><a id="idm246874367584" class="indexterm"></a><a id="idm246926825600" class="indexterm"></a><a id="idm246913132560" class="indexterm"></a><div class="para">
Since associative arrays are normally processed in multiple probes (as we will demonstrate later), they should be declared as <code class="command">global</code> variables in the SystemTap script. The syntax for accessing an element in an associative array is similar to that of <code class="command">awk</code>, and is as follows:
- </div><a id="id
p65182336" class="indexterm"></a><a id="idp42205248" class="indexterm"></a><a id="idp22441440" class="indexterm"></a><pre class="screen"><em class="replaceable"><code>array_name</code></em>[<em class="replaceable"><code>index_expression</code></em>]</pre><div class="para">
- Here, the <code class="command"><em class="replaceable"><code>array_name</code></em></code> is any arbitrary name the array uses. The <code class="command"><em class="replaceable"><code>index_expression</code></em></code> is used to refer to a specific unique key in the array. To illustrate, let us try to build an array named <code class="command">foo</code> that specifies the ages of three people (i.e. the unique keys): <code class="command">tom</code>, <code class="command">dick</code>, and <code class="command">harry</code>. To assign them the ages (i.e. associated values) of 23, 24, and 25 respectively, we'd use the following array statements:
- </div><a id="id
p28507344" class="indexterm"></a><a id="idp22631280" class="indexterm"></a><div class="example" id="arraysimplestexample"><h6>Example 3.13. Basic Array Statements</h6><div class="example-contents"><pre class="screen">foo["tom"] = 23
+ </div><a id="id
m246912382864" class="indexterm"></a><a id="idm246917892464" class="indexterm"></a><a id="idm246927253376" class="indexterm"></a><pre class="screen"><em class="replaceable"><code>array_name</code></em>[<em class="replaceable"><code>index_expression</code></em>]</pre><div class="para">
+ Here, the <code class="command"><em class="replaceable"><code>array_name</code></em></code> is any arbitrary name the array uses. The <code class="command"><em class="replaceable"><code>index_expression</code></em></code> is used to refer to a specific unique key in the array. To illustrate, let us try to build an array named <code class="command">foo</code> that specifies the ages of three people <code class="command">tom</code>, <code class="command">dick</code>, and <code class="command">harry</code> (which are unique keys). To assign them the ages (associated values) of 23, 24, and 25 respectively, we'd use the following array statements:
+ </div><a id="id
m246928561792" class="indexterm"></a><a id="idm246918058176" class="indexterm"></a><div class="example"><a id="arraysimplestexample"></a><p class="title"><strong>Example 3.13. Basic Array Statements</strong></p><div class="example-contents"><pre class="screen">foo["tom"] = 23
foo["dick"] = 24
foo["harry"] = 25</pre></div></div><br class="example-break" /><div class="para">
- You can specify up to nine index expressons in an array statement, each one delimited by a comma (<code class="command">,</code>). This is useful if you wish to have a key that contains multiple pieces of information. The following line from <a class="xref" href="mainsect-disk.html#scriptdisktop">disktop.stp</a> uses 5 elements for the key: process ID, executable name, user ID, parent process ID, and string "W". It associates the value of <code class="command">devname</code> with that key.
- </div><pre class="screen">device[pid(),execname(),uid(),ppid(),"W"] = devname</pre><div
class="important"><div class="admonition_header"><h2>Important</h2></div><div class="admonition"><div class="para">
+ You can specify up to nine index express
ions in an array statement, each one delimited by a comma (<code class="command">,</code>). This is useful if you wish to have a key that contains multiple pieces of information. The following line from <a class="xref" href="mainsect-disk.html#scriptdisktop">disktop.stp</a> uses 5 elements for the key: process ID, executable name, user ID, parent process ID, and string "W". It associates the value of <code class="command">devname</code> with that key.
+ </div><pre class="screen">device[pid(),execname(),uid(),ppid(),"W"] = devname</pre><div
xmlns:d="http://docbook.org/ns/docbook" class="important"><div class="admonition_header"><p><strong>Important</strong></p></div><div class="admonition"><div class="para">
All associate arrays must be declared as <code class="command">global</code>, regardless of whether the associate array is used in one or multiple probes.
- </div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="commandlineargssect.html"><strong>Prev</strong>3.3.4. Command-Line Arguments</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="arrayoperators.html"><strong>Next</strong>3.5. Array Operations in SystemTap</a></li></ul></body></html>
+ </div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="commandlineargssect.html"><strong>Prev</strong>3.3.4. Command-Line Arguments</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="arrayoperators.html"><strong>Next</strong>3.5. Array Operations in SystemTap</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>3.3.4. Command-Line Arguments</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="scriptconstructions.html" title="3.3. Basic SystemTap Handler Constructs" /><link rel="prev" href="handlerconditionalstatements.html" title="3.3.3. Conditional Statements" /><link rel="next" href="associativearrays.html" title="3.4. Associative Arrays" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="handlerconditionalstatements.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="associativearrays.html"><strong>Next</strong></a></li></ul><div class="section" id="commandlineargssect"><div class="titlepage"><div><div><h3 class="title" id="commandlineargssect">3.3.4. Command-Line Arguments</h3></div></div></div><a id="idp20418800" class="indexterm"></a><a id="idp28170144" class="indexterm"></a><a id="idp24987040" class="indexterm"></a><div class="para">
- You can also allow a SystemTap script to accept simple command-line arguments using a <code class="command">$</code> or <code class="command">@</code> immediately followed by the number of the argument on the command line. Use <code class="command">$</code> if you are expecting the user to enter an integer as a command-line argument, and <code class="command">@</code> if you are expecting a string.
- </div><div class="example" id="commandlineargs"><h6>Example 3.12. commandlineargs.stp</h6><div class="example-contents"><pre class="programlisting">probe kernel.function(@1) { }
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">3.3.4. Command-Line Arguments</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="scriptconstructions.html" title="3.3. Basic SystemTap Handler Constructs" /><link rel="prev" href="handlerconditionalstatements.html" title="3.3.3. Conditional Statements" /><link rel="next" href="associativearrays.html" title="3.4. Associative Arrays" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="handlerconditionalstatements.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="associativearrays.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="commandlineargssect"></a>3.3.4. Command-Line Arguments</h3></div></div></div><a id="idm246926486944" class="indexterm"></a><a id="idm246927136624" class="indexterm"></a><a id="idm246927961456" class="indexterm"></a><div class="para">
+ A SystemTap script can also accept simple command-line arguments using a <code class="command">$</code> or <code class="command">@</code> immediately followed by the number of the argument on the command line. Use <code class="command">$</code> if you are expecting the user to enter an integer as a command-line argument, and <code class="command">@</code> if you are expecting a string.
+ </div><div class="example"><a id="commandlineargs"></a><p class="title"><strong>Example 3.12. commandlineargs.stp</strong></p><div class="example-contents"><pre class="programlisting">probe kernel.function(@1) { }
probe kernel.function(@1).return { }</pre></div></div><br class="example-break" /><div class="para">
<a class="xref" href="commandlineargssect.html#commandlineargs">Example 3.12, “commandlineargs.stp”</a> is similar to <a class="xref" href="scripts.html#wildcards">Example 3.1, “wildcards.stp”</a>, except that it allows you to pass the kernel function to be probed as a command-line argument (as in <code class="command">stap commandlineargs.stp <em class="replaceable"><code>kernel function</code></em></code>). You can also specify the script to accept multiple command-line arguments, noting them as <code class="command">@1</code>, <code class="command">@2</code>, and so on, in the order they are entered by the user.
- </div><a id="idp40028512" class="indexterm"></a><a id="idp52287632" class="indexterm"></a><a id="idp20572064" class="indexterm"></a></div><ul class="docnav"><li class="previous"><a accesskey="p" href="handlerconditionalstatements.html"><strong>Prev</strong>3.3.3. Conditional Statements</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="associativearrays.html"><strong>Next</strong>3.4. Associative Arrays</a></li></ul></body></html>
+ </div><a id="idm246917857648" class="indexterm"></a><a id="idm246926534304" class="indexterm"></a><a id="idm246877802048" class="indexterm"></a></div><ul class="docnav"><li class="previous"><a accesskey="p" href="handlerconditionalstatements.html"><strong>Prev</strong>3.3.3. Conditional Statements</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="associativearrays.html"><strong>Next</strong>3.4. Associative Arrays</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>2.2. Generating Instrumentation for Other Computers</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="using-systemtap.html" title="Chapter 2. Using SystemTap" /><link rel="prev" href="using-systemtap.html" title="Chapter 2. Using SystemTap" /><link rel="next" href="using-usage.html" title="2.3. Running SystemTap Scripts" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="using-systemtap.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="using-usage.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="cross-compiling" lang="en-US"><div class="titlepage"><div><div><h2 class="title" id="cross-compiling">2.2. Generating Instrumentation for Other Computers</h2></div></div></div><a id="idp18180320" class="indexterm"></a><a id="idp18178912" class="indexterm"></a><a id="idp13857856" class="indexterm"></a><a id="idp25072560" class="indexterm"></a><a id="idp63991376" class="indexterm"></a><a id="idp44638288" class="indexterm"></a><a id="idp33262128" class="indexterm"></a><a id="idp37588672" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">2.2. Generating Instrumentation for Other Computers</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="using-systemtap.html" title="Chapter 2. Using SystemTap" /><link rel="prev" href="using-systemtap.html" title="Chapter 2. Using SystemTap" /><link rel="next" href="using-usage.html" title="2.3. Running SystemTap Scripts" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="using-systemtap.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="using-usage.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h2 class="title"><a id="cross-compiling"></a>2.2. Generating Instrumentation for Other Computers</h2></div></div></div><a id="idm246925959920" class="indexterm"></a><a id="idm246875250768" class="indexterm"></a><a id="idm246880504656" class="indexterm"></a><a id="idm246873746544" class="indexterm"></a><a id="idm246878065984" class="indexterm"></a><a id="idm246914242512" class="indexterm"></a><a id="idm246877654000" class="indexterm"></a><a id="idm246917572880" class="indexterm"></a><div class="para">
When users run a SystemTap script, SystemTap builds a kernel module out of that script. SystemTap then loads the module into the kernel, allowing it to extract the specified data directly from the kernel (refer to <a class="xref" href="understanding-how-systemtap-works.html#systemtapsession">Procedure 3.1, “SystemTap Session”</a> in <a class="xref" href="understanding-how-systemtap-works.html#understanding-architecture-tools">Section 3.1, “Architecture”</a> for more information).
</div><div class="para">
- Normally, however, SystemTap scripts can only be run on systems where SystemTap is deployed (as in <a class="xref" href="using-systemtap.html#using-setup">Section 2.1, “Installation and Setup”</a>). This could mean that if you want to run SystemTap on ten systems, you would need to deploy SystemTap on <span class="emphasis"><em>all</em></span> those systems. In some cases, this may be neither feasible nor desired. For instance, corporate policy may prohibit an administrator from installing RPMs that provide compilers or debug information on specific machines, which will prevent the deployment of SystemTap.
+ Normally, however, SystemTap scripts can only be run on systems where SystemTap is deployed (as in <a class="xref" href="using-systemtap.html#using-setup">Section 2.1, “Installation and Setup”</a>). This could mean that if you want to run SystemTap on ten systems, you would need to deploy SystemTap on <span class="emphasis"><em>all</em></span> those systems. In some cases, this may be neither feasible nor desired. For instance, corporate policy may prohibit an administrator from installing RPM packages that provide compilers or debug information on specific machines, and thus prevent the deployment of SystemTap. To work around this problem, SystemTap allows you to use <em class="firstterm">cross-instrumentation</em>.
</div><div class="para">
- To work around this, you can resort to <em class="firstterm">cross-instrumentation</em>. Cross-instrumentation is the process of generating SystemTap instrumentation module from a SystemTap script on one computer to be used on another computer. This process offers the following benefits:
- </div><a id="id
p18808464" class="indexterm"></a><a id="idp38573792" class="indexterm"></a><div class="itemizedlist"><ul><li class="listitem"><div class="para">
+ Cross-instrumentation is the process of generating SystemTap instrumentation module from a SystemTap script on one computer to be used on another computer. This process offers the following benefits:
+ </div><a id="id
m246871281296" class="indexterm"></a><a id="idm246877247440" class="indexterm"></a><div xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
The kernel information packages for various machines can be installed on a single <span class="emphasis"><em>host machine</em></span>.
</div></li><li class="listitem"><div class="para">
- Each <span class="emphasis"><em>target machine</em></span> only needs one RPM to be installed to use the generated SystemTap instrumentation module: <code class="filename">systemtap-runtime</code>.
- </div></li></ul></div><div class="note"><div class="admonition_header"><h2>Note</h2></div><div class="admonition"><div class="para">
- For the sake of simplicity, we will be using the following terms throughout this section:
- </div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
- <a id="idp50800928" class="indexterm"></a>
- <a id="idp21847984" class="indexterm"></a>
- <span class="emphasis"><em>instrumentation module</em></span> — the kernel module built from a SystemTap script; i.e. the <span class="emphasis"><em>SystemTap module</em></span> is built on the <span class="emphasis"><em>host system</em></span>, and will be loaded on the <span class="emphasis"><em>target kernel</em></span> of <span class="emphasis"><em>target system</em></span>.
- </div></li><li class="listitem"><div class="para">
- <a id="idp22715392" class="indexterm"></a>
- <a id="idp17714112" class="indexterm"></a>
- <span class="emphasis"><em>host system</em></span> — the system on which you compile the instrumentation modules (from SystemTap scripts), to be loaded on <span class="emphasis"><em>target systems</em></span>.
- </div></li><li class="listitem"><div class="para">
- <a id="idp33613632" class="indexterm"></a>
- <a id="idp44026352" class="indexterm"></a>
- <span class="emphasis"><em>target system</em></span> — the system for which you are building the <span class="emphasis"><em>instrumentation module</em></span> (from SystemTap scripts).
- </div></li><li class="listitem"><div class="para">
- <a id="idp17705088" class="indexterm"></a>
- <a id="idp22440160" class="indexterm"></a>
- <span class="emphasis"><em>target kernel</em></span> — the kernel of the <span class="emphasis"><em>target system</em></span>. This is the kernel on which you wish to load/run the <span class="emphasis"><em>instrumentation module</em></span>.
- </div></li></ul></div></div></div><div class="procedure" id="preppingxcompile"><h6>Procedure 2.1. Configuring a Host System and Target Systems</h6><a id="idp30116800" class="indexterm"></a><a id="idp49285808" class="indexterm"></a><a id="idp45864592" class="indexterm"></a><ol class="1"><li class="step"><div class="para">
- Install the <code class="filename">systemtap-runtime</code> RPM on each <span class="emphasis"><em>target system</em></span>.
+ Each <span class="emphasis"><em>target machine</em></span> only needs one RPM package to be installed in order to use the generated SystemTap instrumentation module: the <span class="package">systemtap-runtime</span> package.
+ </div></li></ul></div><div class="para">
+ For the sake of simplicity, the following terms are used throughout this section:
+ </div><div xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
+ <a id="idm246927320432" class="indexterm"></a> <a id="idm246914411904" class="indexterm"></a> <span class="emphasis"><em>Instrumentation module</em></span> — the kernel module built from a SystemTap script. The <span class="emphasis"><em>SystemTap module</em></span> is built on the <span class="emphasis"><em>host system</em></span>, and will be loaded on the <span class="emphasis"><em>target kernel</em></span> of <span class="emphasis"><em>target system</em></span>.
+ </div></li><li class="listitem"><div class="para">
+ <a id="idm246907857280" class="indexterm"></a> <a id="idm246917522176" class="indexterm"></a> <span class="emphasis"><em>Host system</em></span> — the system on which you compile the <span class="emphasis"><em>instrumentation modules</em></span> from SystemTap scripts in order to load them on <span class="emphasis"><em>target systems</em></span>.
+ </div></li><li class="listitem"><div class="para">
+ <a id="idm246913059600" class="indexterm"></a> <a id="idm246871727296" class="indexterm"></a> <span class="emphasis"><em>Target system</em></span> — the system for which you are building the <span class="emphasis"><em>instrumentation modules</em></span> from SystemTap scripts.
+ </div></li><li class="listitem"><div class="para">
+ <a id="idm246928051760" class="indexterm"></a> <a id="idm246875290544" class="indexterm"></a> <span class="emphasis"><em>Target kernel</em></span> — the kernel of the <span class="emphasis"><em>target system</em></span>. This is the kernel on which you intend to load or run the <span class="emphasis"><em>instrumentation module</em></span>.
+ </div></li></ul></div><div class="para">
+ To configure a host system and target systems, complete the following steps:
+ </div><div xmlns:d="http://docbook.org/ns/docbook" class="procedure"><a id="preppingxcompile"></a><a id="idm246911923168" class="indexterm"></a><a id="idm246927632480" class="indexterm"></a><a id="idm246917564832" class="indexterm"></a><ol class="1"><li class="step"><div class="para">
+ Install the <span class="package">systemtap-runtime</span> package on each <span class="emphasis"><em>target system</em></span>.
</div></li><li class="step"><div class="para">
- Determine the kernel running on each <span class="emphasis"><em>target system</em></span> by running <code class="command">uname -r</code> on each <span class="emphasis"><em>target system</em></span>.
+ Determine the kernel running on each <span class="emphasis"><em>target system</em></span> by running the <code class="command">uname -r</code> command on each of these systems.
</div></li><li class="step"><div class="para">
Install SystemTap on the <span class="emphasis"><em>host system</em></span>. You will be building the <span class="emphasis"><em>instrumentation module</em></span> for the <span class="emphasis"><em>target systems</em></span> on the <span class="emphasis"><em>host system</em></span>. For instructions on how to install SystemTap, refer to <a class="xref" href="using-systemtap.html#installproper">Section 2.1.1, “Installing SystemTap”</a>.
</div></li><li class="step"><div class="para">
- Using the <span class="emphasis"><em>target kernel</em></span> version determined earlier, install the <span class="emphasis"><em>target kernel</em></span> and related RPMs on the <span class="emphasis"><em>host system</em></span> by the method described in <a class="xref" href="using-systemtap.html#install-kinfo">Section 2.1.2, “Installing Required Kernel Information RPMs”</a>. If multiple <span class="emphasis"><em>target systems</em></span> use different <span class="emphasis"><em>target kernels</em></span>, you will need to repeat this step for each different kernel used on the <span class="emphasis"><em>target systems</em></span>.
+ Using the <span class="emphasis"><em>target kernel</em></span> version determined earlier, install the <span class="emphasis"><em>target kernel</em></span> and related RPM packages on the <span class="emphasis"><em>host system</em></span> as described in <a class="xref" href="using-systemtap.html#install-kinfo">Section 2.1.2, “Installing Required Kernel Information Packages Manually”</a>. If multiple <span class="emphasis"><em>target systems</em></span> use different <span class="emphasis"><em>target kernels</em></span>, repeat this step for each different kernel used on the <span class="emphasis"><em>target systems</em></span>.
</div></li></ol></div><div class="para">
- After performing <a class="xref" href="cross-compiling.html#preppingxcompile">Procedure 2.1, “Configuring a Host System and Target Systems”</a>, you can now build the <span class="emphasis"><em>instrumentation module</em></span> (for any <span class="emphasis"><em>target system</em></span>) on the <span class="emphasis"><em>host system</em></span>.
+ After completing these steps, you can now build the <span class="emphasis"><em>instrumentation module</em></span> (for any <span class="emphasis"><em>target system</em></span>) on the <span class="emphasis"><em>host system</em></span>.
</div><div class="para">
To build the <span class="emphasis"><em>instrumentation module</em></span>, run the following command on the <span class="emphasis"><em>host system</em></span> (be sure to specify the appropriate values):
- </div><pre class="screen">
stap -r <em class="replaceable"><code>kernel_version</code></em> <em class="replaceable"><code>script</code></em> -m <em class="replaceable"><code>module_name</code></em></pre><div class="para">
- Here, <code class="command"><em class="replaceable"><code>kernel_version</code></em></code> refers to the version of the <span class="emphasis"><em>target kernel</em></span> (the output of <code class="command">uname -r</code> on the target machine), <code class="command"><em class="replaceable"><code>script</code></em></code> refers to the script to be converted into an <span class="emphasis"><em>instrumentation module</em></span>, and <code class="command"><em class="replaceable"><code>module_name</code></em></code> is the desired name of the <span class="emphasis"><em>instrumentation module</em></span>.
- </div><div
class="note"><div class="admonition_header"><h2>Note</h2></div><div class="admonition"><a id="idp21619344" class="indexterm"></a><a id="idp21620304" class="indexterm"></a><a id="idp38813648" class="indexterm"></a><div class="para">
- To determine the architecture notation of a running kernel, run <code class="command">uname -m</code>.
- </div></div></div><div class="para">
- Once the the <span class="emphasis"><em>instrumentation module</em></span> is compiled, copy it to the <span class="emphasis"><em>target system</em></span> and then load it using:
- </div><pre class="screen">
staprun <em class="replaceable"><code>module_name</code></em>.ko</pre><div class="para">
+ </div><pre class="screen">
<code class="command">stap -r <em class="replaceable"><code>kernel_version</code></em> <em class="replaceable"><code>script</code></em> -m <em class="replaceable"><code>module_name</code></em></code></pre><div class="para">
+ Here, <em class="replaceable"><code>kernel_version</code></em> refers to the version of the <span class="emphasis"><em>target kernel</em></span> (the output of the <code class="command">uname -r</code> command on the target machine), <em class="replaceable"><code>script</code></em> refers to the script to be converted into the <span class="emphasis"><em>instrumentation module</em></span>, and <em class="replaceable"><code>module_name</code></em> is the desired name of the <span class="emphasis"><em>instrumentation module</em></span>.
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="note"><div class="admonition_header"><p><strong>Note</strong></p></div><div class="admonition"><a id="idm246911863984" class="indexterm"></a><a id="idm246869060400" class="indexterm"></a><a id="idm246869059472" class="indexterm"></a><div class="para">
+ To determine the architecture notation of a running kernel, you can run the following command:
+ </div><
pre class="screen"><code class="command">uname -m</code></pre></div></div><div class="para">
+ Once the <span class="emphasis"><em>instrumentation module</em></span> is compiled, copy it to the <span class="emphasis"><em>target system</em></span> and then load it using:
+ </div><pre class="screen">
<code class="command">staprun <em class="replaceable"><code>module_name</code></em>.ko</code></pre><div class="para">
For example, to create the <span class="emphasis"><em>instrumentation module</em></span> <code class="filename">simple.ko</code> from a SystemTap script named <code class="filename">simple.stp</code> for the <span class="emphasis"><em>target kernel</em></span> 2.6.18-92.1.10.el5 (on x86_64 architecture), use the following command:
- </div><div class="para">
- <code class="command">stap -r 2.6.18-92.1.10.el5 -e 'probe vfs.read {exit()}' -m simple</code>
- </div><div class="para">
- This will create a module named <code class="filename">simple.ko</code>. To use the <span class="emphasis"><em>instrumentation module</em></span> <code class="filename">simple.ko</code>, copy it to the <span class="emphasis"><em>target system</em></span> and run the following command (on the <span class="emphasis"><em>target system</em></span>):
- </div><div class="para">
- <code class="command">staprun simple.ko</code>
- </div><div class="important"><div class="admonition_header"><h2>Important</h2></div><div class="admonition"><div class="para">
+ </div><pre class="screen"><code class="command">stap -r 2.6.18-92.1.10.el5 -e 'probe vfs.read {exit()}' -m simple</code></pre><div class="para">
+ This creates a module named <code class="filename">simple.ko</code>. To use this <span class="emphasis"><em>instrumentation module</em></span>, copy it to the <span class="emphasis"><em>target system</em></span> and run the following command (on the <span class="emphasis"><em>target system</em></span>):
+ </div><pre class="screen"><code class="command">staprun simple.ko</code></pre><div xmlns:d="http://docbook.org/ns/docbook" class="important"><div class="admonition_header"><p><strong>Important</strong></p></div><div class="admonition"><div class="para">
The <span class="emphasis"><em>host system</em></span> must be the same architecture and running the same distribution of Linux as the <span class="emphasis"><em>target system</em></span> in order for the built <span class="emphasis"><em>instrumentation module</em></span> to work.
- </div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="using-systemtap.html"><strong>Prev</strong>Chapter 2. Using SystemTap</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="using-usage.html"><strong>Next</strong>2.3. Running SystemTap Scripts</a></li></ul></body></html>
+ </div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="using-systemtap.html"><strong>Prev</strong>Chapter 2. Using SystemTap</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="using-usage.html"><strong>Next</strong>2.3. Running SystemTap Scripts</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 6. Understanding SystemTap Errors</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="futexcontentionsect.html" title="5.4. Identifying Contended User-Space Locks" /><link rel="next" href="runtimeerror.html" title="6.2. Run Time Errors and Warnings" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="futexcontentionsect.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="runtimeerror.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="chapter" id="errors" lang="en-US"><div class="titlepage"><div><div><h2 class="title">Chapter 6. Understanding SystemTap Errors</h2></div></div></div><div class="toc"><dl><dt><span class="section"><a href="errors.html#parsetype">6.1. Parse and Semantic Errors</a></span></dt><dt><span class="section"><a href="runtimeerror.html">6.2. Run Time Errors and Warnings</a></span></dt></dl></div><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">Chapter 6. Understanding SystemTap Errors</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="futexcontentionsect.html" title="5.4. Identifying Contended User-Space Locks" /><link rel="next" href="runtimeerror.html" title="6.2. Runtime Errors and Warnings" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="futexcontentionsect.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="runtimeerror.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="chapter" lang="en-US"><div class="titlepage"><div><div><h1 class="title"><a id="errors"></a>Chapter 6. Understanding SystemTap Errors</h1></div></div></div><div class="toc"><dl class="toc"><dt><span class="section"><a href="errors.html#parsetype">6.1. Parse and Semantic Errors</a></span></dt><dt><span class="section"><a href="runtimeerror.html">6.2. Runtime Errors and Warnings</a></span></dt></dl></div><div class="para">
This chapter explains the most common errors you may encounter while using SystemTap.
- </div><div class="section"
id="parsetype"><div class="titlepage"><div><div><h2 class="title" id="parsetype">6.1. Parse and Semantic Errors</h2></div></div></div><a id="idp28368352" class="indexterm"></a><a id="idp61985104" class="indexterm"></a><a id="idp60265696" class="indexterm"></a><div class="para">
- These types of errors occur while SystemTap attempts to parse and translate the script into C, prior to being converted into a kernel module. For example type errors result from operations that assign invalid values to variables or arrays.
- </div><div class="formalpara"><h5 class="formalpara" id="idp30579296">parse error: expected <em class="replaceable"><code>foo</code></em>, saw <em class="replaceable"><code>bar</code></em></h5><a id="idp26759520" class="indexterm"></a><a id="idp22679680" class="indexterm"></a><a id="idp30212096" class="indexterm"></a><a id="idp28794128" class="indexterm"></a><a id="idp31047760" class="indexterm"></a><a id="idp31049616" class="indexterm"></a><a id="idp44436032" class="indexterm"></a><a id="idp44437888" class="indexterm"></a><a id="idp44440032" class="indexterm"></a>
- The script contains a grammatical/typographical error. SystemTap detected type of construct that is incorrect, given the context of the probe.
-
</div><div class="para">
- The following invalid SystemTap script is missing its probe handlers:
+ </div><div class="section"
><div class="titlepage"><div><div><h2 class="title"><a id="parsetype"></a>6.1. Parse and Semantic Errors</h2></div></div></div><a id="idm246927567376" class="indexterm"></a><a id="idm246912115056" class="indexterm"></a><a id="idm246920961584" class="indexterm"></a><div class="para">
+ Parse and semantic errors occur while SystemTap attempts to parse and translate the script into C, before converting it into a kernel module. For example, type errors result from operations that assign invalid values to variables or arrays.
+ </div><h3><a id="idm246920902896"></a>parse error: expected <em class="replaceable"><code>foo</code></em>, saw <em class="replaceable"><code>bar</code></em></h3><a id="idm246911755328" class="indexterm"></a><a id="idm246875263856" class="indexterm"></a><a id="idm246927858688" class="indexterm"></a><a id="idm246923108848" class="indexterm"></a><a id="idm246883215680" class="indexterm"></a><a id="idm246928089424" class="indexterm"></a><a id="idm246928087536" class="indexterm"></a><a id="idm246870506720" class="indexterm"></a><a id="idm246870504576" class="indexterm"></a><div class="para">
+ The script contains a grammatical or typographical error. SystemTap detected the type of the construct that is incorrect, given the context of the probe.
+ </div><div class="para">
+ For example, the following invalid SystemTap script is missing its probe handlers:
</div><div class="para">
<pre class="programlisting">probe vfs.read
probe vfs.write
</pre>
</div><div class="para">
- It results in the following error message showing that the parser was expecting something other than the <code class="command">probe</code> keyword in column 1 of line 2:
+ An attempt to run this SystemTap script fails with the following error message showing that the parser expects something other than the <code class="command">probe</code> keyword in column 1 of line 2:
</div><div class="para">
<pre class="programlisting">parse error: expected one of '. , ( ? ! { = +='
saw: keyword at perror.stp:2:1
1 parse error(s).</pre>
- </div><div class="formalpara"><h5 class="formalpara" id="idp18688320">parse error: embedded code in unprivileged script</h5><a id="idp18689376" class="indexterm"></a><a id="idp18691232" class="indexterm"></a><a id="idp31893776" class="indexterm"></a><a id="idp31895632" class="indexterm"></a><a id="idp31897488" class="indexterm"></a><a id="idp24960352" class="indexterm"></a>
- The script contains unsafe embedded C code (blocks of code surrounded by <code class="command">%{</code> <code class="command">%}</code>. SystemTap allows you to embed C code in a script, which is useful if there are no tapsets to suit your purposes. However, embedded C constructs are not safe; as such, SystemTap warns you with this error if such constructs appear in the script.
-
</div><a id="idp24964304" class="indexterm"></a><a id="idp18056272" class="indexterm"></a><a id="idp18058192" class="indexterm"></a><a id="idp18060080" class="indexterm"></a><div class="para">
- If you are sure of the safety of any similar constructs in the script <span class="emphasis"><em>and</em></span> are member of <code class="command">stapdev</code> group (or have root privileges), run the script in "guru" mode by using the option <code class="command">-g</code> (i.e. <code class="command">stap -g <em class="replaceable"><code>script</code></em></code>).
- </div><div class="formalpara"><h5 class="formalpara" id="idp26711232">semantic error: type mismatch for identifier '<em class="replaceable"><code>foo</code></em>' ... string vs. long</h5><a id="idp26712768" class="indexterm"></a><a id="idp65398304" class="indexterm"></a><a id="idp65400192" class="indexterm"></a><a id="idp65402048" class="indexterm"></a><a id="idm2434304" class="indexterm"></a>
- The function <code class="command"><em class="replaceable"><code>foo</code></em></code> in the script used the wrong type (i.e. <code class="command">%s</code> or <code class="command">%d</code>). This error will present itself in <a class="xref" href="errors.html#errorvariable">Example 6.1, “error-variable.stp”</a>, because the function <code class="command">execname()</code> returns a string the format specifier should be a <code class="command">%s</code>, not <code class="command">%d</code>.
-
</div><div class="example" id="errorvariable"><h6>Example 6.1. error-variable.stp</h6><div class="example-contents"><pre class="programlisting">probe syscall.open
+ </div><h3><a id="idm246912136880"></a>parse error: embedded code in unprivileged script</h3><a id="idm246912136112" class="indexterm"></a><a id="idm246929885600" class="indexterm"></a><a id="idm246929883712" class="indexterm"></a><a id="idm246929881856" class="indexterm"></a><a id="idm246929880000" class="indexterm"></a><a id="idm246928211648" class="indexterm"></a><div class="para">
+ The script contains unsafe embedded C code, that is, blocks of code surrounded by <code class="command">%{</code> and <code class="command">%}</code>. SystemTap allows you to embed C code in a script, which is useful if there are no tapsets to suit your purposes. However, embedded C constructs are not safe and SystemTap reports this error to warn you if such constructs appear in the script.
+
</div><a id="idm246928207872" class="indexterm"></a><a id="idm246928205984" class="indexterm"></a><a id="idm246918014288" class="indexterm"></a><a id="idm246918012400" class="indexterm"></a><div class="para">
+ If you are sure that any similar constructs in the script are safe <span class="emphasis"><em>and</em></span> you are a member of the <code class="systemitem">stapdev</code> group (or have root privileges), run the script in "guru" mode by using the <code class="option">-g</code> option:
+ </div><pre class="screen"><code class="command">stap -g <em class="replaceable"><code>script</code></em></code></pre><h3><a id="idm246869932768"></a>semantic error: type mismatch for identifier '<em class="replaceable"><code>foo</code></em>' ... string vs. long</h3><a id="idm246869931520" class="indexterm"></a><a id="idm246869929664" class="indexterm"></a><a id="idm246869927776" class="indexterm"></a><a id="idm246928436352" class="indexterm"></a><a id="idm246928434496" class="indexterm"></a><div class="para">
+ The function <em class="replaceable"><code>foo</code></em> in the script used the wrong type (such as <code class="literal">%s</code> or <code class="literal">%d</code>). In the following example, the format specifier should be <code class="literal">%s</code> and not <code class="literal">%d</code>, because the <code class="function">execname()</code> function returns a string:
+
</div><pre class="programlisting">probe syscall.open
{
printf ("%d(%d) open\n", execname(), pid())
-}</pre></div></div><br class="example-break" /><div class="formalpara"><h5 class="formalpara" id="idp24415696">semantic error: unresolved type for identifier '<em class="replaceable"><code>foo</code></em>'</h5><a id="idp24417232" class="indexterm"></a><a id="idp48988000" class="indexterm"></a><a id="idp48989888" class="indexterm"></a><a id="idp48991744" class="indexterm"></a>
- The identifier (e.g. a variable) was used, but no type (integer or string) could be determined. This occurs, for instance, if you use a variable in a <code class="command">printf</code> statement while the script never assigns a value to the variable.
- </div><div class="formalpara"><h5 class="formalpara" id="idm3923536">semantic error: Expecting symbol or array index expression</h5><a id="idm3922480" class="indexterm"></a><a id="idp50564416" class="indexterm"></a><a id="idp50566304" class="indexterm"></a><a id="idp50568160" class="indexterm"></a>
- SystemTap could not assign a value to a variable or to a location in an array. The destination for the assignment is not a valid destination. The following example code would generate this error:
- </div><div class="para">
-
-<pre class="programlisting">probe begin { printf("x") = 1 }
-</pre>
- </div><div class="formalpara"><h5 class="formalpara" id="idp41044256">while searching for arity <em class="replaceable"><code>N</code></em> function, semantic error: unresolved function call</h5><a id="idp41045760" class="indexterm"></a><a id="idp49479984" class="indexterm"></a><a id="idp49481872" class="indexterm"></a><a id="idp49483728" class="indexterm"></a><a id="idp49526912" class="indexterm"></a>
- A function call or array index expression in the script used an invalid number of arguments/parameters. In SystemTap <em class="firstterm">arity</em> can either refer to the number of indices for an array, or the number of parameters to a function.
- </div><div class="formalpara"><h5 class="formalpara" id="idp49529968">semantic error: array locals not supported, missing global declaration?</h5><a id="idp49531024" class="indexterm"></a><a id="idp33572480" class="indexterm"></a><a id="idp33574368" class="indexterm"></a><a id="idp33576288" class="indexterm"></a><a id="idp20560320" class="indexterm"></a>
- The script used an array operation without declaring the array as a global variable (global variables can be declared after their use in SystemTap scripts). Similar messages appear if an array is used, but with inconsistent arities.
- </div><div class="formalpara"><h5 class="formalpara" id="idp20563072">semantic error: variable ’<em class="replaceable"><code>foo</code></em>’ modified during ’foreach’ iteration</h5><a id="idp48911088" class="indexterm"></a><a id="idp48912944" class="indexterm"></a><a id="idp48914832" class="indexterm"></a><a id="idp39734704" class="indexterm"></a>
- The array <code class="literal">foo</code> is being modifed (being assigned to or deleted from) within an active <code class="command">foreach</code> loop. This error also displays if an operation within the script performs a function call within the <code class="command">foreach</code> loop.
- </div><div class="formalpara"><h5 class="formalpara" id="idp39738576">semantic error: probe point mismatch at position <em class="replaceable"><code>N</code></em>, while resolving probe point <em class="replaceable"><code>foo</code></em></h5><a id="idp34244512" class="indexterm"></a><a id="idp34246400" class="indexterm"></a><a id="idp34248320" class="indexterm"></a><a id="idp48225456" class="indexterm"></a>
- SystemTap did not understand what the event or SystemTap function <code class="computeroutput"><em class="replaceable"><code>foo</code></em></code> refers to. This usually means that SystemTap could not find a match for <code class="computeroutput"><em class="replaceable"><code>foo</code></em></code> in the tapset library. The <em class="replaceable"><code>N</code></em> refers to the line and column of the error.
- </div><div class="formalpara"><h5 class="formalpara" id="idp48230240">semantic error: no match for probe point, while resolving probe point <em class="replaceable"><code>foo</code></em></h5><a id="idm1464736" class="indexterm"></a><a id="idm1462880" class="indexterm"></a><a id="idm1460992" class="indexterm"></a><a id="idp33719280" class="indexterm"></a><a id="idp33721136" class="indexterm"></a>
- The events/handler function <code class="computeroutput"><em class="replaceable"><code>foo</code></em></code> could not be resolved altogether, for a variety of reasons. This error occurs when the script contains the event <code class="command">kernel.function("<em class="replaceable"><code>blah</code></em>")</code>, and <code class="command"><em class="replaceable"><code>blah</code></em></code> does not exist. In some cases, the error could also mean the script contains an invalid kernel file name or source line number.
- </div><div class="formalpara"><h5 class="formalpara" id="idm8500304">semantic error: unresolved target-symbol expression</h5><a id="idm8499248" class="indexterm"></a><a id="idm8497392" class="indexterm"></a><a id="idp31260512" class="indexterm"></a><a id="idp31262368" class="indexterm"></a><a id="idp31264224" class="indexterm"></a>
- A handler in the script references a target variable, but the value of the variable could not be resolved. This error could also mean that a handler is referencing a target variable that is not valid in the context when it was referenced. This may be a result of compiler optimization of the generated code.
- </div><div class="formalpara"><h5 class="formalpara" id="idp52951632">semantic error: libdwfl failure </h5><a id="idp52952688" class="indexterm"></a><a id="idp52954576" class="indexterm"></a><a id="idp63773824" class="indexterm"></a><a id="idp63775712" class="indexterm"></a>
- There was a problem processing the debugging information. In most cases, this error results from the installation of a <code class="filename">kernel-debuginfo</code> RPM whose version does not match the probed kernel exactly. The installed <code class="filename">kernel-debuginfo</code> RPM itself may have some consistency/correctness problems.
- </div><div class="formalpara"><h5 class="formalpara" id="idp32302480">semantic error: cannot find <em class="replaceable"><code>foo</code></em> debuginfo</h5>
- SystemTap could not find a suitable <code class="filename">kernel-debuginfo</code> at all.
- </div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="futexcontentionsect.html"><strong>Prev</strong>5.4. Identifying Contended User-Space Locks</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="runtimeerror.html"><strong>Next</strong>6.2. Run Time Errors and Warnings</a></li></ul></body></html>
+}</pre><h3><a id="idm246871740880"></a>semantic error: unresolved type for identifier '<em class="replaceable"><code>foo</code></em>'</h3><a id="idm246871739632" class="indexterm"></a><a id="idm246871737776" class="indexterm"></a><a id="idm246871735888" class="indexterm"></a><a id="idm246877418256" class="indexterm"></a><div class="para">
+ The identifier (variable) was used, but no type (integer or string) could be determined. This occurs, for instance, if you use a variable in a <code class="command">printf</code> statement while the script never assigns a value to the variable.
+ </div><h3><a id="idm246877415344"></a>semantic error: Expecting symbol or array index expression</h3><a id="idm246877414576" class="indexterm"></a><a id="idm246877412720" class="indexterm"></a><a id="idm246878166736" class="indexterm"></a><a id="idm246878164880" class="indexterm"></a><div class="para">
+ SystemTap could not assign a value to a variable or to a location in an array. The destination for the assignment is not a valid destination. The following example code would generate this error:
+ </div><pre class="programlisting">probe begin { printf("x") = 1 }
+</pre><h3><a id="idm246878161552"></a>while searching for arity <em class="replaceable"><code>N</code></em> function, semantic error: unresolved function call</h3><a id="idm246878160336" class="indexterm"></a><a id="idm246917477392" class="indexterm"></a><a id="idm246917475504" class="indexterm"></a><a id="idm246917473648" class="indexterm"></a><a id="idm246917471792" class="indexterm"></a><div class="para">
+ A function call or array index expression in the script used an invalid number of arguments or parameters. In SystemTap, <em class="firstterm">arity</em> can either refer to the number of indices for an array, or the number of parameters to a function.
+ </div><h3><a id="idm246880221104"></a>semantic error: array locals not supported, missing global declaration?</h3><a id="idm246880220176" class="indexterm"></a><a id="idm246880218320" class="indexterm"></a><a id="idm246880216432" class="indexterm"></a><a id="idm246877424944" class="indexterm"></a><a id="idm246877423056" class="indexterm"></a><div class="para">
+ The script used an array operation without declaring the array as a global variable (global variables can be declared after their use in SystemTap scripts). Similar messages appear if an array is used, but with inconsistent arities.
+ </div><h3><a id="idm246877420464"></a>semantic error: variable '<em class="replaceable"><code>foo</code></em>' modified during 'foreach' iteration</h3><a id="idm246874529200" class="indexterm"></a><a id="idm246874527344" class="indexterm"></a><a id="idm246874525456" class="indexterm"></a><a id="idm246874523600" class="indexterm"></a><div class="para">
+ The array <em class="replaceable"><code>foo</code></em> is being modified (being assigned to or deleted from) within an active <code class="command">foreach</code> loop. This error also displays if an operation within the script performs a function call within the <code class="command">foreach</code> loop.
+ </div><h3><a id="idm246917768976"></a>semantic error: probe point mismatch at position <em class="replaceable"><code>N</code></em>, while resolving probe point <em class="replaceable"><code>foo</code></em></h3><a id="idm246917767280" class="indexterm"></a><a id="idm246917765392" class="indexterm"></a><a id="idm246868828976" class="indexterm"></a><a id="idm246868827088" class="indexterm"></a><div class="para">
+ SystemTap did not understand what the event or SystemTap function <em class="replaceable"><code>foo</code></em> refers to. This usually means that SystemTap could not find a match for <em class="replaceable"><code>foo</code></em> in the tapset library. <em class="replaceable"><code>N</code></em> refers to the line and column of the error.
+ </div><h3><a id="idm246868822784"></a>semantic error: no match for probe point, while resolving probe point <em class="replaceable"><code>foo</code></em></h3><a id="idm246927521920" class="indexterm"></a><a id="idm246927520064" class="indexterm"></a><a id="idm246927518176" class="indexterm"></a><a id="idm246927516320" class="indexterm"></a><a id="idm246877870848" class="indexterm"></a><div class="para">
+ SystemTap could not resolve the events or handler function <em class="replaceable"><code>foo</code></em> for a variety of reasons. This error occurs when the script contains the event <code class="command">kernel.function("<em class="replaceable"><code>something</code></em>")</code>, and <em class="replaceable"><code>something</code></em> does not exist. In some cases, the error could also mean the script contains an invalid kernel file name or source line number.
+ </div><h3><a id="idm246877866544"></a>semantic error: unresolved target-symbol expression</h3><a id="idm246877865776" class="indexterm"></a><a id="idm246911941984" class="indexterm"></a><a id="idm246911940096" class="indexterm"></a><a id="idm246911938240" class="indexterm"></a><a id="idm246911936384" class="indexterm"></a><div class="para">
+ A handler in the script references a target variable, but the value of the variable could not be resolved. This error could also mean that a handler is referencing a target variable that is not valid in the context when it was referenced. This may be a result of compiler optimization of the generated code.
+ </div><h3><a id="idm246883190752"></a>semantic error: libdwfl failure </h3><a id="idm246883189824" class="indexterm"></a><a id="idm246883187936" class="indexterm"></a><a id="idm246883186016" class="indexterm"></a><a id="idm246917361600" class="indexterm"></a><div class="para">
+ There was a problem processing the debugging information. In most cases, this error results from the installation of a <span class="package">kernel-debuginfo</span> package whose version does not match the probed kernel exactly. The installed <span class="package">kernel-debuginfo</span> package itself may have some consistency or correctness problems.
+ </div><h3><a id="idm246917358224"></a>semantic error: cannot find <em class="replaceable"><code>foo</code></em> debuginfo</h3><div class="para">
+ SystemTap could not find a suitable <span class="package">kernel-debuginfo</span> package.
+ </div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="futexcontentionsect.html"><strong>Prev</strong>5.4. Identifying Contended User-Space Locks</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="runtimeerror.html"><strong>Next</strong>6.2. Runtime Errors and Warnings</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>5.4. Identifying Contended User-Space Locks</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="useful-systemtap-scripts.html" title="Chapter 5. Useful SystemTap Scripts" /><link rel="prev" href="syscallsbyprocpidsect.html" title="5.3.6. Tracking System Call Volume Per Process" /><link rel="next" href="errors.html" title="Chapter 6. Understanding SystemTap Errors" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="syscallsbyprocpidsect.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="errors.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="futexcontentionsect" lang="en-US"><div class="titlepage"><div><div><h2 class="title" id="futexcontentionsect">5.4. Identifying Contended User-Space Locks</h2></div></div></div><a id="idp38698368" class="indexterm"></a><a id="idp32964576" class="indexterm"></a><a id="idp65573232" class="indexterm"></a><a id="idp45173056" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">5.4. Identifying Contended User-Space Locks</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="useful-systemtap-scripts.html" title="Chapter 5. Useful SystemTap Scripts" /><link rel="prev" href="syscallsbyprocpidsect.html" title="5.3.6. Tracking System Call Volume Per Process" /><link rel="next" href="errors.html" title="Chapter 6. Understanding SystemTap Errors" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="syscallsbyprocpidsect.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="errors.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h2 class="title"><a id="futexcontentionsect"></a>5.4. Identifying Contended User-Space Locks</h2></div></div></div><a id="idm246918019088" class="indexterm"></a><a id="idm246877409008" class="indexterm"></a><a id="idm246927966752" class="indexterm"></a><a id="idm246876105232" class="indexterm"></a><div class="para">
This section describes how to identify contended user-space locks throughout the system within a specific time period. The ability to identify contended user-space locks can help you investigate poor program performance that you suspect may be caused by <code class="command">futex</code> contentions.
- </div><a id="id
p18118912" class="indexterm"></a><a id="idp22800736" class="indexterm"></a><a id="idp48336928" class="indexterm"></a><a id="idp26866560" class="indexterm"></a><a id="idp57794096" class="indexterm"></a><div class="para">
+ </div><a id="id
m246872896400" class="indexterm"></a><a id="idm246912264736" class="indexterm"></a><a id="idm246914032736" class="indexterm"></a><a id="idm246923079360" class="indexterm"></a><a id="idm246870443984" class="indexterm"></a><div class="para">
Simply put, <code class="command">futex</code> contention occurs when multiple processes are trying to access the same lock variable at the same time. This can result in a poor performance because the lock serializes execution; one process obtains the lock while the other processes must wait for the lock variable to become available again.
- </div><a id="id
p40096416" class="indexterm"></a><a id="idp26638592" class="indexterm"></a><a id="idp32777376" class="indexterm"></a><div class="para">
+ </div><a id="id
m246912992192" class="indexterm"></a><a id="idm246912417984" class="indexterm"></a><a id="idm246917881456" class="indexterm"></a><div class="para">
The <a class="xref" href="futexcontentionsect.html#futexcontention">futexes.stp</a> script probes the <code class="command">futex</code> system call to show lock contention.
- </div><div class="formalpara" id="futexcontention"><h5 class="formalpara">futexes.stp</h5>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">futexes.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
</pre>
</div><div class="para">
<a class="xref" href="futexcontentionsect.html#futexcontention">futexes.stp</a> needs to be manually stopped; upon exit, it prints the following information:
- </div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
Name and ID of the process responsible for a contention
</div></li><li class="listitem"><div class="para">
The location of the contested lock variable
Average time of contention throughout the probe
</div></li></ul></div><div class="para">
<a class="xref" href="futexcontentionsect.html#futexcontentionoutput">Example 5.19, “futexes.stp Sample Output”</a> contains an excerpt from the output of <a class="xref" href="futexcontentionsect.html#futexcontention">futexes.stp</a> upon exiting the script (after approximately 20 seconds).
- </div><div class="example"
id="futexcontentionoutput"><h6>Example 5.19. <a class="xref" href="futexcontentionsect.html#futexcontention">futexes.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen">[...]
+ </div><div class="example"
><a id="futexcontentionoutput"></a><p class="title"><strong>Example 5.19. <a class="xref" href="futexcontentionsect.html#futexcontention">futexes.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen">[...]
automount[2825] lock 0x00bc7784 contended 18 times, 999931 avg us
synergyc[3686] lock 0x0861e96c contended 192 times, 101991 avg us
synergyc[3758] lock 0x08d98744 contended 192 times, 101990 avg us
synergyc[3938] lock 0x0982a8b4 contended 192 times, 101997 avg us
-[...]</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="syscallsbyprocpidsect.html"><strong>Prev</strong>5.3.6. Tracking System Call Volume Per Process</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="errors.html"><strong>Next</strong>Chapter 6. Understanding SystemTap Errors</a></li></ul></body></html>
+[...]</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="syscallsbyprocpidsect.html"><strong>Prev</strong>5.3.6. Tracking System Call Volume Per Process</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="errors.html"><strong>Next</strong>Chapter 6. Understanding SystemTap Errors</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>3.3.3. Conditional Statements</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="scriptconstructions.html" title="3.3. Basic SystemTap Handler Constructs" /><link rel="prev" href="targetavailable.html" title="3.3.2.3. Checking Target Variable Availablility" /><link rel="next" href="commandlineargssect.html" title="3.3.4. Command-Line Arguments" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="targetavailable.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="commandlineargssect.html"><strong>Next</strong></a></li></ul><div class="section" id="handlerconditionalstatements"><div class="titlepage"><div><div><h3 class="title" id="handlerconditionalstatements">3.3.3. Conditional Statements</h3></div></div></div><a id="idp42212112" class="indexterm"></a><a id="idp22442704" class="indexterm"></a><div class="para">
- In some cases, the output of a SystemTap script may be too big. To address this, you need to further refine the script's logic in order to delimit the output into something more relevant or useful to your probe.
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">3.3.3. Conditional Statements</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="scriptconstructions.html" title="3.3. Basic SystemTap Handler Constructs" /><link rel="prev" href="targetavailable.html" title="3.3.2.3. Checking Target Variable Availability" /><link rel="next" href="commandlineargssect.html" title="3.3.4. Command-Line Arguments" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="targetavailable.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="commandlineargssect.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="handlerconditionalstatements"></a>3.3.3. Conditional Statements</h3></div></div></div><a id="idm246895667344" class="indexterm"></a><a id="idm246875877632" class="indexterm"></a><div class="para">
+ In some cases, the output of a SystemTap script may be too large. To address this, you need to further refine the script's logic in order to delimit the output into something more relevant or useful to your probe.
</div><div class="para">
- You can do this by using <span class="emphasis"><em>conditionals</em></span> in handlers. SystemTap accepts the following types of conditional statements:
- </div><div class="variablelist"><dl
><dt class="varlistentry"><span class="term">If/Else Statements</span></dt><dd><a id="idp22703744" class="indexterm"></a><a id="idp49119408" class="indexterm"></a><a id="idp59443008" class="indexterm"></a><div class="para">
+ Do this by using <span class="emphasis"><em>conditionals</em></span> in handlers. SystemTap accepts the following types of conditional statements:
+ </div><div class="variablelist"><dl
class="variablelist"><dt><span class="term">If/Else Statements</span></dt><dd><a id="idm246913303728" class="indexterm"></a><a id="idm246877410256" class="indexterm"></a><a id="idm246878013952" class="indexterm"></a><div class="para">
Format:
</div><pre class="programlisting">if (<em class="replaceable"><code>condition</code></em>)
<em class="replaceable"><code>statement1</code></em>
else
<em class="replaceable"><code>statement2</code></em></pre><div class="para">
The <code class="command"><em class="replaceable"><code>statement1</code></em></code> is executed if the <code class="command"><em class="replaceable"><code>condition</code></em></code> expression is non-zero. The <code class="command"><em class="replaceable"><code>statement2</code></em></code> is executed if the <code class="command"><em class="replaceable"><code>condition</code></em></code> expression is zero. The <code class="command">else</code> clause (<code class="command">else</code> <em class="replaceable"><code>statement2</code></em>) is optional. Both <code class="command"><em class="replaceable"><code>statement1</code></em></code> and <code class="command"><em class="replaceable"><code>statement2</code></em></code> can be statement blocks.
- </div><div class="example"
id="simpleifelseexample"><h6>Example 3.11. ifelse.stp</h6><div class="example-contents"><pre class="programlisting">global countread, countnonread
+ </div><div class="example"
><a id="simpleifelseexample"></a><p class="title"><strong>Example 3.11. ifelse.stp</strong></p><div class="example-contents"><pre class="programlisting">global countread, countnonread
probe kernel.function("vfs_read"),kernel.function("vfs_write")
{
if (probefunc()=="vfs_read")
printf("VFS reads total %d\n VFS writes total %d\n", countread, countnonread)
}</pre></div></div><br class="example-break" /><div class="para">
<a class="xref" href="handlerconditionalstatements.html#simpleifelseexample">Example 3.11, “ifelse.stp”</a> is a script that counts how many virtual file system reads (<code class="command">vfs_read</code>) and writes (<code class="command">vfs_write</code>) the system performs within a 5-second span. When run, the script increments the value of the variable <code class="command">countread</code> by 1 if the name of the function it probed matches <code class="command">vfs_read</code> (as noted by the condition <code class="command">if (probefunc()=="vfs_read")</code>); otherwise, it increments <code class="command">countnonread</code> (<code class="command">else {countnonread ++}</code>).
- </div></dd><dt
class="varlistentry"><span class="term">While Loops</span></dt><dd><a id="idp63971920" class="indexterm"></a><a id="idm8760240" class="indexterm"></a><a id="idp63398544" class="indexterm"></a><div class="para">
+ </div></dd><dt
><span class="term">While Loops</span></dt><dd><a id="idm246917835264" class="indexterm"></a><a id="idm246929722832" class="indexterm"></a><a id="idm246920925504" class="indexterm"></a><div class="para">
Format:
</div><pre class="programlisting">while (<em class="replaceable"><code>condition</code></em>)
<em class="replaceable"><code>statement</code></em></pre><div class="para">
So long as <code class="command"><em class="replaceable"><code>condition</code></em></code> is non-zero the block of statements in <code class="command"><em class="replaceable"><code>statement</code></em></code> are executed. The <code class="command"><em class="replaceable"><code>statement</code></em></code> is often a statement block and it must change a value so <code class="command"><em class="replaceable"><code>condition</code></em></code> will eventually be zero.
- </div></dd><dt
class="varlistentry"><span class="term">For Loops</span></dt><dd><a id="idp30446288" class="indexterm"></a><a id="idp58038720" class="indexterm"></a><a id="idp28171056" class="indexterm"></a><div class="para">
+ </div></dd><dt
><span class="term">For Loops</span></dt><dd><a id="idm246877366816" class="indexterm"></a><a id="idm246917497248" class="indexterm"></a><a id="idm246918105040" class="indexterm"></a><div class="para">
Format:
</div><pre class="programlisting">for (<em class="replaceable"><code>initialization</code></em>; <em class="replaceable"><code>conditional</code></em>; <em class="replaceable"><code>increment</code></em>) <em class="replaceable"><code>statement</code></em></pre><div class="para">
- The <code class="command">for</code> loop is simply shorthand for a while loop. The following is the equivalent <code class="command">while</code> loop:
+ The <code class="command">for</code> loop is shorthand for a while loop. The following is the equivalent <code class="command">while</code> loop:
</div><pre class="programlisting"><em class="replaceable"><code>initialization</code></em>
while (<em class="replaceable"><code>conditional</code></em>) {
<em class="replaceable"><code>statement</code></em>
<em class="replaceable"><code>increment</code></em>
-}</pre></dd></dl></div><div class="formalpara"><h5 class="formalpara" id="idp21819104">Conditional Operators</h5><a id="idp38199888" class="indexterm"></a><a id="idp21959312" class="indexterm"></a><a id="idp31033632" class="indexterm"></a>
- Aside from <code class="command">==</code> ("is equal to"), you can also use the following operators in your conditional statements:
- </div><div class="variablelist"><dl
><dt class="varlistentry"><span class="term">>=</span></dt><dd><div class="para">
+}</pre></dd></dl></div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">Conditional Operators</div><a id="idm246875170208" class="indexterm"></a><a id="idm246912501072" class="indexterm"></a><a id="idm246928495600" class="indexterm"></a>
+ Aside from <code class="command">==</code> ("is equal to"), following operators can also be used in conditional statements:
+ </div><div class="variablelist"><dl
class="variablelist"><dt><span class="term">>=</span></dt><dd><div class="para">
Greater than or equal to
- </div></dd><dt
class="varlistentry"><span class="term"><=</span></dt><dd><div class="para">
+ </div></dd><dt><span class="term"><=</span></dt><dd><div class="para">
Less than or equal to
- </div></dd><dt
class="varlistentry"><span class="term">!=</span></dt><dd><div class="para">
+ </div></dd><dt><span class="term">!=</span></dt><dd><div class="para">
Is not equal to
- </div></dd></dl></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="targetavailable.html"><strong>Prev</strong>3.3.2.3. Checking Target Variable Availablility</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="commandlineargssect.html"><strong>Next</strong>3.3.4. Command-Line Arguments</a></li></ul></body></html>
+ </div></dd></dl></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="targetavailable.html"><strong>Prev</strong>3.3.2.3. Checking Target Variable Availability</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="commandlineargssect.html"><strong>Next</strong>3.3.4. Command-Line Arguments</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>SystemTap Beginners Guide</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="next" href="SystemTap_Beginners_Guide-Preface.html" title="Preface" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"></li><li class="next"><a accesskey="n" href="SystemTap_Beginners_Guide-Preface.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="book" id="idp12540960" lang="en-US"><div class="titlepage"><div><div class="producttitle"><span class="productname">Systemtap</span> <span class="productnumber">2.2</span></div><div><h1 id="idp12540960" class="title">SystemTap Beginners Guide</h1></div><p class="edition">Edition 2.2</p><div><h3 class="corpauthor">
- <span class="inlinemediaobject"><object data="Common_Content/images/title_logo.svg" type="image/svg+xml"> Logo</object></span>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">SystemTap Beginners Guide</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><meta name="description" content="This guide provides basic instructions on how to use SystemTap to monitor different subsystems of a Linux system in finer detail." /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="next" href="SystemTap_Beginners_Guide-Preface.html" title="Preface" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="SystemTap_Beginners_Guide-Preface.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="book" lang="en-US"><div class="titlepage"><div><div class="producttitle"><span xmlns:d="http://docbook.org/ns/docbook" class="productname">SystemTap</span> <span xmlns:d="http://docbook.org/ns/docbook" class="productnumber">2.6</span></div><div><h1 class="title"><a id="idm246873842800"></a>SystemTap Beginners Guide</h1></div><div><h2 class="subtitle">Introduction to SystemTap</h2></div><p xmlns:d="http://docbook.org/ns/docbook" class="edition">Edition 2.6</p><div><h3 class="corpauthor">
+ <span class="inlinemediaobject"><object data="Common_Content/images/title_logo.svg" type="image/svg+xml"><img src="Common_Content/images/title_logo.png" alt="Logo" /></object></span>
</h3></div><div><div xml:lang="en-US" class="authorgroup" lang="en-US"><h3 class="corpauthor">
Red Hat, Inc.
- </h3><div class="author"><h3 class="author"><span class="firstname">Don</span> <span class="surname">Domingo </span></h3><div class="affiliation"><span
class="orgname">Engineering Services and Operations</span> <span class="orgdiv">Content Services</span></div><code class="email"><a class="email" href="mailto:ddomingo@redhat.com">ddomingo@redhat.com</a></code></div><div class="author"><h3 class="author"><span class="firstname">William</span> <span class="surname">Cohen</span></h3><div class="affiliation"><span class="orgname">Engineering Services and Operations</span> <span class="orgdiv">Performance Tools</span></div><code class="email"><a class="email" href="mailto:wcohen@redhat.com">wcohen@redhat.com</a></code></div></div></div><div><p class="copyright">Copyright © 2013 Red Hat, Inc</p></div><hr /><div><div id="idp22871968" class="legalnotice"><h1 class="legalnotice">Legal Notice</h1><div class="para">
+ </h3><div class="author"><h3 class="author"><span class="firstname">Don</span> <span class="surname">Domingo </span></h3><div class="affiliation"><span
xmlns:d="http://docbook.org/ns/docbook" class="orgname">Engineering Services and Operations</span> <span xmlns:d="http://docbook.org/ns/docbook" class="orgdiv">Content Services</span></div><code class="email"><a class="email" href="mailto:ddomingo@redhat.com">ddomingo@redhat.com</a></code></div><div class="author"><h3 class="author"><span class="firstname">William</span> <span class="surname">Cohen</span></h3><div class="affiliation"><span xmlns:d="http://docbook.org/ns/docbook" class="orgname">Engineering Services and Operations</span> <span xmlns:d="http://docbook.org/ns/docbook" class="orgdiv">Performance Tools</span></div><code class="email"><a class="email" href="mailto:wcohen@redhat.com">wcohen@redhat.com</a></code></div></div></div><div><p class="copyright">Copyright © 2013 Red Hat, Inc</p></div><div><div class="legalnotice"><a id="idm246928404112"></a><h1 class="legalnotice">Legal Notice</h1><div class="para">
This documentation is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.
</div><div class="para">
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
</div><div class="para">
For more details see the file COPYING in the source distribution of Linux.
- </div></div></div></div><hr /></div><div class="toc"><dl><dt><span class="preface"><a href="SystemTap_Beginners_Guide-Preface.html">Preface</a></span></dt><dd><dl><dt><span class="section"><a href="SystemTap_Beginners_Guide-Preface.html#idp35045504">1. Document Conventions</a></span></dt><dd><dl><dt><span class="section"><a href="SystemTap_Beginners_Guide-Preface.html#idp49732512">1.1. Typographic Conventions</a></span></dt><dt><span class="section"><a href="SystemTap_Beginners_Guide-Preface.html#idp50742544">1.2. Pull-quote Conventions</a></span></dt><dt><span class="section"><a href="SystemTap_Beginners_Guide-Preface.html#idp30437968">1.3. Notes and Warnings</a></span></dt></dl></dd><dt><span class="section"><a href="pr01s02.html">2. We Need Feedback!</a></span></dt></dl></dd><dt><span class="chapter"><a href="introduction.html">1. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="introduction.html#goals">1.1. Documentation Goals</a></span></dt><dt><span class="section"><a href="intro-systemtap-vs-others.html">1.2. SystemTap Capabilities</a></span></dt></dl></dd><dt><span class="chapter"><a href="using-systemtap.html">2. Using SystemTap</a></span></dt><dd><dl><dt><span class="section"><a href="using-systemtap.html#using-setup">2.1. Installation and Setup</a></span></dt><dd><dl><dt><span class="section"><a href="using-systemtap.html#installproper">2.1.1. Installing SystemTap</a></span></dt><dt><span class="section"><a href="using-systemtap.html#install-kinfo">2.1.2. Installing Required Kernel Information RPMs</a></span></dt><dt><span class="section"><a href="using-systemtap.html#testing">2.1.3. Initial Testing</a></span></dt></dl></dd><dt><span class="section"><a href="cross-compiling.html">2.2. Generating Instrumentation for Other Computers</a></span></dt><dt><span class="section"><a href="using-usage.html">2.3. Running SystemTap Scripts</a></span></dt><dd><dl><dt><span class="section"><a href="using-usage.html#flight-recorder">2.3.1. SystemTap Flight Recorder Mode</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="understanding-how-systemtap-works.html">3. Understanding How SystemTap Works</a></span></dt><dd><dl><dt><span class="section"><a href="understanding-how-systemtap-works.html#understanding-architecture-tools">3.1. Architecture</a></span></dt><dt><span class="section"><a href="scripts.html">3.2. SystemTap Scripts</a></span></dt><dd><dl><dt><span class="section"><a href="scripts.html#systemtapscript-events">3.2.1. Event</a></span></dt><dt><span class="section"><a href="systemtapscript-handler.html">3.2.2. Systemtap Handler/Body</a></span></dt></dl></dd><dt><span class="section"><a href="scriptconstructions.html">3.3. Basic SystemTap Handler Constructs</a></span></dt><dd><dl><dt><span class="section"><a href="scriptconstructions.html#variablesconstructs">3.3.1. Variables</a></span></dt><dt><span class="section"><a href="targetvariables.html">3.3.2. Target Variables</a></span></dt><dt><span class="section"><a href="handlerconditionalstatements.html">3.3.3. Conditional Statements</a></span></dt><dt><span class="section"><a href="commandlineargssect.html">3.3.4. Command-Line Arguments</a></span></dt></dl></dd><dt><span class="section"><a href="associativearrays.html">3.4. Associative Arrays</a></span></dt><dt><span class="section"><a href="arrayoperators.html">3.5. Array Operations in SystemTap</a></span></dt><dd><dl><dt><span class="section"><a href="arrayoperators.html#arrayops-assignvalue">3.5.1. Assigning an Associated Value</a></span></dt><dt><span class="section"><a href="arrayops-readvalues.html">3.5.2. Reading Values From Arrays</a></span></dt><dt><span class="section"><a href="arrayops-increment.html">3.5.3. Incrementing Associated Values</a></span></dt><dt><span class="section"><a href="arrayops-foreach.html">3.5.4. Processing Multiple Elements in an Array</a></span></dt><dt><span class="section"><a href="arrayops-deleting.html">3.5.5. Clearing/Deleting Arrays and Array Elements</a></span></dt><dt><span class="section"><a href="arrayops-conditionals.html">3.5.6. Using Arrays in Conditional Statements</a></span></dt><dt><span class="section"><a href="arrayops-aggregates.html">3.5.7. Computing for Statistical Aggregates</a></span></dt></dl></dd><dt><span class="section"><a href="understanding-tapsets.html">3.6. Tapsets</a></span></dt></dl></dd><dt><span class="chapter"><a href="userspace-probing.html">4. User-Space Probing</a></span></dt><dd><dl><dt><span class="section"><a href="userspace-probing.html#uevents">4.1. User-Space Events</a></span></dt><dt><span class="section"><a href="utargetvariable.html">4.2. Accessing User-Space Target Variables</a></span></dt><dt><span class="section"><a href="ustack.html">4.3. User-Space Stack Backtraces</a></span></dt></dl></dd><dt><span class="chapter"><a href="useful-systemtap-scripts.html">5. Useful SystemTap Scripts</a></span></dt><dd><dl><dt><span class="section"><a href="useful-systemtap-scripts.html#mainsect-network">5.1. Network</a></span></dt><dd><dl><dt><span class="section"><a href="useful-systemtap-scripts.html#nettopsect">5.1.1. Network Profiling</a></span></dt><dt><span class="section"><a href="useful-systemtap-scripts.html#sockettracesect">5.1.2. Tracing Functions Called in Network Socket Code</a></span></dt><dt><span class="section"><a href="useful-systemtap-scripts.html#tcpconnectionssect">5.1.3. Monitoring Incoming TCP Connections</a></span></dt><dt><span class="section"><a href="useful-systemtap-scripts.html#tcpdumplikesect">5.1.4. Monitoring TCP Packets</a></span></dt><dt><span class="section"><a href="useful-systemtap-scripts.html#dropwatchsect">5.1.5. Monitoring Network Packets Drops in Kernel</a></span></dt></dl></dd><dt><span class="section"><a href="mainsect-disk.html">5.2. Disk</a></span></dt><dd><dl><dt><span class="section"><a href="mainsect-disk.html#disktop">5.2.1. Summarizing Disk Read/Write Traffic</a></span></dt><dt><span class="section"><a href="iotimesect.html">5.2.2. Tracking I/O Time For Each File Read or Write</a></span></dt><dt><span class="section"><a href="traceiosect.html">5.2.3. Track Cumulative IO</a></span></dt><dt><span class="section"><a href="traceio2sect.html">5.2.4. I/O Monitoring (By Device)</a></span></dt><dt><span class="section"><a href="inodewatchsect.html">5.2.5. Monitoring Reads and Writes to a File</a></span></dt><dt><span class="section"><a href="inodewatch2sect.html">5.2.6. Monitoring Changes to File Attributes</a></span></dt><dt><span class="section"><a href="ioblktimesect.html">5.2.7. Periodically Print I/O Block Time</a></span></dt></dl></dd><dt><span class="section"><a href="mainsect-profiling.html">5.3. Profiling</a></span></dt><dd><dl><dt><span class="section"><a href="mainsect-profiling.html#countcallssect">5.3.1. Counting Function Calls Made</a></span></dt><dt><span class="section"><a href="paracallgraph.html">5.3.2. Call Graph Tracing</a></span></dt><dt><span class="section"><a href="threadtimessect.html">5.3.3. Determining Time Spent in Kernel and User Space</a></span></dt><dt><span class="section"><a href="timeoutssect.html">5.3.4. Monitoring Polling Applications</a></span></dt><dt><span class="section"><a href="topsyssect.html">5.3.5. Tracking Most Frequently Used System Calls</a></span></dt><dt><span class="section"><a href="syscallsbyprocpidsect.html">5.3.6. Tracking System Call Volume Per Process</a></span></dt></dl></dd><dt><span class="section"><a href="futexcontentionsect.html">5.4. Identifying Contended User-Space Locks</a></span></dt></dl></dd><dt><span class="chapter"><a href="errors.html">6. Understanding SystemTap Errors</a></span></dt><dd><dl><dt><span class="section"><a href="errors.html#parsetype">6.1. Parse and Semantic Errors</a></span></dt><dt><span class="section"><a href="runtimeerror.html">6.2. Run Time Errors and Warnings</a></span></dt></dl></dd><dt><span class="chapter"><a href="references.html">7. References</a></span></dt><dt><span class="appendix"><a href="appe-Publican-Revision_History.html">A. Revision History</a></span></dt><dt><span class="index"><a href="ix01.html">Index</a></span></dt></dl></div></div><ul class="docnav"><li class="previous"></li><li class="next"><a accesskey="n" href="SystemTap_Beginners_Guide-Preface.html"><strong>Next</strong>Preface</a></li></ul></body></html>
+ </div></div></div><div><div class="abstract"><p class="title"><strong>Abstract</strong></p><div class="para">
+ This guide provides basic instructions on how to use SystemTap to monitor different subsystems of a Linux system in finer detail.
+ </div></div></div></div></div><div class="toc"><dl class="toc"><dt><span class="preface"><a href="SystemTap_Beginners_Guide-Preface.html">Preface</a></span></dt><dd><dl><dt><span class="section"><a href="SystemTap_Beginners_Guide-Preface.html#idm246922603856">1. Document Conventions</a></span></dt><dd><dl><dt><span class="section"><a href="SystemTap_Beginners_Guide-Preface.html#idm246917943776">1.1. Typographic Conventions</a></span></dt><dt><span class="section"><a href="SystemTap_Beginners_Guide-Preface.html#idm246878025616">1.2. Pull-quote Conventions</a></span></dt><dt><span class="section"><a href="SystemTap_Beginners_Guide-Preface.html#idm246930165456">1.3. Notes and Warnings</a></span></dt></dl></dd><dt><span class="section"><a href="pr01s02.html">2. We Need Feedback!</a></span></dt></dl></dd><dt><span class="chapter"><a href="introduction.html">1. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="introduction.html#goals">1.1. Documentation Goals</a></span></dt><dt><span class="section"><a href="intro-systemtap-vs-others.html">1.2. SystemTap Capabilities</a></span></dt><dt><span class="section"><a href="intro-systemtap-limitations.html">1.3. Limitations of SystemTap</a></span></dt></dl></dd><dt><span class="chapter"><a href="using-systemtap.html">2. Using SystemTap</a></span></dt><dd><dl><dt><span class="section"><a href="using-systemtap.html#using-setup">2.1. Installation and Setup</a></span></dt><dd><dl><dt><span class="section"><a href="using-systemtap.html#installproper">2.1.1. Installing SystemTap</a></span></dt><dt><span class="section"><a href="using-systemtap.html#install-kinfo">2.1.2. Installing Required Kernel Information Packages Manually</a></span></dt><dt><span class="section"><a href="using-systemtap.html#testing">2.1.3. Initial Testing</a></span></dt></dl></dd><dt><span class="section"><a href="cross-compiling.html">2.2. Generating Instrumentation for Other Computers</a></span></dt><dt><span class="section"><a href="using-usage.html">2.3. Running SystemTap Scripts</a></span></dt><dd><dl><dt><span class="section"><a href="using-usage.html#flight-recorder">2.3.1. SystemTap Flight Recorder Mode</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="understanding-how-systemtap-works.html">3. Understanding How SystemTap Works</a></span></dt><dd><dl><dt><span class="section"><a href="understanding-how-systemtap-works.html#understanding-architecture-tools">3.1. Architecture</a></span></dt><dt><span class="section"><a href="scripts.html">3.2. SystemTap Scripts</a></span></dt><dd><dl><dt><span class="section"><a href="scripts.html#systemtapscript-events">3.2.1. Event</a></span></dt><dt><span class="section"><a href="systemtapscript-handler.html">3.2.2. SystemTap Handler/Body</a></span></dt></dl></dd><dt><span class="section"><a href="scriptconstructions.html">3.3. Basic SystemTap Handler Constructs</a></span></dt><dd><dl><dt><span class="section"><a href="scriptconstructions.html#variablesconstructs">3.3.1. Variables</a></span></dt><dt><span class="section"><a href="targetvariables.html">3.3.2. Target Variables</a></span></dt><dt><span class="section"><a href="handlerconditionalstatements.html">3.3.3. Conditional Statements</a></span></dt><dt><span class="section"><a href="commandlineargssect.html">3.3.4. Command-Line Arguments</a></span></dt></dl></dd><dt><span class="section"><a href="associativearrays.html">3.4. Associative Arrays</a></span></dt><dt><span class="section"><a href="arrayoperators.html">3.5. Array Operations in SystemTap</a></span></dt><dd><dl><dt><span class="section"><a href="arrayoperators.html#arrayops-assignvalue">3.5.1. Assigning an Associated Value</a></span></dt><dt><span class="section"><a href="arrayops-readvalues.html">3.5.2. Reading Values From Arrays</a></span></dt><dt><span class="section"><a href="arrayops-increment.html">3.5.3. Incrementing Associated Values</a></span></dt><dt><span class="section"><a href="arrayops-foreach.html">3.5.4. Processing Multiple Elements in an Array</a></span></dt><dt><span class="section"><a href="arrayops-deleting.html">3.5.5. Clearing/Deleting Arrays and Array Elements</a></span></dt><dt><span class="section"><a href="arrayops-conditionals.html">3.5.6. Using Arrays in Conditional Statements</a></span></dt><dt><span class="section"><a href="arrayops-aggregates.html">3.5.7. Computing for Statistical Aggregates</a></span></dt></dl></dd><dt><span class="section"><a href="understanding-tapsets.html">3.6. Tapsets</a></span></dt></dl></dd><dt><span class="chapter"><a href="userspace-probing.html">4. User-space Probing</a></span></dt><dd><dl><dt><span class="section"><a href="userspace-probing.html#uevents">4.1. User-Space Events</a></span></dt><dt><span class="section"><a href="utargetvariable.html">4.2. Accessing User-Space Target Variables</a></span></dt><dt><span class="section"><a href="ustack.html">4.3. User-Space Stack Backtraces</a></span></dt></dl></dd><dt><span class="chapter"><a href="useful-systemtap-scripts.html">5. Useful SystemTap Scripts</a></span></dt><dd><dl><dt><span class="section"><a href="useful-systemtap-scripts.html#mainsect-network">5.1. Network</a></span></dt><dd><dl><dt><span class="section"><a href="useful-systemtap-scripts.html#nettopsect">5.1.1. Network Profiling</a></span></dt><dt><span class="section"><a href="useful-systemtap-scripts.html#sockettracesect">5.1.2. Tracing Functions Called in Network Socket Code</a></span></dt><dt><span class="section"><a href="useful-systemtap-scripts.html#tcpconnectionssect">5.1.3. Monitoring Incoming TCP Connections</a></span></dt><dt><span class="section"><a href="useful-systemtap-scripts.html#tcpdumplikesect">5.1.4. Monitoring TCP Packets</a></span></dt><dt><span class="section"><a href="useful-systemtap-scripts.html#dropwatchsect">5.1.5. Monitoring Network Packets Drops in Kernel</a></span></dt></dl></dd><dt><span class="section"><a href="mainsect-disk.html">5.2. Disk</a></span></dt><dd><dl><dt><span class="section"><a href="mainsect-disk.html#disktop">5.2.1. Summarizing Disk Read/Write Traffic</a></span></dt><dt><span class="section"><a href="iotimesect.html">5.2.2. Tracking I/O Time For Each File Read or Write</a></span></dt><dt><span class="section"><a href="traceiosect.html">5.2.3. Track Cumulative IO</a></span></dt><dt><span class="section"><a href="traceio2sect.html">5.2.4. I/O Monitoring (By Device)</a></span></dt><dt><span class="section"><a href="inodewatchsect.html">5.2.5. Monitoring Reads and Writes to a File</a></span></dt><dt><span class="section"><a href="inodewatch2sect.html">5.2.6. Monitoring Changes to File Attributes</a></span></dt><dt><span class="section"><a href="ioblktimesect.html">5.2.7. Periodically Print I/O Block Time</a></span></dt></dl></dd><dt><span class="section"><a href="mainsect-profiling.html">5.3. Profiling</a></span></dt><dd><dl><dt><span class="section"><a href="mainsect-profiling.html#countcallssect">5.3.1. Counting Function Calls Made</a></span></dt><dt><span class="section"><a href="paracallgraph.html">5.3.2. Call Graph Tracing</a></span></dt><dt><span class="section"><a href="threadtimessect.html">5.3.3. Determining Time Spent in Kernel and User Space</a></span></dt><dt><span class="section"><a href="timeoutssect.html">5.3.4. Monitoring Polling Applications</a></span></dt><dt><span class="section"><a href="topsyssect.html">5.3.5. Tracking Most Frequently Used System Calls</a></span></dt><dt><span class="section"><a href="syscallsbyprocpidsect.html">5.3.6. Tracking System Call Volume Per Process</a></span></dt></dl></dd><dt><span class="section"><a href="futexcontentionsect.html">5.4. Identifying Contended User-Space Locks</a></span></dt></dl></dd><dt><span class="chapter"><a href="errors.html">6. Understanding SystemTap Errors</a></span></dt><dd><dl><dt><span class="section"><a href="errors.html#parsetype">6.1. Parse and Semantic Errors</a></span></dt><dt><span class="section"><a href="runtimeerror.html">6.2. Runtime Errors and Warnings</a></span></dt></dl></dd><dt><span class="chapter"><a href="references.html">7. References</a></span></dt><dt><span class="appendix"><a href="appe-Publican-Revision_History.html">A. Revision History</a></span></dt><dt><span class="index"><a href="ix01.html">Index</a></span></dt></dl></div></div><ul class="docnav"><li class="previous"></li><li class="next"><a accesskey="n" href="SystemTap_Beginners_Guide-Preface.html"><strong>Next</strong>Preface</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>5.2.6. Monitoring Changes to File Attributes</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-disk.html" title="5.2. Disk" /><link rel="prev" href="inodewatchsect.html" title="5.2.5. Monitoring Reads and Writes to a File" /><link rel="next" href="ioblktimesect.html" title="5.2.7. Periodically Print I/O Block Time" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="inodewatchsect.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="ioblktimesect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="inodewatch2sect" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="inodewatch2sect">5.2.6. Monitoring Changes to File Attributes</h3></div></div></div><a id="idp62891680" class="indexterm"></a><a id="idp32370160" class="indexterm"></a><a id="idp60289440" class="indexterm"></a><a id="idp59469392" class="indexterm"></a><a id="idp15264432" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">5.2.6. Monitoring Changes to File Attributes</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-disk.html" title="5.2. Disk" /><link rel="prev" href="inodewatchsect.html" title="5.2.5. Monitoring Reads and Writes to a File" /><link rel="next" href="ioblktimesect.html" title="5.2.7. Periodically Print I/O Block Time" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="inodewatchsect.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="ioblktimesect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="inodewatch2sect"></a>5.2.6. Monitoring Changes to File Attributes</h3></div></div></div><a id="idm246876619056" class="indexterm"></a><a id="idm246913084048" class="indexterm"></a><a id="idm246927280608" class="indexterm"></a><a id="idm246914331360" class="indexterm"></a><a id="idm246912779216" class="indexterm"></a><div class="para">
This section describes how to monitor if any processes are changing the attributes of a targeted file, in real time.
- </div><div class="formalpara" id="inodewatch2"><h5 class="formalpara">inodewatch2.stp</h5>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">inodewatch2.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
Like <a class="xref" href="inodewatchsect.html#inodewatch">inodewatch.stp</a> from <a class="xref" href="inodewatchsect.html">Section 5.2.5, “Monitoring Reads and Writes to a File”</a>, <a class="xref" href="inodewatch2sect.html#inodewatch2">inodewatch2.stp</a> takes the targeted file's device number (in integer format) and <code class="command">inode</code> number as arguments. For more information on how to retrieve this information, refer to <a class="xref" href="inodewatchsect.html">Section 5.2.5, “Monitoring Reads and Writes to a File”</a>.
</div><div class="para">
The output for <a class="xref" href="inodewatch2sect.html#inodewatch2">inodewatch2.stp</a> is similar to that of <a class="xref" href="inodewatchsect.html#inodewatch">inodewatch.stp</a>, except that <a class="xref" href="inodewatch2sect.html#inodewatch2">inodewatch2.stp</a> also contains the attribute changes to the monitored file, as well as the ID of the user responsible (<code class="command">uid()</code>). <a class="xref" href="inodewatch2sect.html#inodewatch2output">Example 5.11, “inodewatch2.stp Sample Output”</a> shows the output of <a class="xref" href="inodewatch2sect.html#inodewatch2">inodewatch2.stp</a> while monitoring <code class="filename">/home/joe/bigfile</code> when user <code class="computeroutput">joe</code> executes <code class="command">chmod 777 /home/joe/bigfile</code> and <code class="command">chmod 666 /home/joe/bigfile</code>.
- </div><div class="example" id="inodewatch2output"><h6>Example 5.11. <a class="xref" href="inodewatch2sect.html#inodewatch2">inodewatch2.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen">chmod(17448) inode_setattr 0x800005/6011835 100777 500
-chmod(17449) inode_setattr 0x800005/6011835 100666 500</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="inodewatchsect.html"><strong>Prev</strong>5.2.5. Monitoring Reads and Writes to a File</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="ioblktimesect.html"><strong>Next</strong>5.2.7. Periodically Print I/O Block Time</a></li></ul></body></html>
+ </div><div class="example"><a id="inodewatch2output"></a><p class="title"><strong>Example 5.11. <a class="xref" href="inodewatch2sect.html#inodewatch2">inodewatch2.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen">chmod(17448) inode_setattr 0x800005/6011835 100777 500
+chmod(17449) inode_setattr 0x800005/6011835 100666 500</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="inodewatchsect.html"><strong>Prev</strong>5.2.5. Monitoring Reads and Writes to a File</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="ioblktimesect.html"><strong>Next</strong>5.2.7. Periodically Print I/O Block Time</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>5.2.5. Monitoring Reads and Writes to a File</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-disk.html" title="5.2. Disk" /><link rel="prev" href="traceio2sect.html" title="5.2.4. I/O Monitoring (By Device)" /><link rel="next" href="inodewatch2sect.html" title="5.2.6. Monitoring Changes to File Attributes" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="traceio2sect.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="inodewatch2sect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="inodewatchsect" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="inodewatchsect">5.2.5. Monitoring Reads and Writes to a File</h3></div></div></div><a id="idp65638560" class="indexterm"></a><a id="idp27373776" class="indexterm"></a><a id="idm721872" class="indexterm"></a><a id="idp34112960" class="indexterm"></a><a id="idp44434528" class="indexterm"></a><a id="idp24227888" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">5.2.5. Monitoring Reads and Writes to a File</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-disk.html" title="5.2. Disk" /><link rel="prev" href="traceio2sect.html" title="5.2.4. I/O Monitoring (By Device)" /><link rel="next" href="inodewatch2sect.html" title="5.2.6. Monitoring Changes to File Attributes" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="traceio2sect.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="inodewatch2sect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="inodewatchsect"></a>5.2.5. Monitoring Reads and Writes to a File</h3></div></div></div><a id="idm246871571088" class="indexterm"></a><a id="idm246927227776" class="indexterm"></a><a id="idm246913057616" class="indexterm"></a><a id="idm246918398640" class="indexterm"></a><a id="idm246883137152" class="indexterm"></a><a id="idm246927410304" class="indexterm"></a><div class="para">
This section describes how to monitor reads from and writes to a file in real time.
- </div><div class="formalpara" id="inodewatch"><h5 class="formalpara">inodewatch.stp</h5>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">inodewatch.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
</pre>
</div><div class="para">
<a class="xref" href="inodewatchsect.html#inodewatch">inodewatch.stp</a> takes the following information about the file as arguments on the command line:
- </div><a id="id
p39674784" class="indexterm"></a><a id="idp20535440" class="indexterm"></a><a id="idp60220480" class="indexterm"></a><a id="idp26483088" class="indexterm"></a><div class="itemizedlist"><ul><li class="listitem"><div class="para">
+ </div><a id="id
m246929545344" class="indexterm"></a><a id="idm246914338544" class="indexterm"></a><a id="idm246917274240" class="indexterm"></a><a id="idm246926936304" class="indexterm"></a><div xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
The file's major device number.
</div></li><li class="listitem"><div class="para">
The file's minor device number.
</div></li><li class="listitem"><div class="para">
The file's <code class="command">inode</code> number.
- </div></li></ul></div><a id="id
p36696560" class="indexterm"></a><a id="idp14023456" class="indexterm"></a><a id="idp52656096" class="indexterm"></a><div class="para">
+ </div></li></ul></div><a id="id
m246914278656" class="indexterm"></a><a id="idm246877965920" class="indexterm"></a><a id="idm246913070688" class="indexterm"></a><div class="para">
To get this information, use <code class="command">stat -c '%D %i' <em class="replaceable"><code>filename</code></em></code>, where <code class="command"><em class="replaceable"><code>filename</code></em></code> is an absolute path.
</div><div class="para">
- For instance: if you wish to monitor <code class="filename">/etc/crontab</code>, run <code class="command">stat -c '%D %i' /etc/crontab</code> first. This gives the following output:
- </div><pre class="screen">805 1078319</pre><a id="id
p48931696" class="indexterm"></a><a id="idp28449104" class="indexterm"></a><a id="idp32321808" class="indexterm"></a><div class="para">
+ For instance: to monitor <code class="filename">/etc/crontab</code>, run <code class="command">stat -c '%D %i' /etc/crontab</code> first. This gives the following output:
+ </div><pre class="screen">805 1078319</pre><a id="id
m246917754528" class="indexterm"></a><a id="idm246928568752" class="indexterm"></a><a id="idm246876097744" class="indexterm"></a><div class="para">
<code class="computeroutput">805</code> is the base-16 (hexadecimal) device number. The lower two digits are the minor device number and the upper digits are the major number. <code class="computeroutput">1078319</code> is the <code class="command">inode</code> number. To start monitoring <code class="filename">/etc/crontab</code>, run <code class="command">stap inodewatch.stp 0x8 0x05 1078319</code> (The <code class="command">0x</code> prefixes indicate base-16 values.
</div><div class="para">
- The output of this command contains the name and ID of any process performing a read/write, the function it is performing (i.e. <code class="command">vfs_read</code> or <code class="command">vfs_write</code>), the device number (in hex format), and the <code class="command">inode</code> number. <a class="xref" href="inodewatchsect.html#inodewatchoutput">Example 5.10, “inodewatch.stp Sample Output”</a> contains the output of <code class="command">stap inodewatch.stp 0x8 0x05 1078319</code> (when <code class="command">cat /etc/crontab</code> is executed while the script is running) :
- </div><div class="example" id="inodewatchoutput"><h6>Example 5.10. <a class="xref" href="inodewatchsect.html#inodewatch">inodewatch.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen">cat(16437) vfs_read 0x800005/1078319
-cat(16437) vfs_read 0x800005/1078319</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="traceio2sect.html"><strong>Prev</strong>5.2.4. I/O Monitoring (By Device)</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="inodewatch2sect.html"><strong>Next</strong>5.2.6. Monitoring Changes to File Attributes</a></li></ul></body></html>
+ The output of this command contains the name and ID of any process performing a read/write, the function it is performing (that is, <code class="command">vfs_read</code> or <code class="command">vfs_write</code>), the device number (in hex format), and the <code class="command">inode</code> number. <a class="xref" href="inodewatchsect.html#inodewatchoutput">Example 5.10, “inodewatch.stp Sample Output”</a> contains the output of <code class="command">stap inodewatch.stp 0x8 0x05 1078319</code> (when <code class="command">cat /etc/crontab</code> is executed while the script is running) :
+ </div><div class="example"><a id="inodewatchoutput"></a><p class="title"><strong>Example 5.10. <a class="xref" href="inodewatchsect.html#inodewatch">inodewatch.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen">cat(16437) vfs_read 0x800005/1078319
+cat(16437) vfs_read 0x800005/1078319</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="traceio2sect.html"><strong>Prev</strong>5.2.4. I/O Monitoring (By Device)</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="inodewatch2sect.html"><strong>Next</strong>5.2.6. Monitoring Changes to File Attributes</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>1.2. SystemTap Capabilities</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="introduction.html" title="Chapter 1. Introduction" /><link rel="prev" href="introduction.html" title="Chapter 1. Introduction" /><link rel="next" href="using-systemtap.html" title="Chapter 2. Using SystemTap" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="introduction.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="using-systemtap.html"><strong>Next</strong></a></li></ul><div class="section" id="intro-systemtap-vs-others"><div class="titlepage"><div><div><h2 class="title" id="intro-systemtap-vs-others">1.2. SystemTap Capabilities</h2></div></div></div><a id="idp36385840" class="indexterm"></a><a id="idp36387248" class="indexterm"></a><div class="itemizedlist"><ul><li class="listitem"><div class="para">
- Flexibility: SystemTap's framework allows users to develop simple scripts for investigating and monitoring a wide variety of kernel functions, system calls, and other events that occur in kernel-space. With this, SystemTap is not so much a <span class="emphasis"><em>tool</em></span> as it is a system that allows you to develop your own kernel-specific forensic and monitoring tools.
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">1.2. SystemTap Capabilities</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="introduction.html" title="Chapter 1. Introduction" /><link rel="prev" href="introduction.html" title="Chapter 1. Introduction" /><link rel="next" href="intro-systemtap-limitations.html" title="1.3. Limitations of SystemTap" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="introduction.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="intro-systemtap-limitations.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="intro-systemtap-vs-others"></a>1.2. SystemTap Capabilities</h2></div></div></div><a id="idm246874947200" class="indexterm"></a><a id="idm246880631280" class="indexterm"></a><div xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
+ <span class="strong strong"><strong>Flexibility:</strong></span> SystemTap's framework allows users to develop simple scripts for investigating and monitoring a wide variety of kernel functions, system calls, and other events that occur in kernel space. As a result, SystemTap is not so much a <span class="emphasis"><em>tool</em></span> as it is a system that allows you to develop your own kernel-specific forensic and monitoring tools.
</div></li><li class="listitem"><div class="para">
- Ease-Of-Use: as mentioned earlier, SystemTap allows users to probe kernel-space events without having to resort to instrument, recompile, install, and reboot the kernel.
+ <span class="strong strong"><strong>Ease of use</strong></span>: as mentioned earlier, SystemTap allows users to probe kernel-space events without having to resort to instrument, recompile, install, and reboot the kernel.
</div></li></ul></div><div class="para">
- Most of the SystemTap scripts enumerated in <a class="xref" href="useful-systemtap-scripts.html">Chapter 5, <em>Useful SystemTap Scripts</em></a> demonstrate system forensics and monitoring capabilities not natively available with other similar tools (such as <code class="command">top</code>, <code class="command">oprofile</code>, or <code class="command">ps</code>). These scripts are provided to give readers extensive examples of the application of SystemTap, which in turn will educate them further on the capabilities they can employ when writing their own SystemTap scripts.
- </div><a id="idp22301760" class="indexterm"></a><a id="idp22303168" class="indexterm"></a><div class="formalpara"><h5 class="formalpara" id="idp49679152">Limitations</h5>
- The current iteration of SystemTap allows for a multitude of options when probing kernel-space events for a wide range of kernels. However, SystemTap's ability to probe user-space events is dependent on kernel support (the Utrace mechanism) that is unavailable in many kernels. Thus, only some kernel versions support user-space probing. At present, the developmental efforts of the SystemTap community are geared towards improving SystemTap's user-space probing capabilities.
- </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="introduction.html"><strong>Prev</strong>Chapter 1. Introduction</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="using-systemtap.html"><strong>Next</strong>Chapter 2. Using SystemTap</a></li></ul></body></html>
+ Most of the SystemTap scripts enumerated in <a class="xref" href="useful-systemtap-scripts.html">Chapter 5, <em>Useful SystemTap Scripts</em></a> demonstrate system forensics and monitoring capabilities not natively available with other similar tools (such as <code class="command">top</code>, <code class="command">oprofile</code>, or <code class="command">ps</code>). These scripts are provided to give readers extensive examples of the application of SystemTap and to educate them further on the capabilities they can employ when writing their own SystemTap scripts.
+ </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="introduction.html"><strong>Prev</strong>Chapter 1. Introduction</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="intro-systemtap-limitations.html"><strong>Next</strong>1.3. Limitations of SystemTap</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 1. Introduction</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="pr01s02.html" title="2. We Need Feedback!" /><link rel="next" href="intro-systemtap-vs-others.html" title="1.2. SystemTap Capabilities" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="pr01s02.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="intro-systemtap-vs-others.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="chapter" id="introduction" lang="en-US"><div class="titlepage"><div><div><h2 class="title">Chapter 1. Introduction</h2></div></div></div><div class="toc"><dl><dt><span class="section"><a href="introduction.html#goals">1.1. Documentation Goals</a></span></dt><dt><span class="section"><a href="intro-systemtap-vs-others.html">1.2. SystemTap Capabilities</a></span></dt></dl></div><a id="idp13858368" class="indexterm"></a><a id="idm4000224" class="indexterm"></a><div class="para">
- SystemTap is a tracing and probing tool that allows users to study and monitor the activities of the computer system (particularly, the kernel) in fine detail. It provides information similar to the output of tools like <code class="command">netstat</code>, <code class="command">ps</code>, <code class="command">top</code>, and <code class="command">iostat</code>; however, SystemTap is designed to provide more filtering and analysis options for collected information.
- </div><div class="section" id="goals"><div class="titlepage"><div><div><h2 class="title" id="goals">1.1. Documentation Goals</h2></div></div></div><a id="idp22681296" class="indexterm"></a><a id="idp14079360" class="indexterm"></a><a id="idp44966608" class="indexterm"></a><a id="idp41017344" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">Chapter 1. Introduction</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="pr01s02.html" title="2. We Need Feedback!" /><link rel="next" href="intro-systemtap-vs-others.html" title="1.2. SystemTap Capabilities" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="pr01s02.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="intro-systemtap-vs-others.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="chapter" lang="en-US"><div class="titlepage"><div><div><h1 class="title"><a id="introduction"></a>Chapter 1. Introduction</h1></div></div></div><div class="toc"><dl class="toc"><dt><span class="section"><a href="introduction.html#goals">1.1. Documentation Goals</a></span></dt><dt><span class="section"><a href="intro-systemtap-vs-others.html">1.2. SystemTap Capabilities</a></span></dt><dt><span class="section"><a href="intro-systemtap-limitations.html">1.3. Limitations of SystemTap</a></span></dt></dl></div><a id="idm246912131760" class="indexterm"></a><a id="idm246877716272" class="indexterm"></a><div class="para">
+ SystemTap is a tracing and probing tool that allows users to study and monitor the activities of the computer system (particularly, the kernel) in fine detail. It provides information similar to the output of tools like <code class="command">netstat</code>, <code class="command">ps</code>, <code class="command">top</code>, and <code class="command">iostat</code>, but is designed to provide more filtering and analysis options for collected information.
+ </div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="goals"></a>1.1. Documentation Goals</h2></div></div></div><a id="idm246917582496" class="indexterm"></a><a id="idm246912120336" class="indexterm"></a><a id="idm246880282576" class="indexterm"></a><a id="idm246877457904" class="indexterm"></a><div class="para">
SystemTap provides the infrastructure to monitor the running Linux kernel for detailed analysis. This can assist administrators and developers in identifying the underlying cause of a bug or performance problem.
</div><div class="para">
- Without SystemTap, monitoring the activity of a running kernel would require a tedious instrument, recompile, install, and reboot sequence. SystemTap is designed to eliminate this, allowing users to gather the same information by simply running user-written SystemTap scripts.
+ Without SystemTap, monitoring the activity of a running kernel would require a tedious instrument, recompile, install, and reboot sequence. SystemTap is designed to eliminate this and allows users to gather the same information by running user-written SystemTap scripts.
</div><div class="para">
- However, SystemTap was initially designed for users with intermediate to advanced knowledge of the kernel. This makes SystemTap less useful to administrators or developers with limited knowledge of and experience with the Linux kernel. Moreover, much of the existing SystemTap documentation is similarly aimed at knowledgeable and experienced users. This makes learning the tool similarly difficult.
+ SystemTap was initially designed for users with intermediate to advanced knowledge of the kernel. As a consequence, it is less useful to administrators or developers with limited knowledge of and experience with the Linux kernel. Moreover, much of the existing SystemTap documentation is aimed at knowledgeable and experienced users, which makes learning the tool similarly difficult.
</div><div class="para">
- To lower these barriers the SystemTap Beginners Guide was written with the following goals:
- </div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
- To introduce users to SystemTap, familiarize them with its architecture, and provide setup instructions.
+ To lower these barriers, the SystemTap Beginners Guide was written with the following goals:
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
+ to introduce users to SystemTap, familiarize them with its architecture, and provide setup instructions;
</div></li><li class="listitem"><div class="para">
- To provide pre-written SystemTap scripts for monitoring detailed activity in different components of the system, along with instructions on how to run them and analyze their output.
- </div></li></ul></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="pr01s02.html"><strong>Prev</strong>2. We Need Feedback!</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="intro-systemtap-vs-others.html"><strong>Next</strong>1.2. SystemTap Capabilities</a></li></ul></body></html>
+ to provide pre-written SystemTap scripts for monitoring detailed activity in different components of the system, along with instructions on how to run them and analyze their output.
+ </div></li></ul></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="pr01s02.html"><strong>Prev</strong>2. We Need Feedback!</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="intro-systemtap-vs-others.html"><strong>Next</strong>1.2. SystemTap Capabilities</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>5.2.7. Periodically Print I/O Block Time</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-disk.html" title="5.2. Disk" /><link rel="prev" href="inodewatch2sect.html" title="5.2.6. Monitoring Changes to File Attributes" /><link rel="next" href="mainsect-profiling.html" title="5.3. Profiling" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="inodewatch2sect.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="mainsect-profiling.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="ioblktimesect" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="ioblktimesect">5.2.7. Periodically Print I/O Block Time</h3></div></div></div><a id="idp51422880" class="indexterm"></a><a id="idm1427760" class="indexterm"></a><a id="idp45899968" class="indexterm"></a><a id="idp20858784" class="indexterm"></a><a id="idp48230592" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">5.2.7. Periodically Print I/O Block Time</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-disk.html" title="5.2. Disk" /><link rel="prev" href="inodewatch2sect.html" title="5.2.6. Monitoring Changes to File Attributes" /><link rel="next" href="mainsect-profiling.html" title="5.3. Profiling" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="inodewatch2sect.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="mainsect-profiling.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="ioblktimesect"></a>5.2.7. Periodically Print I/O Block Time</h3></div></div></div><a id="idm246924575696" class="indexterm"></a><a id="idm246913011504" class="indexterm"></a><a id="idm246920646720" class="indexterm"></a><a id="idm246918036544" class="indexterm"></a><a id="idm246917404720" class="indexterm"></a><div class="para">
This section describes how to track the amount of time each block I/O requests spends waiting for completion. This is useful in determining whether there are too many outstanding block I/O operations at any given time.
- </div><div class="formalpara" id="ioblktime"><h5 class="formalpara">ioblktime.stp</h5>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">ioblktime.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
-global req_time, etimes
+global req_time%[25000], etimes
probe ioblock.request
{
<a class="xref" href="ioblktimesect.html#ioblktime">ioblktime.stp</a> computes the average waiting time for block I/O per device, and prints a list every 10 seconds. As always, you can revise this refresh rate by editing the specified value in <code class="command">probe timer.s(10), end {</code>.
</div><div class="para">
In some cases, there can be too many outstanding block I/O operations, at which point the script can exceed the default number of <code class="command">MAXMAPENTRIES</code>. <code class="command">MAXMAPENTRIES</code> is the maximum number of rows in an array if the array size is not specified explicitly when declared. If the script exceeds the default <code class="command">MAXMAPENTRIES</code> value of 2048, run the script again with the <code class="command">stap</code> option <code class="command">-DMAXMAPENTRIES=10000</code>.
- </div><div class="example"
id="ioblktimeoutput"><h6>Example 5.12. <a class="xref" href="ioblktimesect.html#ioblktime">ioblktime.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen"> device rw total (us) count avg (us)
+ </div><div class="example"
><a id="ioblktimeoutput"></a><p class="title"><strong>Example 5.12. <a class="xref" href="ioblktimesect.html#ioblktime">ioblktime.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen"> device rw total (us) count avg (us)
sda W 9659 6 1609
dm-0 W 20278 6 3379
dm-0 R 20524 5 4104
sda R 19277 5 3855</pre></div></div><br class="example-break" /><div class="para">
<a class="xref" href="ioblktimesect.html#ioblktimeoutput">Example 5.12, “ioblktime.stp Sample Output”</a> displays the device name, operations performed (<code class="command">rw</code>), total wait time of all operations (<code class="command">total(us)</code>), number of operations (<code class="command">count</code>), and average wait time for all those operations (<code class="command">avg (us)</code>). The times tallied by the script are in microseconds.
- </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="inodewatch2sect.html"><strong>Prev</strong>5.2.6. Monitoring Changes to File Attributes</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="mainsect-profiling.html"><strong>Next</strong>5.3. Profiling</a></li></ul></body></html>
+ </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="inodewatch2sect.html"><strong>Prev</strong>5.2.6. Monitoring Changes to File Attributes</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="mainsect-profiling.html"><strong>Next</strong>5.3. Profiling</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>5.2.2. Tracking I/O Time For Each File Read or Write</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-disk.html" title="5.2. Disk" /><link rel="prev" href="mainsect-disk.html" title="5.2. Disk" /><link rel="next" href="traceiosect.html" title="5.2.3. Track Cumulative IO" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="mainsect-disk.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="traceiosect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="iotimesect" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="iotimesect">5.2.2. Tracking I/O Time For Each File Read or Write</h3></div></div></div><a id="idp58392768" class="indexterm"></a><a id="idp26310352" class="indexterm"></a><a id="idp35524800" class="indexterm"></a><a id="idp56877088" class="indexterm"></a><a id="idp36194832" class="indexterm"></a><div class="para">
- This section describes how to monitor the amount of time it takes for each process to read from or write to any file. This is useful if you wish to determine what files are slow to load on a given system.
- </div><div class="formalpara" id="iotime"><h5 class="formalpara">iotime.stp</h5>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">5.2.2. Tracking I/O Time For Each File Read or Write</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-disk.html" title="5.2. Disk" /><link rel="prev" href="mainsect-disk.html" title="5.2. Disk" /><link rel="next" href="traceiosect.html" title="5.2.3. Track Cumulative IO" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="mainsect-disk.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="traceiosect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="iotimesect"></a>5.2.2. Tracking I/O Time For Each File Read or Write</h3></div></div></div><a id="idm246914224016" class="indexterm"></a><a id="idm246929512688" class="indexterm"></a><a id="idm246912282288" class="indexterm"></a><a id="idm246912283376" class="indexterm"></a><a id="idm246911814368" class="indexterm"></a><div class="para">
+ This section describes how to monitor the amount of time it takes for each process to read from or write to any file. This is useful to determine what files are slow to load on a given system.
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">iotime.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
</pre>
</div><div class="para">
<a class="xref" href="iotimesect.html#iotime">iotime.stp</a> tracks each time a system call opens, closes, reads from, and writes to a file. For each file any system call accesses, <a class="xref" href="iotimesect.html#iotime">iotime.stp</a> counts the number of microseconds it takes for any reads or writes to finish and tracks the amount of data (in bytes) read from or written to the file.
- </div><a id="id
p62746528" class="indexterm"></a><a id="idm3938304" class="indexterm"></a><a id="idp32882944" class="indexterm"></a><div class="para">
- <a class="xref" href="iotimesect.html#iotime">iotime.stp</a> also uses the local variable <code class="command">$count</code> to track the amount of data (in bytes) that any system call <span class="emphasis"><em>attempts</em></span> to read or write. Note that <code class="command">$return</code> (as used in <a class="xref" href="mainsect-disk.html#scriptdisktop">disktop.stp</a> from <a class="xref" href="mainsect-disk.html#disktop">Section 5.2.1, “Summarizing Disk Read/Write Traffic”</a>) stores the <span class="emphasis"><em>actual</em></span> amount of data read/written. <code class="command">$count</code> can only be used on probes that track data reads or writes (e.g. <code class="command">syscall.read</code> and <code class="command">syscall.write</code>).
- </div><div class="example"
id="iotimeoutput"><h6>Example 5.7. <a class="xref" href="iotimesect.html#iotime">iotime.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen">[...]
+ </div><a id="id
m246875163184" class="indexterm"></a><a id="idm246869037504" class="indexterm"></a><a id="idm246927603008" class="indexterm"></a><div class="para">
+ <a class="xref" href="iotimesect.html#iotime">iotime.stp</a> also uses the local variable <code class="command">$count</code> to track the amount of data (in bytes) that any system call <span class="emphasis"><em>attempts</em></span> to read or write. Note that <code class="command">$return</code> (as used in <a class="xref" href="mainsect-disk.html#scriptdisktop">disktop.stp</a> from <a class="xref" href="mainsect-disk.html#disktop">Section 5.2.1, “Summarizing Disk Read/Write Traffic”</a>) stores the <span class="emphasis"><em>actual</em></span> amount of data read/written. <code class="command">$count</code> can only be used on probes that track data reads or writes (that is, <code class="command">syscall.read</code> and <code class="command">syscall.write</code>).
+ </div><div class="example"
><a id="iotimeoutput"></a><p class="title"><strong>Example 5.7. <a class="xref" href="iotimesect.html#iotime">iotime.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen">[...]
825946 3364 (NetworkManager) access /sys/class/net/eth0/carrier read: 8190 write: 0
825955 3364 (NetworkManager) iotime /sys/class/net/eth0/carrier time: 9
[...]
3973744 2886 (sendmail) iotime /proc/loadavg time: 11
[...]</pre></div></div><br class="example-break" /><div class="para">
<a class="xref" href="iotimesect.html#iotimeoutput">Example 5.7, “iotime.stp Sample Output”</a> prints out the following data:
- </div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
A timestamp, in microseconds.
</div></li><li class="listitem"><div class="para">
Process ID and process name.
</div></li></ul></div><div class="para">
If a process was able to read or write any data, a pair of <code class="computeroutput">access</code> and <code class="computeroutput">iotime</code> lines should appear together. The <code class="computeroutput">access</code> line's timestamp refers to the time that a given process started accessing a file; at the end of the line, it will show the amount of data read/written (in bytes). The <code class="computeroutput">iotime</code> line will show the amount of time (in microseconds) that the process took in order to perform the read or write.
</div><div class="para">
- If an <code class="computeroutput">access</code> line is not followed by an <code class="computeroutput">iotime</code> line, it simply means that the process did not read or write any data.
- </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="mainsect-disk.html"><strong>Prev</strong>5.2. Disk</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="traceiosect.html"><strong>Next</strong>5.2.3. Track Cumulative IO</a></li></ul></body></html>
+ If an <code class="computeroutput">access</code> line is not followed by an <code class="computeroutput">iotime</code> line, it means that the process did not read or write any data.
+ </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="mainsect-disk.html"><strong>Prev</strong>5.2. Disk</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="traceiosect.html"><strong>Next</strong>5.2.3. Track Cumulative IO</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Index</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="appe-Publican-Revision_History.html" title="Appendix A. Revision History" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="appe-Publican-Revision_History.html"><strong>Prev</strong></a></li><li class="next"></li></ul><div class="index" id="idp45722496"><div class="titlepage"><div><div><h2 class="title">Index</h2></div></div></div><div class="index"><div class="indexdiv"><h3>Symbols</h3><dl><dt>$count</dt><dd><dl><dt>sample usage</dt><dd><dl><dt>local variables, <a class="indexterm" href="iotimesect.html">Tracking I/O Time For Each File Read or Write</a></dt></dl></dd></dl></dd><dt>$return</dt><dd><dl><dt>sample usage</dt><dd><dl><dt>local variables, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a>, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt></dl></dd></dl></dd><dt>@avg (integer extractor)</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd><dt>@count (integer extractor)</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd><dt>@max (integer extractor)</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd><dt>@min (integer extractor)</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd><dt>@sum (integer extractor)</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>A</h3><dl><dt>adding values to statistical aggregates</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd><dt>advantages of cross-instrumentation, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>aggregate element not found</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt></dl></dd></dl></dd><dt>aggregates (statistical)</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd><dt>aggregation overflow</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt></dl></dd></dl></dd><dt>algebraic formulas using arrays</dt><dd><dl><dt>reading values from arrays</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd></dl></dd><dt>architecture notation, determining, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>architecture of SystemTap, <a class="indexterm" href="understanding-how-systemtap-works.html#understanding-architecture-tools">Architecture</a></dt><dt>array locals not supported</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>array operations</dt><dd><dl><dt>assigning associated values, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt><dd><dl><dt>associating timestamps to process names, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt></dl></dd><dt>associative arrays, <a class="indexterm" href="arrayoperators.html">Array Operations in SystemTap</a></dt><dt>clearing arrays/array elements, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dd><dl><dt>delete operator, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dt>multiple array operations within the same probe, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dt>virtual file system reads (non-cumulative), tallying, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt></dl></dd><dt>computing for statistical aggregates, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dd><dl><dt>@avg (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@count (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@max (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@min (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@sum (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>adding values to statistical aggregates, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>count (operator), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>extracting data collected by statistical aggregates, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd><dt>conditional statements, using arrays in, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt><dd><dl><dt>testing for array membership, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt></dl></dd><dt>deleting arrays and array elements, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dt>incrementing associated values, <a class="indexterm" href="arrayops-increment.html">Incrementing Associated Values</a></dt><dd><dl><dt>tallying virtual file system reads (VFS reads), <a class="indexterm" href="arrayops-increment.html">Incrementing Associated Values</a></dt></dl></dd><dt>multiple elements in an array, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>processing multiple elements in an array, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dd><dl><dt>cumulative virtual file system reads, tallying, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>foreach, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>iterations, processing elements in an array as, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>limiting the output of foreach, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>ordering the output of foreach, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd><dt>reading values from arrays, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt><dd><dl><dt>computing for timestamp deltas, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt><dt>empty unique keys, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt><dt>using arrays in simple computations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd></dl></dd><dt>arrays, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt><dd><dl><dt>(see also associative arrays)</dt></dl></dd><dt>assigning associated values</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt><dd><dl><dt>associating timestamps to process names, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt></dl></dd><dt>associating timestamps to process names</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt></dl></dd></dl></dd><dt>associated values</dt><dd><dl><dt>introduction</dt><dd><dl><dt>arrays, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt></dl></dd></dl></dd><dt>associating timestamps to process names</dt><dd><dl><dt>assigning associated values</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt></dl></dd></dl></dd><dt>associative arrays</dt><dd><dl><dt>introduction, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt><dd><dl><dt>associated values, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt><dt>example, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt><dt>index expression, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt><dt>key pairs, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt><dt>syntax, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt><dt>unique keys, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt></dl></dd></dl></dd><dt>asynchronous events</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>B</h3><dl><dt>begin</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>building instrumentation modules from SystemTap scripts, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>building kernel modules from SystemTap scripts, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></div><div class="indexdiv"><h3>C</h3><dl><dt>call graph tracing</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>capabilities of SystemTap</dt><dd><dl><dt>Introduction, <a class="indexterm" href="intro-systemtap-vs-others.html">SystemTap Capabilities</a></dt></dl></dd><dt>changes to file attributes, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatch2sect.html">Monitoring Changes to File Attributes</a></dt></dl></dd><dt>clearing arrays/array elements</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dd><dl><dt>delete operator, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dt>multiple array operations within the same probe, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dt>virtual file system reads (non-cumulative), tallying, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt></dl></dd></dl></dd><dt>command-line arguments</dt><dd><dl><dt>SystemTap handler constructs</dt><dd><dl><dt>handlers, <a class="indexterm" href="commandlineargssect.html">Command-Line Arguments</a></dt></dl></dd></dl></dd><dt>compiling instrumentation/kernel modules from SystemTap scripts, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>components</dt><dd><dl><dt>SystemTap scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd></dl></dd><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dd><dl><dt>@avg (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@count (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@max (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@min (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@sum (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>adding values to statistical aggregates, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>count (operator), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>extracting data collected by statistical aggregates, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd><dt>computing for timestamp deltas</dt><dd><dl><dt>reading values from arrays</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd></dl></dd><dt>conditional operators</dt><dd><dl><dt>conditional statements</dt><dd><dl><dt>handlers, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt></dl></dd></dl></dd><dt>conditional statements, using arrays in</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt><dd><dl><dt>testing for array membership, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt></dl></dd></dl></dd><dt>CONFIG_HZ, computing for, <a class="indexterm" href="scriptconstructions.html#variablesconstructs">Variables</a></dt><dt>contended user-space locks (futex contentions), identifying</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt></dl></dd><dt>copy fault</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt></dl></dd></dl></dd><dt>count operator</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array (operator), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd><dt>counting function calls</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="mainsect-profiling.html#countcallssect">Counting Function Calls Made</a></dt></dl></dd><dt>CPU ticks</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt></dl></dd><dt>cpu()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt></dl></dd><dt>cross-compiling, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>cross-instrumentation</dt><dd><dl><dt>advantages of, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>building kernel modules from SystemTap scripts, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>configuration</dt><dd><dl><dt>host system and target system, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></dd><dt>generating instrumentation from SystemTap scripts, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>host system, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>instrumentation module, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>target kernel, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>target system, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></dd><dt>ctime()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt></dl></dd><dt>ctime(), example of usage</dt><dd><dl><dt>script examples, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt></dl></dd><dt>cumulative I/O, tracking</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt></dl></dd><dt>cumulative virtual file system reads, tallying</dt><dd><dl><dt>processing multiple elements in an array</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>D</h3><dl><dt>delete operator</dt><dd><dl><dt>clearing arrays/array elements</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt></dl></dd></dl></dd><dt>determining architecture notation, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>determining the kernel version, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information RPMs</a></dt><dt>determining time spent in kernel and user space</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt></dl></dd><dt>device I/O, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt></dl></dd><dt>device number of a file (integer format)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt></dl></dd><dt>disk I/O traffic, summarizing</dt><dd><dl><dt>script examples, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt></dl></dd><dt>division by 0</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt></dl></dd></dl></dd><dt>documentation goals</dt><dd><dl><dt>Introduction, <a class="indexterm" href="introduction.html#goals">Documentation Goals</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>E</h3><dl><dt>embedded code in unprivileged script</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>empty unique keys</dt><dd><dl><dt>reading values from arrays</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd></dl></dd><dt>end</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>errors</dt><dd><dl><dt>parse/semantics error, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dd><dl><dt>embedded code in unprivileged script, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>expected symbol/array index expression, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>grammatical/typographical script error, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>guru mode, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>invalid values to variables/arrays, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>libdwfl failure, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>no match for probe point, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>non-global arrays, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>probe mismatch, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>type mismatch for identifier, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved function call, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved target-symbol expression, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved type for identifier, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>variable modified during 'foreach', <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd><dt>runtime errors/warnings, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dd><dl><dt>aggregate element not found, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>aggregation overflow, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>copy fault, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>division by 0, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>MAXACTION exceeded, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>MAXNESTING exceeded, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>number of errors: N, skipped probes: M, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>pointer dereference fault, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt></dl></dd></dl></dd><dt>event types</dt><dd><dl><dt>Understanding How SystemTap Works, <a class="indexterm" href="understanding-how-systemtap-works.html">Understanding How SystemTap Works</a></dt></dl></dd><dt>Events</dt><dd><dl><dt>asynchronous events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>begin, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>end, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>examples of synchronous and asynchronous events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>introduction, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>kernel.function("function"), <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>kernel.trace("tracepoint"), <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>module("module"), <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>synchronous events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>syscall.system_call, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>timer events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>user-space, <a class="indexterm" href="userspace-probing.html#uevents">User-Space Events</a></dt><dt>vfs.file_operation, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>wildcards, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>events and handlers, <a class="indexterm" href="understanding-how-systemtap-works.html">Understanding How SystemTap Works</a></dt><dt>events wildcards, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>example</dt><dd><dl><dt>introduction</dt><dd><dl><dt>arrays, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt></dl></dd></dl></dd><dt>example of multiple command-line arguments</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>examples of synchronous and asynchronous events</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html">Useful SystemTap Scripts</a></dt><dd><dl><dt>call graph tracing, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt><dt>CPU ticks, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt><dt>ctime(), example of usage, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt><dt>determining time spent in kernel and user space, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt><dt>file device number (integer format), <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt><dt>futex (lock) contentions, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt><dt>futex system call, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt><dt>identifying contended user-space locks (i.e. futex contentions), <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt><dt>if/else conditionals, alternative syntax, <a class="indexterm" href="useful-systemtap-scripts.html#nettopsect">Network Profiling</a></dt><dt>inode number, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt><dt>monitoring changes to file attributes, <a class="indexterm" href="inodewatch2sect.html">Monitoring Changes to File Attributes</a></dt><dt>monitoring device I/O, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt><dt>monitoring I/O block time, <a class="indexterm" href="ioblktimesect.html">Periodically Print I/O Block Time</a></dt><dt>monitoring I/O time, <a class="indexterm" href="iotimesect.html">Tracking I/O Time For Each File Read or Write</a></dt><dt>monitoring incoming TCP connections, <a class="indexterm" href="useful-systemtap-scripts.html#tcpconnectionssect">Monitoring Incoming TCP Connections</a></dt><dt>monitoring polling applications, <a class="indexterm" href="timeoutssect.html">Monitoring Polling Applications</a></dt><dt>monitoring reads and writes to a file, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt><dt>monitoring system calls, <a class="indexterm" href="topsyssect.html">Tracking Most Frequently Used System Calls</a></dt><dt>monitoring system calls (volume per process), <a class="indexterm" href="syscallsbyprocpidsect.html">Tracking System Call Volume Per Process</a></dt><dt>monitoring TCP packets, <a class="indexterm" href="useful-systemtap-scripts.html#tcpdumplikesect">Monitoring TCP Packets</a></dt><dt>multiple command-line arguments, example of, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt><dt>net/socket.c, tracing functions from, <a class="indexterm" href="useful-systemtap-scripts.html#sockettracesect">Tracing Functions Called in Network Socket Code</a></dt><dt>network profiling, <a class="indexterm" href="useful-systemtap-scripts.html#nettopsect">Network Profiling</a>, <a class="indexterm" href="useful-systemtap-scripts.html#dropwatchsect">Monitoring Network Packets Drops in Kernel</a></dt><dt>stat -c, determining file device number (integer format), <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt><dt>stat -c, determining whole device number, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt><dt>summarizing disk I/O traffic, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt><dt>tallying function calls, <a class="indexterm" href="mainsect-profiling.html#countcallssect">Counting Function Calls Made</a></dt><dt>thread_indent(), sample usage, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt><dt>timer.ms(), sample usage, <a class="indexterm" href="mainsect-profiling.html#countcallssect">Counting Function Calls Made</a></dt><dt>timer.s(), sample usage, <a class="indexterm" href="timeoutssect.html">Monitoring Polling Applications</a>, <a class="indexterm" href="topsyssect.html">Tracking Most Frequently Used System Calls</a></dt><dt>tracing functions called in network socket code, <a class="indexterm" href="useful-systemtap-scripts.html#sockettracesect">Tracing Functions Called in Network Socket Code</a></dt><dt>tracking cumulative I/O, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt><dt>trigger function, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt><dt>usrdev2kerndev(), <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt><dt>whole device number (usage as a command-line argument), <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt></dl></dd><dt>exceeded MAXACTION</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt></dl></dd></dl></dd><dt>exceeded MAXNESTING</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt></dl></dd></dl></dd><dt>exit()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt></dl></dd><dt>expected symbol/array index expression</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>extracting data collected by statistical aggregates</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>F</h3><dl><dt>feedback</dt><dd><dl><dt>contact information for this manual, <a class="indexterm" href="pr01s02.html">We Need Feedback!</a></dt></dl></dd><dt>file attributes, monitoring changes to</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatch2sect.html">Monitoring Changes to File Attributes</a></dt></dl></dd><dt>file device number (integer format)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt></dl></dd><dt>file reads/writes, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt></dl></dd><dt>flight recorder mode, <a class="indexterm" href="using-usage.html#flight-recorder">SystemTap Flight Recorder Mode</a></dt><dd><dl><dt>file mode, <a class="indexterm" href="using-usage.html#file-flight-recorder">File Flight Recorder</a></dt><dt>in-memory mode, <a class="indexterm" href="using-usage.html#memory-flight-recorder">In-memory Flight Recorder</a></dt></dl></dd><dt>for loops</dt><dd><dl><dt>conditional statements</dt><dd><dl><dt>handlers, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt></dl></dd></dl></dd><dt>foreach</dt><dd><dl><dt>processing multiple elements in an array</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd></dl></dd><dt>format</dt><dd><dl><dt>introduction</dt><dd><dl><dt>arrays, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt></dl></dd></dl></dd><dt>format and syntax</dt><dd><dl><dt>printf(), <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt><dt>SystemTap handler constructs</dt><dd><dl><dt>handlers, <a class="indexterm" href="scriptconstructions.html#variablesconstructs">Variables</a></dt></dl></dd><dt>SystemTap scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd></dl></dd><dt>format specifiers</dt><dd><dl><dt>printf(), <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt></dl></dd><dt>format strings</dt><dd><dl><dt>printf(), <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt></dl></dd><dt>function call (unresolved)</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>function calls (incoming/outgoing), tracing</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>function calls, tallying</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="mainsect-profiling.html#countcallssect">Counting Function Calls Made</a></dt></dl></dd><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt><dd><dl><dt>cpu(), <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt><dt>ctime(), <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt><dt>gettimeofday_s(), <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt><dt>pp(), <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt><dt>SystemTap scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd><dt>target(), <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt><dt>thread_indent(), <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt><dt>tid(), <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt><dt>uid(), <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt></dl></dd><dt>functions (used in handlers)</dt><dd><dl><dt>exit(), <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt></dl></dd><dt>functions called in network socket code, tracing</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#sockettracesect">Tracing Functions Called in Network Socket Code</a></dt></dl></dd><dt>futex (lock) contentions</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt></dl></dd><dt>futex contention, definition</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt></dl></dd><dt>futex contentions, identifying</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt></dl></dd><dt>futex system call</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>G</h3><dl><dt>gettimeofday_s()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt></dl></dd><dt>global</dt><dd><dl><dt>SystemTap handler constructs</dt><dd><dl><dt>handlers, <a class="indexterm" href="scriptconstructions.html#variablesconstructs">Variables</a></dt></dl></dd></dl></dd><dt>goals, documentation</dt><dd><dl><dt>Introduction, <a class="indexterm" href="introduction.html#goals">Documentation Goals</a></dt></dl></dd><dt>grammatical/typographical script error</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>guru mode</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>H</h3><dl><dt>handler functions, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt><dt>handlers</dt><dd><dl><dt>conditional statements, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt><dd><dl><dt>conditional operators, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt><dt>for loops, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt><dt>if/else, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt><dt>while loops, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt></dl></dd><dt>introduction, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt><dt>SystemTap handler constructs, <a class="indexterm" href="scriptconstructions.html">Basic SystemTap Handler Constructs</a></dt><dd><dl><dt>command-line arguments, <a class="indexterm" href="commandlineargssect.html">Command-Line Arguments</a></dt><dt>global, <a class="indexterm" href="scriptconstructions.html#variablesconstructs">Variables</a></dt><dt>syntax and format, <a class="indexterm" href="scriptconstructions.html">Basic SystemTap Handler Constructs</a></dt><dt>variable notations, <a class="indexterm" href="commandlineargssect.html">Command-Line Arguments</a></dt><dt>variables, <a class="indexterm" href="scriptconstructions.html#variablesconstructs">Variables</a></dt></dl></dd><dt>target variables, <a class="indexterm" href="targetvariables.html">Target Variables</a></dt></dl></dd><dt>handlers and events, <a class="indexterm" href="understanding-how-systemtap-works.html">Understanding How SystemTap Works</a></dt><dd><dl><dt>SystemTap scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd></dl></dd><dt>heaviest disk reads/writes, identifying</dt><dd><dl><dt>script examples, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt></dl></dd><dt>host system</dt><dd><dl><dt>cross-instrumentation, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></dd><dt>host system and target system</dt><dd><dl><dt>cross-instrumentation</dt><dd><dl><dt>configuration, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>I</h3><dl><dt>I/O block time, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="ioblktimesect.html">Periodically Print I/O Block Time</a></dt></dl></dd><dt>I/O monitoring (by device)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt></dl></dd><dt>I/O time, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="iotimesect.html">Tracking I/O Time For Each File Read or Write</a></dt></dl></dd><dt>I/O traffic, summarizing</dt><dd><dl><dt>script examples, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt></dl></dd><dt>identifier type mismatch</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>identifying contended user-space locks (i.e. futex contentions)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt></dl></dd><dt>identifying heaviest disk reads/writes</dt><dd><dl><dt>script examples, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt></dl></dd><dt>if/else</dt><dd><dl><dt>conditional statements</dt><dd><dl><dt>handlers, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt></dl></dd></dl></dd><dt>if/else conditionals, alternative syntax</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#nettopsect">Network Profiling</a></dt></dl></dd><dt>if/else statements, using arrays in</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt></dl></dd><dt>incoming TCP connections, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#tcpconnectionssect">Monitoring Incoming TCP Connections</a></dt></dl></dd><dt>incoming/outgoing function calls, tracing</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>incrementing associated values</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-increment.html">Incrementing Associated Values</a></dt><dd><dl><dt>tallying virtual file system reads (VFS reads), <a class="indexterm" href="arrayops-increment.html">Incrementing Associated Values</a></dt></dl></dd></dl></dd><dt>index expression</dt><dd><dl><dt>introduction</dt><dd><dl><dt>arrays, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt></dl></dd></dl></dd><dt>initial testing, <a class="indexterm" href="using-systemtap.html#testing">Initial Testing</a></dt><dt>inode number</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt></dl></dd><dt>Installation</dt><dd><dl><dt>initial testing, <a class="indexterm" href="using-systemtap.html#testing">Initial Testing</a></dt><dt>kernel information packages, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information RPMs</a></dt><dt>kernel version, determining the, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information RPMs</a></dt><dt>required packages, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information RPMs</a></dt><dt>Setup and Installation, <a class="indexterm" href="using-systemtap.html#using-setup">Installation and Setup</a></dt><dt>systemtap package, <a class="indexterm" href="using-systemtap.html#installproper">Installing SystemTap</a></dt><dt>systemtap-runtime package, <a class="indexterm" href="using-systemtap.html#installproper">Installing SystemTap</a></dt></dl></dd><dt>instrumentation module</dt><dd><dl><dt>cross-instrumentation, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></dd><dt>instrumentation modules from SystemTap scripts, building, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>integer extractors</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd><dt>Introduction</dt><dd><dl><dt>capabilities of SystemTap, <a class="indexterm" href="intro-systemtap-vs-others.html">SystemTap Capabilities</a></dt><dt>documentation goals, <a class="indexterm" href="introduction.html#goals">Documentation Goals</a></dt><dt>goals, documentation, <a class="indexterm" href="introduction.html#goals">Documentation Goals</a></dt><dt>limitations of SystemTap, <a class="indexterm" href="intro-systemtap-vs-others.html">SystemTap Capabilities</a></dt><dt>performance monitoring, <a class="indexterm" href="introduction.html">Introduction</a></dt></dl></dd><dt>invalid division</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt></dl></dd></dl></dd><dt>invalid values to variables/arrays</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>iterations, processing elements in an array as</dt><dd><dl><dt>processing multiple elements in an array</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>K</h3><dl><dt>kernel and user space, determining time spent in</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt></dl></dd><dt>kernel information packages, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information RPMs</a></dt><dt>kernel modules from SystemTap scripts, building, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>kernel version, determining the, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information RPMs</a></dt><dt>kernel.function("function")</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>kernel.trace("tracepoint")</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>key pairs</dt><dd><dl><dt>introduction</dt><dd><dl><dt>arrays, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>L</h3><dl><dt>libdwfl failure</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>limitations of SystemTap</dt><dd><dl><dt>Introduction, <a class="indexterm" href="intro-systemtap-vs-others.html">SystemTap Capabilities</a></dt></dl></dd><dt>limiting the output of foreach</dt><dd><dl><dt>processing multiple elements in an array</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd></dl></dd><dt>local variables</dt><dd><dl><dt>name, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt><dt>sample usage</dt><dd><dl><dt>$count, <a class="indexterm" href="iotimesect.html">Tracking I/O Time For Each File Read or Write</a></dt><dt>$return, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a>, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>M</h3><dl><dt>MAXACTION exceeded</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt></dl></dd></dl></dd><dt>MAXNESTING exceeded</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt></dl></dd></dl></dd><dt>membership (in array), testing for</dt><dd><dl><dt>conditional statements, using arrays in</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt></dl></dd></dl></dd><dt>module("module")</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>monitoring changes to file attributes</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatch2sect.html">Monitoring Changes to File Attributes</a></dt></dl></dd><dt>monitoring cumulative I/O</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt></dl></dd><dt>monitoring device I/O</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt></dl></dd><dt>monitoring I/O block time</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="ioblktimesect.html">Periodically Print I/O Block Time</a></dt></dl></dd><dt>monitoring I/O time</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="iotimesect.html">Tracking I/O Time For Each File Read or Write</a></dt></dl></dd><dt>monitoring incoming TCP connections</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#tcpconnectionssect">Monitoring Incoming TCP Connections</a></dt></dl></dd><dt>monitoring polling applications</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="timeoutssect.html">Monitoring Polling Applications</a></dt></dl></dd><dt>monitoring reads and writes to a file</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt></dl></dd><dt>monitoring system calls</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="topsyssect.html">Tracking Most Frequently Used System Calls</a></dt></dl></dd><dt>monitoring system calls (volume per process)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="syscallsbyprocpidsect.html">Tracking System Call Volume Per Process</a></dt></dl></dd><dt>monitoring TCP packets</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#tcpdumplikesect">Monitoring TCP Packets</a></dt></dl></dd><dt>multiple array operations within the same probe</dt><dd><dl><dt>clearing arrays/array elements</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt></dl></dd></dl></dd><dt>multiple command-line arguments, example of</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>multiple elements in an array</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>N</h3><dl><dt>name</dt><dd><dl><dt>local variables, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt></dl></dd><dt>net/socket.c, tracing functions from</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#sockettracesect">Tracing Functions Called in Network Socket Code</a></dt></dl></dd><dt>network profiling</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#nettopsect">Network Profiling</a>, <a class="indexterm" href="useful-systemtap-scripts.html#dropwatchsect">Monitoring Network Packets Drops in Kernel</a></dt></dl></dd><dt>network socket code, tracing functions called in</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#sockettracesect">Tracing Functions Called in Network Socket Code</a></dt></dl></dd><dt>network traffic, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#nettopsect">Network Profiling</a>, <a class="indexterm" href="useful-systemtap-scripts.html#dropwatchsect">Monitoring Network Packets Drops in Kernel</a></dt></dl></dd><dt>no match for probe point</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>non-global arrays</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>number of errors: N, skipped probes: M</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>O</h3><dl><dt>operations</dt><dd><dl><dt>assigning associated values</dt><dd><dl><dt>associating timestamps to process names, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt></dl></dd><dt>associative arrays, <a class="indexterm" href="arrayoperators.html">Array Operations in SystemTap</a></dt><dt>clearing arrays/array elements, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dd><dl><dt>delete operator, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dt>multiple array operations within the same probe, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dt>virtual file system reads (non-cumulative), tallying, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt></dl></dd><dt>computing for statistical aggregates, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dd><dl><dt>@avg (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@count (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@max (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@min (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@sum (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>adding values to statistical aggregates, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>count (operator), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>extracting data collected by statistical aggregates, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd><dt>conditional statements, using arrays in, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt><dd><dl><dt>testing for array membership, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt></dl></dd><dt>deleting arrays and array elements, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dt>incrementing associated values, <a class="indexterm" href="arrayops-increment.html">Incrementing Associated Values</a></dt><dd><dl><dt>tallying virtual file system reads (VFS reads), <a class="indexterm" href="arrayops-increment.html">Incrementing Associated Values</a></dt></dl></dd><dt>multiple elements in an array, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>processing multiple elements in an array, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dd><dl><dt>cumulative virtual file system reads, tallying, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>foreach, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>iterations, processing elements in an array as, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>limiting the output of foreach, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>ordering the output of foreach, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd><dt>reading values from arrays, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt><dd><dl><dt>computing for timestamp deltas, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt><dt>empty unique keys, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt><dt>using arrays in simple computations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd></dl></dd><dt>options, stap</dt><dd><dl><dt>Usage, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt></dl></dd><dt>ordering the output of foreach</dt><dd><dl><dt>processing multiple elements in an array</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd></dl></dd><dt>overflow of aggregation</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>P</h3><dl><dt>packages required to run SystemTap, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information RPMs</a></dt><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dd><dl><dt>embedded code in unprivileged script, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>expected symbol/array index expression, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>grammatical/typographical script error, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>guru mode, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>invalid values to variables/arrays, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>libdwfl failure, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>no match for probe point, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>non-global arrays, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>probe mismatch, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>type mismatch for identifier, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved function call, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved target-symbol expression, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved type for identifier, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>variable modified during 'foreach', <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>performance monitoring</dt><dd><dl><dt>Introduction, <a class="indexterm" href="introduction.html">Introduction</a></dt></dl></dd><dt>pointer dereference fault</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt></dl></dd></dl></dd><dt>polling applications, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="timeoutssect.html">Monitoring Polling Applications</a></dt></dl></dd><dt>pp()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt></dl></dd><dt>printf()</dt><dd><dl><dt>format specifiers, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt><dt>format strings, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt><dt>syntax and format, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt></dl></dd><dt>printing I/O activity (cumulative)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt></dl></dd><dt>printing I/O block time (periodically)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="ioblktimesect.html">Periodically Print I/O Block Time</a></dt></dl></dd><dt>probe mismatch</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>probe point (no match for)</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>probes</dt><dd><dl><dt>SystemTap scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd></dl></dd><dt>processing multiple elements in an array</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>cumulative virtual file system reads, tallying</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd><dt>foreach</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd><dt>limiting the output of foreach</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd><dt>ordering the output of foreach</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd></dl></dd><dt>profiling the network</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#nettopsect">Network Profiling</a>, <a class="indexterm" href="useful-systemtap-scripts.html#dropwatchsect">Monitoring Network Packets Drops in Kernel</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>R</h3><dl><dt>reading values from arrays</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt><dd><dl><dt>empty unique keys, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt><dt>using arrays in simple computations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd><dt>computing for timestamp deltas</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd></dl></dd><dt>reads/writes to a file, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt></dl></dd><dt>required packages, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information RPMs</a></dt><dt>RPMs required to run SystemTap, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information RPMs</a></dt><dt>running scripts from standard input, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>running SystemTap scripts</dt><dd><dl><dt>Usage, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt></dl></dd><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dd><dl><dt>aggregate element not found, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>aggregation overflow, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>copy fault, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>division by 0, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>MAXACTION exceeded, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>MAXNESTING exceeded, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>number of errors: N, skipped probes: M, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>pointer dereference fault, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>S</h3><dl><dt>script examples</dt><dd><dl><dt>call graph tracing, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt><dt>CPU ticks, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt><dt>ctime(), example of usage, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt><dt>determining time spent in kernel and user space, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt><dt>file device number (integer format), <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt><dt>futex (lock) contentions, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt><dt>futex system call, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt><dt>identifying contended user-space locks (i.e. futex contentions), <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt><dt>if/else conditionals, alternative syntax, <a class="indexterm" href="useful-systemtap-scripts.html#nettopsect">Network Profiling</a></dt><dt>inode number, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt><dt>monitoring changes to file attributes, <a class="indexterm" href="inodewatch2sect.html">Monitoring Changes to File Attributes</a></dt><dt>monitoring device I/O, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt><dt>monitoring I/O block time, <a class="indexterm" href="ioblktimesect.html">Periodically Print I/O Block Time</a></dt><dt>monitoring I/O time, <a class="indexterm" href="iotimesect.html">Tracking I/O Time For Each File Read or Write</a></dt><dt>monitoring incoming TCP connections, <a class="indexterm" href="useful-systemtap-scripts.html#tcpconnectionssect">Monitoring Incoming TCP Connections</a></dt><dt>monitoring polling applications, <a class="indexterm" href="timeoutssect.html">Monitoring Polling Applications</a></dt><dt>monitoring reads and writes to a file, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt><dt>monitoring system calls, <a class="indexterm" href="topsyssect.html">Tracking Most Frequently Used System Calls</a></dt><dt>monitoring system calls (volume per process), <a class="indexterm" href="syscallsbyprocpidsect.html">Tracking System Call Volume Per Process</a></dt><dt>monitoring TCP packets, <a class="indexterm" href="useful-systemtap-scripts.html#tcpdumplikesect">Monitoring TCP Packets</a></dt><dt>multiple command-line arguments, example of, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt><dt>net/socket.c, tracing functions from, <a class="indexterm" href="useful-systemtap-scripts.html#sockettracesect">Tracing Functions Called in Network Socket Code</a></dt><dt>network profiling, <a class="indexterm" href="useful-systemtap-scripts.html#nettopsect">Network Profiling</a>, <a class="indexterm" href="useful-systemtap-scripts.html#dropwatchsect">Monitoring Network Packets Drops in Kernel</a></dt><dt>stat -c, determining file device number (integer format), <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt><dt>stat -c, determining whole device number, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt><dt>summarizing disk I/O traffic, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt><dt>tallying function calls, <a class="indexterm" href="mainsect-profiling.html#countcallssect">Counting Function Calls Made</a></dt><dt>thread_indent(), sample usage, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt><dt>timer.ms(), sample usage, <a class="indexterm" href="mainsect-profiling.html#countcallssect">Counting Function Calls Made</a></dt><dt>timer.s(), sample usage, <a class="indexterm" href="timeoutssect.html">Monitoring Polling Applications</a>, <a class="indexterm" href="topsyssect.html">Tracking Most Frequently Used System Calls</a></dt><dt>tracing functions called in network socket code, <a class="indexterm" href="useful-systemtap-scripts.html#sockettracesect">Tracing Functions Called in Network Socket Code</a></dt><dt>tracking cumulative I/O, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt><dt>trigger function, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt><dt>usrdev2kerndev(), <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt><dt>whole device number (usage as a command-line argument), <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt></dl></dd><dt>scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dd><dl><dt>components, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>events and handlers, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>format and syntax, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>functions, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>probes, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>statement blocks, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd></dl></dd><dt>sessions, SystemTap, <a class="indexterm" href="understanding-how-systemtap-works.html#understanding-architecture-tools">Architecture</a></dt><dt>Setup and Installation, <a class="indexterm" href="using-systemtap.html#using-setup">Installation and Setup</a></dt><dt>Stack backtrace</dt><dd><dl><dt>user-space, <a class="indexterm" href="ustack.html">User-Space Stack Backtraces</a></dt></dl></dd><dt>standard input, running scripts from</dt><dd><dl><dt>Usage, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt></dl></dd><dt>stap</dt><dd><dl><dt>Usage, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt></dl></dd><dt>stap options, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>stapdev</dt><dd><dl><dt>Usage, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt></dl></dd><dt>staprun</dt><dd><dl><dt>Usage, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt></dl></dd><dt>stapusr</dt><dd><dl><dt>Usage, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt></dl></dd><dt>stat -c, determining file device number (integer format)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt></dl></dd><dt>stat -c, determining whole device number</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt></dl></dd><dt>statement blocks</dt><dd><dl><dt>SystemTap scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd></dl></dd><dt>statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd><dt>summarizing disk I/O traffic</dt><dd><dl><dt>script examples, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt></dl></dd><dt>synchronous events</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>syntax</dt><dd><dl><dt>introduction</dt><dd><dl><dt>arrays, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt></dl></dd></dl></dd><dt>syntax and format</dt><dd><dl><dt>printf(), <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt><dt>SystemTap handler constructs</dt><dd><dl><dt>handlers, <a class="indexterm" href="scriptconstructions.html">Basic SystemTap Handler Constructs</a></dt></dl></dd><dt>SystemTap scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd></dl></dd><dt>syscall.system_call</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>system calls volume (per process), monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="syscallsbyprocpidsect.html">Tracking System Call Volume Per Process</a></dt></dl></dd><dt>system calls, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="topsyssect.html">Tracking Most Frequently Used System Calls</a></dt></dl></dd><dt>SystemTap architecture, <a class="indexterm" href="understanding-how-systemtap-works.html#understanding-architecture-tools">Architecture</a></dt><dt>SystemTap handlers</dt><dd><dl><dt>SystemTap handler constructs, <a class="indexterm" href="scriptconstructions.html">Basic SystemTap Handler Constructs</a></dt><dd><dl><dt>syntax and format, <a class="indexterm" href="scriptconstructions.html">Basic SystemTap Handler Constructs</a></dt></dl></dd></dl></dd><dt>systemtap package, <a class="indexterm" href="using-systemtap.html#installproper">Installing SystemTap</a></dt><dt>SystemTap script functions, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt><dt>SystemTap scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dd><dl><dt>components, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>events and handlers, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>format and syntax, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>functions, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>probes, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>statement blocks, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd><dt>useful examples, <a class="indexterm" href="useful-systemtap-scripts.html">Useful SystemTap Scripts</a></dt></dl></dd><dt>SystemTap scripts, how to run, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>SystemTap sessions, <a class="indexterm" href="understanding-how-systemtap-works.html#understanding-architecture-tools">Architecture</a></dt><dt>SystemTap statements</dt><dd><dl><dt>conditional statements, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt><dd><dl><dt>conditional operators, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt><dt>for loops, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt><dt>if/else, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt><dt>while loops, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt></dl></dd><dt>SystemTap handler constructs</dt><dd><dl><dt>command-line arguments, <a class="indexterm" href="commandlineargssect.html">Command-Line Arguments</a></dt><dt>global, <a class="indexterm" href="scriptconstructions.html#variablesconstructs">Variables</a></dt><dt>variable notations, <a class="indexterm" href="commandlineargssect.html">Command-Line Arguments</a></dt><dt>variables, <a class="indexterm" href="scriptconstructions.html#variablesconstructs">Variables</a></dt></dl></dd></dl></dd><dt>systemtap-runtime package, <a class="indexterm" href="using-systemtap.html#installproper">Installing SystemTap</a></dt><dt>systemtap-testsuite package</dt><dd><dl><dt>sample scripts, <a class="indexterm" href="useful-systemtap-scripts.html">Useful SystemTap Scripts</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>T</h3><dl><dt>tallying function calls</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="mainsect-profiling.html#countcallssect">Counting Function Calls Made</a></dt></dl></dd><dt>tallying virtual file system reads (VFS reads)</dt><dd><dl><dt>incrementing associated values</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-increment.html">Incrementing Associated Values</a></dt></dl></dd></dl></dd><dt>Tapsets</dt><dd><dl><dt>definition of, <a class="indexterm" href="understanding-tapsets.html">Tapsets</a></dt></dl></dd><dt>target kernel</dt><dd><dl><dt>cross-instrumentation, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></dd><dt>target system</dt><dd><dl><dt>cross-instrumentation, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></dd><dt>target system and host system</dt><dd><dl><dt>configuration, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></dd><dt>target variables, <a class="indexterm" href="targetvariables.html">Target Variables</a></dt><dd><dl><dt>pretty printing, <a class="indexterm" href="targetvariables.html#targetprettyprinting">Pretty Printing Target Variables</a></dt><dt>typecasting, <a class="indexterm" href="typecasting.html">Typecasting</a></dt><dt>user-space, <a class="indexterm" href="utargetvariable.html">Accessing User-Space Target Variables</a></dt><dt>variable availability, <a class="indexterm" href="targetavailable.html">Checking Target Variable Availablility</a></dt></dl></dd><dt>target()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt></dl></dd><dt>target-symbol expression, unresolved</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>TCP connections (incoming), monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#tcpconnectionssect">Monitoring Incoming TCP Connections</a></dt></dl></dd><dt>TCP packets, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#tcpdumplikesect">Monitoring TCP Packets</a></dt></dl></dd><dt>testing for array membership</dt><dd><dl><dt>conditional statements, using arrays in</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt></dl></dd></dl></dd><dt>testing, initial, <a class="indexterm" href="using-systemtap.html#testing">Initial Testing</a></dt><dt>thread_indent()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt></dl></dd><dt>thread_indent(), sample usage</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>tid()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt></dl></dd><dt>time of I/O </dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="iotimesect.html">Tracking I/O Time For Each File Read or Write</a></dt></dl></dd><dt>time spent in kernel/user space, determining</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt></dl></dd><dt>timer events</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>timer.ms(), sample usage</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="mainsect-profiling.html#countcallssect">Counting Function Calls Made</a></dt></dl></dd><dt>timer.s(), sample usage</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="timeoutssect.html">Monitoring Polling Applications</a>, <a class="indexterm" href="topsyssect.html">Tracking Most Frequently Used System Calls</a></dt></dl></dd><dt>timestamp deltas, computing for</dt><dd><dl><dt>reading values from arrays</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd></dl></dd><dt>timestamps, association thereof to process names</dt><dd><dl><dt>assigning associated values</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt></dl></dd></dl></dd><dt>tracepoint, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a>, <a class="indexterm" href="useful-systemtap-scripts.html#dropwatchsect">Monitoring Network Packets Drops in Kernel</a></dt><dt>tracing call graph</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>tracing functions called in network socket code</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#sockettracesect">Tracing Functions Called in Network Socket Code</a></dt></dl></dd><dt>tracing incoming/outgoing function calls</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>tracking cumulative I/O</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt></dl></dd><dt>trigger function</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>type mismatch for identifier</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>typographical script error</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>U</h3><dl><dt>uid()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt></dl></dd><dt>uname -m, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>uname -r, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information RPMs</a></dt><dt>understainding SystemTap errors</dt><dd><dl><dt>runtime errors/warnings, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dd><dl><dt>aggregate element not found, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>aggregation overflow, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>copy fault, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>division by 0, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>MAXACTION exceeded, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>MAXNESTING exceeded, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>number of errors: N, skipped probes: M, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt><dt>pointer dereference fault, <a class="indexterm" href="runtimeerror.html">Run Time Errors and Warnings</a></dt></dl></dd></dl></dd><dt>Understanding How SystemTap Works, <a class="indexterm" href="understanding-how-systemtap-works.html">Understanding How SystemTap Works</a></dt><dd><dl><dt>architecture, <a class="indexterm" href="understanding-how-systemtap-works.html#understanding-architecture-tools">Architecture</a></dt><dt>event types, <a class="indexterm" href="understanding-how-systemtap-works.html">Understanding How SystemTap Works</a></dt><dt>events and handlers, <a class="indexterm" href="understanding-how-systemtap-works.html">Understanding How SystemTap Works</a></dt><dt>SystemTap sessions, <a class="indexterm" href="understanding-how-systemtap-works.html#understanding-architecture-tools">Architecture</a></dt></dl></dd><dt>understanding SystemTap errors</dt><dd><dl><dt>parse/semantics error, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dd><dl><dt>embedded code in unprivileged script, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>expected symbol/array index expression, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>grammatical/typographical script error, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>guru mode, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>invalid values to variables/arrays, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>libdwfl failure, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>no match for probe point, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>non-global arrays, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>probe mismatch, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>type mismatch for identifier, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved function call, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved target-symbol expression, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved type for identifier, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>variable modified during 'foreach', <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>unique keys</dt><dd><dl><dt>introduction</dt><dd><dl><dt>arrays, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt></dl></dd></dl></dd><dt>unprivileged script, embedded code in</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>unresolved function call</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>unresolved target-symbol expression</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>unresolved type for identifier</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>unsafe embedded code in unprivileged script</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>Usage</dt><dd><dl><dt>options, stap, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>running SystemTap scripts, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>standard input, running scripts from, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>stap, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>stapdev, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>staprun, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>stapusr, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt></dl></dd><dt>useful examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html">Useful SystemTap Scripts</a></dt><dt>user and kernel space, determining time spent in</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt></dl></dd><dt>using arrays in simple computations</dt><dd><dl><dt>reading values from arrays</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd></dl></dd><dt>Using SystemTap, <a class="indexterm" href="using-systemtap.html">Using SystemTap</a></dt><dt>usrdev2kerndev()</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>V</h3><dl><dt>values, assignment of</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt></dl></dd><dt>variable modified during 'foreach'</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>variable notations</dt><dd><dl><dt>SystemTap handler constructs</dt><dd><dl><dt>handlers, <a class="indexterm" href="commandlineargssect.html">Command-Line Arguments</a></dt></dl></dd></dl></dd><dt>variables</dt><dd><dl><dt>SystemTap handler constructs</dt><dd><dl><dt>handlers, <a class="indexterm" href="scriptconstructions.html#variablesconstructs">Variables</a></dt></dl></dd></dl></dd><dt>variables (local)</dt><dd><dl><dt>name, <a class="indexterm" href="systemtapscript-handler.html">Systemtap Handler/Body</a></dt><dt>sample usage</dt><dd><dl><dt>$count, <a class="indexterm" href="iotimesect.html">Tracking I/O Time For Each File Read or Write</a></dt><dt>$return, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a>, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt></dl></dd></dl></dd><dt>VFS reads, tallying of</dt><dd><dl><dt>incrementing associated values</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-increment.html">Incrementing Associated Values</a></dt></dl></dd></dl></dd><dt>vfs.file_operation</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>virtual file system reads (cumulative), tallying</dt><dd><dl><dt>processing multiple elements in an array</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd></dl></dd><dt>virtual file system reads (non-cumulative), tallying</dt><dd><dl><dt>clearing arrays/array elements</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>W</h3><dl><dt>while loops</dt><dd><dl><dt>conditional statements</dt><dd><dl><dt>handlers, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt></dl></dd></dl></dd><dt>whole device number (usage as a command-line argument)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt></dl></dd><dt>wildcards in events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>writes/reads to a file, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt></dl></dd></dl></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="appe-Publican-Revision_History.html"><strong>Prev</strong>Appendix A. Revision History</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li></ul></body></html>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">Index</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="appe-Publican-Revision_History.html" title="Appendix A. Revision History" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="appe-Publican-Revision_History.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"></li></ul><div class="index"><div class="titlepage"><div><div><h1 class="title"><a id="idm246876658656"></a>Index</h1></div></div></div><div class="index"><div class="indexdiv"><h3>Symbols</h3><dl><dt>$count</dt><dd><dl><dt>sample usage</dt><dd><dl><dt>local variables, <a class="indexterm" href="iotimesect.html">Tracking I/O Time For Each File Read or Write</a></dt></dl></dd></dl></dd><dt>$return</dt><dd><dl><dt>sample usage</dt><dd><dl><dt>local variables, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a>, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt></dl></dd></dl></dd><dt>@avg (integer extractor)</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd><dt>@count (integer extractor)</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd><dt>@max (integer extractor)</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd><dt>@min (integer extractor)</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd><dt>@sum (integer extractor)</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>A</h3><dl><dt>adding values to statistical aggregates</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd><dt>advantages of cross-instrumentation, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>aggregate element not found</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt></dl></dd></dl></dd><dt>aggregates (statistical)</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd><dt>aggregation overflow</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt></dl></dd></dl></dd><dt>algebraic formulas using arrays</dt><dd><dl><dt>reading values from arrays</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd></dl></dd><dt>architecture notation, determining, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>architecture of SystemTap, <a class="indexterm" href="understanding-how-systemtap-works.html#understanding-architecture-tools">Architecture</a></dt><dt>array locals not supported</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>array operations</dt><dd><dl><dt>assigning associated values, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt><dd><dl><dt>associating timestamps to process names, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt></dl></dd><dt>associative arrays, <a class="indexterm" href="arrayoperators.html">Array Operations in SystemTap</a></dt><dt>clearing arrays/array elements, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dd><dl><dt>delete operator, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dt>multiple array operations within the same probe, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dt>virtual file system reads (non-cumulative), tallying, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt></dl></dd><dt>computing for statistical aggregates, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dd><dl><dt>@avg (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@count (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@max (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@min (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@sum (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>adding values to statistical aggregates, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>count (operator), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>extracting data collected by statistical aggregates, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd><dt>conditional statements, using arrays in, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt><dd><dl><dt>testing for array membership, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt></dl></dd><dt>deleting arrays and array elements, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dt>incrementing associated values, <a class="indexterm" href="arrayops-increment.html">Incrementing Associated Values</a></dt><dd><dl><dt>tallying virtual file system reads (VFS reads), <a class="indexterm" href="arrayops-increment.html">Incrementing Associated Values</a></dt></dl></dd><dt>multiple elements in an array, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>processing multiple elements in an array, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dd><dl><dt>cumulative virtual file system reads, tallying, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>foreach, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>iterations, processing elements in an array as, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>limiting the output of foreach, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>ordering the output of foreach, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd><dt>reading values from arrays, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt><dd><dl><dt>computing for timestamp deltas, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt><dt>empty unique keys, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt><dt>using arrays in simple computations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd></dl></dd><dt>arrays, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt><dd><dl><dt>(see also associative arrays)</dt></dl></dd><dt>assigning associated values</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt><dd><dl><dt>associating timestamps to process names, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt></dl></dd><dt>associating timestamps to process names</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt></dl></dd></dl></dd><dt>associated values</dt><dd><dl><dt>introduction</dt><dd><dl><dt>arrays, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt></dl></dd></dl></dd><dt>associating timestamps to process names</dt><dd><dl><dt>assigning associated values</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt></dl></dd></dl></dd><dt>associative arrays</dt><dd><dl><dt>introduction, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt><dd><dl><dt>associated values, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt><dt>example, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt><dt>index expression, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt><dt>key pairs, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt><dt>syntax, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt><dt>unique keys, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt></dl></dd></dl></dd><dt>asynchronous events</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>B</h3><dl><dt>begin</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>building instrumentation modules from SystemTap scripts, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>building kernel modules from SystemTap scripts, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></div><div class="indexdiv"><h3>C</h3><dl><dt>call graph tracing</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>capabilities of SystemTap</dt><dd><dl><dt>Introduction, <a class="indexterm" href="intro-systemtap-vs-others.html">SystemTap Capabilities</a></dt></dl></dd><dt>changes to file attributes, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatch2sect.html">Monitoring Changes to File Attributes</a></dt></dl></dd><dt>clearing arrays/array elements</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dd><dl><dt>delete operator, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dt>multiple array operations within the same probe, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dt>virtual file system reads (non-cumulative), tallying, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt></dl></dd></dl></dd><dt>command-line arguments</dt><dd><dl><dt>SystemTap handler constructs</dt><dd><dl><dt>handlers, <a class="indexterm" href="commandlineargssect.html">Command-Line Arguments</a></dt></dl></dd></dl></dd><dt>compiling instrumentation/kernel modules from SystemTap scripts, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>components</dt><dd><dl><dt>SystemTap scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd></dl></dd><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dd><dl><dt>@avg (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@count (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@max (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@min (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@sum (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>adding values to statistical aggregates, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>count (operator), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>extracting data collected by statistical aggregates, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd><dt>computing for timestamp deltas</dt><dd><dl><dt>reading values from arrays</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd></dl></dd><dt>conditional operators</dt><dd><dl><dt>conditional statements</dt><dd><dl><dt>handlers, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt></dl></dd></dl></dd><dt>conditional statements, using arrays in</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt><dd><dl><dt>testing for array membership, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt></dl></dd></dl></dd><dt>CONFIG_HZ, computing for, <a class="indexterm" href="scriptconstructions.html#variablesconstructs">Variables</a></dt><dt>contended user-space locks (futex contentions), identifying</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt></dl></dd><dt>copy fault</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt></dl></dd></dl></dd><dt>count operator</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array (operator), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd><dt>counting function calls</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="mainsect-profiling.html#countcallssect">Counting Function Calls Made</a></dt></dl></dd><dt>CPU ticks</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt></dl></dd><dt>cpu()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt></dl></dd><dt>cross-compiling, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>cross-instrumentation</dt><dd><dl><dt>advantages of, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>building kernel modules from SystemTap scripts, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>configuration</dt><dd><dl><dt>host system and target system, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></dd><dt>generating instrumentation from SystemTap scripts, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>host system, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>instrumentation module, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>target kernel, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>target system, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></dd><dt>ctime()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt></dl></dd><dt>ctime(), example of usage</dt><dd><dl><dt>script examples, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt></dl></dd><dt>cumulative I/O, tracking</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt></dl></dd><dt>cumulative virtual file system reads, tallying</dt><dd><dl><dt>processing multiple elements in an array</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>D</h3><dl><dt>delete operator</dt><dd><dl><dt>clearing arrays/array elements</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt></dl></dd></dl></dd><dt>determining architecture notation, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>determining the kernel version, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information Packages Manually</a></dt><dt>determining time spent in kernel and user space</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt></dl></dd><dt>device I/O, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt></dl></dd><dt>device number of a file (integer format)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt></dl></dd><dt>disk I/O traffic, summarizing</dt><dd><dl><dt>script examples, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt></dl></dd><dt>division by 0</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt></dl></dd></dl></dd><dt>documentation goals</dt><dd><dl><dt>Introduction, <a class="indexterm" href="introduction.html#goals">Documentation Goals</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>E</h3><dl><dt>embedded code in unprivileged script</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>empty unique keys</dt><dd><dl><dt>reading values from arrays</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd></dl></dd><dt>end</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>errors</dt><dd><dl><dt>parse/semantics error, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dd><dl><dt>embedded code in unprivileged script, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>expected symbol/array index expression, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>grammatical/typographical script error, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>guru mode, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>invalid values to variables/arrays, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>libdwfl failure, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>no match for probe point, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>non-global arrays, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>probe mismatch, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>type mismatch for identifier, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved function call, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved target-symbol expression, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved type for identifier, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>variable modified during 'foreach', <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd><dt>runtime errors/warnings, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dd><dl><dt>aggregate element not found, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>aggregation overflow, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>copy fault, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>division by 0, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>MAXACTION exceeded, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>MAXNESTING exceeded, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>number of errors: N, skipped probes: M, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>pointer dereference fault, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt></dl></dd></dl></dd><dt>event types</dt><dd><dl><dt>Understanding How SystemTap Works, <a class="indexterm" href="understanding-how-systemtap-works.html">Understanding How SystemTap Works</a></dt></dl></dd><dt>Events</dt><dd><dl><dt>asynchronous events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>begin, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>end, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>examples of synchronous and asynchronous events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>introduction, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>kernel.function("function"), <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>kernel.trace("tracepoint"), <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>module("module"), <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>synchronous events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>syscall.system_call, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>timer events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>user-space, <a class="indexterm" href="userspace-probing.html#uevents">User-Space Events</a></dt><dt>vfs.file_operation, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>wildcards, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>events and handlers, <a class="indexterm" href="understanding-how-systemtap-works.html">Understanding How SystemTap Works</a></dt><dt>events wildcards, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>example</dt><dd><dl><dt>introduction</dt><dd><dl><dt>arrays, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt></dl></dd></dl></dd><dt>example of multiple command-line arguments</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>examples of synchronous and asynchronous events</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html">Useful SystemTap Scripts</a></dt><dd><dl><dt>call graph tracing, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt><dt>CPU ticks, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt><dt>ctime(), example of usage, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt><dt>determining time spent in kernel and user space, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt><dt>file device number (integer format), <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt><dt>futex (lock) contentions, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt><dt>futex system call, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt><dt>identifying contended user-space locks (futex contentions), <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt><dt>if/else conditionals, alternative syntax, <a class="indexterm" href="useful-systemtap-scripts.html#nettopsect">Network Profiling</a></dt><dt>inode number, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt><dt>monitoring changes to file attributes, <a class="indexterm" href="inodewatch2sect.html">Monitoring Changes to File Attributes</a></dt><dt>monitoring device I/O, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt><dt>monitoring I/O block time, <a class="indexterm" href="ioblktimesect.html">Periodically Print I/O Block Time</a></dt><dt>monitoring I/O time, <a class="indexterm" href="iotimesect.html">Tracking I/O Time For Each File Read or Write</a></dt><dt>monitoring incoming TCP connections, <a class="indexterm" href="useful-systemtap-scripts.html#tcpconnectionssect">Monitoring Incoming TCP Connections</a></dt><dt>monitoring polling applications, <a class="indexterm" href="timeoutssect.html">Monitoring Polling Applications</a></dt><dt>monitoring reads and writes to a file, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt><dt>monitoring system calls, <a class="indexterm" href="topsyssect.html">Tracking Most Frequently Used System Calls</a></dt><dt>monitoring system calls (volume per process), <a class="indexterm" href="syscallsbyprocpidsect.html">Tracking System Call Volume Per Process</a></dt><dt>monitoring TCP packets, <a class="indexterm" href="useful-systemtap-scripts.html#tcpdumplikesect">Monitoring TCP Packets</a></dt><dt>multiple command-line arguments, example of, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt><dt>net/socket.c, tracing functions from, <a class="indexterm" href="useful-systemtap-scripts.html#sockettracesect">Tracing Functions Called in Network Socket Code</a></dt><dt>network profiling, <a class="indexterm" href="useful-systemtap-scripts.html#nettopsect">Network Profiling</a>, <a class="indexterm" href="useful-systemtap-scripts.html#dropwatchsect">Monitoring Network Packets Drops in Kernel</a></dt><dt>stat -c, determining file device number (integer format), <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt><dt>stat -c, determining whole device number, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt><dt>summarizing disk I/O traffic, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt><dt>tallying function calls, <a class="indexterm" href="mainsect-profiling.html#countcallssect">Counting Function Calls Made</a></dt><dt>thread_indent(), sample usage, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt><dt>timer.ms(), sample usage, <a class="indexterm" href="mainsect-profiling.html#countcallssect">Counting Function Calls Made</a></dt><dt>timer.s(), sample usage, <a class="indexterm" href="timeoutssect.html">Monitoring Polling Applications</a>, <a class="indexterm" href="topsyssect.html">Tracking Most Frequently Used System Calls</a></dt><dt>tracing functions called in network socket code, <a class="indexterm" href="useful-systemtap-scripts.html#sockettracesect">Tracing Functions Called in Network Socket Code</a></dt><dt>tracking cumulative I/O, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt><dt>trigger function, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt><dt>usrdev2kerndev(), <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt><dt>whole device number (usage as a command-line argument), <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt></dl></dd><dt>exceeded MAXACTION</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt></dl></dd></dl></dd><dt>exceeded MAXNESTING</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt></dl></dd></dl></dd><dt>exit()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt></dl></dd><dt>expected symbol/array index expression</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>extracting data collected by statistical aggregates</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>F</h3><dl><dt>feedback</dt><dd><dl><dt>contact information for this manual, <a class="indexterm" href="pr01s02.html">We Need Feedback!</a></dt></dl></dd><dt>file attributes, monitoring changes to</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatch2sect.html">Monitoring Changes to File Attributes</a></dt></dl></dd><dt>file device number (integer format)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt></dl></dd><dt>file reads/writes, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt></dl></dd><dt>flight recorder mode, <a class="indexterm" href="using-usage.html#flight-recorder">SystemTap Flight Recorder Mode</a></dt><dd><dl><dt>file mode, <a class="indexterm" href="using-usage.html#file-flight-recorder">File Flight Recorder</a></dt><dt>in-memory mode, <a class="indexterm" href="using-usage.html#memory-flight-recorder">In-memory Flight Recorder</a></dt></dl></dd><dt>for loops</dt><dd><dl><dt>conditional statements</dt><dd><dl><dt>handlers, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt></dl></dd></dl></dd><dt>foreach</dt><dd><dl><dt>processing multiple elements in an array</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd></dl></dd><dt>format</dt><dd><dl><dt>introduction</dt><dd><dl><dt>arrays, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt></dl></dd></dl></dd><dt>format and syntax</dt><dd><dl><dt>printf(), <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt><dt>SystemTap handler constructs</dt><dd><dl><dt>handlers, <a class="indexterm" href="scriptconstructions.html#variablesconstructs">Variables</a></dt></dl></dd><dt>SystemTap scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd></dl></dd><dt>format specifiers</dt><dd><dl><dt>printf(), <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt></dl></dd><dt>format strings</dt><dd><dl><dt>printf(), <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt></dl></dd><dt>function call (unresolved)</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>function calls (incoming/outgoing), tracing</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>function calls, tallying</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="mainsect-profiling.html#countcallssect">Counting Function Calls Made</a></dt></dl></dd><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt><dd><dl><dt>cpu(), <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt><dt>ctime(), <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt><dt>gettimeofday_s(), <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt><dt>pp(), <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt><dt>SystemTap scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd><dt>target(), <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt><dt>thread_indent(), <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt><dt>tid(), <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt><dt>uid(), <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt></dl></dd><dt>functions (used in handlers)</dt><dd><dl><dt>exit(), <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt></dl></dd><dt>functions called in network socket code, tracing</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#sockettracesect">Tracing Functions Called in Network Socket Code</a></dt></dl></dd><dt>futex (lock) contentions</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt></dl></dd><dt>futex contention, definition</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt></dl></dd><dt>futex contentions, identifying</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt></dl></dd><dt>futex system call</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>G</h3><dl><dt>gettimeofday_s()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt></dl></dd><dt>global</dt><dd><dl><dt>SystemTap handler constructs</dt><dd><dl><dt>handlers, <a class="indexterm" href="scriptconstructions.html#variablesconstructs">Variables</a></dt></dl></dd></dl></dd><dt>goals, documentation</dt><dd><dl><dt>Introduction, <a class="indexterm" href="introduction.html#goals">Documentation Goals</a></dt></dl></dd><dt>grammatical/typographical script error</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>guru mode</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>H</h3><dl><dt>handler functions, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt><dt>handlers</dt><dd><dl><dt>conditional statements, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt><dd><dl><dt>conditional operators, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt><dt>for loops, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt><dt>if/else, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt><dt>while loops, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt></dl></dd><dt>introduction, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt><dt>SystemTap handler constructs, <a class="indexterm" href="scriptconstructions.html">Basic SystemTap Handler Constructs</a></dt><dd><dl><dt>command-line arguments, <a class="indexterm" href="commandlineargssect.html">Command-Line Arguments</a></dt><dt>global, <a class="indexterm" href="scriptconstructions.html#variablesconstructs">Variables</a></dt><dt>syntax and format, <a class="indexterm" href="scriptconstructions.html">Basic SystemTap Handler Constructs</a></dt><dt>variable notations, <a class="indexterm" href="commandlineargssect.html">Command-Line Arguments</a></dt><dt>variables, <a class="indexterm" href="scriptconstructions.html#variablesconstructs">Variables</a></dt></dl></dd><dt>target variables, <a class="indexterm" href="targetvariables.html">Target Variables</a></dt></dl></dd><dt>handlers and events, <a class="indexterm" href="understanding-how-systemtap-works.html">Understanding How SystemTap Works</a></dt><dd><dl><dt>SystemTap scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd></dl></dd><dt>heaviest disk reads/writes, identifying</dt><dd><dl><dt>script examples, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt></dl></dd><dt>host system</dt><dd><dl><dt>cross-instrumentation, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></dd><dt>host system and target system</dt><dd><dl><dt>cross-instrumentation</dt><dd><dl><dt>configuration, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>I</h3><dl><dt>I/O block time, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="ioblktimesect.html">Periodically Print I/O Block Time</a></dt></dl></dd><dt>I/O monitoring (by device)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt></dl></dd><dt>I/O time, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="iotimesect.html">Tracking I/O Time For Each File Read or Write</a></dt></dl></dd><dt>I/O traffic, summarizing</dt><dd><dl><dt>script examples, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt></dl></dd><dt>identifier type mismatch</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>identifying contended user-space locks (futex contentions)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt></dl></dd><dt>identifying heaviest disk reads/writes</dt><dd><dl><dt>script examples, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt></dl></dd><dt>if/else</dt><dd><dl><dt>conditional statements</dt><dd><dl><dt>handlers, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt></dl></dd></dl></dd><dt>if/else conditionals, alternative syntax</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#nettopsect">Network Profiling</a></dt></dl></dd><dt>if/else statements, using arrays in</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt></dl></dd><dt>incoming TCP connections, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#tcpconnectionssect">Monitoring Incoming TCP Connections</a></dt></dl></dd><dt>incoming/outgoing function calls, tracing</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>incrementing associated values</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-increment.html">Incrementing Associated Values</a></dt><dd><dl><dt>tallying virtual file system reads (VFS reads), <a class="indexterm" href="arrayops-increment.html">Incrementing Associated Values</a></dt></dl></dd></dl></dd><dt>index expression</dt><dd><dl><dt>introduction</dt><dd><dl><dt>arrays, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt></dl></dd></dl></dd><dt>initial testing, <a class="indexterm" href="using-systemtap.html#testing">Initial Testing</a></dt><dt>inode number</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt></dl></dd><dt>Installation</dt><dd><dl><dt>initial testing, <a class="indexterm" href="using-systemtap.html#testing">Initial Testing</a></dt><dt>kernel information packages, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information Packages Manually</a></dt><dt>kernel version, determining the, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information Packages Manually</a></dt><dt>required packages, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information Packages Manually</a></dt><dt>Setup and Installation, <a class="indexterm" href="using-systemtap.html#using-setup">Installation and Setup</a></dt><dt>systemtap package, <a class="indexterm" href="using-systemtap.html#installproper">Installing SystemTap</a></dt><dt>systemtap-runtime package, <a class="indexterm" href="using-systemtap.html#installproper">Installing SystemTap</a></dt></dl></dd><dt>instrumentation module</dt><dd><dl><dt>cross-instrumentation, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></dd><dt>instrumentation modules from SystemTap scripts, building, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>integer extractors</dt><dd><dl><dt>computing for statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd></dl></dd><dt>Introduction</dt><dd><dl><dt>capabilities of SystemTap, <a class="indexterm" href="intro-systemtap-vs-others.html">SystemTap Capabilities</a></dt><dt>documentation goals, <a class="indexterm" href="introduction.html#goals">Documentation Goals</a></dt><dt>goals, documentation, <a class="indexterm" href="introduction.html#goals">Documentation Goals</a></dt><dt>limitations of SystemTap, <a class="indexterm" href="intro-systemtap-limitations.html">Limitations of SystemTap</a></dt><dt>performance monitoring, <a class="indexterm" href="introduction.html">Introduction</a></dt></dl></dd><dt>invalid division</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt></dl></dd></dl></dd><dt>invalid values to variables/arrays</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>iterations, processing elements in an array as</dt><dd><dl><dt>processing multiple elements in an array</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>K</h3><dl><dt>kernel and user space, determining time spent in</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt></dl></dd><dt>kernel information packages, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information Packages Manually</a></dt><dt>kernel modules from SystemTap scripts, building, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>kernel version, determining the, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information Packages Manually</a></dt><dt>kernel.function("function")</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>kernel.trace("tracepoint")</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>key pairs</dt><dd><dl><dt>introduction</dt><dd><dl><dt>arrays, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>L</h3><dl><dt>libdwfl failure</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>limitations of SystemTap</dt><dd><dl><dt>Introduction, <a class="indexterm" href="intro-systemtap-limitations.html">Limitations of SystemTap</a></dt></dl></dd><dt>limiting the output of foreach</dt><dd><dl><dt>processing multiple elements in an array</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd></dl></dd><dt>local variables</dt><dd><dl><dt>name, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt><dt>sample usage</dt><dd><dl><dt>$count, <a class="indexterm" href="iotimesect.html">Tracking I/O Time For Each File Read or Write</a></dt><dt>$return, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a>, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>M</h3><dl><dt>MAXACTION exceeded</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt></dl></dd></dl></dd><dt>MAXNESTING exceeded</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt></dl></dd></dl></dd><dt>membership (in array), testing for</dt><dd><dl><dt>conditional statements, using arrays in</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt></dl></dd></dl></dd><dt>module("module")</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>monitoring changes to file attributes</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatch2sect.html">Monitoring Changes to File Attributes</a></dt></dl></dd><dt>monitoring cumulative I/O</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt></dl></dd><dt>monitoring device I/O</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt></dl></dd><dt>monitoring I/O block time</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="ioblktimesect.html">Periodically Print I/O Block Time</a></dt></dl></dd><dt>monitoring I/O time</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="iotimesect.html">Tracking I/O Time For Each File Read or Write</a></dt></dl></dd><dt>monitoring incoming TCP connections</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#tcpconnectionssect">Monitoring Incoming TCP Connections</a></dt></dl></dd><dt>monitoring polling applications</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="timeoutssect.html">Monitoring Polling Applications</a></dt></dl></dd><dt>monitoring reads and writes to a file</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt></dl></dd><dt>monitoring system calls</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="topsyssect.html">Tracking Most Frequently Used System Calls</a></dt></dl></dd><dt>monitoring system calls (volume per process)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="syscallsbyprocpidsect.html">Tracking System Call Volume Per Process</a></dt></dl></dd><dt>monitoring TCP packets</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#tcpdumplikesect">Monitoring TCP Packets</a></dt></dl></dd><dt>multiple array operations within the same probe</dt><dd><dl><dt>clearing arrays/array elements</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt></dl></dd></dl></dd><dt>multiple command-line arguments, example of</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>multiple elements in an array</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>N</h3><dl><dt>name</dt><dd><dl><dt>local variables, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt></dl></dd><dt>net/socket.c, tracing functions from</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#sockettracesect">Tracing Functions Called in Network Socket Code</a></dt></dl></dd><dt>network profiling</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#nettopsect">Network Profiling</a>, <a class="indexterm" href="useful-systemtap-scripts.html#dropwatchsect">Monitoring Network Packets Drops in Kernel</a></dt></dl></dd><dt>network socket code, tracing functions called in</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#sockettracesect">Tracing Functions Called in Network Socket Code</a></dt></dl></dd><dt>network traffic, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#nettopsect">Network Profiling</a>, <a class="indexterm" href="useful-systemtap-scripts.html#dropwatchsect">Monitoring Network Packets Drops in Kernel</a></dt></dl></dd><dt>no match for probe point</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>non-global arrays</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>number of errors: N, skipped probes: M</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>O</h3><dl><dt>operations</dt><dd><dl><dt>assigning associated values</dt><dd><dl><dt>associating timestamps to process names, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt></dl></dd><dt>associative arrays, <a class="indexterm" href="arrayoperators.html">Array Operations in SystemTap</a></dt><dt>clearing arrays/array elements, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dd><dl><dt>delete operator, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dt>multiple array operations within the same probe, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dt>virtual file system reads (non-cumulative), tallying, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt></dl></dd><dt>computing for statistical aggregates, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dd><dl><dt>@avg (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@count (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@max (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@min (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>@sum (integer extractor), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>adding values to statistical aggregates, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>count (operator), <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt><dt>extracting data collected by statistical aggregates, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd><dt>conditional statements, using arrays in, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt><dd><dl><dt>testing for array membership, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt></dl></dd><dt>deleting arrays and array elements, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt><dt>incrementing associated values, <a class="indexterm" href="arrayops-increment.html">Incrementing Associated Values</a></dt><dd><dl><dt>tallying virtual file system reads (VFS reads), <a class="indexterm" href="arrayops-increment.html">Incrementing Associated Values</a></dt></dl></dd><dt>multiple elements in an array, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>processing multiple elements in an array, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dd><dl><dt>cumulative virtual file system reads, tallying, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>foreach, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>iterations, processing elements in an array as, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>limiting the output of foreach, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>ordering the output of foreach, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd><dt>reading values from arrays, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt><dd><dl><dt>computing for timestamp deltas, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt><dt>empty unique keys, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt><dt>using arrays in simple computations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd></dl></dd><dt>options, stap</dt><dd><dl><dt>Usage, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt></dl></dd><dt>ordering the output of foreach</dt><dd><dl><dt>processing multiple elements in an array</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd></dl></dd><dt>overflow of aggregation</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>P</h3><dl><dt>packages required to run SystemTap, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information Packages Manually</a></dt><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dd><dl><dt>embedded code in unprivileged script, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>expected symbol/array index expression, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>grammatical/typographical script error, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>guru mode, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>invalid values to variables/arrays, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>libdwfl failure, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>no match for probe point, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>non-global arrays, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>probe mismatch, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>type mismatch for identifier, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved function call, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved target-symbol expression, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved type for identifier, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>variable modified during 'foreach', <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>performance monitoring</dt><dd><dl><dt>Introduction, <a class="indexterm" href="introduction.html">Introduction</a></dt></dl></dd><dt>pointer dereference fault</dt><dd><dl><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt></dl></dd></dl></dd><dt>polling applications, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="timeoutssect.html">Monitoring Polling Applications</a></dt></dl></dd><dt>pp()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt></dl></dd><dt>printf()</dt><dd><dl><dt>format specifiers, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt><dt>format strings, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt><dt>syntax and format, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt></dl></dd><dt>printing I/O activity (cumulative)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt></dl></dd><dt>printing I/O block time (periodically)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="ioblktimesect.html">Periodically Print I/O Block Time</a></dt></dl></dd><dt>probe mismatch</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>probe point (no match for)</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>probes</dt><dd><dl><dt>SystemTap scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd></dl></dd><dt>processing multiple elements in an array</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt><dt>cumulative virtual file system reads, tallying</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd><dt>foreach</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd><dt>limiting the output of foreach</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd><dt>ordering the output of foreach</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd></dl></dd><dt>profiling the network</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#nettopsect">Network Profiling</a>, <a class="indexterm" href="useful-systemtap-scripts.html#dropwatchsect">Monitoring Network Packets Drops in Kernel</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>R</h3><dl><dt>reading values from arrays</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt><dd><dl><dt>empty unique keys, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt><dt>using arrays in simple computations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd><dt>computing for timestamp deltas</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd></dl></dd><dt>reads/writes to a file, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt></dl></dd><dt>required packages, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information Packages Manually</a></dt><dt>RPMs required to run SystemTap, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information Packages Manually</a></dt><dt>running scripts from standard input, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>running SystemTap scripts</dt><dd><dl><dt>Usage, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt></dl></dd><dt>runtime errors/warnings</dt><dd><dl><dt>understainding SystemTap errors, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dd><dl><dt>aggregate element not found, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>aggregation overflow, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>copy fault, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>division by 0, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>MAXACTION exceeded, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>MAXNESTING exceeded, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>number of errors: N, skipped probes: M, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>pointer dereference fault, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>S</h3><dl><dt>script examples</dt><dd><dl><dt>call graph tracing, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt><dt>CPU ticks, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt><dt>ctime(), example of usage, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt><dt>determining time spent in kernel and user space, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt><dt>file device number (integer format), <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt><dt>futex (lock) contentions, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt><dt>futex system call, <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt><dt>identifying contended user-space locks (futex contentions), <a class="indexterm" href="futexcontentionsect.html">Identifying Contended User-Space Locks</a></dt><dt>if/else conditionals, alternative syntax, <a class="indexterm" href="useful-systemtap-scripts.html#nettopsect">Network Profiling</a></dt><dt>inode number, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt><dt>monitoring changes to file attributes, <a class="indexterm" href="inodewatch2sect.html">Monitoring Changes to File Attributes</a></dt><dt>monitoring device I/O, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt><dt>monitoring I/O block time, <a class="indexterm" href="ioblktimesect.html">Periodically Print I/O Block Time</a></dt><dt>monitoring I/O time, <a class="indexterm" href="iotimesect.html">Tracking I/O Time For Each File Read or Write</a></dt><dt>monitoring incoming TCP connections, <a class="indexterm" href="useful-systemtap-scripts.html#tcpconnectionssect">Monitoring Incoming TCP Connections</a></dt><dt>monitoring polling applications, <a class="indexterm" href="timeoutssect.html">Monitoring Polling Applications</a></dt><dt>monitoring reads and writes to a file, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt><dt>monitoring system calls, <a class="indexterm" href="topsyssect.html">Tracking Most Frequently Used System Calls</a></dt><dt>monitoring system calls (volume per process), <a class="indexterm" href="syscallsbyprocpidsect.html">Tracking System Call Volume Per Process</a></dt><dt>monitoring TCP packets, <a class="indexterm" href="useful-systemtap-scripts.html#tcpdumplikesect">Monitoring TCP Packets</a></dt><dt>multiple command-line arguments, example of, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt><dt>net/socket.c, tracing functions from, <a class="indexterm" href="useful-systemtap-scripts.html#sockettracesect">Tracing Functions Called in Network Socket Code</a></dt><dt>network profiling, <a class="indexterm" href="useful-systemtap-scripts.html#nettopsect">Network Profiling</a>, <a class="indexterm" href="useful-systemtap-scripts.html#dropwatchsect">Monitoring Network Packets Drops in Kernel</a></dt><dt>stat -c, determining file device number (integer format), <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt><dt>stat -c, determining whole device number, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt><dt>summarizing disk I/O traffic, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt><dt>tallying function calls, <a class="indexterm" href="mainsect-profiling.html#countcallssect">Counting Function Calls Made</a></dt><dt>thread_indent(), sample usage, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt><dt>timer.ms(), sample usage, <a class="indexterm" href="mainsect-profiling.html#countcallssect">Counting Function Calls Made</a></dt><dt>timer.s(), sample usage, <a class="indexterm" href="timeoutssect.html">Monitoring Polling Applications</a>, <a class="indexterm" href="topsyssect.html">Tracking Most Frequently Used System Calls</a></dt><dt>tracing functions called in network socket code, <a class="indexterm" href="useful-systemtap-scripts.html#sockettracesect">Tracing Functions Called in Network Socket Code</a></dt><dt>tracking cumulative I/O, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt><dt>trigger function, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt><dt>usrdev2kerndev(), <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt><dt>whole device number (usage as a command-line argument), <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt></dl></dd><dt>scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dd><dl><dt>components, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>events and handlers, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>format and syntax, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>functions, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>probes, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>statement blocks, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd></dl></dd><dt>sessions, SystemTap, <a class="indexterm" href="understanding-how-systemtap-works.html#understanding-architecture-tools">Architecture</a></dt><dt>Setup and Installation, <a class="indexterm" href="using-systemtap.html#using-setup">Installation and Setup</a></dt><dt>Stack backtrace</dt><dd><dl><dt>user-space, <a class="indexterm" href="ustack.html">User-Space Stack Backtraces</a></dt></dl></dd><dt>standard input, running scripts from</dt><dd><dl><dt>Usage, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt></dl></dd><dt>stap</dt><dd><dl><dt>Usage, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt></dl></dd><dt>stap options, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>stapdev</dt><dd><dl><dt>Usage, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt></dl></dd><dt>staprun</dt><dd><dl><dt>Usage, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt></dl></dd><dt>stapusr</dt><dd><dl><dt>Usage, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt></dl></dd><dt>stat -c, determining file device number (integer format)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt></dl></dd><dt>stat -c, determining whole device number</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt></dl></dd><dt>statement blocks</dt><dd><dl><dt>SystemTap scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd></dl></dd><dt>statistical aggregates</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-aggregates.html">Computing for Statistical Aggregates</a></dt></dl></dd><dt>summarizing disk I/O traffic</dt><dd><dl><dt>script examples, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a></dt></dl></dd><dt>synchronous events</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>syntax</dt><dd><dl><dt>introduction</dt><dd><dl><dt>arrays, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt></dl></dd></dl></dd><dt>syntax and format</dt><dd><dl><dt>printf(), <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt><dt>SystemTap handler constructs</dt><dd><dl><dt>handlers, <a class="indexterm" href="scriptconstructions.html">Basic SystemTap Handler Constructs</a></dt></dl></dd><dt>SystemTap scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd></dl></dd><dt>syscall.system_call</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>system calls volume (per process), monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="syscallsbyprocpidsect.html">Tracking System Call Volume Per Process</a></dt></dl></dd><dt>system calls, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="topsyssect.html">Tracking Most Frequently Used System Calls</a></dt></dl></dd><dt>SystemTap architecture, <a class="indexterm" href="understanding-how-systemtap-works.html#understanding-architecture-tools">Architecture</a></dt><dt>SystemTap handlers</dt><dd><dl><dt>SystemTap handler constructs, <a class="indexterm" href="scriptconstructions.html">Basic SystemTap Handler Constructs</a></dt><dd><dl><dt>syntax and format, <a class="indexterm" href="scriptconstructions.html">Basic SystemTap Handler Constructs</a></dt></dl></dd></dl></dd><dt>systemtap package, <a class="indexterm" href="using-systemtap.html#installproper">Installing SystemTap</a></dt><dt>SystemTap script functions, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt><dt>SystemTap scripts</dt><dd><dl><dt>introduction, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dd><dl><dt>components, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>events and handlers, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>format and syntax, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>functions, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>probes, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt><dt>statement blocks, <a class="indexterm" href="scripts.html">SystemTap Scripts</a></dt></dl></dd><dt>useful examples, <a class="indexterm" href="useful-systemtap-scripts.html">Useful SystemTap Scripts</a></dt></dl></dd><dt>SystemTap scripts, how to run, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>SystemTap sessions, <a class="indexterm" href="understanding-how-systemtap-works.html#understanding-architecture-tools">Architecture</a></dt><dt>SystemTap statements</dt><dd><dl><dt>conditional statements, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt><dd><dl><dt>conditional operators, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt><dt>for loops, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt><dt>if/else, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt><dt>while loops, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt></dl></dd><dt>SystemTap handler constructs</dt><dd><dl><dt>command-line arguments, <a class="indexterm" href="commandlineargssect.html">Command-Line Arguments</a></dt><dt>global, <a class="indexterm" href="scriptconstructions.html#variablesconstructs">Variables</a></dt><dt>variable notations, <a class="indexterm" href="commandlineargssect.html">Command-Line Arguments</a></dt><dt>variables, <a class="indexterm" href="scriptconstructions.html#variablesconstructs">Variables</a></dt></dl></dd></dl></dd><dt>systemtap-runtime package, <a class="indexterm" href="using-systemtap.html#installproper">Installing SystemTap</a></dt><dt>systemtap-testsuite package</dt><dd><dl><dt>sample scripts, <a class="indexterm" href="useful-systemtap-scripts.html">Useful SystemTap Scripts</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>T</h3><dl><dt>tallying function calls</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="mainsect-profiling.html#countcallssect">Counting Function Calls Made</a></dt></dl></dd><dt>tallying virtual file system reads (VFS reads)</dt><dd><dl><dt>incrementing associated values</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-increment.html">Incrementing Associated Values</a></dt></dl></dd></dl></dd><dt>Tapsets</dt><dd><dl><dt>definition of, <a class="indexterm" href="understanding-tapsets.html">Tapsets</a></dt></dl></dd><dt>target kernel</dt><dd><dl><dt>cross-instrumentation, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></dd><dt>target system</dt><dd><dl><dt>cross-instrumentation, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></dd><dt>target system and host system</dt><dd><dl><dt>configuration, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt></dl></dd><dt>target variables, <a class="indexterm" href="targetvariables.html">Target Variables</a></dt><dd><dl><dt>pretty printing, <a class="indexterm" href="targetvariables.html#targetprettyprinting">Pretty Printing Target Variables</a></dt><dt>typecasting, <a class="indexterm" href="typecasting.html">Typecasting</a></dt><dt>user-space, <a class="indexterm" href="utargetvariable.html">Accessing User-Space Target Variables</a></dt><dt>variable availability, <a class="indexterm" href="targetavailable.html">Checking Target Variable Availability</a></dt></dl></dd><dt>target()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt></dl></dd><dt>target-symbol expression, unresolved</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>TCP connections (incoming), monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#tcpconnectionssect">Monitoring Incoming TCP Connections</a></dt></dl></dd><dt>TCP packets, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#tcpdumplikesect">Monitoring TCP Packets</a></dt></dl></dd><dt>testing for array membership</dt><dd><dl><dt>conditional statements, using arrays in</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-conditionals.html">Using Arrays in Conditional Statements</a></dt></dl></dd></dl></dd><dt>testing, initial, <a class="indexterm" href="using-systemtap.html#testing">Initial Testing</a></dt><dt>thread_indent()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt></dl></dd><dt>thread_indent(), sample usage</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>tid()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt></dl></dd><dt>time of I/O </dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="iotimesect.html">Tracking I/O Time For Each File Read or Write</a></dt></dl></dd><dt>time spent in kernel/user space, determining</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt></dl></dd><dt>timer events</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>timer.ms(), sample usage</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="mainsect-profiling.html#countcallssect">Counting Function Calls Made</a></dt></dl></dd><dt>timer.s(), sample usage</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="timeoutssect.html">Monitoring Polling Applications</a>, <a class="indexterm" href="topsyssect.html">Tracking Most Frequently Used System Calls</a></dt></dl></dd><dt>timestamp deltas, computing for</dt><dd><dl><dt>reading values from arrays</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd></dl></dd><dt>timestamps, association thereof to process names</dt><dd><dl><dt>assigning associated values</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt></dl></dd></dl></dd><dt>tracepoint, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a>, <a class="indexterm" href="useful-systemtap-scripts.html#dropwatchsect">Monitoring Network Packets Drops in Kernel</a></dt><dt>tracing call graph</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>tracing functions called in network socket code</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html#sockettracesect">Tracing Functions Called in Network Socket Code</a></dt></dl></dd><dt>tracing incoming/outgoing function calls</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>tracking cumulative I/O</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt></dl></dd><dt>trigger function</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="paracallgraph.html">Call Graph Tracing</a></dt></dl></dd><dt>type mismatch for identifier</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>typographical script error</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>U</h3><dl><dt>uid()</dt><dd><dl><dt>functions, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt></dl></dd><dt>uname -m, <a class="indexterm" href="cross-compiling.html">Generating Instrumentation for Other Computers</a></dt><dt>uname -r, <a class="indexterm" href="using-systemtap.html#install-kinfo">Installing Required Kernel Information Packages Manually</a></dt><dt>understainding SystemTap errors</dt><dd><dl><dt>runtime errors/warnings, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dd><dl><dt>aggregate element not found, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>aggregation overflow, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>copy fault, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>division by 0, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>MAXACTION exceeded, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>MAXNESTING exceeded, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>number of errors: N, skipped probes: M, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt><dt>pointer dereference fault, <a class="indexterm" href="runtimeerror.html">Runtime Errors and Warnings</a></dt></dl></dd></dl></dd><dt>Understanding How SystemTap Works, <a class="indexterm" href="understanding-how-systemtap-works.html">Understanding How SystemTap Works</a></dt><dd><dl><dt>architecture, <a class="indexterm" href="understanding-how-systemtap-works.html#understanding-architecture-tools">Architecture</a></dt><dt>event types, <a class="indexterm" href="understanding-how-systemtap-works.html">Understanding How SystemTap Works</a></dt><dt>events and handlers, <a class="indexterm" href="understanding-how-systemtap-works.html">Understanding How SystemTap Works</a></dt><dt>SystemTap sessions, <a class="indexterm" href="understanding-how-systemtap-works.html#understanding-architecture-tools">Architecture</a></dt></dl></dd><dt>understanding SystemTap errors</dt><dd><dl><dt>parse/semantics error, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dd><dl><dt>embedded code in unprivileged script, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>expected symbol/array index expression, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>grammatical/typographical script error, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>guru mode, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>invalid values to variables/arrays, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>libdwfl failure, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>no match for probe point, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>non-global arrays, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>probe mismatch, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>type mismatch for identifier, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved function call, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved target-symbol expression, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>unresolved type for identifier, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt><dt>variable modified during 'foreach', <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>unique keys</dt><dd><dl><dt>introduction</dt><dd><dl><dt>arrays, <a class="indexterm" href="associativearrays.html">Associative Arrays</a></dt></dl></dd></dl></dd><dt>unprivileged script, embedded code in</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>unresolved function call</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>unresolved target-symbol expression</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>unresolved type for identifier</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>unsafe embedded code in unprivileged script</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>Usage</dt><dd><dl><dt>options, stap, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>running SystemTap scripts, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>standard input, running scripts from, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>stap, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>stapdev, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>staprun, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt><dt>stapusr, <a class="indexterm" href="using-usage.html">Running SystemTap Scripts</a></dt></dl></dd><dt>useful examples of SystemTap scripts, <a class="indexterm" href="useful-systemtap-scripts.html">Useful SystemTap Scripts</a></dt><dt>user and kernel space, determining time spent in</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="threadtimessect.html">Determining Time Spent in Kernel and User Space</a></dt></dl></dd><dt>using arrays in simple computations</dt><dd><dl><dt>reading values from arrays</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-readvalues.html">Reading Values From Arrays</a></dt></dl></dd></dl></dd><dt>Using SystemTap, <a class="indexterm" href="using-systemtap.html">Using SystemTap</a></dt><dt>usrdev2kerndev()</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt></dl></dd></dl></div><div class="indexdiv"><h3>V</h3><dl><dt>values, assignment of</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayoperators.html#arrayops-assignvalue">Assigning an Associated Value</a></dt></dl></dd><dt>variable modified during 'foreach'</dt><dd><dl><dt>parse/semantics error</dt><dd><dl><dt>understanding SystemTap errors, <a class="indexterm" href="errors.html#parsetype">Parse and Semantic Errors</a></dt></dl></dd></dl></dd><dt>variable notations</dt><dd><dl><dt>SystemTap handler constructs</dt><dd><dl><dt>handlers, <a class="indexterm" href="commandlineargssect.html">Command-Line Arguments</a></dt></dl></dd></dl></dd><dt>variables</dt><dd><dl><dt>SystemTap handler constructs</dt><dd><dl><dt>handlers, <a class="indexterm" href="scriptconstructions.html#variablesconstructs">Variables</a></dt></dl></dd></dl></dd><dt>variables (local)</dt><dd><dl><dt>name, <a class="indexterm" href="systemtapscript-handler.html">SystemTap Handler/Body</a></dt><dt>sample usage</dt><dd><dl><dt>$count, <a class="indexterm" href="iotimesect.html">Tracking I/O Time For Each File Read or Write</a></dt><dt>$return, <a class="indexterm" href="mainsect-disk.html#disktop">Summarizing Disk Read/Write Traffic</a>, <a class="indexterm" href="traceiosect.html">Track Cumulative IO</a></dt></dl></dd></dl></dd><dt>VFS reads, tallying of</dt><dd><dl><dt>incrementing associated values</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-increment.html">Incrementing Associated Values</a></dt></dl></dd></dl></dd><dt>vfs.file_operation</dt><dd><dl><dt>Events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt></dl></dd><dt>virtual file system reads (cumulative), tallying</dt><dd><dl><dt>processing multiple elements in an array</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-foreach.html">Processing Multiple Elements in an Array</a></dt></dl></dd></dl></dd><dt>virtual file system reads (non-cumulative), tallying</dt><dd><dl><dt>clearing arrays/array elements</dt><dd><dl><dt>array operations, <a class="indexterm" href="arrayops-deleting.html">Clearing/Deleting Arrays and Array Elements</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>W</h3><dl><dt>while loops</dt><dd><dl><dt>conditional statements</dt><dd><dl><dt>handlers, <a class="indexterm" href="handlerconditionalstatements.html">Conditional Statements</a></dt></dl></dd></dl></dd><dt>whole device number (usage as a command-line argument)</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="traceio2sect.html">I/O Monitoring (By Device)</a></dt></dl></dd><dt>wildcards in events, <a class="indexterm" href="scripts.html#systemtapscript-events">Event</a></dt><dt>writes/reads to a file, monitoring</dt><dd><dl><dt>examples of SystemTap scripts, <a class="indexterm" href="inodewatchsect.html">Monitoring Reads and Writes to a File</a></dt></dl></dd></dl></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="appe-Publican-Revision_History.html"><strong>Prev</strong>Appendix A. Revision History</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>5.2. Disk</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="useful-systemtap-scripts.html" title="Chapter 5. Useful SystemTap Scripts" /><link rel="prev" href="useful-systemtap-scripts.html" title="Chapter 5. Useful SystemTap Scripts" /><link rel="next" href="iotimesect.html" title="5.2.2. Tracking I/O Time For Each File Read or Write" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="useful-systemtap-scripts.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="iotimesect.html"><strong>Next</strong></a></li></ul><div class="section" id="mainsect-disk"><div class="titlepage"><div><div><h2 class="title" id="mainsect-disk">5.2. Disk</h2></div></div></div><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">5.2. Disk</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="useful-systemtap-scripts.html" title="Chapter 5. Useful SystemTap Scripts" /><link rel="prev" href="useful-systemtap-scripts.html" title="Chapter 5. Useful SystemTap Scripts" /><link rel="next" href="iotimesect.html" title="5.2.2. Tracking I/O Time For Each File Read or Write" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="useful-systemtap-scripts.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="iotimesect.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="mainsect-disk"></a>5.2. Disk</h2></div></div></div><div class="para">
The following sections showcase scripts that monitor disk and I/O activity.
- </div><div xml:lang="en-US" class="section"
id="disktop" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="disktop">5.2.1. Summarizing Disk Read/Write Traffic</h3></div></div></div><a id="idp58221616" class="indexterm"></a><a id="idp38336000" class="indexterm"></a><a id="idp26299744" class="indexterm"></a><a id="idp33634544" class="indexterm"></a><a id="idp59056336" class="indexterm"></a><a id="idp17290192" class="indexterm"></a><a id="idp50185744" class="indexterm"></a><a id="idp63196544" class="indexterm"></a><div class="para">
+ </div><div xml:lang="en-US" class="section"
lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="disktop"></a>5.2.1. Summarizing Disk Read/Write Traffic</h3></div></div></div><a id="idm246876077936" class="indexterm"></a><a id="idm246927896096" class="indexterm"></a><a id="idm246873251856" class="indexterm"></a><a id="idm246877781872" class="indexterm"></a><a id="idm246917194352" class="indexterm"></a><a id="idm246927667152" class="indexterm"></a><a id="idm246873101696" class="indexterm"></a><a id="idm246926681648" class="indexterm"></a><div class="para">
This section describes how to identify which processes are performing the heaviest disk reads/writes to the system.
- </div><div class="formalpara" id="scriptdisktop"><h5 class="formalpara">disktop.stp</h5>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">disktop.stp</div>
<pre class="programlisting">#!/usr/bin/env stap
#
</pre>
</div><div class="para">
<a class="xref" href="mainsect-disk.html#scriptdisktop">disktop.stp</a> outputs the top ten processes responsible for the heaviest reads/writes to disk. <a class="xref" href="mainsect-disk.html#disktopoutput">Example 5.6, “disktop.stp Sample Output”</a> displays a sample output for this script, and includes the following data per listed process:
- </div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
<code class="computeroutput">UID</code> — user ID. A user ID of <code class="computeroutput">0</code> refers to the root user.
</div></li><li class="listitem"><div class="para">
<code class="computeroutput">PID</code> — the ID of the listed process.
<code class="computeroutput">T</code> — the type of action performed by the listed process; <code class="computeroutput">W</code> refers to write, while <code class="computeroutput">R</code> refers to read.
</div></li><li class="listitem"><div class="para">
<code class="computeroutput">BYTES</code> — the amount of data read to or written from disk.
- </div></li></ul></div><a id="idm
3739264" class="indexterm"></a><a id="idp29159760" class="indexterm"></a><a id="idp59889408" class="indexterm"></a><div class="para">
+ </div></li></ul></div><a id="idm
246920810880" class="indexterm"></a><a id="idm246907804512" class="indexterm"></a><a id="idm246913007360" class="indexterm"></a><div class="para">
The time and date in the output of <a class="xref" href="mainsect-disk.html#scriptdisktop">disktop.stp</a> is returned by the functions <code class="command">ctime()</code> and <code class="command">gettimeofday_s()</code>. <code class="command">ctime()</code> derives calendar time in terms of seconds passed since the Unix epoch (January 1, 1970). <code class="command">gettimeofday_s()</code> counts the <span class="emphasis"><em>actual</em></span> number of seconds since Unix epoch, which gives a fairly accurate human-readable timestamp for the output.
- </div><a id="id
p64766640" class="indexterm"></a><a id="idp29152160" class="indexterm"></a><a id="idp50016704" class="indexterm"></a><div class="para">
- In this script, the <code class="command">$return</code> is a local variable that stores the actual number of bytes each process reads or writes from the virtual file system. <code class="command">$return</code> can only be used in return probes (e.g. <code class="command">vfs.read.return</code> and <code class="command">vfs.read.return</code>).
- </div><div class="example"
id="disktopoutput"><h6>Example 5.6. <a class="xref" href="mainsect-disk.html#scriptdisktop">disktop.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen">[...]
+ </div><a id="id
m246912910192" class="indexterm"></a><a id="idm246876588704" class="indexterm"></a><a id="idm246922733184" class="indexterm"></a><div class="para">
+ In this script, the <code class="command">$return</code> is a local variable that stores the actual number of bytes each process reads or writes from the virtual file system. <code class="command">$return</code> can only be used in return probes (for example, <code class="command">vfs.read.return</code> and <code class="command">vfs.read.return</code>).
+ </div><div class="example"
><a id="disktopoutput"></a><p class="title"><strong>Example 5.6. <a class="xref" href="mainsect-disk.html#scriptdisktop">disktop.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen">[...]
Mon Sep 29 03:38:28 2008 , Average: 19Kb/sec, Read: 7Kb, Write: 89Kb
UID PID PPID CMD DEVICE T BYTES
UID PID PPID CMD DEVICE T BYTES
0 2758 2757 pam_timestamp_c sda5 R 8064
-0 2885 1 cupsd sda5 W 1678</pre></div></div><br class="example-break" /></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="useful-systemtap-scripts.html"><strong>Prev</strong>Chapter 5. Useful SystemTap Scripts</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="iotimesect.html"><strong>Next</strong>5.2.2. Tracking I/O Time For Each File Read or Wr...</a></li></ul></body></html>
+0 2885 1 cupsd sda5 W 1678</pre></div></div><br class="example-break" /></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="useful-systemtap-scripts.html"><strong>Prev</strong>Chapter 5. Useful SystemTap Scripts</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="iotimesect.html"><strong>Next</strong>5.2.2. Tracking I/O Time For Each File Read or Wr...</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>5.3. Profiling</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="useful-systemtap-scripts.html" title="Chapter 5. Useful SystemTap Scripts" /><link rel="prev" href="ioblktimesect.html" title="5.2.7. Periodically Print I/O Block Time" /><link rel="next" href="paracallgraph.html" title="5.3.2. Call Graph Tracing" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="ioblktimesect.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="paracallgraph.html"><strong>Next</strong></a></li></ul><div class="section" id="mainsect-profiling"><div class="titlepage"><div><div><h2 class="title" id="mainsect-profiling">5.3. Profiling</h2></div></div></div><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">5.3. Profiling</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="useful-systemtap-scripts.html" title="Chapter 5. Useful SystemTap Scripts" /><link rel="prev" href="ioblktimesect.html" title="5.2.7. Periodically Print I/O Block Time" /><link rel="next" href="paracallgraph.html" title="5.3.2. Call Graph Tracing" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="ioblktimesect.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="paracallgraph.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="mainsect-profiling"></a>5.3. Profiling</h2></div></div></div><div class="para">
The following sections showcase scripts that profile kernel activity by monitoring function calls.
- </div><div xml:lang="en-US" class="section"
id="countcallssect" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="countcallssect">5.3.1. Counting Function Calls Made</h3></div></div></div><a id="idp27256512" class="indexterm"></a><a id="idp15269888" class="indexterm"></a><a id="idp32452944" class="indexterm"></a><a id="idp56780544" class="indexterm"></a><a id="idp50542592" class="indexterm"></a><div class="para">
- This section describes how to identify how many times the system called a specific kernel function in a 30-second sample. Depending on your use of wildcards, you can also use this script to target multiple kernel functions.
- </div><div class="formalpara" id="countcalls"><h5 class="formalpara">functioncallcount.stp</h5>
+ </div><div xml:lang="en-US" class="section"
lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="countcallssect"></a>5.3.1. Counting Function Calls Made</h3></div></div></div><a id="idm246928792224" class="indexterm"></a><a id="idm246926783616" class="indexterm"></a><a id="idm246929560080" class="indexterm"></a><a id="idm246883103504" class="indexterm"></a><a id="idm246928487280" class="indexterm"></a><div class="para">
+ This section describes how to identify how many times the system called a specific kernel function in a 30-second sample. Depending on the use of wildcards, you can also use this script to target multiple kernel functions.
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">functioncallcount.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
# The following line command will probe all the functions
</pre>
</div><div class="para">
<a class="xref" href="mainsect-profiling.html#countcalls">functioncallcount.stp</a> takes the targeted kernel function as an argument. The argument supports wildcards, which enables you to target multiple kernel functions up to a certain extent.
- </div><a id="idm24
35968" class="indexterm"></a><a id="idp45873792" class="indexterm"></a><a id="idm3930928" class="indexterm"></a><div class="para">
+ </div><a id="idm24
6926560512" class="indexterm"></a><a id="idm246927329984" class="indexterm"></a><a id="idm246917042560" class="indexterm"></a><div class="para">
The output of <a class="xref" href="mainsect-profiling.html#countcalls">functioncallcount.stp</a> contains the name of the function called and how many times it was called during the sample time (in alphabetical order). <a class="xref" href="mainsect-profiling.html#countcallsoutput">Example 5.13, “functioncallcount.stp Sample Output”</a> contains an excerpt from the output of <code class="command">stap functioncallcount.stp "*@mm/*.c"</code>:
- </div><div class="example"
id="countcallsoutput"><h6>Example 5.13. <a class="xref" href="mainsect-profiling.html#countcalls">functioncallcount.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen">[...]
+ </div><div class="example"
><a id="countcallsoutput"></a><p class="title"><strong>Example 5.13. <a class="xref" href="mainsect-profiling.html#countcalls">functioncallcount.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen">[...]
__vma_link 97
__vma_link_file 66
__vma_link_list 97
atomic_dec_and_test 5153
atomic_inc 470
atomic_inc_and_test 1
-[...]</pre></div></div><br class="example-break" /></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="ioblktimesect.html"><strong>Prev</strong>5.2.7. Periodically Print I/O Block Time</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="paracallgraph.html"><strong>Next</strong>5.3.2. Call Graph Tracing</a></li></ul></body></html>
+[...]</pre></div></div><br class="example-break" /></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="ioblktimesect.html"><strong>Prev</strong>5.2.7. Periodically Print I/O Block Time</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="paracallgraph.html"><strong>Next</strong>5.3.2. Call Graph Tracing</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>5.3.2. Call Graph Tracing</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-profiling.html" title="5.3. Profiling" /><link rel="prev" href="mainsect-profiling.html" title="5.3. Profiling" /><link rel="next" href="threadtimessect.html" title="5.3.3. Determining Time Spent in Kernel and User Space" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="mainsect-profiling.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="threadtimessect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="paracallgraph" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="paracallgraph">5.3.2. Call Graph Tracing</h3></div></div></div><a id="idp58389760" class="indexterm"></a><a id="idp48335008" class="indexterm"></a><a id="idp15004544" class="indexterm"></a><a id="idp63048096" class="indexterm"></a><a id="idp14030240" class="indexterm"></a><a id="idp22475040" class="indexterm"></a><a id="idp13009056" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">5.3.2. Call Graph Tracing</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-profiling.html" title="5.3. Profiling" /><link rel="prev" href="mainsect-profiling.html" title="5.3. Profiling" /><link rel="next" href="threadtimessect.html" title="5.3.3. Determining Time Spent in Kernel and User Space" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="mainsect-profiling.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="threadtimessect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="paracallgraph"></a>5.3.2. Call Graph Tracing</h3></div></div></div><a id="idm246869018208" class="indexterm"></a><a id="idm246877394176" class="indexterm"></a><a id="idm246926131152" class="indexterm"></a><a id="idm246917317504" class="indexterm"></a><a id="idm246914264128" class="indexterm"></a><a id="idm246880215856" class="indexterm"></a><a id="idm246913298496" class="indexterm"></a><div class="para">
This section describes how to trace incoming and outgoing function calls.
- </div><div class="formalpara" id="scriptcallgraph"><h5 class="formalpara">para-callgraph.stp</h5>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">para-callgraph.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
probe $1.call { trace(1, $$parms) }
probe $1.return { trace(-1, $$return) }
</pre>
- </div><a id="id
p19714032" class="indexterm"></a><a id="idp24571312" class="indexterm"></a><a id="idp29475664" class="indexterm"></a><a id="idp27701856" class="indexterm"></a><div class="para">
+ </div><a id="id
m246868834304" class="indexterm"></a><a id="idm246929429904" class="indexterm"></a><a id="idm246926402544" class="indexterm"></a><a id="idm246907790352" class="indexterm"></a><div class="para">
<a class="xref" href="paracallgraph.html#scriptcallgraph">para-callgraph.stp</a> takes two command-line arguments:
- </div><a id="id
p63415552" class="indexterm"></a><a id="idp35346528" class="indexterm"></a><a id="idp24748960" class="indexterm"></a><div class="itemizedlist"><ul><li class="listitem"><div class="para">
+ </div><a id="id
m246877976608" class="indexterm"></a><a id="idm246876618016" class="indexterm"></a><a id="idm246875268352" class="indexterm"></a><div xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
The function/s whose entry/exit call you'd like to trace (<code class="command">$1</code>).
</div></li><li class="listitem"><div class="para">
A second optional <em class="firstterm">trigger function</em> (<code class="command">$2</code>), which enables or disables tracing on a per-thread basis. Tracing in each thread will continue as long as the trigger function has not exited yet.
- </div></li></ul></div><a id="id
p21183328" class="indexterm"></a><a id="idm1466112" class="indexterm"></a><a id="idp51422416" class="indexterm"></a><div class="para">
- <a class="xref" href="paracallgraph.html#scriptcallgraph">para-callgraph.stp</a> uses <code class="command">thread_indent()</code>; as such, its output contains the timestamp, process name, and thread ID of <code class="command">$1</code> (
i.e. the probe function you are tracing). For more information about <code class="command">thread_indent()</code>, refer to its entry in <a class="xref" href="systemtapscript-handler.html#systemtapscript-functions">SystemTap Functions</a>.
+ </div></li></ul></div><a id="id
m246913071264" class="indexterm"></a><a id="idm246917761664" class="indexterm"></a><a id="idm246875163664" class="indexterm"></a><div class="para">
+ <a class="xref" href="paracallgraph.html#scriptcallgraph">para-callgraph.stp</a> uses <code class="command">thread_indent()</code>; as such, its output contains the timestamp, process name, and thread ID of <code class="command">$1</code> (
that is, the probe function you are tracing). For more information about <code class="command">thread_indent()</code>, refer to its entry in <a class="xref" href="systemtapscript-handler.html#systemtapscript-functions">SystemTap Functions</a>.
</div><div class="para">
The following example contains an excerpt from the output for <code class="command">stap para-callgraph.stp 'kernel.function("*@fs/*.c")' 'kernel.function("sys_read")'</code>:
- </div><div class="example"
id="paracallgraphoutput"><h6>Example 5.14. <a class="xref" href="paracallgraph.html#scriptcallgraph">para-callgraph.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen">[...]
+ </div><div class="example"
><a id="paracallgraphoutput"></a><p class="title"><strong>Example 5.14. <a class="xref" href="paracallgraph.html#scriptcallgraph">para-callgraph.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen">[...]
267 gnome-terminal(2921): <-do_sync_read return=0xfffffffffffffff5
269 gnome-terminal(2921):<-vfs_read return=0xfffffffffffffff5
0 gnome-terminal(2921):->fput file=0xffff880111eebbc0
12 gnome-terminal(2921): ->do_sync_read filp=0xffff8801116ce980 buf=0xc86504 len=0x1000 ppos=0xffff88010544df48
15 gnome-terminal(2921): <-do_sync_read return=0xfffffffffffffff5
18 gnome-terminal(2921):<-vfs_read return=0xfffffffffffffff5
- 0 gnome-terminal(2921):->fput file=0xffff8801116ce980</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="mainsect-profiling.html"><strong>Prev</strong>5.3. Profiling</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="threadtimessect.html"><strong>Next</strong>5.3.3. Determining Time Spent in Kernel and User ...</a></li></ul></body></html>
+ 0 gnome-terminal(2921):->fput file=0xffff8801116ce980</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="mainsect-profiling.html"><strong>Prev</strong>5.3. Profiling</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="threadtimessect.html"><strong>Next</strong>5.3.3. Determining Time Spent in Kernel and User ...</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>2. We Need Feedback!</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="SystemTap_Beginners_Guide-Preface.html" title="Preface" /><link rel="prev" href="SystemTap_Beginners_Guide-Preface.html" title="Preface" /><link rel="next" href="introduction.html" title="Chapter 1. Introduction" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="SystemTap_Beginners_Guide-Preface.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="introduction.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h2 class="title" id="idp39663712">2. We Need Feedback!</h2></div></div></div><a id="idp39664704" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">2. We Need Feedback!</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="SystemTap_Beginners_Guide-Preface.html" title="Preface" /><link rel="prev" href="SystemTap_Beginners_Guide-Preface.html" title="Preface" /><link rel="next" href="introduction.html" title="Chapter 1. Introduction" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="SystemTap_Beginners_Guide-Preface.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="introduction.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h2 class="title"><a id="idm246912539856"></a>2. We Need Feedback!</h2></div></div></div><a id="idm246912538864" class="indexterm"></a><div class="para">
If you find a typographical error in this manual, or if you have thought of a way to make this manual better, we would love to hear from you! Please submit a report in Bugzilla: <a href="http://sourceware.org/bugzilla/">http://sourceware.org/bugzilla/</a> against the product <span class="application"><strong>systemtap</strong></span>.
</div><div class="para">
When submitting a report, be sure to include the specific file or URL the report refers to and the manual's identifier: <em class="citetitle">SystemTap_Beginners_Guide</em>
</div><div class="para">
If you have a suggestion for improving the documentation, try to be as specific as possible when describing it. If you have found an error, please include the section number and some of the surrounding text so we can find it easily.
- </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="SystemTap_Beginners_Guide-Preface.html"><strong>Prev</strong>Preface</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="introduction.html"><strong>Next</strong>Chapter 1. Introduction</a></li></ul></body></html>
+ </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="SystemTap_Beginners_Guide-Preface.html"><strong>Prev</strong>Preface</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="introduction.html"><strong>Next</strong>Chapter 1. Introduction</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 7. References</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="runtimeerror.html" title="6.2. Run Time Errors and Warnings" /><link rel="next" href="appe-Publican-Revision_History.html" title="Appendix A. Revision History" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="runtimeerror.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="appe-Publican-Revision_History.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="chapter" id="references" lang="en-US"><div class="titlepage"><div><div><h2 class="title">Chapter 7. References</h2></div></div></div><div class="para">
- This chapter enumerates other references for more information about SystemTap. It is advisable that you refer to these sources in the course of writing advanced probes and tapsets.
- </div><div class="variablelist"><dl><dt class="varlistentry"><span class="term">SystemTap Wiki</span></dt><dd><div class="para">
- The <em class="citetitle">SystemTap Wiki</em> is a collection of links and articles related to the deployment, usage, and development of SystemTap. You can find it at <a href=" http://sourceware.org/systemtap/wiki/HomePage"> http://sourceware.org/systemtap/wiki/HomePage</a>.
- </div></dd><dt class="varlistentry"><span class="term">SystemTap Tutorial</span></dt><dd><div class="para">
- Much of the content in this book comes from the <em class="citetitle">SystemTap Tutorial</em>. The <em class="citetitle">SystemTap Tutorial</em> is a more appropriate reference for users with intermediate to advanced knowledge of C++ and kernel development, and can be found at <a href="http://sourceware.org/systemtap/tutorial/">http://sourceware.org/systemtap/tutorial/</a>.
- </div></dd><dt class="varlistentry"><span class="term">man stapprobes</span></dt><dd><div class="para">
- The <code class="filename">stapprobes</code> man page enumerates a variety of probe points supported by SystemTap, along with additional aliases defined by the SystemTap tapset library. The bottom of the man page includes a list of other man pages enumerating similar probe points for specific system components, such as <code class="filename">tapset::scsi</code>, <code class="filename">tapset::kprocess</code>, <code class="filename">tapset::signal</code>, etc.
- </div></dd><dt class="varlistentry"><span class="term">man stapfuncs</span></dt><dd><div class="para">
- The <code class="filename">stapfuncs</code> man page enumerates numerous functions supported by the SystemTap tapset library, along with the prescribed syntax for each one. Note, however, that this is not a complete list of <span class="emphasis"><em>all</em></span> supported functions; there are more undocumented functions available.
- </div></dd><dt class="varlistentry"><span class="term">SystemTap Tapset Reference Manual</span></dt><dd><div class="para">
- The <em class="citetitle">SystemTap Tapset Reference Manual</em> at <a href="http://sourceware.org/systemtap/tapsets/">http://sourceware.org/systemtap/tapsets/</a> describes the individual predefined functions and probe points of the tapsets greater detail.
- </div></dd><dt class="varlistentry"><span class="term">SystemTap Language Reference</span></dt><dd><div class="para">
- This document is a comprehensive reference of SystemTap's language constructs and syntax. It is recommended for users with a rudimentary to intermediate knowledge of C++ and other similar programming languages. The <em class="citetitle">SystemTap Language Reference</em> is available to all users at <a href="http://sourceware.org/systemtap/langref/">http://sourceware.org/systemtap/langref/</a>
- </div></dd><dt class="varlistentry"><span class="term">Tapset Developers Guide</span></dt><dd><div class="para">
- Once you have sufficient proficiency in writing SystemTap scripts, you can then try your hand out on writing your own tapsets. The <em class="citetitle">Tapset Developers Guide</em> describes how to add functions to your tapset library.
- </div></dd><dt class="varlistentry"><span class="term">Test Suite</span></dt><dd><div class="para">
- The <code class="filename">systemtap-testsuite</code> package allows you to test the entire SystemTap toolchain without having to build from source. In addition, it also contains numerous examples of SystemTap scripts you can study and test; some of these scripts are also documented in <a class="xref" href="useful-systemtap-scripts.html">Chapter 5, <em>Useful SystemTap Scripts</em></a>.
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">Chapter 7. References</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="runtimeerror.html" title="6.2. Runtime Errors and Warnings" /><link rel="next" href="appe-Publican-Revision_History.html" title="Appendix A. Revision History" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="runtimeerror.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="appe-Publican-Revision_History.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="chapter" lang="en-US"><div class="titlepage"><div><div><h1 class="title"><a id="references"></a>Chapter 7. References</h1></div></div></div><div class="para">
+ This chapter enumerates other references for more information about SystemTap. Refer to these sources in the course of writing advanced probes and tapsets.
+ </div><div class="variablelist"><dl class="variablelist"><dt><span class="term">SystemTap Wiki</span></dt><dd><div class="para">
+ The <em class="citetitle">SystemTap Wiki</em> is a collection of links and articles related to the deployment, usage, and development of SystemTap. You can find it at <a href="http://sourceware.org/systemtap/wiki/HomePage">http://sourceware.org/systemtap/wiki/HomePage</a>.
+ </div></dd><dt><span class="term">SystemTap Tutorial</span></dt><dd><div class="para">
+ Much of the content in this book comes from the <em class="citetitle">SystemTap Tutorial</em>. The <em class="citetitle">SystemTap Tutorial</em> is a more appropriate reference for users with intermediate to advanced knowledge of C++ and kernel development, and you can find it at <a href="http://sourceware.org/systemtap/tutorial/">http://sourceware.org/systemtap/tutorial/</a>.
+ </div></dd><dt><span class="term">man stapprobes</span></dt><dd><div class="para">
+ The <span class="citerefentry"><span class="refentrytitle">stapprobes</span>(3stap)</span> man page enumerates a variety of probe points supported by SystemTap, along with additional aliases defined by the SystemTap tapset library. The bottom part of the man page includes a list of other man pages enumerating similar probe points for specific system components, such as <code class="filename">tapset::scsi</code>, <code class="filename">tapset::kprocess</code>, <code class="filename">tapset::signal</code>, and so on.
+ </div></dd><dt><span class="term">man stapfuncs</span></dt><dd><div class="para">
+ The <span class="citerefentry"><span class="refentrytitle">stapfuncs</span>(3stap)</span> man page enumerates numerous functions supported by the SystemTap tapset library, along with the prescribed syntax for each of them. Note, however, that it does not provide a complete list of <span class="emphasis"><em>all</em></span> supported functions; there are more undocumented functions available.
+ </div></dd><dt><span class="term">SystemTap Tapset Reference Manual</span></dt><dd><div class="para">
+ The <em class="citetitle">SystemTap Tapset Reference Manual</em> describes the individual predefined functions and probe points of the tapsets in greater detail. You can find it at <a href="http://sourceware.org/systemtap/tapsets/">http://sourceware.org/systemtap/tapsets/</a>.
+ </div></dd><dt><span class="term">SystemTap Language Reference</span></dt><dd><div class="para">
+ The <em class="citetitle">SystemTap Language Reference</em> is a comprehensive reference of SystemTap's language constructs and syntax. It is recommended for users with a rudimentary to intermediate knowledge of C++ and other similar programming languages, and is available to all users at <a href="http://sourceware.org/systemtap/langref/">http://sourceware.org/systemtap/langref/</a>.
+ </div></dd><dt><span class="term">Tapset Developers Guide</span></dt><dd><div class="para">
+ Once you have sufficient proficiency in writing SystemTap scripts, you can try to write your own tapsets. The <em class="citetitle">Tapset Developers Guide</em> describes how to add functions to your tapset library.
+ </div></dd><dt><span class="term">Test Suite</span></dt><dd><div class="para">
+ The <span class="package">systemtap-testsuite</span> package allows you to test the entire SystemTap toolchain without having to build it from source code. In addition, it also contains numerous examples of SystemTap scripts to study and test; some of these scripts are also documented in <a class="xref" href="useful-systemtap-scripts.html">Chapter 5, <em>Useful SystemTap Scripts</em></a>.
</div><div class="para">
- By default, the example scripts included in <code class="filename">systemtap-testsuite</code> are located in <code class="filename">/usr/share/systemtap/testsuite/systemtap.examples</code>.
- </div></dd></dl></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="runtimeerror.html"><strong>Prev</strong>6.2. Run Time Errors and Warnings</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="appe-Publican-Revision_History.html"><strong>Next</strong>Appendix A. Revision History</a></li></ul></body></html>
+ By default, the example scripts included in <span class="package">systemtap-testsuite</span> are located in the <code class="filename">/usr/share/systemtap/testsuite/systemtap.examples/</code> directory.
+ </div></dd></dl></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="runtimeerror.html"><strong>Prev</strong>6.2. Runtime Errors and Warnings</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="appe-Publican-Revision_History.html"><strong>Next</strong>Appendix A. Revision History</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>6.2. Run Time Errors and Warnings</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="errors.html" title="Chapter 6. Understanding SystemTap Errors" /><link rel="prev" href="errors.html" title="Chapter 6. Understanding SystemTap Errors" /><link rel="next" href="references.html" title="Chapter 7. References" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="errors.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="references.html"><strong>Next</strong></a></li></ul><div class="section" id="runtimeerror"><div class="titlepage"><div><div><h2 class="title" id="runtimeerror">6.2. Run Time Errors and Warnings</h2></div></div></div><a id="idp32306288" class="indexterm"></a><a id="idp30240080" class="indexterm"></a><a id="idp30241520" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">6.2. Runtime Errors and Warnings</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="errors.html" title="Chapter 6. Understanding SystemTap Errors" /><link rel="prev" href="errors.html" title="Chapter 6. Understanding SystemTap Errors" /><link rel="next" href="references.html" title="Chapter 7. References" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="errors.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="references.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="runtimeerror"></a>6.2. Runtime Errors and Warnings</h2></div></div></div><a id="idm246917354624" class="indexterm"></a><a id="idm246882061792" class="indexterm"></a><a id="idm246882060352" class="indexterm"></a><div class="para">
Runtime errors and warnings occur when the SystemTap instrumentation has been installed and is collecting data on the system.
- </div><div class="formalpara"><h5 class="formalpara" id="idp30243520">WARNING: Number of errors: <em class="replaceable"><code>N</code></em>, skipped probes: <em class="replaceable"><code>M</code></em></h5><a id="idp28622608" class="indexterm"></a><a id="idp28624464" class="indexterm"></a><a id="idp28626352" class="indexterm"></a><a id="idp26869552" class="indexterm"></a>
- Errors and/or skipped probes occurred during this run. Both <em class="replaceable"><code>N</code></em> and <em class="replaceable"><code>M</code></em> are the counts of the number of probes that were not executed due to conditions such as too much time required to execute event handlers over an interval of time.
- </div><div class="formalpara"><h5 class="formalpara" id="idp26873120">division by 0</h5><a id="idp31278256" class="indexterm"></a><a id="idp31280144" class="indexterm"></a><a id="idp31282064" class="indexterm"></a><a id="idp21513520" class="indexterm"></a><a id="idp21515408" class="indexterm"></a>
- The script code performed an invalid division.
- </div><div class="formalpara"><h5 class="formalpara" id="idp21517904">aggregate element not found</h5><a id="idm10712336" class="indexterm"></a><a id="idm10710480" class="indexterm"></a><a id="idm10708592" class="indexterm"></a><a id="idp17276288" class="indexterm"></a>
- A statistics extractor function other than <code class="command">@count</code> was invoked on an aggregate that has not had any values accumulated yet. This is similar to a division by zero.
- </div><div class="formalpara"><h5 class="formalpara" id="idp17279328">aggregation overflow</h5><a id="idp17280416" class="indexterm"></a><a id="idp27233248" class="indexterm"></a><a id="idp27235168" class="indexterm"></a><a id="idp27237056" class="indexterm"></a><a id="idp39317584" class="indexterm"></a>
- An array containing aggregate values contains too many distinct key pairs at this time.
- </div><div class="formalpara"><h5 class="formalpara" id="idp39320496">MAXNESTING exceeded</h5><a id="idp39321296" class="indexterm"></a><a id="idp49373008" class="indexterm"></a><a id="idp49374928" class="indexterm"></a><a id="idp49376816" class="indexterm"></a><a id="idp32436160" class="indexterm"></a>
- Too many levels of function call nesting were attempted. The default nesting of function calls allowed is 10.
- </div><div class="formalpara"><h5 class="formalpara" id="idp32438784">MAXACTION exceeded</h5><a id="idp32439872" class="indexterm"></a><a id="idp29856848" class="indexterm"></a><a id="idp29858768" class="indexterm"></a><a id="idp29860656" class="indexterm"></a><a id="idp48921856" class="indexterm"></a>
- The probe handler attempted to execute too many statements in the probe handler. The default number of actions allowed in a probe handler is 1000.
- </div><div class="formalpara"><h5 class="formalpara" id="idp48924528">kernel/user string copy fault at <em class="replaceable"><code>ADDR</code></em></h5><a id="idp48925904" class="indexterm"></a><a id="idp45966160" class="indexterm"></a><a id="idp45968080" class="indexterm"></a><a id="idp45969968" class="indexterm"></a>
- The probe handler attempted to copy a string from kernel or user-space at an invalid address (<em class="replaceable"><code>ADDR</code></em>).
- </div><div class="formalpara"><h5 class="formalpara" id="idp32790160">pointer dereference fault</h5><a id="idp32791216" class="indexterm"></a><a id="idp32793072" class="indexterm"></a><a id="idp20737456" class="indexterm"></a><a id="idp20739312" class="indexterm"></a>
- There was a fault encountered during a pointer dereference operation such as a target variable evaluation.
- </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="errors.html"><strong>Prev</strong>Chapter 6. Understanding SystemTap Errors</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="references.html"><strong>Next</strong>Chapter 7. References</a></li></ul></body></html>
+ </div><h3><a id="idm246882058352"></a>WARNING: Number of errors: <em class="replaceable"><code>N</code></em>, skipped probes: <em class="replaceable"><code>M</code></em></h3><a id="idm246882056704" class="indexterm"></a><a id="idm246912297600" class="indexterm"></a><a id="idm246912295712" class="indexterm"></a><a id="idm246912293856" class="indexterm"></a><div class="para">
+ Errors and/or skipped probes occurred during this run. Both <em class="replaceable"><code>N</code></em> and <em class="replaceable"><code>M</code></em> are the counts of the number of probes that were not executed due to conditions such as too much time required to execute event handlers over an interval of time.
+ </div><h3><a id="idm246923060384"></a>division by 0</h3><a id="idm246923059584" class="indexterm"></a><a id="idm246923057696" class="indexterm"></a><a id="idm246923055776" class="indexterm"></a><a id="idm246923053888" class="indexterm"></a><a id="idm246870128384" class="indexterm"></a><div class="para">
+ The script code performed an invalid division.
+ </div><h3><a id="idm246870126048"></a>aggregate element not found</h3><a id="idm246870125280" class="indexterm"></a><a id="idm246870123424" class="indexterm"></a><a id="idm246918298992" class="indexterm"></a><a id="idm246918297136" class="indexterm"></a><div class="para">
+ A statistics extractor function other than <code class="command">@count</code> was invoked on an aggregate that has not had any values accumulated yet. This is similar to a division by zero.
+ </div><h3><a id="idm246918294256"></a>aggregation overflow</h3><a id="idm246918293456" class="indexterm"></a><a id="idm246882984576" class="indexterm"></a><a id="idm246882982656" class="indexterm"></a><a id="idm246882980768" class="indexterm"></a><a id="idm246882978880" class="indexterm"></a><div class="para">
+ An array containing aggregate values contains too many distinct key pairs at this time.
+ </div><h3><a id="idm246929772544"></a>MAXNESTING exceeded</h3><a id="idm246929771872" class="indexterm"></a><a id="idm246929769984" class="indexterm"></a><a id="idm246929768064" class="indexterm"></a><a id="idm246873301232" class="indexterm"></a><a id="idm246873299344" class="indexterm"></a><div class="para">
+ Too many levels of function call nesting were attempted. The default nesting of function calls allowed is 10.
+ </div><h3><a id="idm246873296880"></a>MAXACTION exceeded</h3><a id="idm246873296080" class="indexterm"></a><a id="idm246873294192" class="indexterm"></a><a id="idm246870301184" class="indexterm"></a><a id="idm246870299296" class="indexterm"></a><a id="idm246870297408" class="indexterm"></a><div class="para">
+ The probe handler attempted to execute too many statements in the probe handler. The default number of actions allowed in a probe handler is 1000.
+ </div><h3><a id="idm246928751632"></a>kernel/user string copy fault at <em class="replaceable"><code>ADDR</code></em></h3><a id="idm246928750544" class="indexterm"></a><a id="idm246928748656" class="indexterm"></a><a id="idm246928746736" class="indexterm"></a><a id="idm246928744848" class="indexterm"></a><div class="para">
+ The probe handler attempted to copy a string from kernel or user space at an invalid address (<em class="replaceable"><code>ADDR</code></em>).
+ </div><h3><a id="idm246912495088"></a>pointer dereference fault</h3><a id="idm246912494160" class="indexterm"></a><a id="idm246912492304" class="indexterm"></a><a id="idm246912490416" class="indexterm"></a><a id="idm246926018096" class="indexterm"></a><div class="para">
+ There was a fault encountered during a pointer dereference operation such as a target variable evaluation.
+ </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="errors.html"><strong>Prev</strong>Chapter 6. Understanding SystemTap Errors</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="references.html"><strong>Next</strong>Chapter 7. References</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>3.3. Basic SystemTap Handler Constructs</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="understanding-how-systemtap-works.html" title="Chapter 3. Understanding How SystemTap Works" /><link rel="prev" href="systemtapscript-handler.html" title="3.2.2. Systemtap Handler/Body" /><link rel="next" href="targetvariables.html" title="3.3.2. Target Variables" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="systemtapscript-handler.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="targetvariables.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="scriptconstructions" lang="en-US"><div class="titlepage"><div><div><h2 class="title" id="scriptconstructions">3.3. Basic SystemTap Handler Constructs</h2></div></div></div><a id="idp21274432" class="indexterm"></a><a id="idp21272160" class="indexterm"></a><a id="idp26648464" class="indexterm"></a><a id="idp14981216" class="indexterm"></a><a id="idp53545168" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">3.3. Basic SystemTap Handler Constructs</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="understanding-how-systemtap-works.html" title="Chapter 3. Understanding How SystemTap Works" /><link rel="prev" href="systemtapscript-handler.html" title="3.2.2. SystemTap Handler/Body" /><link rel="next" href="targetvariables.html" title="3.3.2. Target Variables" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="systemtapscript-handler.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="targetvariables.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h2 class="title"><a id="scriptconstructions"></a>3.3. Basic SystemTap Handler Constructs</h2></div></div></div><a id="idm246875109312" class="indexterm"></a><a id="idm246875109968" class="indexterm"></a><a id="idm246913133680" class="indexterm"></a><a id="idm246920716992" class="indexterm"></a><a id="idm246921840080" class="indexterm"></a><div class="para">
SystemTap supports the use of several basic constructs in handlers. The syntax for most of these handler constructs are mostly based on C and <code class="command">awk</code> syntax. This section describes several of the most useful SystemTap handler constructs, which should provide you with enough information to write simple yet useful SystemTap scripts.
- </div><div class="section"
id="variablesconstructs"><div class="titlepage"><div><div><h3 class="title" id="variablesconstructs">3.3.1. Variables</h3></div></div></div><a id="idp29097200" class="indexterm"></a><a id="idp45166960" class="indexterm"></a><a id="idp62596432" class="indexterm"></a><a id="idm5937648" class="indexterm"></a><div class="para">
+ </div><div class="section"
><div class="titlepage"><div><div><h3 class="title"><a id="variablesconstructs"></a>3.3.1. Variables</h3></div></div></div><a id="idm246877655232" class="indexterm"></a><a id="idm246914128640" class="indexterm"></a><a id="idm246875111104" class="indexterm"></a><a id="idm246872276016" class="indexterm"></a><div class="para">
Variables can be used freely throughout a handler; simply choose a name, assign a value from a function or expression to it, and use it in an expression. SystemTap automatically identifies whether a variable should be typed as a string or integer, based on the type of the values assigned to it. For instance, if you use set the variable <code class="command">foo</code> to <code class="command">gettimeofday_s()</code> (as in <code class="command">foo = gettimeofday_s()</code>), then <code class="command">foo</code> is typed as a number and can be printed in a <code class="command">printf()</code> with the integer format specifier (<code class="command">%d</code>).
- </div><a id="id
p60148704" class="indexterm"></a><a id="idp65196672" class="indexterm"></a><a id="idp13473312" class="indexterm"></a><div class="para">
+ </div><a id="id
m246912367264" class="indexterm"></a><a id="idm246926099664" class="indexterm"></a><a id="idm246870019072" class="indexterm"></a><div class="para">
Note, however, that by default variables are only local to the probe they are used in. This means that variables are initialized, used and disposed at each probe handler invocation. To share a variable between probes, declare the variable name using <code class="command">global</code> outside of the probes. Consider the following example:
- </div><div class="example"
id="timerjiffies"><h6>Example 3.8. timer-jiffies.stp</h6><div class="example-contents"><pre class="programlisting">global count_jiffies, count_ms
+ </div><div class="example"
><a id="timerjiffies"></a><p class="title"><strong>Example 3.8. timer-jiffies.stp</strong></p><div class="example-contents"><pre class="programlisting">global count_jiffies, count_ms
probe timer.jiffies(100) { count_jiffies ++ }
probe timer.ms(100) { count_ms ++ }
probe timer.ms(12345)
printf ("jiffies:ms ratio %d:%d => CONFIG_HZ=%d\n",
count_jiffies, count_ms, hz)
exit ()
-}</pre></div></div><br class="example-break" /><a id="id
p25252432" class="indexterm"></a><div class="para">
+}</pre></div></div><br class="example-break" /><a id="id
m246926763888" class="indexterm"></a><div class="para">
<a class="xref" href="scriptconstructions.html#timerjiffies">Example 3.8, “timer-jiffies.stp”</a> computes the <code class="command">CONFIG_HZ</code> setting of the kernel using timers that count jiffies and milliseconds, then computing accordingly. The <code class="command">global</code> statement allows the script to use the variables <code class="command">count_jiffies</code> and <code class="command">count_ms</code> (set in their own respective probes) to be shared with <code class="command">probe timer.ms(12345)</code>.
- </div><div
class="note"><div class="admonition_header"><h2>Note</h2></div><div class="admonition"><div class="para">
- The <code class="command">++</code> notation in <a class="xref" href="scriptconstructions.html#timerjiffies">Example 3.8, “timer-jiffies.stp”</a> (i.e. <code class="command">count_jiffies ++</code> and <code class="command">count_ms ++</code>) is used to increment the value of a variable by 1. In the following probe, <code class="command">count_jiffies</code> is incremented by 1 every 100 jiffies:
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="note"><div class="admonition_header"><p><strong>Note</strong></p></div><div class="admonition"><div class="para">
+ The <code class="command">++</code> notation in <a class="xref" href="scriptconstructions.html#timerjiffies">Example 3.8, “timer-jiffies.stp”</a> (that is, <code class="command">count_jiffies ++</code> and <code class="command">count_ms ++</code>) is used to increment the value of a variable by 1. In the following probe, <code class="command">count_jiffies</code> is incremented by 1 every 100 jiffies:
</div><pre class="screen">probe timer.jiffies(100) { count_jiffies ++ }</pre><div class="para">
In this instance, SystemTap understands that <code class="command">count_jiffies</code> is an integer. Because no initial value was assigned to <code class="command">count_jiffies</code>, its initial value is zero by default.
- </div></div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="systemtapscript-handler.html"><strong>Prev</strong>3.2.2. Systemtap Handler/Body</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="targetvariables.html"><strong>Next</strong>3.3.2. Target Variables</a></li></ul></body></html>
+ </div></div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="systemtapscript-handler.html"><strong>Prev</strong>3.2.2. SystemTap Handler/Body</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="targetvariables.html"><strong>Next</strong>3.3.2. Target Variables</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>3.2. SystemTap Scripts</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="understanding-how-systemtap-works.html" title="Chapter 3. Understanding How SystemTap Works" /><link rel="prev" href="understanding-how-systemtap-works.html" title="Chapter 3. Understanding How SystemTap Works" /><link rel="next" href="systemtapscript-handler.html" title="3.2.2. Systemtap Handler/Body" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="understanding-how-systemtap-works.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="systemtapscript-handler.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="scripts" lang="en-US"><div class="titlepage"><div><div><h2 class="title" id="scripts">3.2. SystemTap Scripts</h2></div></div></div><a id="idm6439488" class="indexterm"></a><a id="idm4921472" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">3.2. SystemTap Scripts</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="understanding-how-systemtap-works.html" title="Chapter 3. Understanding How SystemTap Works" /><link rel="prev" href="understanding-how-systemtap-works.html" title="Chapter 3. Understanding How SystemTap Works" /><link rel="next" href="systemtapscript-handler.html" title="3.2.2. SystemTap Handler/Body" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="understanding-how-systemtap-works.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="systemtapscript-handler.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h2 class="title"><a id="scripts"></a>3.2. SystemTap Scripts</h2></div></div></div><a id="idm246921675264" class="indexterm"></a><a id="idm246921676720" class="indexterm"></a><div class="para">
For the most part, SystemTap scripts are the foundation of each SystemTap session. SystemTap scripts instruct SystemTap on what type of information to collect, and what to do once that information is collected.
- </div><a id="idm
4923536" class="indexterm"></a><a id="idm4925488" class="indexterm"></a><a id="idm4927440" class="indexterm"></a><a id="idm4929392" class="indexterm"></a><a id="idm4931344" class="indexterm"></a><a id="idm4933296" class="indexterm"></a><div class="para">
+ </div><a id="idm
246921678784" class="indexterm"></a><a id="idm246921680736" class="indexterm"></a><a id="idm246921682688" class="indexterm"></a><a id="idm246921684640" class="indexterm"></a><a id="idm246921686592" class="indexterm"></a><a id="idm246921688544" class="indexterm"></a><div class="para">
As stated in <a class="xref" href="understanding-how-systemtap-works.html">Chapter 3, <em>Understanding How SystemTap Works</em></a>, SystemTap scripts are made up of two components: <span class="emphasis"><em>events</em></span> and <span class="emphasis"><em>handlers</em></span>. Once a SystemTap session is underway, SystemTap monitors the operating system for the specified events and executes the handlers as they occur.
- </div><div
class="note"><div class="admonition_header"><h2>Note</h2></div><div class="admonition"><a id="idm4937968" class="indexterm"></a><a id="idm4939824" class="indexterm"></a><a id="idm4421776" class="indexterm"></a><div class="para">
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="note"><div class="admonition_header"><p><strong>Note</strong></p></div><div class="admonition"><a id="idm246921693216" class="indexterm"></a><a id="idm246921695184" class="indexterm"></a><a id="idm246921697152" class="indexterm"></a><div class="para">
An event and its corresponding handler is collectively called a <span class="emphasis"><em>probe</em></span>. A SystemTap script can have multiple probes.
</div><div class="para">
A probe's handler is commonly referred to as a <span class="emphasis"><em>probe body</em></span>.
In terms of application development, using events and handlers is similar to instrumenting the code by inserting diagnostic print statements in a program's sequence of commands. These diagnostic print statements allow you to view a history of commands executed once the program is run.
</div><div class="para">
SystemTap scripts allow insertion of the instrumentation code without recompilation of the code and allows more flexibility with regard to handlers. Events serve as the triggers for handlers to run; handlers can be specified to record specified data and print it in a certain manner.
- </div><div class="formalpara" id="scriptformats"><h5 class="formalpara">Format</h5><a id="idm4431088" class="indexterm"></a><a id="idm4430320" class="indexterm"></a><a id="idm4432704" class="indexterm"></a><a id="idm4434608" class="indexterm"></a>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">Format</div><a id="idm246921706464" class="indexterm"></a><a id="idm246921705696" class="indexterm"></a><a id="idm246921708080" class="indexterm"></a><a id="idm246921709984" class="indexterm"></a>
SystemTap scripts use the file extension <code class="filename">.stp</code>, and contains probes written in the following format:
</div><pre class="screen">probe <em class="replaceable"><code>event</code></em> {<em class="replaceable"><code>statements</code></em>}</pre><div class="para">
SystemTap supports multiple events per probe; multiple events are delimited by a comma (<code class="command">,</code>). If multiple events are specified in a single probe, SystemTap will execute the handler when any of the specified events occur.
- </div><a id="idm
4439680" class="indexterm"></a><a id="idp62242000" class="indexterm"></a><a id="idp62239856" class="indexterm"></a><div class="para">
+ </div><a id="idm
246921715056" class="indexterm"></a><a id="idm246921717312" class="indexterm"></a><a id="idm246921719456" class="indexterm"></a><div class="para">
Each probe has a corresponding <em class="firstterm">statement block</em>. This statement block is enclosed in braces (<code class="command">{ }</code>) and contains the statements to be executed per event. SystemTap executes these statements in sequence; special separators or terminators are generally not necessary between multiple statements.
- </div><div
class="note"><div class="admonition_header"><h2>Note</h2></div><div class="admonition"><div class="para">
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="note"><div class="admonition_header"><p><strong>Note</strong></p></div><div class="admonition"><div class="para">
Statement blocks in SystemTap scripts follow the same syntax and semantics as the C programming language. A statement block can be nested within another statement block.
- </div></div></div><a id="id
p62234464" class="indexterm"></a><a id="idp62232528" class="indexterm"></a><a id="idp62230592" class="indexterm"></a><div class="para">
- Systemtap allows you to write functions to factor out code to be used by a number of probes. Thus, rather than repeatedly writing the same series of statements in multiple probes, you can just place the instructions in a <em class="firstterm">function</em>, as in:
+ </div></div></div><a id="id
m246921724864" class="indexterm"></a><a id="idm246921726800" class="indexterm"></a><a id="idm246921728736" class="indexterm"></a><div class="para">
+ SystemTap allows you to write functions to factor out code to be used by a number of probes. Thus, rather than repeatedly writing the same series of statements in multiple probes, you can just place the instructions in a <em class="firstterm">function</em>, as in:
</div><pre class="screen">function <em class="replaceable"><code>function_name</code></em>(<em class="replaceable"><code>arguments</code></em>) {<em class="replaceable"><code>statements</code></em>}
probe <em class="replaceable"><code>event</code></em> {<em class="replaceable"><code>function_name</code></em>(<em class="replaceable"><code>arguments</code></em>)}</pre><div class="para">
The <code class="command"><em class="replaceable"><code>statements</code></em></code> in <em class="replaceable"><code>function_name</code></em> are executed when the probe for <em class="replaceable"><code>event</code></em> executes. The <em class="replaceable"><code>arguments</code></em> are optional values passed into the function.
- </div><div
class="important"><div class="admonition_header"><h2>Important</h2></div><div class="admonition"><div class="para">
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="important"><div class="admonition_header"><p><strong>Important</strong></p></div><div class="admonition"><div class="para">
<a class="xref" href="scripts.html">Section 3.2, “SystemTap Scripts”</a> is designed to introduce readers to the basics of SystemTap scripts. To understand SystemTap scripts better, it is advisable that you refer to <a class="xref" href="useful-systemtap-scripts.html">Chapter 5, <em>Useful SystemTap Scripts</em></a>; each section therein provides a detailed explanation of the script, its events, handlers, and expected output.
- </div></div></div><div class="section"
id="systemtapscript-events"><div class="titlepage"><div><div><h3 class="title" id="systemtapscript-events">3.2.1. Event</h3></div></div></div><a id="idp36369504" class="indexterm"></a><div class="para">
+ </div></div></div><div class="section"
><div class="titlepage"><div><div><h3 class="title"><a id="systemtapscript-events"></a>3.2.1. Event</h3></div></div></div><a id="idm246921741648" class="indexterm"></a><div class="para">
SystemTap events can be broadly classified into two types: <em class="firstterm">synchronous</em> and <em class="firstterm">asynchronous</em>.
- </div><div class="formalpara"><h5 class="formalpara" id="idp36366032">Synchronous Events</h5><a id="idp36365392" class="indexterm"></a><a id="idp36363920" class="indexterm"></a>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">Synchronous Events</div><a id="idm246921745760" class="indexterm"></a><a id="idm246921747232" class="indexterm"></a>
A <em class="firstterm">synchronous</em> event occurs when any process executes an instruction at a particular location in kernel code. This gives other events a reference point from which more contextual data may be available.
- </div><a id="id
p36360368" class="indexterm"></a><a id="idp36358928" class="indexterm"></a><div class="para">
+ </div><a id="id
m246921750784" class="indexterm"></a><a id="idm246921752224" class="indexterm"></a><div class="para">
Examples of synchronous events include:
- </div><div class="variablelist"><dl
><dt class="varlistentry"><span class="term">syscall.<em class="replaceable"><code>system_call</code></em></span></dt><dd><a id="idp36355360" class="indexterm"></a><a id="idm5919568" class="indexterm"></a><div class="para">
+ </div><div class="variablelist"><dl
class="variablelist"><dt><span class="term">syscall.<em class="replaceable"><code>system_call</code></em></span></dt><dd><a id="idm246921755792" class="indexterm"></a><a id="idm246921758544" class="indexterm"></a><div class="para">
The entry to the system call <em class="replaceable"><code>system_call</code></em>. If the exit from a syscall is desired, appending a <code class="command">.return</code> to the event monitor the exit of the system call instead. For example, to specify the entry and exit of the system call <code class="command">close</code>, use <code class="command">syscall.close</code> and <code class="command">syscall.close.return</code> respectively.
- </div></dd><dt
class="varlistentry"><span class="term">vfs.<em class="replaceable"><code>file_operation</code></em></span></dt><dd><a id="idm5925776" class="indexterm"></a><a id="idm5927728" class="indexterm"></a><div class="para">
+ </div></dd><dt
><span class="term">vfs.<em class="replaceable"><code>file_operation</code></em></span></dt><dd><a id="idm246921764832" class="indexterm"></a><a id="idm246921766784" class="indexterm"></a><div class="para">
The entry to the <em class="replaceable"><code>file_operation</code></em> event for Virtual File System (VFS). Similar to <code class="command">syscall</code> event, appending a <code class="command">.return</code> to the event monitors the exit of the <em class="replaceable"><code>file_operation</code></em> operation.
- </div></dd><dt
class="varlistentry"><span class="term">kernel.function("<em class="replaceable"><code>function</code></em>")</span></dt><dd><a id="idm5934928" class="indexterm"></a><a id="idm5937344" class="indexterm"></a><div class="para">
- The entry to the kernel function <em class="replaceable"><code>function</code></em>. For example, <code class="command">kernel.function("sys_open")</code> refers to the "event" that occurs when the kernel function <code class="command">sys_open</code> is called by any thread in the system. To specify the <span class="emphasis"><em>return</em></span> of the kernel function <code class="command">sys_open</code>, append the <code class="command">return</code> string to the event statement; i.e. <code class="command">kernel.function("sys_open").return</code>.
- </div><a id="id
p28923808" class="indexterm"></a><a id="idp28922352" class="indexterm"></a><a id="idp28921408" class="indexterm"></a><div class="para">
+ </div></dd><dt
><span class="term">kernel.function("<em class="replaceable"><code>function</code></em>")</span></dt><dd><a id="idm246921773984" class="indexterm"></a><a id="idm246921776400" class="indexterm"></a><div class="para">
+ The entry to the kernel function <em class="replaceable"><code>function</code></em>. For example, <code class="command">kernel.function("sys_open")</code> refers to the "event" that occurs when the kernel function <code class="command">sys_open</code> is called by any thread in the system. To specify the <span class="emphasis"><em>return</em></span> of the kernel function <code class="command">sys_open</code>, append the <code class="command">return</code> string to the event statement; that is, <code class="command">kernel.function("sys_open").return</code>.
+ </div><a id="id
m246921783296" class="indexterm"></a><a id="idm246921784752" class="indexterm"></a><a id="idm246921785696" class="indexterm"></a><div class="para">
When defining probe events, you can use asterisk (<code class="literal">*</code>) for wildcards. You can also trace the entry or exit of a function in a kernel source file. Consider the following example:
- </div><div class="example"
id="wildcards"><h6>Example 3.1. wildcards.stp</h6><div class="example-contents"><pre class="programlisting">probe kernel.function("*@net/socket.c") { }
+ </div><div class="example"
><a id="wildcards"></a><p class="title"><strong>Example 3.1. wildcards.stp</strong></p><div class="example-contents"><pre class="programlisting">probe kernel.function("*@net/socket.c") { }
probe kernel.function("*@net/socket.c").return { }</pre></div></div><br class="example-break" /><div class="para">
In the previous example, the first probe's event specifies the entry of ALL functions in the kernel source file <code class="filename">net/socket.c</code>. The second probe specifies the exit of all those functions. Note that in this example, there are no statements in the handler; as such, no information will be collected or displayed.
- </div></dd><dt
class="varlistentry"><span class="term">kernel.trace("<em class="replaceable"><code>tracepoint</code></em>")</span></dt><dd><a id="idp28913600" class="indexterm"></a><a id="idp28910768" class="indexterm"></a><a id="idp28910448" class="indexterm"></a><div class="para">
+ </div></dd><dt
><span class="term">kernel.trace("<em class="replaceable"><code>tracepoint</code></em>")</span></dt><dd><a id="idm246921793504" class="indexterm"></a><a id="idm246921796336" class="indexterm"></a><a id="idm246921796656" class="indexterm"></a><div class="para">
The static probe for <em class="replaceable"><code>tracepoint</code></em>. Recent kernels (2.6.30 and newer) include instrumentation for specific events in the kernel. These events are statically marked with tracepoints. One example of a tracepoint available in systemtap is <code class="command">kernel.trace("kfree_skb")</code> which indicates each time a network buffer is freed in the kernel.
- </div></dd><dt
class="varlistentry"><span class="term">module("<em class="replaceable"><code>module</code></em>").function("<em class="replaceable"><code>function</code></em>")</span></dt><dd><a id="idp27363472" class="indexterm"></a><a id="idp27361072" class="indexterm"></a><div class="para">
+ </div></dd><dt
><span class="term">module("<em class="replaceable"><code>module</code></em>").function("<em class="replaceable"><code>function</code></em>")</span></dt><dd><a id="idm246921802816" class="indexterm"></a><a id="idm246921805296" class="indexterm"></a><div class="para">
Allows you to probe functions within modules. For example:
- </div><div class="example"
id="eventsmodules"><h6>Example 3.2. moduleprobe.stp</h6><div class="example-contents"><pre class="programlisting">probe module("ext3").function("*") { }
+ </div><div class="example"
><a id="eventsmodules"></a><p class="title"><strong>Example 3.2. moduleprobe.stp</strong></p><div class="example-contents"><pre class="programlisting">probe module("ext3").function("*") { }
probe module("ext3").function("*").return { }</pre></div></div><br class="example-break" /><div class="para">
The first probe in <a class="xref" href="scripts.html#eventsmodules">Example 3.2, “moduleprobe.stp”</a> points to the entry of <span class="emphasis"><em>all</em></span> functions for the <code class="filename">ext3</code> module. The second probe points to the exits of all functions for that same module; the use of the <code class="command">.return</code> suffix is similar to <code class="command">kernel.function()</code>. Note that the probes in <a class="xref" href="scripts.html#eventsmodules">Example 3.2, “moduleprobe.stp”</a> do not contain statements in the probe handlers, and as such will not print any useful data (as in <a class="xref" href="scripts.html#wildcards">Example 3.1, “wildcards.stp”</a>).
</div><div class="para">
A system's kernel modules are typically located in <code class="filename">/lib/modules/<em class="replaceable"><code>kernel_version</code></em></code>, where <em class="replaceable"><code>kernel_version</code></em> refers to the currently loaded kernel version. Modules use the file name extension <code class="filename">.ko</code>.
- </div></dd></dl></div><div class="formalpara"><h5 class="formalpara" id="idp27349952">Asynchronous Events</h5><a id="idp27348832" class="indexterm"></a><a id="idp27347376" class="indexterm"></a>
+ </div></dd></dl></div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">Asynchronous Events</div><a id="idm246921817536" class="indexterm"></a><a id="idm246921818992" class="indexterm"></a>
<em class="firstterm">Asynchronous</em> events are not tied to a particular instruction or location in code. This family of probe points consists mainly of counters, timers, and similar constructs.
</div><div class="para">
Examples of asynchronous events include:
- </div><div class="variablelist"><dl
><dt class="varlistentry"><span class="term">begin</span></dt><dd><a id="idm7922320" class="indexterm"></a><a id="idm7922640" class="indexterm"></a><div class="para">
- The startup of a SystemTap session; i.e. as soon as the SystemTap script is run.
- </div></dd><dt
class="varlistentry"><span class="term">end</span></dt><dd><a id="idm7926368" class="indexterm"></a><a id="idm7927664" class="indexterm"></a><div class="para">
+ </div><div class="variablelist"><dl
class="variablelist"><dt><span class="term">begin</span></dt><dd><a id="idm246921825792" class="indexterm"></a><a id="idm246921826112" class="indexterm"></a><div class="para">
+ The startup of a SystemTap session; that is, as soon as the SystemTap script is run.
+ </div></dd><dt
><span class="term">end</span></dt><dd><a id="idm246921829840" class="indexterm"></a><a id="idm246921831136" class="indexterm"></a><div class="para">
The end of a SystemTap session.
- </div></dd><dt
class="varlistentry"><span class="term">timer events</span></dt><dd><a id="idm7931632" class="indexterm"></a><a id="idm7933088" class="indexterm"></a><div class="para">
+ </div></dd><dt
><span class="term">timer events</span></dt><dd><a id="idm246921835104" class="indexterm"></a><a id="idm246921836560" class="indexterm"></a><div class="para">
An event that specifies a handler to be executed periodically. For example:
- </div><div class="example"
id="timer"><h6>Example 3.3. timer-s.stp</h6><div class="example-contents"><pre class="programlisting">probe timer.s(4)
+ </div><div class="example"
><a id="timer"></a><p class="title"><strong>Example 3.3. timer-s.stp</strong></p><div class="example-contents"><pre class="programlisting">probe timer.s(4)
{
printf("hello world\n")
}</pre></div></div><br class="example-break" /><div class="para">
- <a class="xref" href="scripts.html#timer">Example 3.3, “timer-s.stp”</a> is an example of a probe that prints <code class="command">hello world</code> every 4 seconds. Note that you can also use the following timer events:
- </div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
+ <a class="xref" href="scripts.html#timer">Example 3.3, “timer-s.stp”</a> is an example of a probe that prints <code class="command">hello world</code> every 4 seconds. It is also possible to use the following timer events:
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
<code class="command">timer.ms(<em class="replaceable"><code>milliseconds</code></em>)</code>
</div></li><li class="listitem"><div class="para">
<code class="command">timer.us(<em class="replaceable"><code>microseconds</code></em>)</code>
<code class="command">timer.jiffies(<em class="replaceable"><code>jiffies</code></em>)</code>
</div></li></ul></div><div class="para">
When used in conjunction with other probes that collect information, timer events allows you to print out get periodic updates and see how that information changes over time.
- </div></dd></dl></div><div
class="important"><div class="admonition_header"><h2>Important</h2></div><div class="admonition"><div class="para">
+ </div></dd></dl></div><div
xmlns:d="http://docbook.org/ns/docbook" class="important"><div class="admonition_header"><p><strong>Important</strong></p></div><div class="admonition"><div class="para">
SystemTap supports the use of a large collection of probe events. For more information about supported events, refer to <code class="command">man stapprobes</code>. The <em class="citetitle">SEE ALSO</em> section of <code class="command">man stapprobes</code> also contains links to other <code class="command">man</code> pages that discuss supported events for specific subsystems and components.
- </div></div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="understanding-how-systemtap-works.html"><strong>Prev</strong>Chapter 3. Understanding How SystemTap Works</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="systemtapscript-handler.html"><strong>Next</strong>3.2.2. Systemtap Handler/Body</a></li></ul></body></html>
+ </div></div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="understanding-how-systemtap-works.html"><strong>Prev</strong>Chapter 3. Understanding How SystemTap Works</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="systemtapscript-handler.html"><strong>Next</strong>3.2.2. SystemTap Handler/Body</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>5.3.6. Tracking System Call Volume Per Process</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-profiling.html" title="5.3. Profiling" /><link rel="prev" href="topsyssect.html" title="5.3.5. Tracking Most Frequently Used System Calls" /><link rel="next" href="futexcontentionsect.html" title="5.4. Identifying Contended User-Space Locks" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="topsyssect.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="futexcontentionsect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="syscallsbyprocpidsect" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="syscallsbyprocpidsect">5.3.6. Tracking System Call Volume Per Process</h3></div></div></div><a id="idp45906528" class="indexterm"></a><a id="idm1934848" class="indexterm"></a><a id="idp40104512" class="indexterm"></a><a id="idp29954720" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">5.3.6. Tracking System Call Volume Per Process</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-profiling.html" title="5.3. Profiling" /><link rel="prev" href="topsyssect.html" title="5.3.5. Tracking Most Frequently Used System Calls" /><link rel="next" href="futexcontentionsect.html" title="5.4. Identifying Contended User-Space Locks" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="topsyssect.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="futexcontentionsect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="syscallsbyprocpidsect"></a>5.3.6. Tracking System Call Volume Per Process</h3></div></div></div><a id="idm246913101264" class="indexterm"></a><a id="idm246920806208" class="indexterm"></a><a id="idm246917447568" class="indexterm"></a><a id="idm246913519088" class="indexterm"></a><div class="para">
This section illustrates how to determine which processes are performing the highest volume of system calls. In previous sections, we've described how to monitor the top system calls used by the system over time (<a class="xref" href="topsyssect.html">Section 5.3.5, “Tracking Most Frequently Used System Calls”</a>). We've also described how to identify which applications use a specific set of "polling suspect" system calls the most (<a class="xref" href="timeoutssect.html">Section 5.3.4, “Monitoring Polling Applications”</a>). Monitoring the volume of system calls made by each process provides more data in investigating your system for polling processes and other resource hogs.
- </div><div class="formalpara" id="syscallsbyprocpid"><h5 class="formalpara">syscalls_by_proc.stp</h5>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">syscalls_by_proc.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
</pre>
</div><div class="para">
<a class="xref" href="syscallsbyprocpidsect.html#syscallsbyprocpid">syscalls_by_proc.stp</a> lists the top 20 processes performing the highest number of system calls. It also lists how many system calls each process performed during the time period. Refer to <a class="xref" href="syscallsbyprocpidsect.html#syscallsbyprocpidoutput">Example 5.18, “topsys.stp Sample Output”</a> for a sample output.
- </div><div class="example"
id="syscallsbyprocpidoutput"><h6>Example 5.18. <a class="xref" href="topsyssect.html#topsys">topsys.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen">Collecting data... Type Ctrl-C to exit and display results
+ </div><div class="example"
><a id="syscallsbyprocpidoutput"></a><p class="title"><strong>Example 5.18. <a class="xref" href="topsyssect.html#topsys">topsys.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen">Collecting data... Type Ctrl-C to exit and display results
#SysCalls Process Name
1577 multiload-apple
692 synergyc
78 gnome-screensav
66 scim-launcher
[...]</pre></div></div><br class="example-break" /><div class="para">
- If you prefer the output to display the process IDs instead of the process names, use the following script instead.
- </div><div class="formalpara" id="syscallsbypid"><h5 class="formalpara">syscalls_by_pid.stp</h5>
+ To display the process IDs instead of the process names, use the following script instead.
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">syscalls_by_pid.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
</div><pre class="screen">probe timer.s(5)
{
exit()
-}</pre></div><ul class="docnav"><li class="previous"><a accesskey="p" href="topsyssect.html"><strong>Prev</strong>5.3.5. Tracking Most Frequently Used System Calls</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="futexcontentionsect.html"><strong>Next</strong>5.4. Identifying Contended User-Space Locks</a></li></ul></body></html>
+}</pre></div><ul class="docnav"><li class="previous"><a accesskey="p" href="topsyssect.html"><strong>Prev</strong>5.3.5. Tracking Most Frequently Used System Calls</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="futexcontentionsect.html"><strong>Next</strong>5.4. Identifying Contended User-Space Locks</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>3.2.2. Systemtap Handler/Body</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="scripts.html" title="3.2. SystemTap Scripts" /><link rel="prev" href="scripts.html" title="3.2. SystemTap Scripts" /><link rel="next" href="scriptconstructions.html" title="3.3. Basic SystemTap Handler Constructs" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="scripts.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="scriptconstructions.html"><strong>Next</strong></a></li></ul><div class="section" id="systemtapscript-handler"><div class="titlepage"><div><div><h3 class="title" id="systemtapscript-handler">3.2.2. Systemtap Handler/Body</h3></div></div></div><a id="idp53544432" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">3.2.2. SystemTap Handler/Body</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="scripts.html" title="3.2. SystemTap Scripts" /><link rel="prev" href="scripts.html" title="3.2. SystemTap Scripts" /><link rel="next" href="scriptconstructions.html" title="3.3. Basic SystemTap Handler Constructs" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="scripts.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="scriptconstructions.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="systemtapscript-handler"></a>3.2.2. SystemTap Handler/Body</h3></div></div></div><a id="idm246921858192" class="indexterm"></a><div class="para">
Consider the following sample script:
- </div><div class="example"
id="helloworld"><h6>Example 3.4. helloworld.stp</h6><div class="example-contents"><pre class="programlisting">probe begin
+ </div><div class="example"
><a id="helloworld"></a><p class="title"><strong>Example 3.4. helloworld.stp</strong></p><div class="example-contents"><pre class="programlisting">probe begin
{
printf ("hello world\n")
exit ()
}</pre></div></div><br class="example-break" /><div class="para">
- In <a class="xref" href="systemtapscript-handler.html#helloworld">Example 3.4, “helloworld.stp”</a>, the event <code class="command">begin</code> (i.e. the start of the session) triggers the handler enclosed in <code class="command">{ }</code>, which simply prints <code class="command">hello world</code> followed by a new-line, then exits.
- </div><div
class="note"><div class="admonition_header"><h2>Note</h2></div><div class="admonition"><a id="idm6922144" class="indexterm"></a><a id="idm6923840" class="indexterm"></a><div class="para">
+ In <a class="xref" href="systemtapscript-handler.html#helloworld">Example 3.4, “helloworld.stp”</a>, the event <code class="command">begin</code> (that is, the start of the session) triggers the handler enclosed in <code class="command">{ }</code>, which simply prints <code class="command">hello world</code> followed by a new-line, then exits.
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="note"><div class="admonition_header"><p><strong>Note</strong></p></div><div class="admonition"><a id="idm246921865616" class="indexterm"></a><a id="idm246921867344" class="indexterm"></a><div class="para">
SystemTap scripts continue to run until the <code class="command">exit()</code> function executes. If the users wants to stop the execution of the script, it can interrupted manually with <span class="keycap"><strong>Ctrl</strong></span>+<span class="keycap"><strong>C</strong></span>.
- </div></div></div><div class="formalpara" id="printf"><h5 class="formalpara">printf ( ) Statements</h5><a id="idm6928480" class="indexterm"></a>
+ </div></div></div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">printf ( ) Statements</div><a id="idm246921871984" class="indexterm"></a>
The <code class="command">printf ()</code> statement is one of the simplest functions for printing data. <code class="command">printf ()</code> can also be used to display data using a wide variety of SystemTap functions in the following format:
</div><pre class="programlisting"> printf ("<em class="replaceable"><code>format string</code></em>\n", <em class="replaceable"><code>arguments</code></em>)
-</pre><a id="idm
6933344" class="indexterm"></a><a id="idm6935040" class="indexterm"></a><div class="para">
- The <em class="replaceable"><code>format string</code></em> specifies how <em class="replaceable"><code>arguments</code></em> should be printed. The format string of <a class="xref" href="systemtapscript-handler.html#helloworld">Example 3.4, “helloworld.stp”</a> simply instructs SystemTap to print <code class="command">hello world</code>, and contains no format specifiers.
- </div><a id="id
p29377904" class="indexterm"></a><a id="idp29376624" class="indexterm"></a><div class="para">
+</pre><a id="idm
246921876624" class="indexterm"></a><a id="idm246921878320" class="indexterm"></a><div class="para">
+ The <em class="replaceable"><code>format string</code></em> specifies how <em class="replaceable"><code>arguments</code></em> should be printed. The format string of <a class="xref" href="systemtapscript-handler.html#helloworld">Example 3.4, “helloworld.stp”</a> instructs SystemTap to print <code class="command">hello world</code>, and contains no format specifiers.
+ </div><a id="id
m246921882032" class="indexterm"></a><a id="idm246921883792" class="indexterm"></a><div class="para">
You can use the format specifiers <code class="command">%s</code> (for strings) and <code class="command">%d</code> (for numbers) in format strings, depending on your list of arguments. Format strings can have multiple format specifiers, each matching a corresponding argument; multiple arguments are delimited by a comma (<code class="command">,</code>).
- </div><div
class="note"><div class="admonition_header"><h2>Note</h2></div><div class="admonition"><a id="idp29372400" class="indexterm"></a><a id="idp29370224" class="indexterm"></a><a id="idp29368096" class="indexterm"></a><div class="para">
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="note"><div class="admonition_header"><p><strong>Note</strong></p></div><div class="admonition"><a id="idm246921888016" class="indexterm"></a><a id="idm246921889520" class="indexterm"></a><a id="idm246921892320" class="indexterm"></a><div class="para">
Semantically, the SystemTap <code class="command">printf</code> function is very similar to its C language counterpart. The aforementioned syntax and format for SystemTap's <code class="command">printf</code> function is identical to that of the C-style <code class="command">printf</code>.
</div></div></div><div class="para">
To illustrate this, consider the following probe example:
- </div><div class="example"
id="syscall-open"><h6>Example 3.5. variables-in-printf-statements.stp</h6><div class="example-contents"><pre class="programlisting">probe syscall.open
+ </div><div class="example"
><a id="syscall-open"></a><p class="title"><strong>Example 3.5. variables-in-printf-statements.stp</strong></p><div class="example-contents"><pre class="programlisting">probe syscall.open
{
printf ("%s(%d) open\n", execname(), pid())
}</pre></div></div><br class="example-break" /><div class="para">
df(3433) open
df(3433) open
df(3433) open
-hald(2360) open</pre><div class="formalpara" id="systemtapscript-functions"><h5 class="formalpara">SystemTap Functions</h5><a id="idp25426000" class="indexterm"></a><a id="idp25425104" class="indexterm"></a><a id="idp25424208" class="indexterm"></a>
+hald(2360) open</pre><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">SystemTap Functions</div><a id="idm246921903104" class="indexterm"></a><a id="idm246921904000" class="indexterm"></a><a id="idm246921904992" class="indexterm"></a>
SystemTap supports a wide variety of functions that can be used as <code class="command">printf ()</code> arguments. <a class="xref" href="systemtapscript-handler.html#syscall-open">Example 3.5, “variables-in-printf-statements.stp”</a> uses the SystemTap functions <code class="command">execname()</code> (name of the process that called a kernel function/performed a system call) and <code class="command">pid()</code> (current process ID).
</div><div class="para">
The following is a list of commonly-used SystemTap functions:
- </div><div class="variablelist"><dl
><dt class="varlistentry"><span class="term">tid()</span></dt><dd><a id="idp25417408" class="indexterm"></a><a id="idp25415504" class="indexterm"></a><a id="idp25413600" class="indexterm"></a><div class="para">
+ </div><div class="variablelist"><dl
class="variablelist"><dt><span class="term">tid()</span></dt><dd><a id="idm246921911280" class="indexterm"></a><a id="idm246921913184" class="indexterm"></a><a id="idm246921915088" class="indexterm"></a><div class="para">
The ID of the current thread.
- </div></dd><dt
class="varlistentry"><span class="term">uid()</span></dt><dd><a id="idp25409712" class="indexterm"></a><a id="idp25407504" class="indexterm"></a><div class="para">
+ </div></dd><dt
><span class="term">uid()</span></dt><dd><a id="idm246921918848" class="indexterm"></a><a id="idm246921921184" class="indexterm"></a><div class="para">
The ID of the current user.
- </div></dd><dt
class="varlistentry"><span class="term">cpu()</span></dt><dd><a id="idp35280032" class="indexterm"></a><a id="idp35277952" class="indexterm"></a><div class="para">
+ </div></dd><dt
><span class="term">cpu()</span></dt><dd><a id="idm246921925072" class="indexterm"></a><a id="idm246921927664" class="indexterm"></a><div class="para">
The current CPU number.
- </div></dd><dt
class="varlistentry"><span class="term">gettimeofday_s()</span></dt><dd><a id="idp35273520" class="indexterm"></a><a id="idp35271424" class="indexterm"></a><div class="para">
+ </div></dd><dt
><span class="term">gettimeofday_s()</span></dt><dd><a id="idm246921931584" class="indexterm"></a><a id="idm246921934160" class="indexterm"></a><div class="para">
The number of seconds since UNIX epoch (January 1, 1970).
- </div></dd><dt
class="varlistentry"><span class="term">ctime()</span></dt><dd><a id="idp35266560" class="indexterm"></a><a id="idp35264352" class="indexterm"></a><div class="para">
+ </div></dd><dt
><span class="term">ctime()</span></dt><dd><a id="idm246921939024" class="indexterm"></a><a id="idm246921941264" class="indexterm"></a><div class="para">
Convert number of seconds since UNIX epoch to date.
- </div></dd><dt
class="varlistentry"><span class="term">pp()</span></dt><dd><a id="idp34376752" class="indexterm"></a><a id="idp34375952" class="indexterm"></a><div class="para">
+ </div></dd><dt
><span class="term">pp()</span></dt><dd><a id="idm246921946208" class="indexterm"></a><a id="idm246921948800" class="indexterm"></a><div class="para">
A string describing the probe point currently being handled.
- </div></dd><dt
class="varlistentry"><span class="term">thread_indent()</span></dt><dd><a id="idp34371872" class="indexterm"></a><a id="idp34369264" class="indexterm"></a><div class="para">
- This particular function is quite useful, providing you with a way to better organize your print results. The function takes one argument, an indentation delta, which indicates how many spaces to add or remove from a thread's "indentation counter". It then returns a string with some generic trace data along with an appropriate number of indentation spaces.
+ </div></dd><dt
><span class="term">thread_indent()</span></dt><dd><a id="idm246921952864" class="indexterm"></a><a id="idm246921955008" class="indexterm"></a><div class="para">
+ This particular function is quite useful in providing you with a way to better organize your print results. The function takes one argument, an indentation delta, which indicates how many spaces to add or remove from a thread's "indentation counter". It then returns a string with some generic trace data along with an appropriate number of indentation spaces.
</div><div class="para">
The generic data included in the returned string includes a timestamp (number of microseconds since the first call to <code class="command">thread_indent()</code> by the thread), a process name, and the thread ID. This allows you to identify what functions were called, who called them, and the duration of each function call.
</div><div class="para">
If call entries and exits immediately precede each other, it is easy to match them. However, in most cases, after a first function call entry is made several other call entries and exits may be made before the first call exits. The indentation counter helps you match an entry with its corresponding exit by indenting the next function call if it is not the exit of the previous one.
</div><div class="para">
Consider the following example on the use of <code class="command">thread_indent()</code>:
- </div><div class="example"
id="thread_indent"><h6>Example 3.6. thread_indent.stp</h6><div class="example-contents"><pre class="programlisting">probe kernel.function("*@net/socket.c").call
+ </div><div class="example"
><a id="thread_indent"></a><p class="title"><strong>Example 3.6. thread_indent.stp</strong></p><div class="example-contents"><pre class="programlisting">probe kernel.function("*@net/socket.c").call
{
printf ("%s -> %s\n", thread_indent(1), probefunc())
}
4732 ftp(7223): <- sys_socket
4775 ftp(7223): <- sys_socketcall</pre><div class="para">
This sample output contains the following information:
- </div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
The time (in microseconds) since the initial <code class="command">thread_indent()</code> call for the thread (included in the string from <code class="command">thread_indent()</code>).
</div></li><li class="listitem"><div class="para">
The process name (and its corresponding ID) that made the function call (included in the string from <code class="command">thread_indent()</code>).
An arrow signifying whether the call was an entry (<code class="computeroutput"><-</code>) or an exit (<code class="computeroutput">-></code>); the indentations help you match specific function call entries with their corresponding exits.
</div></li><li class="listitem"><div class="para">
The name of the function called by the process.
- </div></li></ul></div></dd><dt
class="varlistentry"><span class="term">name</span></dt><dd><a id="idp41807504" class="indexterm"></a><a id="idp41805184" class="indexterm"></a><a id="idp14145632" class="indexterm"></a><div class="para">
+ </div></li></ul></div></dd><dt
><span class="term">name</span></dt><dd><a id="idm246882946688" class="indexterm"></a><a id="idm246926803360" class="indexterm"></a><a id="idm246926804848" class="indexterm"></a><div class="para">
Identifies the name of a specific system call. This variable can only be used in probes that use the event <code class="command">syscall.<em class="replaceable"><code>system_call</code></em></code>.
- </div></dd><dt
class="varlistentry"><span class="term">target()</span></dt><dd><a id="idp14140960" class="indexterm"></a><a id="idp52365248" class="indexterm"></a><div class="para">
+ </div></dd><dt
><span class="term">target()</span></dt><dd><a id="idm246926809808" class="indexterm"></a><a id="idm246917557280" class="indexterm"></a><div class="para">
Used in conjunction with <code class="command">stap <em class="replaceable"><code>script</code></em> -x <em class="replaceable"><code>process ID</code></em></code> or <code class="command">stap <em class="replaceable"><code>script</code></em> -c <em class="replaceable"><code>command</code></em></code>. If you want to specify a script to take an argument of a process ID or command, use <code class="command">target()</code> as the variable in the script to refer to it. For example:
- </div><div class="example"
id="targetexample"><h6>Example 3.7. targetexample.stp</h6><div class="example-contents"><pre class="programlisting">probe syscall.* {
+ </div><div class="example"
><a id="targetexample"></a><p class="title"><strong>Example 3.7. targetexample.stp</strong></p><div class="example-contents"><pre class="programlisting">probe syscall.* {
if (pid() == target())
- printf("%s/n", name)
+ printf("%s\n", name)
}</pre></div></div><br class="example-break" /><div class="para">
When <a class="xref" href="systemtapscript-handler.html#targetexample">Example 3.7, “targetexample.stp”</a> is run with the argument <code class="command">-x <em class="replaceable"><code>process ID</code></em></code>, it watches all system calls (as specified by the event <code class="command">syscall.*</code>) and prints out the name of all system calls made by the specified process.
</div><div class="para">
- This has the same effect as specifying <code class="command">if (pid() == <em class="replaceable"><code>process ID</code></em>)</code> each time you wish to target a specific process. However, using <code class="command">target()</code> makes it easier for you to re-use the script, giving you the ability to simply pass a process ID as an argument each time you wish to run the script (e.g. <code class="command">stap targetexample.stp -x <em class="replaceable"><code>process ID</code></em></code>).
+ This has the same effect as specifying <code class="command">if (pid() == <em class="replaceable"><code>process ID</code></em>)</code> each time you wish to target a specific process. However, using <code class="command">target()</code> makes it easier for you to re-use the script, giving you the ability to pass a process ID as an argument each time you wish to run the script (that is, <code class="command">stap targetexample.stp -x <em class="replaceable"><code>process ID</code></em></code>).
</div></dd></dl></div><div class="para">
For more information about supported SystemTap functions, refer to <code class="command">man stapfuncs</code>.
- </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="scripts.html"><strong>Prev</strong>3.2. SystemTap Scripts</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="scriptconstructions.html"><strong>Next</strong>3.3. Basic SystemTap Handler Constructs</a></li></ul></body></html>
+ </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="scripts.html"><strong>Prev</strong>3.2. SystemTap Scripts</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="scriptconstructions.html"><strong>Next</strong>3.3. Basic SystemTap Handler Constructs</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>3.3.2.3. Checking Target Variable Availablility</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="targetvariables.html" title="3.3.2. Target Variables" /><link rel="prev" href="typecasting.html" title="3.3.2.2. Typecasting" /><link rel="next" href="handlerconditionalstatements.html" title="3.3.3. Conditional Statements" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="typecasting.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="handlerconditionalstatements.html"><strong>Next</strong></a></li></ul><div class="section" id="targetavailable"><div class="titlepage"><div><div><h4 class="title" id="targetavailable">3.3.2.3. Checking Target Variable Availablility</h4></div></div></div><a id="idp33325312" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">3.3.2.3. Checking Target Variable Availability</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="targetvariables.html" title="3.3.2. Target Variables" /><link rel="prev" href="typecasting.html" title="3.3.2.2. Typecasting" /><link rel="next" href="handlerconditionalstatements.html" title="3.3.3. Conditional Statements" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="typecasting.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="handlerconditionalstatements.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="targetavailable"></a>3.3.2.3. Checking Target Variable Availability</h4></div></div></div><a id="idm246873353520" class="indexterm"></a><div class="para">
As code evolves the target variables available may change. The <code class="command">@defined</code> makes it easier to handle those variations in the available target variables. The <code class="command">@defined</code> provides a test to see if a particular target variable is available. The result of this test can be used to select the appropriate expression.
</div><div class="para">
The <a class="xref" href="targetavailable.html#available">Example 3.10, “Testing target variable available Example”</a> from the <code class="command">memory.stp</code> tapset provides an probe event alias. Some version of the kernel functions being probed have an argument <code class="command">$flags</code>. When available, the <code class="command">$flags</code> argument is used to generate the local variable <code class="command">write_access</code>. The versions of the probed functions that do not have the <code class="command">$flags</code> argument have a <code class="command">$write</code> argument and that is used instead for the local variable <code class="command">write_access</code>.
- </div><div class="example"
id="available"><h6>Example 3.10. Testing target variable available Example</h6><div class="example-contents"><pre class="programlisting">probe vm.pagefault = kernel.function("__handle_mm_fault@mm/memory.c") ?,
+ </div><div class="example"
><a id="available"></a><p class="title"><strong>Example 3.10. Testing target variable available Example</strong></p><div class="example-contents"><pre class="programlisting">probe vm.pagefault = kernel.function("__handle_mm_fault@mm/memory.c") ?,
kernel.function("handle_mm_fault@mm/memory.c") ?
{
name = "pagefault"
? $flags & FAULT_FLAG_WRITE : $write_access)
address = $address
}
-</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="typecasting.html"><strong>Prev</strong>3.3.2.2. Typecasting</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="handlerconditionalstatements.html"><strong>Next</strong>3.3.3. Conditional Statements</a></li></ul></body></html>
+</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="typecasting.html"><strong>Prev</strong>3.3.2.2. Typecasting</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="handlerconditionalstatements.html"><strong>Next</strong>3.3.3. Conditional Statements</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>3.3.2. Target Variables</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="scriptconstructions.html" title="3.3. Basic SystemTap Handler Constructs" /><link rel="prev" href="scriptconstructions.html" title="3.3. Basic SystemTap Handler Constructs" /><link rel="next" href="typecasting.html" title="3.3.2.2. Typecasting" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="scriptconstructions.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="typecasting.html"><strong>Next</strong></a></li></ul><div class="section" id="targetvariables"><div class="titlepage"><div><div><h3 class="title" id="targetvariables">3.3.2. Target Variables</h3></div></div></div><a id="idp21279136" class="indexterm"></a><a id="idp50692384" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">3.3.2. Target Variables</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="scriptconstructions.html" title="3.3. Basic SystemTap Handler Constructs" /><link rel="prev" href="scriptconstructions.html" title="3.3. Basic SystemTap Handler Constructs" /><link rel="next" href="typecasting.html" title="3.3.2.2. Typecasting" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="scriptconstructions.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="typecasting.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="targetvariables"></a>3.3.2. Target Variables</h3></div></div></div><a id="idm246929816064" class="indexterm"></a><a id="idm246917819632" class="indexterm"></a><div class="para">
The probe events that map to actual locations in the code (for example <code class="command">kernel.function("<em class="replaceable"><code>function</code></em>")</code> and <code class="command">kernel.statement("<em class="replaceable"><code>statement</code></em>")</code>) allow the use of <span class="emphasis"><em>target variables</em></span> to obtain the value of variables visible at that location in the code. You can use the <code class="command">-L</code> option to list the target variable available at a probe point. If the debug information is installed for the running kernel, you can run the following command to find out what target variables are available for the <code class="command">vfs_read</code> function:
</div><pre class="screen">stap -L 'kernel.function("vfs_read")'</pre><div class="para">
This will yield something similar to the following:
current files_stat max_files: 386070
</pre><div class="para">
For pointers to base types such as integers and strings there are a number of functions listed below to access kernel-space data. The first argument for each functions is the pointer to the data item. Similar functions are described in <a class="xref" href="utargetvariable.html">Section 4.2, “Accessing User-Space Target Variables”</a> for accessing target variables in user-space code.
- </div><div class="variablelist"><dl
><dt class="varlistentry"><span class="term">kernel_char(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
+ </div><div class="variablelist"><dl
class="variablelist"><dt><span class="term">kernel_char(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
Obtain the character at <em class="replaceable"><code>address</code></em> from kernel memory.
- </div></dd><dt
class="varlistentry"><span class="term">kernel_short(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
+ </div></dd><dt><span class="term">kernel_short(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
Obtain the short at <em class="replaceable"><code>address</code></em> from kernel memory.
- </div></dd><dt
class="varlistentry"><span class="term">kernel_int(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
+ </div></dd><dt><span class="term">kernel_int(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
Obtain the int at <em class="replaceable"><code>address</code></em> from kernel memory.
- </div></dd><dt
class="varlistentry"><span class="term">kernel_long(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
+ </div></dd><dt><span class="term">kernel_long(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
Obtain the long at <em class="replaceable"><code>address</code></em> from kernel memory
- </div></dd><dt
class="varlistentry"><span class="term">kernel_string(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
+ </div></dd><dt><span class="term">kernel_string(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
Obtain the string at <em class="replaceable"><code>address</code></em> from kernel memory.
- </div></dd><dt
class="varlistentry"><span class="term">kernel_string_n(<em class="replaceable"><code>address</code></em>, <em class="replaceable"><code>n</code></em>)</span></dt><dd><div class="para">
+ </div></dd><dt><span class="term">kernel_string_n(<em class="replaceable"><code>address</code></em>, <em class="replaceable"><code>n</code></em>)</span></dt><dd><div class="para">
Obtain the string at <em class="replaceable"><code>address</code></em> from the kernel memory and limits the string to <em class="replaceable"><code>n</code></em> bytes.
- </div></dd></dl></div><div class="section"
id="targetprettyprinting"><div class="titlepage"><div><div><h4 class="title" id="targetprettyprinting">3.3.2.1. Pretty Printing Target Variables</h4></div></div></div><a id="idp26645376" class="indexterm"></a><div class="para">
+ </div></dd></dl></div><div class="section"
><div class="titlepage"><div><div><h4 class="title"><a id="targetprettyprinting"></a>3.3.2.1. Pretty Printing Target Variables</h4></div></div></div><a id="idm246871566080" class="indexterm"></a><div class="para">
SystemTap scripts are often used to observe what is happening within the code. In many cases just printing the values of the various context variables is sufficient. SystemTap makes a number operations available that can generate printable strings for target variables:
- </div><div class="variablelist"><dl
><dt class="varlistentry"><span class="term">$$vars</span></dt><dd><div class="para">
+ </div><div class="variablelist"><dl
class="variablelist"><dt><span class="term">$$vars</span></dt><dd><div class="para">
Expands to a character string that is equivalent to <code class="command">sprintf("parm1=%x ... parmN=%x var1=%x ... varN=%x", parm1, ..., parmN, var1, ..., varN)</code> for each variable in scope at the probe point. Some values may be printed as <span class="quote">“<span class="quote"><code class="command">=?</code></span>”</span> if their run-time location cannot be found.
- </div></dd><dt
class="varlistentry"><span class="term">$$locals</span></dt><dd><div class="para">
+ </div></dd><dt><span class="term">$$locals</span></dt><dd><div class="para">
Expands to a subset of <code class="command">$$vars</code> containing only the local variables.
- </div></dd><dt
class="varlistentry"><span class="term">$$parms</span></dt><dd><div class="para">
+ </div></dd><dt><span class="term">$$parms</span></dt><dd><div class="para">
Expands to a subset of <code class="command">$$vars</code> containing only the function parameters.
- </div></dd><dt
class="varlistentry"><span class="term">$$return</span></dt><dd><div class="para">
+ </div></dd><dt><span class="term">$$return</span></dt><dd><div class="para">
Is available in return probes only. It expands to a string that is equivalent to <code class="command">sprintf("return=%x", $return)</code> if the probed function has a return value, or else an empty string.
</div></dd></dl></div><div class="para">
Below is a command-line script that prints the values of the parameters passed into the function <code class="command">vfs_read</code>:
</div><pre class="programlisting">stap -e 'probe kernel.function("vfs_read") {printf("%s\n", $$parms); exit(); }'</pre><div class="para">
There are four parameters passed into <code class="command">vfs_read</code>: <code class="command">file</code>, <code class="command">buf</code>, <code class="command">count</code>, and <code class="command">pos</code>. The <code class="command">$$parms</code> generates a string for the parameters passed into the function. In this case all but the <code class="command">count</code> parameter are pointers. The following is an example of the output from the previous command-line script:
</div><pre class="programlisting">file=0xffff8800b40d4c80 buf=0x7fff634403e0 count=0x2004 pos=0xffff8800af96df48</pre><div class="para">
- Having the address a pointer points to may not be useful. You might be more interested in the fields of the data structure the pointer points to. You can use the the <span class="quote">“<span class="quote"><code class="command">$</code></span>”</span> suffix to pretty print the data structure. The following command-line example uses the pretty printing suffix to print more details about the data structures passed into the function <code class="command">vfs_read</code>:
+ Having the address a pointer points to may not be useful. Instead the fields of the data structure the pointer points to may be of more use. Use the <span class="quote">“<span class="quote"><code class="command">$</code></span>”</span> suffix to pretty print the data structure. The following command-line example uses the pretty printing suffix to print more details about the data structures passed into the function <code class="command">vfs_read</code>:
</div><pre class="programlisting">stap -e 'probe kernel.function("vfs_read") {printf("%s\n", $$parms$); exit(); }'</pre><div class="para">
The previous command line will generate something similar to the following with the fields of the data structure included in the output:
</div><pre class="programlisting">file={.f_u={...}, .f_path={...}, .f_op=0xffffffffa06e1d80, .f_lock={...}, .f_count={...}, .f_flags=34818, .f_mode=31, .f_pos=0, .f_owner={...}, .f_cred=0xffff88013148fc80, .f_ra={...}, .f_version=0, .f_security=0xffff8800b8dce560, .private_data=0x0, .f_ep_links={...}, .f_mapping=0xffff880037f8fdf8} buf="" count=8196 pos=-131938753921208</pre><div class="para">
With the <span class="quote">“<span class="quote"><code class="command">$</code></span>”</span> suffix fields that are composed of data structures are not expanded. The <span class="quote">“<span class="quote"><code class="command">$$</code></span>”</span> suffix will print the values contained within the nested data structures. Below is an example using the <span class="quote">“<span class="quote"><code class="command">$$</code></span>”</span> suffix:
</div><pre class="programlisting">stap -e 'probe kernel.function("vfs_read") {printf("%s\n", $$parms$$); exit(); }'</pre><div class="para">
- The <span class="quote">“<span class="quote"><code class="command">$$</code></span>”</span> suffix, like all strings, is limited to the maximum string size. Below is a represenative output from the previous command-line script, which is truncated because of the string size limit:
- </div><pre class="programlisting">file={.f_u={.fu_list={.next=0xffff8801336ca0e8, .prev=0xffff88012ded0840}, .fu_rcuhead={.next=0xffff8801336ca0e8, .func=0xffff88012ded0840}}, .f_path={.mnt=0xffff880132fc97c0, .dentry=0xffff88001a889cc0}, .f_op=0xffffffffa06f64c0, .f_lock={.raw_lock={.slock=196611}}, .f_count={.counter=2}, .f_flags=34818, .f_mode=31, .f_pos=0, .f_owner={.lock={.raw_lock={.lock=16777216}}, .pid=0x0, .pid_type=0, .uid=0, .euid=0, .signum=0}, .f_cred=0xffff880130129a80, .f_ra={.start=0, .size=0, .async_size=0, .ra_pages=32, .</pre></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="scriptconstructions.html"><strong>Prev</strong>3.3. Basic SystemTap Handler Constructs</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="typecasting.html"><strong>Next</strong>3.3.2.2. Typecasting</a></li></ul></body></html>
+ The <span class="quote">“<span class="quote"><code class="command">$$</code></span>”</span> suffix, like all strings, is limited to the maximum string size. Below is a representative output from the previous command-line script, which is truncated because of the string size limit:
+ </div><pre class="programlisting">file={.f_u={.fu_list={.next=0xffff8801336ca0e8, .prev=0xffff88012ded0840}, .fu_rcuhead={.next=0xffff8801336ca0e8, .func=0xffff88012ded0840}}, .f_path={.mnt=0xffff880132fc97c0, .dentry=0xffff88001a889cc0}, .f_op=0xffffffffa06f64c0, .f_lock={.raw_lock={.slock=196611}}, .f_count={.counter=2}, .f_flags=34818, .f_mode=31, .f_pos=0, .f_owner={.lock={.raw_lock={.lock=16777216}}, .pid=0x0, .pid_type=0, .uid=0, .euid=0, .signum=0}, .f_cred=0xffff880130129a80, .f_ra={.start=0, .size=0, .async_size=0, .ra_pages=32, .</pre></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="scriptconstructions.html"><strong>Prev</strong>3.3. Basic SystemTap Handler Constructs</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="typecasting.html"><strong>Next</strong>3.3.2.2. Typecasting</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>5.3.3. Determining Time Spent in Kernel and User Space</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-profiling.html" title="5.3. Profiling" /><link rel="prev" href="paracallgraph.html" title="5.3.2. Call Graph Tracing" /><link rel="next" href="timeoutssect.html" title="5.3.4. Monitoring Polling Applications" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="paracallgraph.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="timeoutssect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="threadtimessect" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="threadtimessect">5.3.3. Determining Time Spent in Kernel and User Space</h3></div></div></div><a id="idp64768016" class="indexterm"></a><a id="idp63998688" class="indexterm"></a><a id="idp27377296" class="indexterm"></a><a id="idp36689872" class="indexterm"></a><a id="idp14278752" class="indexterm"></a><a id="idp14517056" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">5.3.3. Determining Time Spent in Kernel and User Space</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-profiling.html" title="5.3. Profiling" /><link rel="prev" href="paracallgraph.html" title="5.3.2. Call Graph Tracing" /><link rel="next" href="timeoutssect.html" title="5.3.4. Monitoring Polling Applications" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="paracallgraph.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="timeoutssect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="threadtimessect"></a>5.3.3. Determining Time Spent in Kernel and User Space</h3></div></div></div><a id="idm246868872928" class="indexterm"></a><a id="idm246895665968" class="indexterm"></a><a id="idm246913172240" class="indexterm"></a><a id="idm246929638480" class="indexterm"></a><a id="idm246912379328" class="indexterm"></a><a id="idm246928045904" class="indexterm"></a><div class="para">
This section illustrates how to determine the amount of time any given thread is spending in either kernel or user-space.
- </div><div class="formalpara" id="threadtimes"><h5 class="formalpara">thread-times.stp</h5>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">thread-times.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
delete tids
}
</pre>
- </div><a id="id
p56870896" class="indexterm"></a><a id="idp22746320" class="indexterm"></a><a id="idp40100112" class="indexterm"></a><div class="para">
+ </div><a id="id
m246880214768" class="indexterm"></a><a id="idm246921055104" class="indexterm"></a><a id="idm246926338064" class="indexterm"></a><div class="para">
<a class="xref" href="threadtimessect.html#threadtimes">thread-times.stp</a> lists the top 20 processes currently taking up CPU time within a 5-second sample, along with the total number of CPU ticks made during the sample. The output of this script also notes the percentage of CPU time each process used, as well as whether that time was spent in kernel space or user space.
</div><div class="para">
<a class="xref" href="threadtimessect.html#threadtimesoutput">Example 5.15, “thread-times.stp Sample Output”</a> contains a 5-second sample of the output for <a class="xref" href="threadtimessect.html#threadtimes">thread-times.stp</a>:
- </div><div class="example"
id="threadtimesoutput"><h6>Example 5.15. <a class="xref" href="threadtimessect.html#threadtimes">thread-times.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen"> tid %user %kernel (of 20002 ticks)
+ </div><div class="example"
><a id="threadtimesoutput"></a><p class="title"><strong>Example 5.15. <a class="xref" href="threadtimessect.html#threadtimes">thread-times.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen"> tid %user %kernel (of 20002 ticks)
0 0.00% 87.88%
32169 5.24% 0.03%
9815 3.33% 0.36%
3883 0.00% 0.00%
3775 0.00% 0.00%
3943 0.00% 0.00%
- 3873 0.00% 0.00%</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="paracallgraph.html"><strong>Prev</strong>5.3.2. Call Graph Tracing</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="timeoutssect.html"><strong>Next</strong>5.3.4. Monitoring Polling Applications</a></li></ul></body></html>
+ 3873 0.00% 0.00%</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="paracallgraph.html"><strong>Prev</strong>5.3.2. Call Graph Tracing</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="timeoutssect.html"><strong>Next</strong>5.3.4. Monitoring Polling Applications</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>5.3.4. Monitoring Polling Applications</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-profiling.html" title="5.3. Profiling" /><link rel="prev" href="threadtimessect.html" title="5.3.3. Determining Time Spent in Kernel and User Space" /><link rel="next" href="topsyssect.html" title="5.3.5. Tracking Most Frequently Used System Calls" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="threadtimessect.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="topsyssect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="timeoutssect" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="timeoutssect">5.3.4. Monitoring Polling Applications</h3></div></div></div><a id="idp40515232" class="indexterm"></a><a id="idm1944320" class="indexterm"></a><a id="idp23930944" class="indexterm"></a><a id="idm242272" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">5.3.4. Monitoring Polling Applications</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-profiling.html" title="5.3. Profiling" /><link rel="prev" href="threadtimessect.html" title="5.3.3. Determining Time Spent in Kernel and User Space" /><link rel="next" href="topsyssect.html" title="5.3.5. Tracking Most Frequently Used System Calls" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="threadtimessect.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="topsyssect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="timeoutssect"></a>5.3.4. Monitoring Polling Applications</h3></div></div></div><a id="idm246926947792" class="indexterm"></a><a id="idm246882985536" class="indexterm"></a><a id="idm246880103680" class="indexterm"></a><a id="idm246877918928" class="indexterm"></a><div class="para">
This section describes how to identify and monitor which applications are polling. Doing so allows you to track unnecessary or excessive polling, which can help you pinpoint areas for improvement in terms of CPU usage and power savings.
- </div><div class="formalpara" id="timeouts"><h5 class="formalpara">timeout.stp</h5>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">timeout.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
# Copyright (C) 2009 Red Hat, Inc.
</pre>
</div><div class="para">
<a class="xref" href="timeoutssect.html#timeouts">timeout.stp</a> tracks how many times each of the following system calls completed due to time expiring rather than due to an actual event occurring:
- </div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
<code class="command">poll</code>
</div></li><li class="listitem"><div class="para">
<code class="command">select</code>
<code class="command">nanosleep</code>
</div></li><li class="listitem"><div class="para">
<code class="command">signal</code>
- </div></li></ul></div><a id="id
p21216560" class="indexterm"></a><a id="idp62452096" class="indexterm"></a><a id="idp34235568" class="indexterm"></a><div class="example" id="timeoutsoutput"><h6>Example 5.16. <a class="xref" href="timeoutssect.html#timeouts">timeout.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen"> uid | poll select epoll itimer futex nanosle signal| process
+ </div></li></ul></div><a id="id
m246877847904" class="indexterm"></a><a id="idm246928961024" class="indexterm"></a><a id="idm246868851168" class="indexterm"></a><div class="example"><a id="timeoutsoutput"></a><p class="title"><strong>Example 5.16. <a class="xref" href="timeoutssect.html#timeouts">timeout.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen"> uid | poll select epoll itimer futex nanosle signal| process
28937 | 148793 0 0 4727 37288 0 0| firefox
22945 | 0 56949 0 1 0 0 0| scim-bridge
0 | 0 0 0 36414 0 0 0| swapper
29548 | 0 1440 0 0 0 0 0| httpd
1862 | 0 0 0 0 0 1438 0| iscsid</pre></div></div><br class="example-break" /><div class="para">
You can increase the sample time by editing the second probe (<code class="command">timer.s(1)</code>). The output of <a class="xref" href="timeoutssect.html#timeouts">timeout.stp</a> contains the name and UID of the top 20 polling applications, along with how many times each application performed each polling system call (over time). <a class="xref" href="timeoutssect.html#timeoutsoutput">Example 5.16, “timeout.stp Sample Output”</a> contains an excerpt of the script. In this particular example firefox is doing an excessive amount of polling due to a plugin module.
- </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="threadtimessect.html"><strong>Prev</strong>5.3.3. Determining Time Spent in Kernel and User ...</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="topsyssect.html"><strong>Next</strong>5.3.5. Tracking Most Frequently Used System Calls</a></li></ul></body></html>
+ </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="threadtimessect.html"><strong>Prev</strong>5.3.3. Determining Time Spent in Kernel and User ...</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="topsyssect.html"><strong>Next</strong>5.3.5. Tracking Most Frequently Used System Calls</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>5.3.5. Tracking Most Frequently Used System Calls</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-profiling.html" title="5.3. Profiling" /><link rel="prev" href="timeoutssect.html" title="5.3.4. Monitoring Polling Applications" /><link rel="next" href="syscallsbyprocpidsect.html" title="5.3.6. Tracking System Call Volume Per Process" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="timeoutssect.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="syscallsbyprocpidsect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="topsyssect" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="topsyssect">5.3.5. Tracking Most Frequently Used System Calls</h3></div></div></div><a id="idp27487024" class="indexterm"></a><a id="idm1123712" class="indexterm"></a><a id="idp44808656" class="indexterm"></a><a id="idp15386160" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">5.3.5. Tracking Most Frequently Used System Calls</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-profiling.html" title="5.3. Profiling" /><link rel="prev" href="timeoutssect.html" title="5.3.4. Monitoring Polling Applications" /><link rel="next" href="syscallsbyprocpidsect.html" title="5.3.6. Tracking System Call Volume Per Process" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="timeoutssect.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="syscallsbyprocpidsect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="topsyssect"></a>5.3.5. Tracking Most Frequently Used System Calls</h3></div></div></div><a id="idm246883130992" class="indexterm"></a><a id="idm246868845600" class="indexterm"></a><a id="idm246927184656" class="indexterm"></a><a id="idm246920873616" class="indexterm"></a><div class="para">
<a class="xref" href="timeoutssect.html#timeouts">timeout.stp</a> from <a class="xref" href="timeoutssect.html">Section 5.3.4, “Monitoring Polling Applications”</a> helps you identify which applications are polling by examining a small subset of system calls ( <code class="command">poll</code>, <code class="command">select</code>, <code class="command">epoll</code>, <code class="command">itimer</code>, <code class="command">futex</code>, <code class="command">nanosleep</code>, and <code class="command">signal</code>). However, in some systems, an excessive number of system calls outside that small subset might be responsible for time spent in the kernel. If you suspect that an application is using system calls excessively, you need to identify the most frequently used system calls on the system. To do this, use <a class="xref" href="topsyssect.html#topsys">topsys.stp</a>.
- </div><div class="formalpara" id="topsys"><h5 class="formalpara">topsys.stp</h5>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">topsys.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
#
global syscalls_count
probe syscall.* {
- syscalls_count[name]++
+ syscalls_count[name] <<< 1
}
function print_systop () {
printf ("%25s %10s\n", "SYSCALL", "COUNT")
foreach (syscall in syscalls_count- limit 20) {
- printf("%25s %10d\n", syscall, syscalls_count[syscall])
+ printf("%25s %10d\n", syscall, @count(syscalls_count[syscall]))
}
delete syscalls_count
}
</pre>
</div><div class="para">
<a class="xref" href="topsyssect.html#topsys">topsys.stp</a> lists the top 20 system calls used by the system per 5-second interval. It also lists how many times each system call was used during that period. Refer to <a class="xref" href="topsyssect.html#topsysoutput">Example 5.17, “topsys.stp Sample Output”</a> for a sample output.
- </div><a id="id
p31839584" class="indexterm"></a><a id="idp33594320" class="indexterm"></a><a id="idp50217808" class="indexterm"></a><div class="example" id="topsysoutput"><h6>Example 5.17. <a class="xref" href="topsyssect.html#topsys">topsys.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen">--------------------------------------------------------------
+ </div><a id="id
m246927867760" class="indexterm"></a><a id="idm246928583168" class="indexterm"></a><a id="idm246883084736" class="indexterm"></a><div class="example"><a id="topsysoutput"></a><p class="title"><strong>Example 5.17. <a class="xref" href="topsyssect.html#topsys">topsys.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen">--------------------------------------------------------------
SYSCALL COUNT
gettimeofday 1857
read 1821
time 81
sigreturn 72
fstat 66
---------------------------------------------------------------</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="timeoutssect.html"><strong>Prev</strong>5.3.4. Monitoring Polling Applications</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="syscallsbyprocpidsect.html"><strong>Next</strong>5.3.6. Tracking System Call Volume Per Process</a></li></ul></body></html>
+--------------------------------------------------------------</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="timeoutssect.html"><strong>Prev</strong>5.3.4. Monitoring Polling Applications</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="syscallsbyprocpidsect.html"><strong>Next</strong>5.3.6. Tracking System Call Volume Per Process</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>5.2.4. I/O Monitoring (By Device)</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-disk.html" title="5.2. Disk" /><link rel="prev" href="traceiosect.html" title="5.2.3. Track Cumulative IO" /><link rel="next" href="inodewatchsect.html" title="5.2.5. Monitoring Reads and Writes to a File" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="traceiosect.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="inodewatchsect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="traceio2sect" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="traceio2sect">5.2.4. I/O Monitoring (By Device)</h3></div></div></div><a id="idp41455856" class="indexterm"></a><a id="idp49267920" class="indexterm"></a><a id="idp38194288" class="indexterm"></a><a id="idp41609904" class="indexterm"></a><a id="idp38715840" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">5.2.4. I/O Monitoring (By Device)</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-disk.html" title="5.2. Disk" /><link rel="prev" href="traceiosect.html" title="5.2.3. Track Cumulative IO" /><link rel="next" href="inodewatchsect.html" title="5.2.5. Monitoring Reads and Writes to a File" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="traceiosect.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="inodewatchsect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="traceio2sect"></a>5.2.4. I/O Monitoring (By Device)</h3></div></div></div><a id="idm246927255200" class="indexterm"></a><a id="idm246929471584" class="indexterm"></a><a id="idm246883061568" class="indexterm"></a><a id="idm246912960896" class="indexterm"></a><a id="idm246882996240" class="indexterm"></a><div class="para">
This section describes how to monitor I/O activity on a specific device.
- </div><div class="formalpara" id="traceio2"><h5 class="formalpara">traceio2.stp</h5>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">traceio2.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
execname(), pid(), probefunc(), dev)
}
</pre>
- </div><a id="id
p18030512" class="indexterm"></a><a id="idp39328496" class="indexterm"></a><a id="idm3435952" class="indexterm"></a><a id="idp49674704" class="indexterm"></a><a id="idp31863936" class="indexterm"></a><a id="idm1427040" class="indexterm"></a><div class="para">
- <a class="xref" href="traceio2sect.html#traceio2">traceio2.stp</a> takes 1 argument: the whole device number. To get this number, use <code class="command">stat -c "0x%D" <em class="replaceable"><code>directory</code></em></code>, where <code class="command"><em class="replaceable"><code>directory</code></em></code> is located in the device you wish to monitor.
- </div><a id="id
p41841792" class="indexterm"></a><a id="idp17295520" class="indexterm"></a><a id="idp36532720" class="indexterm"></a><div class="para">
+ </div><a id="id
m246920929968" class="indexterm"></a><a id="idm246927905008" class="indexterm"></a><a id="idm246912066752" class="indexterm"></a><a id="idm246869979344" class="indexterm"></a><a id="idm246917514560" class="indexterm"></a><a id="idm246883144272" class="indexterm"></a><div class="para">
+ <a class="xref" href="traceio2sect.html#traceio2">traceio2.stp</a> takes 1 argument: the whole device number. To get this number, use <code class="command">stat -c "0x%D" <em class="replaceable"><code>directory</code></em></code>, where <code class="command"><em class="replaceable"><code>directory</code></em></code> is located in the device to be monitored.
+ </div><a id="id
m246870503072" class="indexterm"></a><a id="idm246873561088" class="indexterm"></a><a id="idm246929558528" class="indexterm"></a><div class="para">
The <code class="command">usrdev2kerndev()</code> function converts the whole device number into the format understood by the kernel. The output produced by <code class="command">usrdev2kerndev()</code> is used in conjunction with the <code class="command">MKDEV()</code>, <code class="command">MINOR()</code>, and <code class="command">MAJOR()</code> functions to determine the major and minor numbers of a specific device.
</div><div class="para">
- The output of <a class="xref" href="traceio2sect.html#traceio2">traceio2.stp</a> includes the name and ID of any process performing a read/write, the function it is performing (i.e. <code class="command">vfs_read</code> or <code class="command">vfs_write</code>), and the kernel device number.
+ The output of <a class="xref" href="traceio2sect.html#traceio2">traceio2.stp</a> includes the name and ID of any process performing a read/write, the function it is performing (that is, <code class="command">vfs_read</code> or <code class="command">vfs_write</code>), and the kernel device number.
</div><div class="para">
The following example is an excerpt from the full output of <code class="command">stap traceio2.stp 0x805</code>, where <code class="literal">0x805</code> is the whole device number of <code class="filename">/home</code>. <code class="filename">/home</code> resides in <code class="filename">/dev/sda5</code>, which is the device we wish to monitor.
- </div><div class="example"
id="traceio2output"><h6>Example 5.9. <a class="xref" href="traceio2sect.html#traceio2">traceio2.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen">[...]
+ </div><div class="example"
><a id="traceio2output"></a><p class="title"><strong>Example 5.9. <a class="xref" href="traceio2sect.html#traceio2">traceio2.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen">[...]
synergyc(3722) vfs_read 0x800005
synergyc(3722) vfs_read 0x800005
cupsd(2889) vfs_write 0x800005
cupsd(2889) vfs_write 0x800005
cupsd(2889) vfs_write 0x800005
-[...]</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="traceiosect.html"><strong>Prev</strong>5.2.3. Track Cumulative IO</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="inodewatchsect.html"><strong>Next</strong>5.2.5. Monitoring Reads and Writes to a File</a></li></ul></body></html>
+[...]</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="traceiosect.html"><strong>Prev</strong>5.2.3. Track Cumulative IO</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="inodewatchsect.html"><strong>Next</strong>5.2.5. Monitoring Reads and Writes to a File</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>5.2.3. Track Cumulative IO</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-disk.html" title="5.2. Disk" /><link rel="prev" href="iotimesect.html" title="5.2.2. Tracking I/O Time For Each File Read or Write" /><link rel="next" href="traceio2sect.html" title="5.2.4. I/O Monitoring (By Device)" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="iotimesect.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="traceio2sect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" id="traceiosect" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="traceiosect">5.2.3. Track Cumulative IO</h3></div></div></div><a id="idp32300032" class="indexterm"></a><a id="idp22081536" class="indexterm"></a><a id="idp35047680" class="indexterm"></a><a id="idp40739360" class="indexterm"></a><a id="idp17636592" class="indexterm"></a><a id="idp48307808" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">5.2.3. Track Cumulative IO</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="mainsect-disk.html" title="5.2. Disk" /><link rel="prev" href="iotimesect.html" title="5.2.2. Tracking I/O Time For Each File Read or Write" /><link rel="next" href="traceio2sect.html" title="5.2.4. I/O Monitoring (By Device)" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="iotimesect.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="traceio2sect.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="traceiosect"></a>5.2.3. Track Cumulative IO</h3></div></div></div><a id="idm246916989888" class="indexterm"></a><a id="idm246918027920" class="indexterm"></a><a id="idm246912007056" class="indexterm"></a><a id="idm246873307312" class="indexterm"></a><a id="idm246877669696" class="indexterm"></a><a id="idm246875169248" class="indexterm"></a><div class="para">
This section describes how to track the cumulative amount of I/O to the system.
- </div><div class="formalpara" id="traceio"><h5 class="formalpara">traceio.stp</h5>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">traceio.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
# traceio.stp
global reads, writes, total_io
probe vfs.read.return {
- reads[pid(),execname()] += $return
- total_io[pid(),execname()] += $return
+ if ($return > 0) {
+ reads[pid(),execname()] += $return
+ total_io[pid(),execname()] += $return
+ }
}
probe vfs.write.return {
- writes[pid(),execname()] += $return
- total_io[pid(),execname()] += $return
+ if ($return > 0) {
+ writes[pid(),execname()] += $return
+ total_io[pid(),execname()] += $return
+ }
}
function humanreadable(bytes) {
</pre>
</div><div class="para">
<a class="xref" href="traceiosect.html#traceio">traceio.stp</a> prints the top ten executables generating I/O traffic over time. In addition, it also tracks the cumulative amount of I/O reads and writes done by those ten executables. This information is tracked and printed out in 1-second intervals, and in descending order.
- </div><a id="id
p23108848" class="indexterm"></a><a id="idm9607152" class="indexterm"></a><a id="idp23730832" class="indexterm"></a><div class="para">
+ </div><a id="id
m246873303856" class="indexterm"></a><a id="idm246870461904" class="indexterm"></a><a id="idm246871118352" class="indexterm"></a><div class="para">
Note that <a class="xref" href="traceiosect.html#traceio">traceio.stp</a> also uses the local variable <code class="command">$return</code>, which is also used by <a class="xref" href="mainsect-disk.html#scriptdisktop">disktop.stp</a> from <a class="xref" href="mainsect-disk.html#disktop">Section 5.2.1, “Summarizing Disk Read/Write Traffic”</a>.
- </div><div class="example"
id="traceiooutput"><h6>Example 5.8. <a class="xref" href="traceiosect.html#traceio">traceio.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen">[...]
+ </div><div class="example"
><a id="traceiooutput"></a><p class="title"><strong>Example 5.8. <a class="xref" href="traceiosect.html#traceio">traceio.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen">[...]
Xorg r: 583401 KiB w: 0 KiB
floaters r: 96 KiB w: 7130 KiB
multiload-apple r: 538 KiB w: 537 KiB
snmpd r: 46 KiB w: 0 KiB
pcscd r: 28 KiB w: 0 KiB
irqbalance r: 27 KiB w: 4 KiB
- cupsd r: 4 KiB w: 18 KiB</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="iotimesect.html"><strong>Prev</strong>5.2.2. Tracking I/O Time For Each File Read or Wr...</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="traceio2sect.html"><strong>Next</strong>5.2.4. I/O Monitoring (By Device)</a></li></ul></body></html>
+ cupsd r: 4 KiB w: 18 KiB</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="iotimesect.html"><strong>Prev</strong>5.2.2. Tracking I/O Time For Each File Read or Wr...</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="traceio2sect.html"><strong>Next</strong>5.2.4. I/O Monitoring (By Device)</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>3.3.2.2. Typecasting</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="targetvariables.html" title="3.3.2. Target Variables" /><link rel="prev" href="targetvariables.html" title="3.3.2. Target Variables" /><link rel="next" href="targetavailable.html" title="3.3.2.3. Checking Target Variable Availablility" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="targetvariables.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="targetavailable.html"><strong>Next</strong></a></li></ul><div class="section" id="typecasting"><div class="titlepage"><div><div><h4 class="title" id="typecasting">3.3.2.2. Typecasting</h4></div></div></div><a id="idp31812288" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">3.3.2.2. Typecasting</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="targetvariables.html" title="3.3.2. Target Variables" /><link rel="prev" href="targetvariables.html" title="3.3.2. Target Variables" /><link rel="next" href="targetavailable.html" title="3.3.2.3. Checking Target Variable Availability" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="targetvariables.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="targetavailable.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="typecasting"></a>3.3.2.2. Typecasting</h4></div></div></div><a id="idm246917320368" class="indexterm"></a><div class="para">
In most cases SystemTap can determine a variable's type from the debug information. However, code may use void pointers for variables (for example memory allocation routines) and typing information is not available. Also the typing information available within a probe handler is not available within a function; SystemTap functions arguments use a long in place of a typed pointer. SystemTap's <code class="command">@cast</code> operator (first available in SystemTap 0.9) can be used to indicate the correct type of the object.
</div><div class="para">
- The <a class="xref" href="typecasting.html#casting">Example 3.9, “Casting Example”</a> is from the <code class="command">task.stp</code> tapset. The function returns the value of the <code class="command">state</code> field from a <code class="command">task_struct</code> pointed to by the long <code class="command">task</code>. The first argument of the <code class="command">@cast</code> operator, <code class="command">task</code>, is the pointer to the object. The second argument is the type to cast the object to, <code class="command">task_struct</code>. The third arument lists what file that the type definition information comes from and is optional. With the <code class="command">@cast</code> operator the various fields of this particular <code class="command">task_struct</code> <code class="command">task</code> can be accessed; in this example the <code class="command">state</code> field is obtained.
- </div><div class="example"
id="casting"><h6>Example 3.9. Casting Example</h6><div class="example-contents"><pre class="programlisting">function task_state:long (task:long)
+ The <a class="xref" href="typecasting.html#casting">Example 3.9, “Casting Example”</a> is from the <code class="command">task.stp</code> tapset. The function returns the value of the <code class="command">state</code> field from a <code class="command">task_struct</code> pointed to by the long <code class="command">task</code>. The first argument of the <code class="command">@cast</code> operator, <code class="command">task</code>, is the pointer to the object. The second argument is the type to cast the object to, <code class="command">task_struct</code>. The third argument lists what file that the type definition information comes from and is optional. With the <code class="command">@cast</code> operator the various fields of this particular <code class="command">task_struct</code> <code class="command">task</code> can be accessed; in this example the <code class="command">state</code> field is obtained.
+ </div><div class="example"
><a id="casting"></a><p class="title"><strong>Example 3.9. Casting Example</strong></p><div class="example-contents"><pre class="programlisting">function task_state:long (task:long)
{
return @cast(task, "task_struct", "kernel<linux/sched.h>")->state
}
-</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="targetvariables.html"><strong>Prev</strong>3.3.2. Target Variables</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="targetavailable.html"><strong>Next</strong>3.3.2.3. Checking Target Variable Availablility</a></li></ul></body></html>
+</pre></div></div><br class="example-break" /></div><ul class="docnav"><li class="previous"><a accesskey="p" href="targetvariables.html"><strong>Prev</strong>3.3.2. Target Variables</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="targetavailable.html"><strong>Next</strong>3.3.2.3. Checking Target Variable Availability</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 3. Understanding How SystemTap Works</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="using-usage.html" title="2.3. Running SystemTap Scripts" /><link rel="next" href="scripts.html" title="3.2. SystemTap Scripts" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="using-usage.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="scripts.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="chapter" id="understanding-how-systemtap-works" lang="en-US"><div class="titlepage"><div><div><h2 class="title">Chapter 3. Understanding How SystemTap Works</h2></div></div></div><div class="toc"><dl><dt><span class="section"><a href="understanding-how-systemtap-works.html#understanding-architecture-tools">3.1. Architecture</a></span></dt><dt><span class="section"><a href="scripts.html">3.2. SystemTap Scripts</a></span></dt><dd><dl><dt><span class="section"><a href="scripts.html#systemtapscript-events">3.2.1. Event</a></span></dt><dt><span class="section"><a href="systemtapscript-handler.html">3.2.2. Systemtap Handler/Body</a></span></dt></dl></dd><dt><span class="section"><a href="scriptconstructions.html">3.3. Basic SystemTap Handler Constructs</a></span></dt><dd><dl><dt><span class="section"><a href="scriptconstructions.html#variablesconstructs">3.3.1. Variables</a></span></dt><dt><span class="section"><a href="targetvariables.html">3.3.2. Target Variables</a></span></dt><dt><span class="section"><a href="handlerconditionalstatements.html">3.3.3. Conditional Statements</a></span></dt><dt><span class="section"><a href="commandlineargssect.html">3.3.4. Command-Line Arguments</a></span></dt></dl></dd><dt><span class="section"><a href="associativearrays.html">3.4. Associative Arrays</a></span></dt><dt><span class="section"><a href="arrayoperators.html">3.5. Array Operations in SystemTap</a></span></dt><dd><dl><dt><span class="section"><a href="arrayoperators.html#arrayops-assignvalue">3.5.1. Assigning an Associated Value</a></span></dt><dt><span class="section"><a href="arrayops-readvalues.html">3.5.2. Reading Values From Arrays</a></span></dt><dt><span class="section"><a href="arrayops-increment.html">3.5.3. Incrementing Associated Values</a></span></dt><dt><span class="section"><a href="arrayops-foreach.html">3.5.4. Processing Multiple Elements in an Array</a></span></dt><dt><span class="section"><a href="arrayops-deleting.html">3.5.5. Clearing/Deleting Arrays and Array Elements</a></span></dt><dt><span class="section"><a href="arrayops-conditionals.html">3.5.6. Using Arrays in Conditional Statements</a></span></dt><dt><span class="section"><a href="arrayops-aggregates.html">3.5.7. Computing for Statistical Aggregates</a></span></dt></dl></dd><dt><span class="section"><a href="understanding-tapsets.html">3.6. Tapsets</a></span></dt></dl></div><a id="idm10088640" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">Chapter 3. Understanding How SystemTap Works</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="using-usage.html" title="2.3. Running SystemTap Scripts" /><link rel="next" href="scripts.html" title="3.2. SystemTap Scripts" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="using-usage.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="scripts.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="chapter" lang="en-US"><div class="titlepage"><div><div><h1 class="title"><a id="understanding-how-systemtap-works"></a>Chapter 3. Understanding How SystemTap Works</h1></div></div></div><div class="toc"><dl class="toc"><dt><span class="section"><a href="understanding-how-systemtap-works.html#understanding-architecture-tools">3.1. Architecture</a></span></dt><dt><span class="section"><a href="scripts.html">3.2. SystemTap Scripts</a></span></dt><dd><dl><dt><span class="section"><a href="scripts.html#systemtapscript-events">3.2.1. Event</a></span></dt><dt><span class="section"><a href="systemtapscript-handler.html">3.2.2. SystemTap Handler/Body</a></span></dt></dl></dd><dt><span class="section"><a href="scriptconstructions.html">3.3. Basic SystemTap Handler Constructs</a></span></dt><dd><dl><dt><span class="section"><a href="scriptconstructions.html#variablesconstructs">3.3.1. Variables</a></span></dt><dt><span class="section"><a href="targetvariables.html">3.3.2. Target Variables</a></span></dt><dt><span class="section"><a href="handlerconditionalstatements.html">3.3.3. Conditional Statements</a></span></dt><dt><span class="section"><a href="commandlineargssect.html">3.3.4. Command-Line Arguments</a></span></dt></dl></dd><dt><span class="section"><a href="associativearrays.html">3.4. Associative Arrays</a></span></dt><dt><span class="section"><a href="arrayoperators.html">3.5. Array Operations in SystemTap</a></span></dt><dd><dl><dt><span class="section"><a href="arrayoperators.html#arrayops-assignvalue">3.5.1. Assigning an Associated Value</a></span></dt><dt><span class="section"><a href="arrayops-readvalues.html">3.5.2. Reading Values From Arrays</a></span></dt><dt><span class="section"><a href="arrayops-increment.html">3.5.3. Incrementing Associated Values</a></span></dt><dt><span class="section"><a href="arrayops-foreach.html">3.5.4. Processing Multiple Elements in an Array</a></span></dt><dt><span class="section"><a href="arrayops-deleting.html">3.5.5. Clearing/Deleting Arrays and Array Elements</a></span></dt><dt><span class="section"><a href="arrayops-conditionals.html">3.5.6. Using Arrays in Conditional Statements</a></span></dt><dt><span class="section"><a href="arrayops-aggregates.html">3.5.7. Computing for Statistical Aggregates</a></span></dt></dl></dd><dt><span class="section"><a href="understanding-tapsets.html">3.6. Tapsets</a></span></dt></dl></div><a id="idm246881862336" class="indexterm"></a><div class="para">
SystemTap allows users to write and reuse simple scripts to deeply examine the activities of a running Linux system. These scripts can be designed to extract data, filter it, and summarize it quickly (and safely), enabling the diagnosis of complex performance (or even functional) problems.
- </div><a id="idm
10090048" class="indexterm"></a><a id="idm10091744" class="indexterm"></a><a id="idm10095504" class="indexterm"></a><div class="para">
+ </div><a id="idm
246881863680" class="indexterm"></a><a id="idm246921644352" class="indexterm"></a><a id="idm246921647344" class="indexterm"></a><div class="para">
The essential idea behind a SystemTap script is to name <span class="emphasis"><em>events</em></span>, and to give them <span class="emphasis"><em>handlers</em></span>. When SystemTap runs the script, SystemTap monitors for the event; once the event occurs, the Linux kernel then runs the handler as a quick sub-routine, then resumes.
- </div><a id="idm
10096736" class="indexterm"></a><a id="idm10099664" class="indexterm"></a><div class="para">
+ </div><a id="idm
246921649136" class="indexterm"></a><a id="idm246921650176" class="indexterm"></a><div class="para">
There are several kind of events; entering/exiting a function, timer expiration, session termination, etc. A handler is a series of script language statements that specify the work to be done whenever the event occurs. This work normally includes extracting data from the event context, storing them into internal variables, and printing results.
- </div><div class="section"
id="understanding-architecture-tools"><div class="titlepage"><div><div><h2 class="title" id="understanding-architecture-tools">3.1. Architecture</h2></div></div></div><a id="idm10102112" class="indexterm"></a><a id="idm6421920" class="indexterm"></a><a id="idm6420960" class="indexterm"></a><div class="para">
+ </div><div class="section"
><div class="titlepage"><div><div><h2 class="title"><a id="understanding-architecture-tools"></a>3.1. Architecture</h2></div></div></div><a id="idm246921654576" class="indexterm"></a><a id="idm246921656032" class="indexterm"></a><a id="idm246921657024" class="indexterm"></a><div class="para">
A SystemTap session begins when you run a SystemTap script. This session occurs in the following fashion:
- </div><div
class="procedure" id="systemtapsession"><h6>Procedure 3.1. SystemTap Session</h6><a id="idm6423808" class="indexterm"></a><a id="idm6425344" class="indexterm"></a><a id="idm6426320" class="indexterm"></a><ol class="1"><li class="step"><div class="para">
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="procedure"><a id="systemtapsession"></a><p class="title"><strong>Procedure 3.1. SystemTap Session</strong></p><a id="idm246921659952" class="indexterm"></a><a id="idm246921660928" class="indexterm"></a><a id="idm246921663856" class="indexterm"></a><ol class="1"><li class="step"><div class="para">
First, SystemTap checks the script against the existing tapset library (normally in <code class="filename">/usr/share/systemtap/tapset/</code> for any tapsets used. SystemTap will then substitute any located tapsets with their corresponding definitions in the tapset library.
</div></li><li class="step"><div class="para">
SystemTap then translates the script to C, running the system C compiler to create a kernel module from it. The tools that perform this step are contained in the <code class="filename">systemtap</code> package (refer to <a class="xref" href="using-systemtap.html#installproper">Section 2.1.1, “Installing SystemTap”</a> for more information).
Once the SystemTap session is terminated, the probes are disabled, and the kernel module is unloaded.
</div></li></ol></div><div class="para">
This sequence is driven from a single command-line program: <code class="command">stap</code>. This program is SystemTap's main front-end tool. For more information about <code class="command">stap</code>, refer to <code class="command">man stap</code> (once SystemTap is properly installed on your machine).
- </div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="using-usage.html"><strong>Prev</strong>2.3. Running SystemTap Scripts</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="scripts.html"><strong>Next</strong>3.2. SystemTap Scripts</a></li></ul></body></html>
+ </div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="using-usage.html"><strong>Prev</strong>2.3. Running SystemTap Scripts</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="scripts.html"><strong>Next</strong>3.2. SystemTap Scripts</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>3.6. Tapsets</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="understanding-how-systemtap-works.html" title="Chapter 3. Understanding How SystemTap Works" /><link rel="prev" href="arrayops-aggregates.html" title="3.5.7. Computing for Statistical Aggregates" /><link rel="next" href="userspace-probing.html" title="Chapter 4. User-Space Probing" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-aggregates.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="userspace-probing.html"><strong>Next</strong></a></li></ul><div class="section" id="understanding-tapsets"><div class="titlepage"><div><div><h2 class="title" id="understanding-tapsets">3.6. Tapsets</h2></div></div></div><a id="idp13753120" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">3.6. Tapsets</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="understanding-how-systemtap-works.html" title="Chapter 3. Understanding How SystemTap Works" /><link rel="prev" href="arrayops-aggregates.html" title="3.5.7. Computing for Statistical Aggregates" /><link rel="next" href="userspace-probing.html" title="Chapter 4. User-space Probing" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="arrayops-aggregates.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="userspace-probing.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="understanding-tapsets"></a>3.6. Tapsets</h2></div></div></div><a id="idm246928952464" class="indexterm"></a><div class="para">
<em class="firstterm">Tapsets</em> are scripts that form a library of pre-written probes and functions to be used in SystemTap scripts. When a user runs a SystemTap script, SystemTap checks the script's probe events and handlers against the tapset library; SystemTap then loads the corresponding probes and functions before translating the script to C (refer to <a class="xref" href="understanding-how-systemtap-works.html#understanding-architecture-tools">Section 3.1, “Architecture”</a> for information on what transpires in a SystemTap session).
</div><div class="para">
Like SystemTap scripts, tapsets use the file name extension <code class="filename">.stp</code>. The standard library of tapsets is located in <code class="filename">/usr/share/systemtap/tapset/</code> by default. However, unlike SystemTap scripts, tapsets are not meant for direct execution; rather, they constitute the library from which other scripts can pull definitions.
</div><div class="para">
- Simply put, the tapset library is an abstraction layer designed to make it easier for users to define events and functions. In a manner of speaking, tapsets provide useful aliases for functions that users may want to specify as an event; knowing the proper alias to use is, for the most part, easier than remembering specific kernel functions that might vary between kernel versions.
+ The tapset library is an abstraction layer designed to make it easier for users to define events and functions. Tapsets provide useful aliases for functions that users may want to specify as an event; knowing the proper alias to use is, for the most part, easier than remembering specific kernel functions that might vary between kernel versions.
</div><div class="para">
Several handlers and functions in <a class="xref" href="scripts.html#systemtapscript-events">Section 3.2.1, “Event”</a> and <a class="xref" href="systemtapscript-handler.html#systemtapscript-functions">SystemTap Functions</a> are defined in tapsets. For example, <code class="command">thread_indent()</code> is defined in <code class="filename">indent.stp</code>.
- </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-aggregates.html"><strong>Prev</strong>3.5.7. Computing for Statistical Aggregates</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="userspace-probing.html"><strong>Next</strong>Chapter 4. User-Space Probing</a></li></ul></body></html>
+ </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="arrayops-aggregates.html"><strong>Prev</strong>3.5.7. Computing for Statistical Aggregates</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="userspace-probing.html"><strong>Next</strong>Chapter 4. User-space Probing</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 5. Useful SystemTap Scripts</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="ustack.html" title="4.3. User-Space Stack Backtraces" /><link rel="next" href="mainsect-disk.html" title="5.2. Disk" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="ustack.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="mainsect-disk.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="chapter" id="useful-systemtap-scripts" lang="en-US"><div class="titlepage"><div><div><h2 class="title">Chapter 5. Useful SystemTap Scripts</h2></div></div></div><div class="toc"><dl><dt><span class="section"><a href="useful-systemtap-scripts.html#mainsect-network">5.1. Network</a></span></dt><dd><dl><dt><span class="section"><a href="useful-systemtap-scripts.html#nettopsect">5.1.1. Network Profiling</a></span></dt><dt><span class="section"><a href="useful-systemtap-scripts.html#sockettracesect">5.1.2. Tracing Functions Called in Network Socket Code</a></span></dt><dt><span class="section"><a href="useful-systemtap-scripts.html#tcpconnectionssect">5.1.3. Monitoring Incoming TCP Connections</a></span></dt><dt><span class="section"><a href="useful-systemtap-scripts.html#tcpdumplikesect">5.1.4. Monitoring TCP Packets</a></span></dt><dt><span class="section"><a href="useful-systemtap-scripts.html#dropwatchsect">5.1.5. Monitoring Network Packets Drops in Kernel</a></span></dt></dl></dd><dt><span class="section"><a href="mainsect-disk.html">5.2. Disk</a></span></dt><dd><dl><dt><span class="section"><a href="mainsect-disk.html#disktop">5.2.1. Summarizing Disk Read/Write Traffic</a></span></dt><dt><span class="section"><a href="iotimesect.html">5.2.2. Tracking I/O Time For Each File Read or Write</a></span></dt><dt><span class="section"><a href="traceiosect.html">5.2.3. Track Cumulative IO</a></span></dt><dt><span class="section"><a href="traceio2sect.html">5.2.4. I/O Monitoring (By Device)</a></span></dt><dt><span class="section"><a href="inodewatchsect.html">5.2.5. Monitoring Reads and Writes to a File</a></span></dt><dt><span class="section"><a href="inodewatch2sect.html">5.2.6. Monitoring Changes to File Attributes</a></span></dt><dt><span class="section"><a href="ioblktimesect.html">5.2.7. Periodically Print I/O Block Time</a></span></dt></dl></dd><dt><span class="section"><a href="mainsect-profiling.html">5.3. Profiling</a></span></dt><dd><dl><dt><span class="section"><a href="mainsect-profiling.html#countcallssect">5.3.1. Counting Function Calls Made</a></span></dt><dt><span class="section"><a href="paracallgraph.html">5.3.2. Call Graph Tracing</a></span></dt><dt><span class="section"><a href="threadtimessect.html">5.3.3. Determining Time Spent in Kernel and User Space</a></span></dt><dt><span class="section"><a href="timeoutssect.html">5.3.4. Monitoring Polling Applications</a></span></dt><dt><span class="section"><a href="topsyssect.html">5.3.5. Tracking Most Frequently Used System Calls</a></span></dt><dt><span class="section"><a href="syscallsbyprocpidsect.html">5.3.6. Tracking System Call Volume Per Process</a></span></dt></dl></dd><dt><span class="section"><a href="futexcontentionsect.html">5.4. Identifying Contended User-Space Locks</a></span></dt></dl></div><a id="idm1938528" class="indexterm"></a><a id="idm1939936" class="indexterm"></a><a id="idm1940864" class="indexterm"></a><a id="idm1941792" class="indexterm"></a><div class="para">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">Chapter 5. Useful SystemTap Scripts</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="ustack.html" title="4.3. User-Space Stack Backtraces" /><link rel="next" href="mainsect-disk.html" title="5.2. Disk" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="ustack.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="mainsect-disk.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="chapter" lang="en-US"><div class="titlepage"><div><div><h1 class="title"><a id="useful-systemtap-scripts"></a>Chapter 5. Useful SystemTap Scripts</h1></div></div></div><div class="toc"><dl class="toc"><dt><span class="section"><a href="useful-systemtap-scripts.html#mainsect-network">5.1. Network</a></span></dt><dd><dl><dt><span class="section"><a href="useful-systemtap-scripts.html#nettopsect">5.1.1. Network Profiling</a></span></dt><dt><span class="section"><a href="useful-systemtap-scripts.html#sockettracesect">5.1.2. Tracing Functions Called in Network Socket Code</a></span></dt><dt><span class="section"><a href="useful-systemtap-scripts.html#tcpconnectionssect">5.1.3. Monitoring Incoming TCP Connections</a></span></dt><dt><span class="section"><a href="useful-systemtap-scripts.html#tcpdumplikesect">5.1.4. Monitoring TCP Packets</a></span></dt><dt><span class="section"><a href="useful-systemtap-scripts.html#dropwatchsect">5.1.5. Monitoring Network Packets Drops in Kernel</a></span></dt></dl></dd><dt><span class="section"><a href="mainsect-disk.html">5.2. Disk</a></span></dt><dd><dl><dt><span class="section"><a href="mainsect-disk.html#disktop">5.2.1. Summarizing Disk Read/Write Traffic</a></span></dt><dt><span class="section"><a href="iotimesect.html">5.2.2. Tracking I/O Time For Each File Read or Write</a></span></dt><dt><span class="section"><a href="traceiosect.html">5.2.3. Track Cumulative IO</a></span></dt><dt><span class="section"><a href="traceio2sect.html">5.2.4. I/O Monitoring (By Device)</a></span></dt><dt><span class="section"><a href="inodewatchsect.html">5.2.5. Monitoring Reads and Writes to a File</a></span></dt><dt><span class="section"><a href="inodewatch2sect.html">5.2.6. Monitoring Changes to File Attributes</a></span></dt><dt><span class="section"><a href="ioblktimesect.html">5.2.7. Periodically Print I/O Block Time</a></span></dt></dl></dd><dt><span class="section"><a href="mainsect-profiling.html">5.3. Profiling</a></span></dt><dd><dl><dt><span class="section"><a href="mainsect-profiling.html#countcallssect">5.3.1. Counting Function Calls Made</a></span></dt><dt><span class="section"><a href="paracallgraph.html">5.3.2. Call Graph Tracing</a></span></dt><dt><span class="section"><a href="threadtimessect.html">5.3.3. Determining Time Spent in Kernel and User Space</a></span></dt><dt><span class="section"><a href="timeoutssect.html">5.3.4. Monitoring Polling Applications</a></span></dt><dt><span class="section"><a href="topsyssect.html">5.3.5. Tracking Most Frequently Used System Calls</a></span></dt><dt><span class="section"><a href="syscallsbyprocpidsect.html">5.3.6. Tracking System Call Volume Per Process</a></span></dt></dl></dd><dt><span class="section"><a href="futexcontentionsect.html">5.4. Identifying Contended User-Space Locks</a></span></dt></dl></div><a id="idm246918175088" class="indexterm"></a><a id="idm246918176944" class="indexterm"></a><a id="idm246918177872" class="indexterm"></a><a id="idm246918178800" class="indexterm"></a><div class="para">
This chapter enumerates several SystemTap scripts you can use to monitor and investigate different subsystems. All of these scripts are available at <code class="filename">/usr/share/systemtap/testsuite/systemtap.examples/</code> once you install the <code class="filename">systemtap-testsuite</code> RPM.
- </div><div class="section"
id="mainsect-network"><div class="titlepage"><div><div><h2 class="title" id="mainsect-network">5.1. Network</h2></div></div></div><div class="para">
+ </div><div class="section"
><div class="titlepage"><div><div><h2 class="title"><a id="mainsect-network"></a>5.1. Network</h2></div></div></div><div class="para">
The following sections showcase scripts that trace network-related functions and build a profile of network activity.
- </div><div xml:lang="en-US" class="section"
id="nettopsect" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="nettopsect">5.1.1. Network Profiling</h3></div></div></div><a id="idp40475696" class="indexterm"></a><a id="idp40474256" class="indexterm"></a><a id="idp40473968" class="indexterm"></a><a id="idp40471088" class="indexterm"></a><a id="idp13729776" class="indexterm"></a><div class="para">
+ </div><div xml:lang="en-US" class="section"
lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="nettopsect"></a>5.1.1. Network Profiling</h3></div></div></div><a id="idm246927849152" class="indexterm"></a><a id="idm246927850608" class="indexterm"></a><a id="idm246927852176" class="indexterm"></a><a id="idm246895709792" class="indexterm"></a><a id="idm246895711248" class="indexterm"></a><div class="para">
This section describes how to profile network activity. <a class="xref" href="useful-systemtap-scripts.html#nettop">nettop.stp</a> provides a glimpse into how much network traffic each process is generating on a machine.
- </div><div class="formalpara" id="nettop"><h5 class="formalpara">nettop.stp</h5>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">nettop.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
print_activity()
}
</pre>
- </div><a id="id
p23122912" class="indexterm"></a><a id="idp60259712" class="indexterm"></a><a id="idp13724176" class="indexterm"></a><div class="para">
+ </div><a id="id
m246917411344" class="indexterm"></a><a id="idm246929725840" class="indexterm"></a><a id="idm246921049808" class="indexterm"></a><div class="para">
Note that <code class="command">function print_activity()</code> uses the following expressions:
</div><pre class="screen">n_xmit ? @sum(ifxmit[pid, dev, exec, uid])/1024 : 0
n_recv ? @sum(ifrecv[pid, dev, exec, uid])/1024 : 0</pre><div class="para">
- These expressions are if/else conditionals. The first statement is simply a more concise way of writing the following psuedo code:
+ These expressions are if/else conditionals. The first statement is a more concise way of writing the following psuedo code:
</div><pre class="screen">if n_recv != 0 then
@sum(ifrecv[pid, dev, exec, uid])/1024
else
0</pre><div class="para">
<a class="xref" href="useful-systemtap-scripts.html#nettop">nettop.stp</a> tracks which processes are generating network traffic on the system, and provides the following information about each process:
- </div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
<code class="computeroutput">PID</code> — the ID of the listed process.
</div></li><li class="listitem"><div class="para">
<code class="computeroutput">UID</code> — user ID. A user ID of <code class="computeroutput">0</code> refers to the root user.
</div></li><li class="listitem"><div class="para">
- <code class="computeroutput">DEV</code> — which ethernet device the process used to send / receive data (e.g. eth0, eth1)
+ <code class="computeroutput">DEV</code> — which ethernet device the process used to send / receive data (for example, eth0, eth1)
</div></li><li class="listitem"><div class="para">
<code class="computeroutput">XMIT_PK</code> — number of packets transmitted by the process
</div></li><li class="listitem"><div class="para">
<code class="computeroutput">RECV_KB</code> — amount of data received by the service, in kilobytes
</div></li></ul></div><div class="para">
<a class="xref" href="useful-systemtap-scripts.html#nettop">nettop.stp</a> provides network profile sampling every 5 seconds. You can change this setting by editing <code class="command">probe timer.ms(5000)</code> accordingly. <a class="xref" href="useful-systemtap-scripts.html#nettopoutput">Example 5.1, “nettop.stp Sample Output”</a> contains an excerpt of the output from <a class="xref" href="useful-systemtap-scripts.html#nettop">nettop.stp</a> over a 20-second period:
- </div><div class="example"
id="nettopoutput"><h6>Example 5.1. <a class="xref" href="useful-systemtap-scripts.html#nettop">nettop.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen">[...]
+ </div><div class="example"
><a id="nettopoutput"></a><p class="title"><strong>Example 5.1. <a class="xref" href="useful-systemtap-scripts.html#nettop">nettop.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen">[...]
PID UID DEV XMIT_PK RECV_PK XMIT_KB RECV_KB COMMAND
0 0 eth0 0 5 0 0 swapper
11178 0 eth0 2 0 0 0 synergyc
11178 0 eth0 43 1 3 0 synergyc
11362 0 eth0 0 7 0 0 firefox
3897 0 eth0 0 1 0 0 multiload-apple
-[...]</pre></div></div><br class="example-break" /></div><div xml:lang="en-US" class="section"
id="sockettracesect" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="sockettracesect">5.1.2. Tracing Functions Called in Network Socket Code</h3></div></div></div><a id="idp21187056" class="indexterm"></a><a id="idp49668464" class="indexterm"></a><a id="idm9431392" class="indexterm"></a><a id="idp32442192" class="indexterm"></a><a id="idp29947872" class="indexterm"></a><a id="idp49526016" class="indexterm"></a><a id="idp63779600" class="indexterm"></a><a id="idp31277936" class="indexterm"></a><div class="para">
+[...]</pre></div></div><br class="example-break" /></div><div xml:lang="en-US" class="section"
lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="sockettracesect"></a>5.1.2. Tracing Functions Called in Network Socket Code</h3></div></div></div><a id="idm246871109008" class="indexterm"></a><a id="idm246880238352" class="indexterm"></a><a id="idm246918104272" class="indexterm"></a><a id="idm246913399936" class="indexterm"></a><a id="idm246927078624" class="indexterm"></a><a id="idm246927410720" class="indexterm"></a><a id="idm246920810544" class="indexterm"></a><a id="idm246926743104" class="indexterm"></a><div class="para">
This section describes how to trace functions called from the kernel's <code class="filename">net/socket.c</code> file. This task helps you identify, in finer detail, how each process interacts with the network at the kernel level.
- </div><div class="formalpara" id="sockettrace"><h5 class="formalpara">socket-trace.stp</h5>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">socket-trace.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
</pre>
</div><div class="para">
<a class="xref" href="useful-systemtap-scripts.html#sockettrace">socket-trace.stp</a> is identical to <a class="xref" href="systemtapscript-handler.html#thread_indent">Example 3.6, “thread_indent.stp”</a>, which was earlier used in <a class="xref" href="systemtapscript-handler.html#systemtapscript-functions">SystemTap Functions</a> to illustrate how <code class="command">thread_indent()</code> works.
- </div><div class="example"
id="sockettraceoutput"><h6>Example 5.2. <a class="xref" href="useful-systemtap-scripts.html#sockettrace">socket-trace.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen">[...]
+ </div><div class="example"
><a id="sockettraceoutput"></a><p class="title"><strong>Example 5.2. <a class="xref" href="useful-systemtap-scripts.html#sockettrace">socket-trace.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen">[...]
0 Xorg(3611): -> sock_poll
3 Xorg(3611): <- sock_poll
0 Xorg(3611): -> sock_poll
35 scim-bridge(3883): <- sys_socketcall
[...]</pre></div></div><br class="example-break" /><div class="para">
<a class="xref" href="useful-systemtap-scripts.html#sockettraceoutput">Example 5.2, “socket-trace.stp Sample Output”</a> contains a 3-second excerpt of the output for <a class="xref" href="useful-systemtap-scripts.html#sockettrace">socket-trace.stp</a>. For more information about the output of this script as provided by <code class="command">thread_indent()</code>, refer to <a class="xref" href="systemtapscript-handler.html#systemtapscript-functions">SystemTap Functions</a> <a class="xref" href="systemtapscript-handler.html#thread_indent">Example 3.6, “thread_indent.stp”</a>.
- </div></div><div xml:lang="en-US" class="section"
id="tcpconnectionssect" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="tcpconnectionssect">5.1.3. Monitoring Incoming TCP Connections</h3></div></div></div><a id="idp59107328" class="indexterm"></a><a id="idp32306816" class="indexterm"></a><a id="idp26483856" class="indexterm"></a><a id="idp25158288" class="indexterm"></a><a id="idp22705728" class="indexterm"></a><div class="para">
+ </div></div><div xml:lang="en-US" class="section"
lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="tcpconnectionssect"></a>5.1.3. Monitoring Incoming TCP Connections</h3></div></div></div><a id="idm246871570432" class="indexterm"></a><a id="idm246918299760" class="indexterm"></a><a id="idm246926647984" class="indexterm"></a><a id="idm246877713872" class="indexterm"></a><a id="idm246929547376" class="indexterm"></a><div class="para">
This section illustrates how to monitor incoming TCP connections. This task is useful in identifying any unauthorized, suspicious, or otherwise unwanted network access requests in real time.
- </div><div class="formalpara" id="tcpconnections"><h5 class="formalpara">tcp_connections.stp</h5>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">tcp_connections.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
</pre>
</div><div class="para">
While <a class="xref" href="useful-systemtap-scripts.html#tcpconnections">tcp_connections.stp</a> is running, it will print out the following information about any incoming TCP connections accepted by the system in real time:
- </div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
Current <code class="command">UID</code>
</div></li><li class="listitem"><div class="para">
<code class="command">CMD</code> - the command accepting the connection
Port used by the connection
</div></li><li class="listitem"><div class="para">
IP address from which the TCP connection originated
- </div></li></ul></div><div class="example"
id="tcpconnectionsoutput"><h6>Example 5.3. <a class="xref" href="useful-systemtap-scripts.html#tcpconnections">tcp_connections.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen">UID CMD PID PORT IP_SOURCE
+ </div></li></ul></div><div class="example"
><a id="tcpconnectionsoutput"></a><p class="title"><strong>Example 5.3. <a class="xref" href="useful-systemtap-scripts.html#tcpconnections">tcp_connections.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen">UID CMD PID PORT IP_SOURCE
0 sshd 3165 22 10.64.0.227
-0 sshd 3165 22 10.64.0.227</pre></div></div><br class="example-break" /></div><div xml:lang="en-US" class="section"
id="tcpdumplikesect" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="tcpdumplikesect">5.1.4. Monitoring TCP Packets</h3></div></div></div><a id="idp44693264" class="indexterm"></a><a id="idp35969280" class="indexterm"></a><a id="idm1945808" class="indexterm"></a><a id="idp63046864" class="indexterm"></a><a id="idp27444448" class="indexterm"></a><div class="para">
+0 sshd 3165 22 10.64.0.227</pre></div></div><br class="example-break" /></div><div xml:lang="en-US" class="section"
lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="tcpdumplikesect"></a>5.1.4. Monitoring TCP Packets</h3></div></div></div><a id="idm246917316128" class="indexterm"></a><a id="idm246870511072" class="indexterm"></a><a id="idm246929502576" class="indexterm"></a><a id="idm246878073632" class="indexterm"></a><a id="idm246912632672" class="indexterm"></a><div class="para">
This section illustrates how to monitor TCP packets received by the system. This is useful in analyzing network traffic generated by applications running on the system.
- </div><div class="formalpara" id="tcpdumplike"><h5 class="formalpara">tcpdumplike.stp</h5>
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">tcpdumplike.stp</div>
<pre class="programlisting"> #! /usr/bin/env stap
printf("-----------------------------------------------------------------\n")
}
+probe udp.recvmsg /* ,udp.sendmsg */ {
+ printf(" %15s %15s %5d %5d UDP\n",
+ saddr, daddr, sport, dport)
+}
+
probe tcp.receive {
printf(" %15s %15s %5d %5d %d %d %d %d %d %d\n",
saddr, daddr, sport, dport, urg, ack, psh, rst, syn, fin)
</pre>
</div><div class="para">
While <a class="xref" href="useful-systemtap-scripts.html#tcpdumplike">tcpdumplike.stp</a> is running, it will print out the following information about any received TCP packets in real time:
- </div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
Source and destination IP address (<code class="command">saddr</code>, <code class="command">daddr</code>, respectively)
</div></li><li class="listitem"><div class="para">
Source and destination ports (<code class="command">sport</code>, <code class="command">dport</code>, respectively)
Packet flags
</div></li></ul></div><div class="para">
To determine the flags used by the packet, <a class="xref" href="useful-systemtap-scripts.html#tcpdumplike">tcpdumplike.stp</a> uses the following functions:
- </div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
<code class="command">urg</code> - urgent
</div></li><li class="listitem"><div class="para">
<code class="command">ack</code> - acknowledgement
<code class="command">fin</code> - finished
</div></li></ul></div><div class="para">
The aforementioned functions return <code class="command">1</code> or <code class="command">0</code> to specify whether the packet uses the corresponding flag.
- </div><div class="example"
id="tcpdumplikeoutput"><h6>Example 5.4. <a class="xref" href="useful-systemtap-scripts.html#tcpdumplike">tcpdumplike.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen">-----------------------------------------------------------------
+ </div><div class="example"
><a id="tcpdumplikeoutput"></a><p class="title"><strong>Example 5.4. <a class="xref" href="useful-systemtap-scripts.html#tcpdumplike">tcpdumplike.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen">-----------------------------------------------------------------
Source IP Dest IP SPort DPort U A P R S F
-----------------------------------------------------------------
209.85.229.147 10.0.2.15 80 20373 0 1 1 0 0 0
209.85.229.147 10.0.2.15 80 21141 0 1 1 0 0 0
209.85.229.147 10.0.2.15 80 21141 0 1 1 0 0 0
209.85.229.118 10.0.2.15 80 63433 0 1 1 0 0 0
-[...]</pre></div></div><br class="example-break" /></div><div xml:lang="en-US" class="section" id="dropwatchsect" lang="en-US"><div class="titlepage"><div><div><h3 class="title" id="dropwatchsect">5.1.5. Monitoring Network Packets Drops in Kernel</h3></div></div></div><a id="idp38171344" class="indexterm"></a><a id="idp33200576" class="indexterm"></a><a id="idp33595616" class="indexterm"></a><a id="idp31425296" class="indexterm"></a><a id="idm2925232" class="indexterm"></a><div class="para">
- <a id="idp32785376" class="indexterm"></a>
- The network stack in Linux can discard packets for various reasons. Some Linux kernels include a tracepoint, <code class="command">kernel.trace("kfree_skb")</code>, which easily tracks where packets are discarded. <a class="xref" href="useful-systemtap-scripts.html#dropwatch">dropwatch.stp</a> uses <code class="command">kernel.trace("kfree_skb")</code> to trace packet discards; the script summarizes which locations discard packets every five-second interval.
- </div><div class="formalpara" id="dropwatch"><h5 class="formalpara">dropwatch.stp</h5>
+[...]</pre></div></div><br class="example-break" /></div><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h3 class="title"><a id="dropwatchsect"></a>5.1.5. Monitoring Network Packets Drops in Kernel</h3></div></div></div><a id="idm246870389328" class="indexterm"></a><a id="idm246875760144" class="indexterm"></a><a id="idm246929001024" class="indexterm"></a><a id="idm246928729152" class="indexterm"></a><a id="idm246914098768" class="indexterm"></a><div class="para">
+ <a id="idm246917002288" class="indexterm"></a> The network stack in Linux can discard packets for various reasons. Some Linux kernels include a tracepoint, <code class="command">kernel.trace("kfree_skb")</code>, which easily tracks where packets are discarded. <a class="xref" href="useful-systemtap-scripts.html#dropwatch">dropwatch.stp</a> uses <code class="command">kernel.trace("kfree_skb")</code> to trace packet discards; the script summarizes which locations discard packets every five-second interval.
+ </div><div class="formalpara"><div xmlns:d="http://docbook.org/ns/docbook" class="title">dropwatch.stp</div>
<pre class="programlisting">#! /usr/bin/env stap
}
</pre>
</div><div class="para">
- The <code class="command">kernel.trace("kfree_skb")</code> traces which places in the kernel drop network packets. The <code class="command">kernel.trace("kfree_skb")</code> has two arguments: a pointer to the buffer being freed (<code class="command">$skb</code>) and the location in kernel code the buffer is being freed (<code class="command">$location</code>). The <a class="xref" href="useful-systemtap-scripts.html#dropwatch">dropwatch.stp</a> script provides the function containing <code class="command">$location</code> where possible. The information to map <code class="command">$location</code> back to the function is not in the instrumentation by default. On Systemtap 1.4 the <code class="command">--all-modules</code> option will include the required mapping information and the following command can be used to run the script:
+ The <code class="command">kernel.trace("kfree_skb")</code> traces which places in the kernel drop network packets. The <code class="command">kernel.trace("kfree_skb")</code> has two arguments: a pointer to the buffer being freed (<code class="command">$skb</code>) and the location in kernel code the buffer is being freed (<code class="command">$location</code>). The <a class="xref" href="useful-systemtap-scripts.html#dropwatch">dropwatch.stp</a> script provides the function containing <code class="command">$location</code> where possible. The information to map <code class="command">$location</code> back to the function is not in the instrumentation by default. On SystemTap 1.4 the <code class="command">--all-modules</code> option will include the required mapping information and the following command can be used to run the script:
</div><pre class="programlisting">stap --all-modules dropwatch.stp</pre><div class="para">
- On older versions of Systemtap you can use the following command to emulate the <code class="command">--all-modules</code> option:
+ On older versions of SystemTap you can use the following command to emulate the <code class="command">--all-modules</code> option:
</div><pre class="programlisting">stap -dkernel \
`cat /proc/modules | awk 'BEGIN { ORS = " " } {print "-d"$1}'` \
dropwatch.stp</pre><div class="para">
Running the dropwatch.stp script 15 seconds would result in output similar in <a class="xref" href="useful-systemtap-scripts.html#dropwatchoutput">Example 5.5, “dropwatch.stp Sample Output”</a>. The output lists the number of misses for each tracepoint location with either the function name or the address.
- </div><div class="example"
id="dropwatchoutput"><h6>Example 5.5. <a class="xref" href="useful-systemtap-scripts.html#dropwatch">dropwatch.stp</a> Sample Output</h6><div class="example-contents"><pre class="screen">Monitoring for dropped packets
+ </div><div class="example"
><a id="dropwatchoutput"></a><p class="title"><strong>Example 5.5. <a class="xref" href="useful-systemtap-scripts.html#dropwatch">dropwatch.stp</a> Sample Output</strong></p><div class="example-contents"><pre class="screen">Monitoring for dropped packets
1762 packets dropped at unix_stream_recvmsg
4 packets dropped at tun_do_read
ffffffff8149a420 t unix_dgram_poll
ffffffff8149a5e0 t unix_stream_recvmsg
ffffffff8149ad00 t unix_find_other
-[...]</pre></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="ustack.html"><strong>Prev</strong>4.3. User-Space Stack Backtraces</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="mainsect-disk.html"><strong>Next</strong>5.2. Disk</a></li></ul></body></html>
+[...]</pre></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="ustack.html"><strong>Prev</strong>4.3. User-Space Stack Backtraces</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="mainsect-disk.html"><strong>Next</strong>5.2. Disk</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 4. User-Space Probing</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="understanding-tapsets.html" title="3.6. Tapsets" /><link rel="next" href="utargetvariable.html" title="4.2. Accessing User-Space Target Variables" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="understanding-tapsets.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="utargetvariable.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="chapter" id="userspace-probing" lang="en-US"><div class="titlepage"><div><div><h2 class="title">Chapter 4. User-Space Probing</h2></div></div></div><div class="toc"><dl><dt><span class="section"><a href="userspace-probing.html#uevents">4.1. User-Space Events</a></span></dt><dt><span class="section"><a href="utargetvariable.html">4.2. Accessing User-Space Target Variables</a></span></dt><dt><span class="section"><a href="ustack.html">4.3. User-Space Stack Backtraces</a></span></dt></dl></div><div class="para">
- SystemTap initially focused on kernel-space probing. However, there are many instances where user-space probing can help diagnose a problem. SystemTap 0.6 added support to allow probing user-space processes. SystemTap includes support for probing the entry into and return from a function in user-space processes, probing predefined markers in user-space code, and monitoring user-process events.
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">Chapter 4. User-space Probing</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="understanding-tapsets.html" title="3.6. Tapsets" /><link rel="next" href="utargetvariable.html" title="4.2. Accessing User-Space Target Variables" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="understanding-tapsets.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="utargetvariable.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="chapter" lang="en-US"><div class="titlepage"><div><div><h1 class="title"><a id="userspace-probing"></a>Chapter 4. User-space Probing</h1></div></div></div><div class="toc"><dl class="toc"><dt><span class="section"><a href="userspace-probing.html#uevents">4.1. User-Space Events</a></span></dt><dt><span class="section"><a href="utargetvariable.html">4.2. Accessing User-Space Target Variables</a></span></dt><dt><span class="section"><a href="ustack.html">4.3. User-Space Stack Backtraces</a></span></dt></dl></div><div class="para">
+ SystemTap initially focused on kernel-space probing. Because there are many instances where user-space probing can help diagnose a problem, SystemTap 0.6 added support to allow probing user-space processes. SystemTap can probe the entry into and return from a function in user-space processes, probe predefined markers in user-space code, and monitor user-process events.
</div><div class="para">
- The SystemTap user-space probing requires the utrace kernel extensions which provide an API for tracking various user-space events. More details about the utrace infrastructure are available at <a href="http://sourceware.org/systemtap/wiki/utrace">http://sourceware.org/systemtap/wiki/utrace</a>. The following command determines whether the currently running Linux kernel provides the needed utrace support:
- </div><pre class="screen">grep CONFIG_UTRACE /boot/config-`uname -r`</pre><div class="para">
- If the Linux kernel support user-space probing, the following output is printed:
- </div><pre class="screen">CONFIG_UTRACE=y</pre><div class="para">
- The SystemTap user-space probing also needs the uprobes kernel module. If the uprobes kernel module is not available, you will see an error message like the following when attempting to run a script that requires the uprobes kernel module:
- </div><pre class="screen">SystemTap's version of uprobes is out of date.
-As root, or a member of the 'root' group, run
-"make -C /usr/share/systemtap/runtime/uprobes".
-Pass 4: compilation failed. Try again with another '--vp 0001' option.</pre><div class="para">
- If this occurs, you need to generate a uprobes.ko module for the kernel as directed.
- </div><div class="section" id="uevents"><div class="titlepage"><div><div><h2 class="title" id="uevents">4.1. User-Space Events</h2></div></div></div><a id="idp40865824" class="indexterm"></a><div class="para">
- All user-space event probes begin with <span class="emphasis"><em>process</em></span>. The process events can be limited to a specific running process by specifying the process ID. The process events can also be limited to monitoring a particular executable by specifying the path to executable (PATH). SystemTap makes use of the <code class="command">PATH</code> environment variable, so both the name used on the command-line to start the executable and the absolute path to the executable can be used. Several of user-space probe events limit their scope to a particular executable name (PATH) because SystemTap must use debug information to statically analyzed where to places the probes, but for many user-space probes events the process ID and executable name are optional. Any <code class="command">process</code> event in the list below that include process ID or the path to the executable must include those arguments. The process ID and path to the executable are optional for the <code class="command">process</code> events that do not list them:
- </div><div class="variablelist"><dl><dt class="varlistentry"><span class="term">process("<em class="replaceable"><code>PATH</code></em>").function("<em class="replaceable"><code>function</code></em>")</span></dt><dd><div class="para">
- The entry to the user-space function <em class="replaceable"><code>function</code></em> for the executable <em class="replaceable"><code>PATH</code></em>. This event is the user-space analogue of the <code class="command">kernel.function("<em class="replaceable"><code>function</code></em>")</code> event. It allows wildcards for the function <em class="replaceable"><code>function</code></em> and <code class="command">.return</code> suffix.
- </div></dd><dt class="varlistentry"><span class="term">process("<em class="replaceable"><code>PATH</code></em>").statement("<em class="replaceable"><code>statement</code></em>")</span></dt><dd><div class="para">
+ SystemTap requires the uprobes module to perform user-space probing. If your Linux kernel is version 3.5 or higher, it already includes uprobes. To verify that the current kernel supports uprobes natively, run the following command:
+ </div><pre class="screen"><code class="command">grep CONFIG_UPROBES /boot/config-`uname -r`</code></pre><div class="para">
+ If uprobes is integrated, the output of this command is as follows:
+ </div><pre class="screen">CONFIG_UPROBES=y</pre><div class="para">
+ If you are running a kernel prior to version 3.5, SystemTap automatically builds the uprobes module. However, you also need the utrace kernel extensions required by the SystemTap user-space probing to track various user-space events. More details about the utrace infrastructure are available at <a href="http://sourceware.org/systemtap/wiki/utrace">http://sourceware.org/systemtap/wiki/utrace</a>. To determine whether the currently running Linux kernel provides the needed utrace support, type the following at a shell prompt:
+ </div><pre class="screen"><code class="command">grep CONFIG_UTRACE /boot/config-`uname -r`</code></pre><div class="para">
+ If the Linux kernel supports user-space probing, the command produces the following output:
+ </div><pre class="screen">CONFIG_UTRACE=y</pre><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="uevents"></a>4.1. User-Space Events</h2></div></div></div><a id="idm246873738464" class="indexterm"></a><div class="para">
+ All user-space event probes begin with <span class="emphasis"><em>process</em></span>. You can limit the process events to a specific running process by specifying the process ID. You can also limit the process events to monitor a particular executable by specifying the path to the executable (PATH). SystemTap makes use of the <code class="envar">PATH</code> environment variable, which allows you to use both the name used on the command-line to start the executable and the absolute path to the executable.
+ </div><div class="para">
+ Several of the user-space probe events limit their scope to a particular executable name (PATH), because SystemTap must use debug information to statically analyze where to place the probes. But for many user-space probe events, the process ID and executable name are optional. Any <code class="command">process</code> event in the list below that include process ID or the path to the executable must include those arguments. The process ID and path to the executable are optional for the <code class="command">process</code> events that do not list them:
+ </div><div class="variablelist"><dl class="variablelist"><dt><span class="term">process("<em class="replaceable"><code>PATH</code></em>").function("<em class="replaceable"><code>function</code></em>")</span></dt><dd><div class="para">
+ The entry to the user-space function <em class="replaceable"><code>function</code></em> for the executable <em class="replaceable"><code>PATH</code></em>. This event is the user-space analogue of the <code class="command">kernel.function("<em class="replaceable"><code>function</code></em>")</code> event. It allows wildcards for the function <em class="replaceable"><code>function</code></em> and <code class="literal">.return</code> suffix.
+ </div></dd><dt><span class="term">process("<em class="replaceable"><code>PATH</code></em>").statement("<em class="replaceable"><code>statement</code></em>")</span></dt><dd><div class="para">
The earliest instruction in the code for <em class="replaceable"><code>statement</code></em>. This is the user-space analogue of <code class="command">kernel.statement("<em class="replaceable"><code>statement</code></em>")</code>.
- </div></dd><dt class="varlistentry"><span class="term">process("<em class="replaceable"><code>PATH</code></em>").mark("<em class="replaceable"><code>marker</code></em>")</span></dt><dd><div class="para">
- The static probe point <em class="replaceable"><code>marker</code></em> defined in <em class="replaceable"><code>PATH</code></em>. Wildcards can be used for <em class="replaceable"><code>marker</code></em> to specify mutiple marks with a single probe. The static probe points may also have numbered arguments ($1, $2, etc.) available to the probe. A variety of user-space packages such as Java include these static probe points. Most packages that provide static probe points also provide aliases for the raw user-space mark events. Below is one such alias for the x86_64 Java hotspot JVM:
- </div><pre class="screen">probe hotspot.gc_begin =
- process("/usr/lib/jvm/java-1.6.0-openjdk-1.6.0.0.x86_64/jre/lib/amd64/server/libjvm.so").mark("gc__begin")</pre></dd><dt class="varlistentry"><span class="term">process.begin</span></dt><dd><div class="para">
- User-space process is created. This can be limited to a particular process ID or a full path to the executable.
- </div></dd><dt class="varlistentry"><span class="term">process.thread.begin</span></dt><dd><div class="para">
- User-space thread is created. This can be limited to a particular process ID or a full path to the executable.
- </div></dd><dt class="varlistentry"><span class="term">process.end</span></dt><dd><div class="para">
- User-space process died. This can be limited to a particular process ID or a full path to the executable.
- </div></dd><dt class="varlistentry"><span class="term">process.thread.end</span></dt><dd><div class="para">
- User-space thread is destroyed. This can be limited to a particular process ID or a full path to the executable.
- </div></dd><dt class="varlistentry"><span class="term">process.syscall</span></dt><dd><div class="para">
- User-space process makes a system call. The system call number is available via $syscall context variable, and the fist six arguments are available via $arg1 through $arg6. The ".return" suffix will place the probe at the return from the system call. For the "syscall.return" the return value is available through the $return context variable. This can be limited to a particular process ID or a full path to the executable.
- </div></dd></dl></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="understanding-tapsets.html"><strong>Prev</strong>3.6. Tapsets</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="utargetvariable.html"><strong>Next</strong>4.2. Accessing User-Space Target Variables</a></li></ul></body></html>
+ </div></dd><dt><span class="term">process("<em class="replaceable"><code>PATH</code></em>").mark("<em class="replaceable"><code>marker</code></em>")</span></dt><dd><div class="para">
+ The static probe point <em class="replaceable"><code>marker</code></em> defined in <em class="replaceable"><code>PATH</code></em>. You can use wildcards for <em class="replaceable"><code>marker</code></em> to specify multiple marks with a single probe. The static probe points may also have numbered arguments ($1, $2, and so on) available to the probe.
+ </div><div class="para">
+ A variety of user-space packages such as Java include these static probe points. Most packages that provide static probe points also provide aliases for the raw user-space mark events. Below is one such alias for the x86_64 Java hotspot JVM:
+ </div><pre class="programlisting">probe hotspot.gc_begin =
+ process("/usr/lib/jvm/java-1.6.0-openjdk-1.6.0.0.x86_64/jre/lib/amd64/server/libjvm.so").mark("gc__begin")</pre></dd><dt><span class="term">process.begin</span></dt><dd><div class="para">
+ A user-space process is created. You can limit this to a particular process ID or a full path to the executable.
+ </div></dd><dt><span class="term">process.thread.begin</span></dt><dd><div class="para">
+ A user-space thread is created. You can limit this to a particular process ID or a full path to the executable.
+ </div></dd><dt><span class="term">process.end</span></dt><dd><div class="para">
+ A user-space process dies. You can limit this to a particular process ID or a full path to the executable.
+ </div></dd><dt><span class="term">process.thread.end</span></dt><dd><div class="para">
+ A user-space thread is destroyed. You can limit this to a particular process ID or a full path to the executable.
+ </div></dd><dt><span class="term">process.syscall</span></dt><dd><div class="para">
+ A user-space process makes a system call. The system call number is available in the <code class="varname">$syscall</code> context variable, and the fist six arguments are available in <code class="varname">$arg1</code> through <code class="varname">$arg6</code>. The <code class="literal">.return</code> suffix places the probe at the return from the system call. For <code class="command">syscall.return</code>, the return value is available through the <code class="varname">$return</code> context variable.
+ </div><div class="para">
+ You can limit this to a particular process ID or a full path to the executable.
+ </div></dd></dl></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="understanding-tapsets.html"><strong>Prev</strong>3.6. Tapsets</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="utargetvariable.html"><strong>Next</strong>4.2. Accessing User-Space Target Variables</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 2. Using SystemTap</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="intro-systemtap-vs-others.html" title="1.2. SystemTap Capabilities" /><link rel="next" href="cross-compiling.html" title="2.2. Generating Instrumentation for Other Computers" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="intro-systemtap-vs-others.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="cross-compiling.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="chapter" id="using-systemtap" lang="en-US"><div class="titlepage"><div><div><h2 class="title">Chapter 2. Using SystemTap</h2></div></div></div><div class="toc"><dl><dt><span class="section"><a href="using-systemtap.html#using-setup">2.1. Installation and Setup</a></span></dt><dd><dl><dt><span class="section"><a href="using-systemtap.html#installproper">2.1.1. Installing SystemTap</a></span></dt><dt><span class="section"><a href="using-systemtap.html#install-kinfo">2.1.2. Installing Required Kernel Information RPMs</a></span></dt><dt><span class="section"><a href="using-systemtap.html#testing">2.1.3. Initial Testing</a></span></dt></dl></dd><dt><span class="section"><a href="cross-compiling.html">2.2. Generating Instrumentation for Other Computers</a></span></dt><dt><span class="section"><a href="using-usage.html">2.3. Running SystemTap Scripts</a></span></dt><dd><dl><dt><span class="section"><a href="using-usage.html#flight-recorder">2.3.1. SystemTap Flight Recorder Mode</a></span></dt></dl></dd></dl></div><a id="idp24737824" class="indexterm"></a><div class="para">
- This chapter instructs users how to install SystemTap, and provides an introduction on how to run SystemTap scripts.
- </div><div xml:lang="en-US" class="section" id="using-setup" lang="en-US"><div class="titlepage"><div><div><h2 class="title" id="using-setup">2.1. Installation and Setup</h2></div></div></div><a id="idm9236192" class="indexterm"></a><a id="idm9237648" class="indexterm"></a><div class="para">
- To deploy SystemTap, you need to install the SystemTap packages along with the corresponding set of <code class="filename">-devel</code>, <code class="filename">-debuginfo</code> and <code class="filename">-debuginfo-common</code> packages for your kernel. If your system has multiple kernels installed, and you wish to use SystemTap on more than one kernel kernel, you will need to install the <code class="filename">-devel</code> and <code class="filename">-debuginfo</code> packages for <span class="emphasis"><em>each</em></span> of those kernel versions.
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">Chapter 2. Using SystemTap</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="index.html" title="SystemTap Beginners Guide" /><link rel="prev" href="intro-systemtap-limitations.html" title="1.3. Limitations of SystemTap" /><link rel="next" href="cross-compiling.html" title="2.2. Generating Instrumentation for Other Computers" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="intro-systemtap-limitations.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="cross-compiling.html"><strong>Next</strong></a></li></ul><div xml:lang="en-US" class="chapter" lang="en-US"><div class="titlepage"><div><div><h1 class="title"><a id="using-systemtap"></a>Chapter 2. Using SystemTap</h1></div></div></div><div class="toc"><dl class="toc"><dt><span class="section"><a href="using-systemtap.html#using-setup">2.1. Installation and Setup</a></span></dt><dd><dl><dt><span class="section"><a href="using-systemtap.html#installproper">2.1.1. Installing SystemTap</a></span></dt><dt><span class="section"><a href="using-systemtap.html#install-kinfo">2.1.2. Installing Required Kernel Information Packages Manually</a></span></dt><dt><span class="section"><a href="using-systemtap.html#testing">2.1.3. Initial Testing</a></span></dt></dl></dd><dt><span class="section"><a href="cross-compiling.html">2.2. Generating Instrumentation for Other Computers</a></span></dt><dt><span class="section"><a href="using-usage.html">2.3. Running SystemTap Scripts</a></span></dt><dd><dl><dt><span class="section"><a href="using-usage.html#flight-recorder">2.3.1. SystemTap Flight Recorder Mode</a></span></dt></dl></dd></dl></div><a id="idm246929650256" class="indexterm"></a><div class="para">
+ This chapter documents how to install SystemTap in the system and explains how to use the <code class="command">stap</code> utility to run SystemTap scripts.
+ </div><div xml:lang="en-US" class="section" lang="en-US"><div class="titlepage"><div><div><h2 class="title"><a id="using-setup"></a>2.1. Installation and Setup</h2></div></div></div><a id="idm246929655488" class="indexterm"></a><a id="idm246929656720" class="indexterm"></a><div class="para">
+ To deploy SystemTap, install the SystemTap packages along with the corresponding set of <span class="package">-devel</span>, <span class="package">-debuginfo</span>, and <span class="package">-debuginfo-common</span> packages for your kernel. If your system has multiple kernels installed and you intend to use SystemTap on more than one of them, also install the <span class="package">-devel</span> and <span class="package">-debuginfo</span> packages for <span class="emphasis"><em>each</em></span> of those kernel versions.
</div><div class="para">
- These procedures will be discussed in detail in the following sections.
- </div><div
class="important"><div class="admonition_header"><h2>Important</h2></div><div class="admonition"><div class="para">
- Many users confuse <code class="filename">-debuginfo</code> with <code class="filename">-debug</code>. Remember that the deployment of SystemTap requires the installation of the <code class="filename">-debuginfo</code> package of the kernel, not the <code class="filename">-debug</code> version of the kernel.
- </div></div></div><div class="section"
id="installproper"><div class="titlepage"><div><div><h3 class="title" id="installproper">2.1.1. Installing SystemTap</h3></div></div></div><div class="para">
- To deploy Systemtap, you will need to to install the following RPMs:
- </div><a id="idm
9247248" class="indexterm"></a><a id="idm9248688" class="indexterm"></a><a id="idm9250144" class="indexterm"></a><a id="idm9251408" class="indexterm"></a><div class="itemizedlist"><ul><li class="listitem"><div class="para">
- <code class="filename">systemtap</code>
+ The following sections discuss the installation procedures in greater detail.
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="important"><div class="admonition_header"><p><strong>Important</strong></p></div><div class="admonition"><div class="para">
+ Many users confuse <span class="package">-debuginfo</span> with <span class="package">-debug</span>. Remember that the deployment of SystemTap requires the installation of the <span class="package">-debuginfo</span> package of the kernel, not the <span class="package">-debug</span> version of the kernel.
+ </div></div></div><div class="section"
><div class="titlepage"><div><div><h3 class="title"><a id="installproper"></a>2.1.1. Installing SystemTap</h3></div></div></div><div class="para">
+ To deploy SystemTap, install the following RPM packages:
+ </div><a id="idm
246929666656" class="indexterm"></a><a id="idm246929668112" class="indexterm"></a><a id="idm246929669216" class="indexterm"></a><a id="idm246929672112" class="indexterm"></a><div xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
+ <span class="package">systemtap</span>
</div></li><li class="listitem"><div class="para">
- <code class="filename">systemtap-runtime</code>
+ <span class="package">systemtap-runtime</span>
</div></li></ul></div><div class="para">
- Assuming that <code class="command">yum</code> is installed in the system, these two rpms can be installed with <code class="command">yum install systemtap systemtap-runtime</code>. Note that before you can use SystemTap, you will still need to install the required kernel information RPMs.
- </div></div><div class="section" id="install-kinfo"><div class="titlepage"><div><div><h3 class="title" id="install-kinfo">2.1.2. Installing Required Kernel Information RPMs</h3></div></div></div><a id="idp44638688" class="indexterm"></a><a id="idp40070800" class="indexterm"></a><a id="idp40069872" class="indexterm"></a><a id="idp40068496" class="indexterm"></a><a id="idp40067568" class="indexterm"></a><a id="idp40065808" class="indexterm"></a><div class="para">
- SystemTap needs information about the kernel in order to place instrumentation in it (i.e. probe it). This information also allows SystemTap to generate the code for the instrumentation. This information is contained in the matching <code class="filename">-devel</code>, <code class="filename">-debuginfo</code>, and <code class="filename">-debuginfo-common</code> packages for your kernel. The necessary <code class="filename">-devel</code> and <code class="filename">-debuginfo</code> packages for the ordinary "vanilla" kernel are as follows:
- </div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
- <code class="filename">kernel-debuginfo</code>
+ To do so, run the following command as root:
+ </div><pre class="screen"><code class="command">yum install systemtap systemtap-runtime</code></pre><div class="para">
+ Note that before using SystemTap, you still need to install the required kernel information packages. On modern systems, run the following command as root to install these packages:
+ </div><pre class="screen"><code class="command">stap-prep</code></pre><div class="para">
+ If this command does not work, try manual installation as described below.
+ </div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="install-kinfo"></a>2.1.2. Installing Required Kernel Information Packages Manually</h3></div></div></div><a id="idm246929678784" class="indexterm"></a><a id="idm246929680208" class="indexterm"></a><a id="idm246929681408" class="indexterm"></a><a id="idm246929682336" class="indexterm"></a><a id="idm246929683312" class="indexterm"></a><a id="idm246929684784" class="indexterm"></a><div class="para">
+ SystemTap needs information about the kernel in order to place instrumentation in it (in other words, probe it). This information also allows SystemTap to generate the code for the instrumentation.
+ </div><div class="para">
+ The required information is contained in the matching <span class="package">-devel</span>, <span class="package">-debuginfo</span>, and <span class="package">-debuginfo-common</span> packages for your kernel. The necessary <span class="package">-devel</span> and <span class="package">-debuginfo</span> packages for the ordinary "vanilla" kernel are as follows:
+ </div><div xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
+ <span class="package">kernel-debuginfo</span>
</div></li><li class="listitem"><div class="para">
- <code class="filename">kernel-debuginfo-common</code>
+ <span class="package">kernel-debuginfo-common</span>
</div></li><li class="listitem"><div class="para">
- <code class="filename">kernel-devel</code>
+ <span class="package">kernel-devel</span>
</div></li></ul></div><div class="para">
- Likewise, the necessary packages for the PAE kernel would be <code class="filename">kernel-PAE-debuginfo</code>, <code class="filename">kernel-PAE-debuginfo-common</code>, and <code class="filename">kernel-PAE-devel</code>.
- </div><a id="id
p44641504" class="indexterm"></a><a id="idp44639616" class="indexterm"></a><a id="idp44638160" class="indexterm"></a><a id="idp60893456" class="indexterm"></a><div class="para">
+ Likewise, the necessary packages for the PAE kernel are <span class="package">kernel-PAE-debuginfo</span>, <span class="package">kernel-PAE-debuginfo-common</span>, and <span class="package">kernel-PAE-devel</span>.
+ </div><a id="id
m246917575152" class="indexterm"></a><a id="idm246917576272" class="indexterm"></a><a id="idm246917577232" class="indexterm"></a><a id="idm246873788864" class="indexterm"></a><div class="para">
To determine what kernel your system is currently using, use:
</div><pre class="screen">uname -r</pre><div class="para">
- For example, if you wish to use SystemTap on kernel version <code class="filename">2.6.18-53.el5</code> on an i686 machine, then you would need to download and install the following RPMs:
- </div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
- <code class="filename">kernel-debuginfo-2.6.18-53.1.13.el5.i686.rpm</code>
+ For example, if you intend to use SystemTap on kernel version <span class="emphasis"><em>2.6.18-53.el5</em></span> on an <span class="emphasis"><em>i686</em></span> machine, download and install the following RPM packages:
+ </div><div
xmlns:d="http://docbook.org/ns/docbook" class="itemizedlist"><ul><li class="listitem"><div class="para">
+ <span class="package">kernel-debuginfo-2.6.18-53.1.13.el5.i686.rpm</span>
</div></li><li class="listitem"><div class="para">
- <code class="filename">kernel-debuginfo-common-2.6.18-53.1.13.el5.i686.rpm</code>
+ <span class="package">kernel-debuginfo-common-2.6.18-53.1.13.el5.i686.rpm</span>
</div></li><li class="listitem"><div class="para">
- <code class="filename">kernel-devel-2.6.18-53.1.13.el5.i686.rpm</code>
- </div></li></ul></div><div
class="important"><div class="admonition_header"><h2>Important</h2></div><div class="admonition"><div class="para">
- The version, variant, and architecture of the <code class="filename">-devel</code>, <code class="filename">-debuginfo</code> and <code class="filename">-debuginfo-common</code> packages must match the kernel you wish to probe with SystemTap <span class="emphasis"><em>exactly</em></span>.
+ <span class="package">kernel-devel-2.6.18-53.1.13.el5.i686.rpm</span>
+ </div></li></ul></div><div
xmlns:d="http://docbook.org/ns/docbook" class="important"><div class="admonition_header"><p><strong>Important</strong></p></div><div class="admonition"><div class="para">
+ The version, variant, and architecture of the <span class="package">-devel</span>, <span class="package">-debuginfo</span> and <span class="package">-debuginfo-common</span> packages must match the kernel you wish to probe with SystemTap <span class="emphasis"><em>exactly</em></span>.
</div></div></div><div class="para">
- The easiest way to install the required kernel information packages is through <code class="command">yum install</code> and <code class="command">debuginfo-install</code> commands. <code class="command">debuginfo-install</code> is included with later versions of the <code class="filename">yum-utils</code> package (for example, version 1.1.10), and also requires an appropriate <code class="command">yum</code> repository from which to download and install <code class="command">-debuginfo</code>/<code class="filename">-debuginfo-common</code> packages. You can install the required <code class="filename">-devel</code>, <code class="filename">-debuginfo</code>, and <code class="filename">-debuginfo-common</code> packages for your kernel.
+ The easiest way to install the required kernel information packages is through <code class="command">yum install</code> and <code class="command">debuginfo-install</code> commands. The <code class="command">debuginfo-install</code> command is included with later versions of the <span class="package">yum-utils</span> package (for example, version 1.1.10) and also requires an appropriate <code class="command">yum</code> repository from which to download and install <span class="package">-debuginfo</span> and <span class="package">-debuginfo-common</span> packages. You can install the required <span class="package">-devel</span>, <span class="package">-debuginfo</span>, and <span class="package">-debuginfo-common</span> packages for your kernel.
</div><div class="para">
- With the appropriate software repositories are enabled, install the corresponding packages for a specific kernel using <code class="command">yum</code> with the following commands:
- </div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
- <code class="command">yum install <em class="replaceable"><code>kernelname</code></em>-devel-<em class="replaceable"><code>version</code></em></code>
- </div></li><li class="listitem"><div class="para">
- <code class="command">debuginfo-install <em class="replaceable"><code>kernelname</code></em>-<em class="replaceable"><code>version</code></em></code>
- </div></li></ul></div><div class="para">
- Replace <code class="command"><em class="replaceable"><code>kernelname</code></em></code> with the appropriate kernel variant name (for example, <code class="filename">kernel-PAE</code>), and <code class="command"><em class="replaceable"><code>version</code></em></code> with the target kernel's version. For example, to install the required kernel information packages for the <code class="command">kernel-PAE-2.6.18-53.1.13.el5</code> kernel, run:
- </div><div class="itemizedlist"><ul><li class="listitem"><div class="para">
- <code class="command">yum install kernel-PAE-devel-2.6.18-53.1.13.el5</code>
- </div></li><li class="listitem"><div class="para">
- <code class="command">debuginfo-install kernel-PAE-2.6.18-53.1.13.el5</code>
- </div></li></ul></div><div class="para">
- Once you have manually downloaded the required packages to the machine, install the RPMs by running <code class="command">rpm --force -ivh <em class="replaceable"><code>package_names</code></em></code>.
- </div></div><div class="section" id="testing"><div class="titlepage"><div><div><h3 class="title" id="testing">2.1.3. Initial Testing</h3></div></div></div><a id="idp20555008" class="indexterm"></a><a id="idp20552896" class="indexterm"></a><a id="idp20551936" class="indexterm"></a><div class="para">
- If you are currently using the kernel you wish to probe with SystemTap, you can immediately test whether the deployment was successful. If not, you will need to reboot and load the appropriate kernel.
+ When the appropriate software repositories are enabled, install the corresponding packages for a specific kernel with the following commands:
+ </div><pre class="screen"><code class="command">yum install <em class="replaceable"><code>kernelname</code></em>-devel-<em class="replaceable"><code>version</code></em></code>
+<code class="command">debuginfo-install <em class="replaceable"><code>kernelname</code></em>-<em class="replaceable"><code>version</code></em></code></pre><div class="para">
+ Replace <em class="replaceable"><code>kernelname</code></em> with the appropriate kernel variant name (for example, <code class="option">kernel-PAE</code>), and <em class="replaceable"><code>version</code></em> with the target kernel's version. For example, to install the required kernel information packages for the <code class="systemitem">kernel-PAE-2.6.18-53.1.13.el5</code> kernel, run:
+ </div><pre class="screen"><code class="command">yum install kernel-PAE-devel-2.6.18-53.1.13.el5</code>
+<code class="command">debuginfo-install kernel-PAE-2.6.18-53.1.13.el5</code></pre><div class="para">
+ Once you have manually downloaded the required packages to the machine, run the following command as root to install them:
+ </div><pre class="screen"><code class="command">rpm --force -ivh <em class="replaceable"><code>package_names</code></em></code></pre></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="testing"></a>2.1.3. Initial Testing</h3></div></div></div><a id="idm246929711104" class="indexterm"></a><a id="idm246875089536" class="indexterm"></a><a id="idm246875090464" class="indexterm"></a><div class="para">
+ If you are currently using the kernel you intend to probe with SystemTap, you can immediately test whether the deployment was successful. If not, you restart the system and load the appropriate kernel.
</div><div class="para">
- To start the test, run the command <code class="command">stap -v -e 'probe vfs.read {printf("read performed\n"); exit()}'</code>. This command simply instructs SystemTap to print <code class="computeroutput">read performed</code> then exit properly once a virtual file system read is detected. If the SystemTap deployment was successful, you should get output similar to the following:
+ To start the test, run the following command:
+ </div><pre class="screen"><code class="command">stap -v -e 'probe vfs.read {printf("read performed\n"); exit()}'</code></pre><div class="para">
+ This command instructs SystemTap to print <code class="computeroutput">read performed</code> and then exit properly once a virtual file system read is detected. If the SystemTap deployment was successful, it prints output similar to the following:
</div><pre class="screen">Pass 1: parsed user script and 45 library script(s) in 340usr/0sys/358real ms.
Pass 2: analyzed script: 1 probe(s), 1 function(s), 0 embed(s), 0 global(s) in 290usr/260sys/568real ms.
Pass 3: translated to C into "/tmp/stapiArgLX/stap_e5886fa50499994e6a87aacdc43cd392_399.c" in 490usr/430sys/938real ms.
Pass 5: starting run.
read performed
Pass 5: run completed in 10usr/40sys/73real ms.</pre><div class="para">
- The last three lines of the output (i.e. beginning with <code class="computeroutput">Pass 5</code>) indicate that SystemTap was able to successfully create the instrumentation to probe the kernel, run the instrumentation, detect the event being probed (in this case, a virtual file system read), and execute a valid handler (print text then close it with no errors).
- </div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="intro-systemtap-vs-others.html"><strong>Prev</strong>1.2. SystemTap Capabilities</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="cross-compiling.html"><strong>Next</strong>2.2. Generating Instrumentation for Other Compute...</a></li></ul></body></html>
+ The last three lines of the output (beginning with <code class="computeroutput">Pass 5</code>) indicate that SystemTap was able to successfully create the instrumentation to probe the kernel, run the instrumentation, detect the event being probed (in this case, a virtual file system read), and execute a valid handler (print text then close it with no errors).
+ </div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="intro-systemtap-limitations.html"><strong>Prev</strong>1.3. Limitations of SystemTap</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="cross-compiling.html"><strong>Next</strong>2.2. Generating Instrumentation for Other Compute...</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>2.3. Running SystemTap Scripts</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="using-systemtap.html" title="Chapter 2. Using SystemTap" /><link rel="prev" href="cross-compiling.html" title="2.2. Generating Instrumentation for Other Computers" /><link rel="next" href="understanding-how-systemtap-works.html" title="Chapter 3. Understanding How SystemTap Works" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="cross-compiling.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="understanding-how-systemtap-works.html"><strong>Next</strong></a></li></ul><div class="section" id="using-usage"><div class="titlepage"><div><div><h2 class="title" id="using-usage">2.3. Running SystemTap Scripts</h2></div></div></div><a id="idp17684480" class="indexterm"></a><a id="idp38841568" class="indexterm"></a><a id="idp48076080" class="indexterm"></a><a id="idp29338288" class="indexterm"></a><a id="idp59482576" class="indexterm"></a><a id="idp21846304" class="indexterm"></a><div class="para">
- SystemTap scripts are run through the command <code class="command">stap</code>. <code class="command">stap</code> can run SystemTap scripts from standard input or from file.
- </div><a id="idp58022880" class="indexterm"></a><div class="para">
- Running <code class="command">stap</code> and <code class="command">staprun</code> requires elevated privileges to the system. However, not all users can be granted root access just to run SystemTap. In some cases, for instance, you may want to allow a non-privileged user to run SystemTap instrumentation on his machine.
- </div><div class="para">
- To allow ordinary users to run SystemTap without root access, add them to one of these user groups:
- </div><div class="variablelist"><dl><dt class="varlistentry"><span class="term">stapdev</span></dt><dd><a id="idp33571040" class="indexterm"></a><a id="idp60451216" class="indexterm"></a><div class="para">
- Members of this group can use <code class="command">stap</code> to run SystemTap scripts, or <code class="command">staprun</code> to run SystemTap instrumentation modules.
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">2.3. Running SystemTap Scripts</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="using-systemtap.html" title="Chapter 2. Using SystemTap" /><link rel="prev" href="cross-compiling.html" title="2.2. Generating Instrumentation for Other Computers" /><link rel="next" href="understanding-how-systemtap-works.html" title="Chapter 3. Understanding How SystemTap Works" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="cross-compiling.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="understanding-how-systemtap-works.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="using-usage"></a>2.3. Running SystemTap Scripts</h2></div></div></div><a id="idm246912074640" class="indexterm"></a><a id="idm246920814672" class="indexterm"></a><a id="idm246920813264" class="indexterm"></a><a id="idm246930144800" class="indexterm"></a><a id="idm246930143072" class="indexterm"></a><a id="idm246911889520" class="indexterm"></a><div class="para">
+ SystemTap is distributed with a number of command line tools that allow you to monitor the activities of the system. The <code class="command">stap</code> command reads probing instructions from a SystemTap script, translates these instructions into C code, builds a kernel module, and loads it into the running Linux kernel. The <code class="command">staprun</code> command runs SystemTap instrumentation, that is, a kernel module built from SystemTap scripts during a cross-instrumentation.
+ </div><a id="idm246868990944" class="indexterm"></a><div class="para">
+ Running <code class="command">stap</code> and <code class="command">staprun</code> requires elevated privileges to the system. Because not all users can be granted root access just to run SystemTap, you can allow a non-privileged user to run SystemTap instrumentation on their machine by adding them to one of the following user groups:
+ </div><div class="variablelist"><dl class="variablelist"><dt><span class="term">stapdev</span></dt><dd><a id="idm246929055488" class="indexterm"></a><a id="idm246917373056" class="indexterm"></a><div class="para">
+ Members of this group can use the <code class="command">stap</code> command to run SystemTap scripts, or <code class="command">staprun</code> to run SystemTap instrumentation modules.
</div><div class="para">
- Running <code class="command">stap</code> involves compiling SystemTap scripts into kernel modules and loading them into the kernel. This requires elevated privileges to the system, which are granted to <code class="command">stapdev</code> members. Unfortunately, such privileges also grant effective root access to <code class="command">stapdev</code> members. As such, you should only grant <code class="command">stapdev</code> group membership to users whom you can trust root access.
- </div></dd><dt
class="varlistentry"><span class="term">stapusr</span></dt><dd><a id="idp29855248" class="indexterm"></a><a id="idm2814432" class="indexterm"></a><div class="para">
- Members of this group can only run <code class="command">staprun</code> to run SystemTap instrumentation modules. In addition, they can only run those modules from <code class="filename">/lib/modules/<em class="replaceable"><code>kernel_version</code></em>/systemtap/</code>. Note that this directory must be owned only by the root user, and must only be writable by the root user.
+ Running the <code class="command">stap</code> command involves compiling SystemTap scripts into kernel modules and loading them into the kernel. This operation requires elevated privileges to the system, which are granted to <code class="systemitem">stapdev</code> members. Unfortunately, such privileges also grant effective root access to <code class="systemitem">stapdev</code> members. As a consequence, only grant <code class="systemitem">stapdev</code> group membership to users whom you can trust with root access.
+ </div></dd><dt
><span class="term">stapusr</span></dt><dd><a id="idm246914415104" class="indexterm"></a><a id="idm246914413664" class="indexterm"></a><div class="para">
+ Members of this group can only use the <code class="command">staprun</code> command to run SystemTap instrumentation modules. In addition, they can only run modules from the <code class="filename">/lib/modules/<em class="replaceable"><code>kernel_version</code></em>/systemtap/</code> directory. Note that this directory must be owned only by the root user, and must only be writable by the root user.
</div></dd></dl></div><div class="para">
+ The <code class="command">stap</code> command reads a SystemTap script either from a file, or from standard input. To tell <code class="command">stap</code> to read a SystemTap script from a file, specify the file name on the command line:
+ </div><pre class="screen"><code class="command">stap <em class="replaceable"><code>file_name</code></em></code></pre><a id="idm246868954640" class="indexterm"></a><a id="idm246868953232" class="indexterm"></a><a id="idm246869058224" class="indexterm"></a><div class="para">
+ To instruct <code class="command">stap</code> to read a SystemTap script from standard input, use the <code class="option">-</code> switch instead of the file name. Note that any command-line options you wish to use must be inserted before the <code class="option">-</code> switch. For example, to make the output of the <code class="command">stap</code> command more verbose, type:
+ </div><pre class="screen"><code class="command">echo "probe timer.s(1) {exit()}" | stap -v -</code></pre><div class="para">
Below is a list of commonly used <code class="command">stap</code> options:
- </div><a id="id
p65181216" class="indexterm"></a><a id="idp30746304" class="indexterm"></a><div class="variablelist"><a id="idp34173936" class="indexterm"></a><dl><dt class="varlistentry"><span class="term">-v</span></dt><dd><div class="para">
- Makes the output of the SystemTap session more verbose. You can repeat this option (for example, <code class="command">stap -vvv script.stp</code>) to provide more details on the script's execution. This option is particularly useful if you encounter any errors in running the script.
- </div><div class="para">
- For more information about common SystemTap script errors, refer to <a class="xref" href="errors.html">Chapter 6, <em>Understanding SystemTap Errors</em></a>.
- </div></dd><dt
class="varlistentry"><span class="term">-o <em class="replaceable"><code>filename</code></em></span></dt><dd><div class="para">
- Sends the standard output to file (<em class="replaceable"><code>filename</code></em>).
- </div></dd><dt
class="varlistentry"><span class="term">-S <em class="replaceable"><code>size</code></em>,<em class="replaceable"><code>count</code></em></span></dt><dd><div class="para">
- Limit files to <em class="replaceable"><code>size</code></em> megabytes and limit the the number of files kept around to <em class="replaceable"><code>count</code></em>. The file names will have a sequence number suffix. This option implements logrotate operations for SystemTap.
- </div></dd><dt
class="varlistentry"><span class="term">-x <em class="replaceable"><code>process ID</code></em></span></dt><dd><div class="para">
- Sets the SystemTap handler function <code class="
command">target()</code> to the specified process ID. For more information about <code class="command">target()</code>, refer to <a class="xref" href="systemtapscript-handler.html#systemtapscript-functions">SystemTap Functions</a>.
- </div></dd><dt
class="varlistentry"><span class="term">-c '<em class="replaceable"><code>command</code></em>'</span></dt><dd><div class="para">
- Sets the SystemTap handler function <code class="
command">target()</code> to the specified command and runs the SystemTap instrumentation for the duration of the specified command. For more information about <code class="command">target()</code>, refer to <a class="xref" href="systemtapscript-handler.html#systemtapscript-functions">SystemTap Functions</a>.
- </div></dd><dt
class="varlistentry"><span class="term">-e '<em class="replaceable"><code>script</code></em>'</span></dt><dd><div class="para">
- Use <code class="command"><em class="replaceable"><code>script</code></em></code> string rather than a file as input for systemtap translator.
- </div></dd><dt
class="varlistentry"><span class="term">-F</span></dt><dd><div class="para">
- Use
SystemTap's Flight recorder mode and make the script a background process. For more information about flight recorder mode, refer to <a class="xref" href="using-usage.html#flight-recorder">Section 2.3.1, “SystemTap Flight Recorder Mode”</a>.
+ </div><a id="id
m246930039392" class="indexterm"></a><a id="idm246930037952" class="indexterm"></a><div class="variablelist"><a id="idm246930036192" class="indexterm"></a><dl class="variablelist"><dt><span class="term">-v</span></dt><dd><div class="para">
+ Makes the output of the SystemTap session more verbose. You can repeat this option multiple times to provide more details on the script's execution, for example:
+ </div><pre class="screen"><code class="command">stap -vvv script.stp</code></pre><div class="para">
+
This option is particularly useful if you encounter any errors in running the script. For more information about common SystemTap script errors, refer to <a class="xref" href="errors.html">Chapter 6, <em>Understanding SystemTap Errors</em></a>.
+ </div></dd><dt
><span class="term">-o <em class="replaceable"><code>file_name</code></em></span></dt><dd><div class="para">
+ Sends the standard output to a file named <em class="replaceable"><code>file_name</code></em>.
+ </div></dd><dt><span class="term">-S <em class="replaceable"><code>size</code></em>,<em class="replaceable"><code>count</code></em></span></dt><dd><div class="para">
+ Limits the maximum size of output files to <em class="replaceable"><code>size</code></em> megabytes and the maximum number of stored files to <em class="replaceable"><code>count</code></em>. This option implements logrotate operations for SystemTap and the resulting file names have a sequence number suffix.
+ </div></dd><dt
><span class="term">-x <em class="replaceable"><code>process_id</code></em></span></dt><dd><div class="para">
+ Sets the SystemTap handler function <code class="
function">target()</code> to the specified process ID. For more information about <code class="function">target()</code>, refer to <a class="xref" href="systemtapscript-handler.html#systemtapscript-functions">SystemTap Functions</a>.
+ </div></dd><dt><span class="term">-c '<em class="replaceable"><code>command</code></em>'</span></dt><dd><div class="para">
+ Sets the SystemTap handler function <code class="
function">target()</code> to the specified command and runs the SystemTap instrumentation for the duration of this command. For more information about <code class="function">target()</code>, refer to <a class="xref" href="systemtapscript-handler.html#systemtapscript-functions">SystemTap Functions</a>.
+ </div></dd><dt><span class="term">-e '<em class="replaceable"><code>script</code></em>'</span></dt><dd><div class="para">
+ Uses <em class="replaceable"><code>script</code></em> rather than a file as input for the SystemTap translator.
+ </div></dd><dt><span class="term">-F</span></dt><dd><div class="para">
+ Use
s SystemTap's flight recorder mode and makes the script a background process. For more information about flight recorder mode, refer to <a class="xref" href="using-usage.html#flight-recorder">Section 2.3.1, “SystemTap Flight Recorder Mode”</a>.
</div></dd></dl></div><div class="para">
- You can also instruct <code class="command">stap</code> to run scripts from standard input using the switch <code class="command">-</code>. To illustrate:
- </div><a id="idm1473856" class="indexterm"></a><a id="idp29335440" class="indexterm"></a><a id="idp29336848" class="indexterm"></a><div class="example" id="stdinstap"><h6>Example 2.1. Running Scripts From Standard Input</h6><div class="example-contents"><pre class="programlisting">echo "probe timer.s(1) {exit()}" | stap -</pre></div></div><br class="example-break" /><div class="para">
- <a class="xref" href="using-usage.html#stdinstap">Example 2.1, “Running Scripts From Standard Input”</a> instructs <code class="command">stap</code> to run the script passed by <code class="command">echo</code> to standard input. Any <code class="command">stap</code> options you wish to use should be inserted before the <code class="command">-</code> switch; for instance, to make the example in <a class="xref" href="using-usage.html#stdinstap">Example 2.1, “Running Scripts From Standard Input”</a> more verbose, the command would be:
- </div><div class="para">
- <code class="command">echo "probe timer.s(1) {exit()}" | stap -v -</code>
- </div><div class="para">
- For more information about <code class="command">stap</code>, refer to <code class="command">man stap</code>.
- </div><div class="para">
- To run SystemTap instrumentation (i.e. the kernel module built from SystemTap scripts during a cross-instrumentation), use <code class="command">staprun</code> instead. For more information about <code class="command">staprun</code> and cross-instrumentation, refer to <a class="xref" href="cross-compiling.html">Section 2.2, “Generating Instrumentation for Other Computers”</a>.
- </div><div class="note"><div class="admonition_header"><h2>Note</h2></div><div class="admonition"><div class="para">
- The <code class="command">stap</code> options <code class="command">-v</code> and <code class="command">-o</code> also work for <code class="command">staprun</code>. For more information about <code class="command">staprun</code>, refer to <code class="command">man staprun</code>.
- </div></div></div><div class="section" id="flight-recorder"><div class="titlepage"><div><div><h3 class="title" id="flight-recorder">2.3.1. SystemTap Flight Recorder Mode</h3></div></div></div><a id="idp49319056" class="indexterm"></a><div class="para">
- SystemTap's flight recorder mode allows you to run a SystemTap script run for long periods and just focus on recent output. The flight recorder mode (the <code class="command">-F</code> option) limits the amount of output generated. There are two variations of the flight recorder mode: in-memory and file mode. In both cases the SystemTap script runs as a background process.
- </div><div class="section" id="memory-flight-recorder"><div class="titlepage"><div><div><h4 class="title" id="memory-flight-recorder">2.3.1.1. In-memory Flight Recorder</h4></div></div></div><a id="idp44387136" class="indexterm"></a><div class="para">
- When flight recorder mode (the <code class="command">-F</code> option) is used without a file name SystemTap uses a buffer in kernel memory to store the output of the script. The SystemTap instrumentation module will load and the probes start running, the instrumentation will then detach and be put in the background. When the interesting event occurs, you can reattach to the instrumentation and see the recent output in the memory buffer and any continuing output. The following command starts a script using the flight recorder in-memory mode:
- </div><pre class="screen">stap -F iotime.stp</pre><div class="para">
- Once the script starts, you will see a message like the following that provides the command to reconnect to the running script:
+ For more information about the <code class="command">stap</code> command, refer to the <span class="citerefentry"><span class="refentrytitle">stap</span>(1)</span> man page. For more information about the <code class="command">staprun</code> command and cross-instrumentation, refer to <a class="xref" href="cross-compiling.html">Section 2.2, “Generating Instrumentation for Other Computers”</a> or the <span class="citerefentry"><span class="refentrytitle">staprun</span>(8)</span> man page.
+ </div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="flight-recorder"></a>2.3.1. SystemTap Flight Recorder Mode</h3></div></div></div><a id="idm246924510816" class="indexterm"></a><div class="para">
+ SystemTap's flight recorder mode allows you to run a SystemTap script for long periods of time and just focus on recent output. The flight recorder mode limits the amount of output generated.
+ </div><div class="para">
+ There are two variations of the flight recorder mode: <em class="firstterm">in-memory</em> and <em class="firstterm">file</em> mode. In both cases, the SystemTap script runs as a background process.
+ </div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="memory-flight-recorder"></a>2.3.1.1. In-memory Flight Recorder</h4></div></div></div><a id="idm246917220944" class="indexterm"></a><div class="para">
+ When flight recorder mode is used without a file name, SystemTap uses a buffer in kernel memory to store the output of the script. Once the SystemTap instrumentation module is loaded and the probes start running, the instrumentation detaches and is put in the background. When the interesting event occurs, you can reattach to the instrumentation to see the recent output in the memory buffer and any continuing output.
+ </div><div class="para">
+ To run a SystemTap script by using the flight recorder in-memory mode, run the <code class="command">stap</code> command with the <code class="option">-F</code> command line option:
+ </div><pre class="screen"><code class="command">stap -F iotime.stp</code></pre><div class="para">
+ Once the script starts, <code class="command">stap</code> prints a message similar to the following to provide you with the command to reconnect to the running script:
</div><pre class="screen">Disconnecting from systemtap module.
To reconnect, type "staprun -A stap_5dd0073edcb1f13f7565d8c343063e68_19556"</pre><div class="para">
- When the interesting event occurs, you reattach to the currently running script and output the recent data in the memory buffer and get continuing output with the following command:
- </div><pre class="screen">staprun -A stap_5dd0073edcb1f13f7565d8c343063e68_19556</pre><div class="para">
- By default the kernel buffer is 1MB in size and it can be increased with the <code class="command">-s</code> option specifying the size in megabytes (rounded up to the next power over 2) for the buffer. For example <code class="command">-s2</code> on the SystemTap command line would specify 2MB for the buffer.
- </div></div><div class="section" id="file-flight-recorder"><div class="titlepage"><div><div><h4 class="title" id="file-flight-recorder">2.3.1.2. File Flight Recorder</h4></div></div></div><a id="idp15398048" class="indexterm"></a><div class="para">
- The flight recorder mode can also store data to files. The number and size of the files kept is controlled by the <code class="command">-S</code> option followed by two numerical arguments separated by a comma. The first argument is the maximum size in megabytes for the each output file. The second argument is the number of recent files to keep. The file name is specified by the <code class="command">-o</code> option followed by the name. SystemTap will add a number suffix to the file name to indicate the order of the files. The following will start SystemTap in file flight recorder mode with the output going to files named <code class="command">/tmp/iotime.log.</code><em class="replaceable"><code>[0-9]+</code></em> and each file 1MB or smaller and keeping latest two files:
- </div><pre class="screen">stap -F -o /tmp/pfaults.log -S 1,2 pfaults.stp</pre><div class="para">
- The number printed by the command is the process ID. Sending a SIGTERM to the process will shutdown the SystemTap script and stop the data collection. For example if the previous command listed the 7590 as the process ID, the following command whould shutdown the systemtap script:
- </div><pre class="screen">kill -s SIGTERM 7590</pre><div class="para">
- Only the most recent two file generated by the script are kept and the older files are been removed. Thus, <code class="command">ls -sh /tmp/pfaults.log.*</code> shows the only two files:
+ When the interesting event occurs, run the following command to connect to the currently running script, output the recent data in the memory buffer, and get continuing output:
+ </div><pre class="screen"><code class="command">staprun -A stap_5dd0073edcb1f13f7565d8c343063e68_19556</code></pre><div class="para">
+ By default, the kernel buffer is 1MB in size. You can increase this value by using the <code class="option">-s</code> option with the size in megabytes (rounded up to the next power over 2) for the buffer. For example, <code class="option">-s2</code> on the SystemTap command line would specify 2MB for the buffer.
+ </div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a id="file-flight-recorder"></a>2.3.1.2. File Flight Recorder</h4></div></div></div><a id="idm246917260768" class="indexterm"></a><div class="para">
+ The flight recorder mode can also store data to files. You can control the number and size of the files kept by using the <code class="option">-S</code> option followed by two numerical arguments separated by a comma: the first argument is the maximum size in megabytes for the each output file, the second argument is the number of recent files to keep. To specify the file name, use the <code class="option">-o</code> option followed by the name. SystemTap automatically adds a number suffix to the file name to indicate the order of the files.
+ </div><div class="para">
+ The following command starts SystemTap in file flight recorder mode with the output going to files named <code class="filename">/tmp/iotime.log.<em class="replaceable"><code>[0-9]+</code></em></code>, each file 1MB or smaller, and keeping latest two files:
+ </div><pre class="screen"><code class="command">stap -F -o /tmp/pfaults.log -S 1,2 pfaults.stp</code></pre><div class="para">
+ The command prints the process ID to standard output. Sending a SIGTERM to the process terminates the SystemTap script and stops the data collection. For example, if the previous command listed 7590 as the process ID, the following command would stop the SystemTap script:
+ </div><pre class="screen"><code class="command">kill -s SIGTERM 7590</code></pre><div class="para">
+ In this example, only the most recent two files generated by the script are kept: SystemTap automatically removes older files. As a result, the <code class="command">ls -sh /tmp/pfaults.log.*</code> command lists two files:
</div><pre class="screen">1020K /tmp/pfaults.log.5 44K /tmp/pfaults.log.6</pre><div class="para">
- One can look at the highest number file for the latest data, in this case /tmp/pfaults.log.6.
- </div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="cross-compiling.html"><strong>Prev</strong>2.2. Generating Instrumentation for Other Compute...</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="understanding-how-systemtap-works.html"><strong>Next</strong>Chapter 3. Understanding How SystemTap Works</a></li></ul></body></html>
+ To examine the latest data, read the file with the highest number, in this case <code class="filename">/tmp/pfaults.log.6</code>.
+ </div></div></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="cross-compiling.html"><strong>Prev</strong>2.2. Generating Instrumentation for Other Compute...</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="understanding-how-systemtap-works.html"><strong>Next</strong>Chapter 3. Understanding How SystemTap Works</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>4.3. User-Space Stack Backtraces</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="userspace-probing.html" title="Chapter 4. User-Space Probing" /><link rel="prev" href="utargetvariable.html" title="4.2. Accessing User-Space Target Variables" /><link rel="next" href="useful-systemtap-scripts.html" title="Chapter 5. Useful SystemTap Scripts" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="utargetvariable.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="useful-systemtap-scripts.html"><strong>Next</strong></a></li></ul><div class="section" id="ustack"><div class="titlepage"><div><div><h2 class="title" id="ustack">4.3. User-Space Stack Backtraces</h2></div></div></div><a id="idp37539008" class="indexterm"></a><div class="para">
- The probe point (<code class="command">pp</code>) function indicates which particular event triggered the the SystemTap event handler. A probe on the entry into a function would list the function name. However, in many cases the same probe point event may be triggered by many different modules in the program; this is particularly true for functions in shared libraries. A SystemTap backtrace of the user-space stack can provide additional context on how the probe point event is triggered.
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">4.3. User-Space Stack Backtraces</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="userspace-probing.html" title="Chapter 4. User-space Probing" /><link rel="prev" href="utargetvariable.html" title="4.2. Accessing User-Space Target Variables" /><link rel="next" href="useful-systemtap-scripts.html" title="Chapter 5. Useful SystemTap Scripts" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="utargetvariable.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="useful-systemtap-scripts.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="ustack"></a>4.3. User-Space Stack Backtraces</h2></div></div></div><a id="idm246925817024" class="indexterm"></a><div class="para">
+ The probe point (<code class="function">pp</code>) function indicates which particular event triggered the SystemTap event handler. A probe on the entry into a function would list the function name. However, in many cases the same probe point event may be triggered by many different modules in the program; this is particularly true for functions in shared libraries. A SystemTap backtrace of the user-space stack can provide additional context on how the probe point event is triggered.
</div><div class="para">
- The user-space stack backtrace generation is complicated by the compiler producing code optimized to eliminate stack frame pointers. However, the compiler also includes information in the debug information section to allow debugging tools to produce stack backtraces. SystemTap user-space stack backtrace mechanism makes use of that debug information to walk the stack to generate stack traces for 32-bit and 64-bit x86 processors; other processor architectures do not yet support the use of debug information to unwind the user-space stack. You will need to use the <code class="command">-d <em class="replaceable"><code>executable</code></em></code> for the application executable and <code class="command">-ldd</code> for shared libraries to ensure that the needed debug information is used to produce the user-space stack backtraces.
+ The user-space stack backtrace generation is complicated by the compiler producing code optimized to eliminate stack frame pointers. However, the compiler also includes information in the debug information section to allow debugging tools to produce stack backtraces. SystemTap user-space stack backtrace mechanism makes use of that debug information to walk the stack to generate stack traces for 32-bit and 64-bit x86 processors; other processor architectures do not yet support the use of debug information to unwind the user-space stack. To ensure that the needed debug information is used to produce the user-space stack backtraces, use the <code class="option">-d <em class="replaceable"><code>executable</code></em></code> option for executables and <code class="option">-ldd</code> for shared libraries.
</div><div class="para">
- If you want to see how the function <code class="command">xmalloc</code> function is being called by the command <code class="command">ls</code>, you could use the user-space backtrack functions to provide that information. With the debuginfo for the <code class="command">ls</code> command installed the following SystemTap command will provide a backtrace each time the <code class="command">xmalloc</code> function is called:
- </div><pre class="screen">stap -d /bin/ls --ldd \
--e 'probe process("ls").function("xmalloc") {print_usyms(ubacktrace())}' \
-
-c "ls /"</pre><div class="para">
- When the SystemTap script runs will have output similar to the following:
+ For example, you can use the user-space backtrack functions to see how the <code class="function">xmalloc</code> function is being called by the <code class="command">ls</code> command. With the debuginfo for the <code class="command">ls</code> command installed, the following SystemTap command provides a backtrace each time the <code class="function">xmalloc</code> function is called:
+ </div><pre class="screen"><code class="command">stap -d /bin/ls --ldd \</code>
+<code class="command">-e 'probe process("ls").function("xmalloc") {print_usyms(ubacktrace())}' \</code>
+
<code class="command">-c "ls /"</code></pre><div class="para">
+ When executed, this command produces output similar to the following:
</div><pre class="screen">
bin dev lib media net proc sbin sys var
boot etc lib64 misc op_session profilerc selinux tmp
0x3fa441ec5d : __libc_start_main+0xfd/0x1d0 [/lib64/libc-2.12.so]
...
</pre><div class="para">
- For more details on the functions available for user-space stack backtraces look at the <code class="command">ucontext-symbols.stp</code> and <code class="command">ucontext-unwind.stp</code> tapsets. The descriptions of the functions in those tapsets can also be found in the <em class="citetitle">SystemTap Tapset Reference Manual</em>.
- </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="utargetvariable.html"><strong>Prev</strong>4.2. Accessing User-Space Target Variables</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="useful-systemtap-scripts.html"><strong>Next</strong>Chapter 5. Useful SystemTap Scripts</a></li></ul></body></html>
+ For more details on the functions available for user-space stack backtraces, refer to <code class="filename">ucontext-symbols.stp</code> and <code class="filename">ucontext-unwind.stp</code> tapsets. You can also find the description of the functions in the aforementioned tapsets in the <em class="citetitle">SystemTap Tapset Reference Manual</em>.
+ </div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="utargetvariable.html"><strong>Prev</strong>4.2. Accessing User-Space Target Variables</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="useful-systemtap-scripts.html"><strong>Next</strong>Chapter 5. Useful SystemTap Scripts</a></li></ul></body></html>
\ No newline at end of file
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>4.2. Accessing User-Space Target Variables</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta name="generator" content="publican 2.8" /><meta name="package" content="Systemtap-SystemTap_Beginners_Guide-2.2-en-US-2.2-2" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="userspace-probing.html" title="Chapter 4. User-Space Probing" /><link rel="prev" href="userspace-probing.html" title="Chapter 4. User-Space Probing" /><link rel="next" href="ustack.html" title="4.3. User-Space Stack Backtraces" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_left.png" alt="Product Site" /></a><a class="right" href="https://fedorahosted.org/publican"><img src="Common_Content/images/image_right.png" alt="Documentation Site" /></a></p><ul class="docnav"><li class="previous"><a accesskey="p" href="userspace-probing.html"><strong>Prev</strong></a></li><li class="next"><a accesskey="n" href="ustack.html"><strong>Next</strong></a></li></ul><div class="section" id="utargetvariable"><div class="titlepage"><div><div><h2 class="title" id="utargetvariable">4.2. Accessing User-Space Target Variables</h2></div></div></div><a id="idp25071904" class="indexterm"></a><div class="para">
- User-space target variables can be accessed in the same manner as described in <a class="xref" href="targetvariables.html">Section 3.3.2, “Target Variables”</a>. However, in Linux there are separate address spaces for the user and kernel code. When using "->" operator SystemTap will access the appropriate address space. For pointers to base types such as integers and strings there are a number of functions listed below to access user-space data. The first argument for each functions is the pointer to the data item.
- </div><div class="variablelist"><dl><dt class="varlistentry"><span class="term">user_char(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
- Obtain the character at <em class="replaceable"><code>address</code></em> for the current user process.
- </div></dd><dt class="varlistentry"><span class="term">user_short(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
- Obtain the short at <em class="replaceable"><code>address</code></em> for the current user process.
- </div></dd><dt class="varlistentry"><span class="term">user_int(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
- Obtain the int at <em class="replaceable"><code>address</code></em> for the current user process.
- </div></dd><dt class="varlistentry"><span class="term">user_long(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
- Obtain the long at <em class="replaceable"><code>address</code></em> for the current user process.
- </div></dd><dt class="varlistentry"><span class="term">user_string(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
- Obtain the string at <em class="replaceable"><code>address</code></em> for the current user process.
- </div></dd><dt class="varlistentry"><span class="term">user_string_n(<em class="replaceable"><code>address</code></em>, <em class="replaceable"><code>n</code></em>)</span></dt><dd><div class="para">
- Obtain the string at <em class="replaceable"><code>address</code></em> for the current user process and limits the string to <em class="replaceable"><code>n</code></em> bytes.
- </div></dd></dl></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="userspace-probing.html"><strong>Prev</strong>Chapter 4. User-Space Probing</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="ustack.html"><strong>Next</strong>4.3. User-Space Stack Backtraces</a></li></ul></body></html>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title xmlns:d="http://docbook.org/ns/docbook">4.2. Accessing User-Space Target Variables</title><link rel="stylesheet" type="text/css" href="Common_Content/css/default.css" /><link rel="stylesheet" media="print" href="Common_Content/css/print.css" type="text/css" /><meta xmlns:d="http://docbook.org/ns/docbook" name="generator" content="publican v4.0.0" /><meta xmlns:d="http://docbook.org/ns/docbook" name="package" content="SystemTap-SystemTap_Beginners_Guide-2.6-en-US-2.0-1" /><link rel="home" href="index.html" title="SystemTap Beginners Guide" /><link rel="up" href="userspace-probing.html" title="Chapter 4. User-space Probing" /><link rel="prev" href="userspace-probing.html" title="Chapter 4. User-space Probing" /><link rel="next" href="ustack.html" title="4.3. User-Space Stack Backtraces" /></head><body><p id="title"><a class="left" href="https://fedorahosted.org/publican"><img alt="Product Site" src="Common_Content/images//image_left.png" /></a><a class="right" href="https://fedorahosted.org/publican"><img alt="Documentation Site" src="Common_Content/images//image_right.png" /></a></p><ul class="docnav top"><li class="previous"><a accesskey="p" href="userspace-probing.html"><strong>Prev</strong></a></li><li class="home">SystemTap Beginners Guide</li><li class="next"><a accesskey="n" href="ustack.html"><strong>Next</strong></a></li></ul><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="utargetvariable"></a>4.2. Accessing User-Space Target Variables</h2></div></div></div><a id="idm246878454816" class="indexterm"></a><div class="para">
+ You can access user-space target variables in the same manner as described in <a class="xref" href="targetvariables.html">Section 3.3.2, “Target Variables”</a>. In Linux, however, there are separate address spaces for the user and kernel code. When using the <code class="literal">-></code> operator, SystemTap accesses the appropriate address space.
+ </div><div class="para">
+ For pointers to base types such as integers and strings, there are a number of functions listed below to access user-space data. The first argument for each functions is the pointer to the data item.
+ </div><div class="variablelist"><dl class="variablelist"><dt><span class="term">user_char(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
+ Obtains the character at <em class="replaceable"><code>address</code></em> for the current user process.
+ </div></dd><dt><span class="term">user_short(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
+ Obtains the short integer at <em class="replaceable"><code>address</code></em> for the current user process.
+ </div></dd><dt><span class="term">user_int(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
+ Obtains the integer at <em class="replaceable"><code>address</code></em> for the current user process.
+ </div></dd><dt><span class="term">user_long(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
+ Obtains the long integer at <em class="replaceable"><code>address</code></em> for the current user process.
+ </div></dd><dt><span class="term">user_string(<em class="replaceable"><code>address</code></em>)</span></dt><dd><div class="para">
+ Obtains the string at <em class="replaceable"><code>address</code></em> for the current user process.
+ </div></dd><dt><span class="term">user_string_n(<em class="replaceable"><code>address</code></em>, <em class="replaceable"><code>n</code></em>)</span></dt><dd><div class="para">
+ Obtains the string at <em class="replaceable"><code>address</code></em> for the current user process and limits the string to <em class="replaceable"><code>n</code></em> bytes.
+ </div></dd></dl></div></div><ul class="docnav"><li class="previous"><a accesskey="p" href="userspace-probing.html"><strong>Prev</strong>Chapter 4. User-space Probing</a></li><li class="up"><a accesskey="u" href="#"><strong>Up</strong></a></li><li class="home"><a accesskey="h" href="index.html"><strong>Home</strong></a></li><li class="next"><a accesskey="n" href="ustack.html"><strong>Next</strong>4.3. User-Space Stack Backtraces</a></li></ul></body></html>
\ No newline at end of file
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of DTRACE</TITLE>
-</HEAD><BODY>
-<H1>DTRACE</H1>
-Section: User Commands (1)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-dtrace - Dtrace compatibile user application static probe generation tool.
-<P>
-
-
-
-
-<P>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<BR>
-
-<B>dtrace -s </B><I>file</I> [<B>OPTIONS</B>]
-
-<P>
-<A NAME="lbAD"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-The dtrace command converts probe descriptions defined in <I>file.d</I>
-into a probe header
-file via the <B>-h</B> option
-or a probe description file via the <B>-G</B> option.
-<P>
-<A NAME="lbAE"> </A>
-<H2>OPTIONS</H2>
-
-<P>
-
-<DL COMPACT>
-<DT><B>-h</B>
-
-<DD>
-generate a systemtap header file.
-<P>
-<DT><B>-G</B>
-
-<DD>
-generate a systemtap probe definition object file.
-<P>
-<DT><B>-o </B><I>file</I>
-
-<DD>
-is the name of the output file. If the <B>-G</B> option is given then
-the output file will be called <I>file.o</I>; if the <B>-h</B> option is
-given then the output file will be called <I>file.h</I>.
-<P>
-<DT><B>-C</B>
-
-<DD>
-run the cpp preprocessor on the input file when the <B>-h</B> option
-is given.
-<P>
-<DT><B>-I </B><I>file</I>
-
-<DD>
-give this include path to cpp when the <B>-C</B> option is given.
-<P>
-<DT><B>-k</B>
-
-<DD>
-keep temporary files, for example the C language source for the
-<B>-G</B> option.
-<P>
-<DT><B>--types</B>
-
-<DD>
-generate probe argument typedef information when the <B>-h</B>
-option is given.
-<P>
-</DL>
-<A NAME="lbAF"> </A>
-<H2>EXAMPLES</H2>
-
-<P>
-Systemtap is source compatible with dtrace user application static
-probe support.
-Given a file <I>test.d</I> containing:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-provider sdt_probes
-{
- probe test_0 (int type);
- probe test_1 (struct astruct node);
-};
-struct astruct {int a; int b;};
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-Then the command <I>"dtrace -s test.d -G"</I> will create the
-probe definition file <I>test.o</I> and the command <I>"dtrace -stest.d -h"</I> will create the probe header file <I>test.h</I>
-Subsequently the application can use the generated macros this way:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-#include "test.h"
- ...
-struct astruct s;
- ...
-SDT_PROBES_TEST_0(value);
- ...
-if (SDT_PROBES_TEST_1_ENABLED())
- SDT_PROBES_TEST_1(expensive_function(s));
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<A NAME="lbAG"> </A>
-<H2>SEMAPHORES</H2>
-
-<P>
-Semaphores are flag variables used by probes as a way of bypassing
-potentially costly processing to prepare arguments for probes that may
-not even be active. They are automatically set/cleared by systemtap
-when a relevant script is running, so the argument setup cost is only
-paid when necessary. These semaphore variables are defined within the
-the <I>"test.o"</I> object file, which must therefore be linked into an
-application.
-<P>
-
-Sometimes, semaphore variables are not necessary nor helpful. Skipping
-them can simplfy the build process, by omitting the extra <I>"test.o"</I>
-file. To skip dependence upon semaphore variables, include <I>"<<A HREF="file:///usr/include/sys/sdt.h">sys/sdt.h</A>>"</I>
-within the application before <I>"test.h"</I>:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-#include <<A HREF="file:///usr/include/sys/sdt.h">sys/sdt.h</A>>
-#include "test.h"
- ...
-struct astruct s;
- ...
-SDT_PROBES_TEST_0(value);
- ...
-if (SDT_PROBES_TEST_1_ENABLED())
- SDT_PROBES_TEST_1(cheap_function(s));
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-In this mode, the ENABLED() test is fixed at 1.
-<P>
-<A NAME="lbAH"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I><A HREF="stappaths.7.html">stappaths</A></I>(7)
-
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAE">OPTIONS</A><DD>
-<DT><A HREF="#lbAF">EXAMPLES</A><DD>
-<DT><A HREF="#lbAG">SEMAPHORES</A><DD>
-<DT><A HREF="#lbAH">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:25 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of ERROR::BUILDID</TITLE>
-</HEAD><BODY>
-<H1>ERROR::BUILDID</H1>
-Section: Misc. Reference Manual Pages (7stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-error::buildid - build-id verification failures
-<P>
-
-
-
-<P>
-<P>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-Because systemtap's script translation / execution stages may be
-executed at different times and places, it is sometimes necessary to
-verify certain invariants. One such invariant is that if a script
-was informed by translate-time analysis of executables, then those
-same executables need to be used at run time. This checking
-is done based upon the build-id, a binary hash that modern (post-2007)
-compilers/toolchains add as an
-<I>NT_GNU_BUILD_ID</I>
-
-ELF note to object files and executables.
-Use the
-<I>readelf -n</I>
-
-command to examine the build-ids of binaries, if you are interested.
-<P>
-<P>
-
-<P>
-Only scripts are sensitive to executables' build-ids: generally those
-that perform deep analysis of the binaries or their debuginfo. For example,
-scripts that place
-<I>.function</I> or <I>.statement</I>
-
-probes, or use stack backtrace-related tapset functions may be sensitive.
-Other scripts that rely only on
-<I>process.mark</I> or <I>kernel.trace</I>
-
-probes do not require debuginfo. See the DWARF DEBUGINFO section in the
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-man page.
-<P>
-<P>
-
-<P>
-During translation, systemtap saves a copy of the relevant files'
-build-ids within the compiled modules. At run-time, the modules
-compare the saved ones to the actual run-time build-ids in memory.
-The error message indicates that they did not match, so the module
-will decline placing a probe that was computed based upon obsolete
-data. This is important for safety, as placing them at an
-inappropriate address could crash the programs. However, this is not
-necessarily a fatal error, since probes unrelated to the mismatching
-binaries may operate.
-<P>
-<P>
-
-<P>
-A build-id mismatch could be caused by a few different situations.
-The main one is where the executable versions or architecture were
-different between the systemtap translation and execution
-times/places. For example, one may run a stap-server on a slightly
-different version of the OS distribution. Someone may have rebuilt a
-new kernel image, but preserved the previous version numbers. The
-kernel running on the workstation may be slightly different from the
-version being targeted - perhaps due to a pending kernel upgrade
-leaving different files on disk versus running in memory. If your OS
-distribution uses separate debuginfo packages, the split <I>.debug</I>
-files may not exactly match the main binaries.
-<P>
-<P>
-
-<P>
-To disable build-id verification errors, if one is confident that they
-are an artefact of build accidents rather than a real mismatch, one
-might try the
-<I>-DSTP_NO_BUILDID_CHECK</I>
-
-option.
-<P>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="http://fedoraproject.org/wiki/Releases/FeatureBuildId">http://fedoraproject.org/wiki/Releases/FeatureBuildId</A></I>,
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap),
-<I><A HREF="./warning::debuginfo.7stap.html">warning::debuginfo</A></I>(7stap),
-<I><A HREF="./error::reporting.7stap.html">error::reporting</A></I>(7stap)
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of ERROR::DWARF</TITLE>
-</HEAD><BODY>
-<H1>ERROR::DWARF</H1>
-Section: Misc. Reference Manual Pages (7stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-error::dwarf - dwarf debuginfo quality problems
-<P>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-Systemtap sometimes relies on ELF/DWARF debuginfo for programs being
-instrumented to locate places to probe, or context variables to
-read/write, just like a symbolic debugger does. Even though
-examination of the program's source code may show variables or lines
-where probes may be desired, the compiler must preserve information
-about them for systemtap (or a debugger such as gdb) to get pinpoint
-access to the desired information. If a script requires such data,
-but the compiler did not preserve enough of it, pass-2 errors may
-result.
-<P>
-
-Common conditions that trigger these problems include;
-<P>
-<DL COMPACT>
-<DT>compiler version<DD>
-Prior to GCC version 4.5, debuginfo quality was fairly limited.
-Often developers were advised to build their programs with
-<I>-O0 -g</I>
-
-flags to disable optimization. GCC version 4.5 introduced
-a facility called "variable-tracking assignments" that allows it
-to generate high-quality debuginfo under full
-<I>-O2 -g</I>
-
-optimization. It is not perfect, but much better than before.
-Note that, due to another gcc bug (PR51358)
-<I>-O0 -g</I>
-
-can actually sometimes make debuginfo quality worse than for
-<I>-O2 -g</I>.
-
-<P>
-<DT>function inlining<DD>
-Even modern gcc sometimes has problems with parameters for inlined functions.
-It may be necessary to change the script to probe at a slightly different place
-(try a
-<I>.statement()</I> probe, instead of a <I>.function()</I> probe,
-
-somewhere a few source lines into the body of the inlined function. Or try
-putting a probe at the call site of the inlined function. Or use the
-<I>if @defined($var) { ... }</I>
-
-script language construct to test for the resolvability of the context
-variable before using it.
-<P>
-<DT>instruction reordering<DD>
-Heavily optimized code often smears the instructions from
-multiple source statements together. This can leave systemtap with no place
-to choose to place a probe, especially a statement probe specified by line
-number. Systemtap may advise to try a nearby line number, but these may
-not work well either. Consider placing a probe by a statement wildcard
-or line number range.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>ALTERNATIVES</H2>
-
-<P>
-In order to reduce reliance on ELF/DWARF debuginfo, consider the use of
-statically compiled-in instrumentation, such as kernel tracepoints, or
-<I><<A HREF="file:///usr/include/sys/sdt.h">sys/sdt.h</A>></I>
-
-userspace markers. Such instrumentation hook sites are relatively low
-cost (just one NOP instruction for sdt.h), and nearly guarantee the
-availability of parameter data and a reliable probe site,
-all without reliance on debuginfo.
-<P>
-<A NAME="lbAE"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I><A HREF="http://dwarfstd.org/">http://dwarfstd.org/</A></I>,
-<I><A HREF="http://sourceware.org/systemtap/wiki/TipContextVariables">http://sourceware.org/systemtap/wiki/TipContextVariables</A></I>,
-<I><A HREF="http://gcc.gnu.org/wiki/Var_Tracking_Assignments">http://gcc.gnu.org/wiki/Var_Tracking_Assignments</A></I>,
-<I><A HREF="./warning::debuginfo.7stap.html">warning::debuginfo</A></I>(7stap),
-<I><A HREF="./error::reporting.7stap.html">error::reporting</A></I>(7stap)
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">ALTERNATIVES</A><DD>
-<DT><A HREF="#lbAE">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of ERROR::FAULT</TITLE>
-</HEAD><BODY>
-<H1>ERROR::FAULT</H1>
-Section: Misc. Reference Manual Pages (7stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-error::fault - memory access faults
-<P>
-
-
-
-<P>
-<P>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-Read or write faults can occur during the operation of a systemtap
-script, if the script causes dereferencing of a pointer that turns out
-to be invalid. This can be caused by using context variables that do
-not happen to have valid values, or perhaps references to memory that
-is unavailable at that moment due to paging.
-<P>
-
-These fault conditions are benign because they are caught by the
-systemtap runtime, which cleanly terminates the script. If quick
-termination is not desired, consider using the
-<I>--skip-badvars</I> or <I>--suppress-handler-errors</I> or <I>-DMAXERRORS=NN</I>
-
-stap options, or wrapping relevant parts of the probe handlers in a
-<I>try</I>/<I>catch</I>
-
-block.
-<P>
-
-It may be possible to adjust the target program, to make it more likely
-that needed context variables are paged in when systemtap looks for them.
-Consider adding some lightweight processing on the key variables, like a
-<I>strlen(foo)</I>
-
-for a string, or iterating acrosse elements of an array or linked list,
-or touching a few bytes of a heap-allocated block. The idea is to trigger
-any page faults in the target program, before systemtap would need to (but can't).
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I><A HREF="./error::reporting.7stap.html">error::reporting</A></I>(7stap)
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of ERROR::INODE-UPROBES</TITLE>
-</HEAD><BODY>
-<H1>ERROR::INODE-UPROBES</H1>
-Section: Misc. Reference Manual Pages (7stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-error::inode-uprobes - limitations of inode-uprobes
-<P>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-The uprobes kernel facility introduced in Linux 3.5 aims to supplant the
-earlier out-of-tree utrace patch to enable user-space probing. There
-have been some functional limitations in inode-uprobes that preclude
-some systemtap constructs. Over time, we hope these regressions will
-be corrected.
-<P>
-<DL COMPACT>
-<DT>function.return probes<DD>
-<I>process.function().return</I>
-
-probes require "return-probes" or "uretprobes" functionality, which was not
-implemented in the builtin inode-uprobes until kernel 3.10. If you cannot
-upgrade your kernel, consider using
-<I>process.statement()</I>
-
-probes placed on source line numbers at the function's return statements.
-<P>
-<DT>function.statement.absolute probes<DD>
-In utrace-equipped kernels, systemtap made it possible to address probes
-by literal addresses in the process virtual memory address space. The
-new inode-uprobes does not have this capability.
-<P>
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I><A HREF="http://kernelnewbies.org/Linux_3.5">http://kernelnewbies.org/Linux_3.5</A></I>,
-<I><A HREF="http://sourceware.org/systemtap/wiki/utrace">http://sourceware.org/systemtap/wiki/utrace</A></I>,
-<I><A HREF="./error::reporting.7stap.html">error::reporting</A></I>(7stap)
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of ERROR::PASS1</TITLE>
-</HEAD><BODY>
-<H1>ERROR::PASS1</H1>
-Section: Misc. Reference Manual Pages (7stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-error::pass1 - systemtap pass-1 errors
-<P>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-Errors that occur during pass 1 (parsing) usually mean
-a basic syntax error of some sort occurred in the systemtap script.
-There are several classes of problems possible:
-<P>
-<DL COMPACT>
-<DT>plain syntax error<DD>
-The systemtap script parser detects a large variety of errors, such as
-missing operands, bad punctuation. It tries to list what kinds of tokens
-it was expecting to see, and will show the region of the source code with
-the problem. Please review the
-<I><A HREF="stap.1.html">stap</A></I>(1)
-
-man page and/or the tutorial, to correct the script's syntax.
-<P>
-<DT>grammar ambiguities<DD>
-There is at least one known ambiguity in the systemtap grammar. It relates
-to the optionality of
-<I>;</I>
-
-(semicolon) separators between statements, and the
-<I>++</I> and <I>--</I>
-
-increment/decrement operators. If the parser indicates an error, consider
-adding some explicit
-<I>;</I>
-
-separators between nearby statements and try again.
-<P>
-<DT>missing command line arguments<DD>
-A systemtap script that uses the
-<I>$N</I> and <I>@N</I>
-
-constructs for substituting in command-line options may fail if not
-enough options were given on the stap command line.
-<P>
-<DT>compatibility changes<DD>
-Some versions of systemtap have changed the language incompatibly,
-for example by adding the try/catch keywords for exception handling.
-In such cases, rerun systemtap with the
-<I>--compatibility=VERSION</I>
-
-option, substituting the last systemtap version where your script
-was known to work. You may also check the release-history NEWS file
-for compatibility changes.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>GATHERING MORE INFORMATION</H2>
-
-Increasing the verbosity of pass-1 with an option such as
-<I>--vp 1</I>
-
-can help pinpoint the problem.
-<P>
-<A NAME="lbAE"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I><A HREF="./error::reporting.7stap.html">error::reporting</A></I>(7stap)
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">GATHERING MORE INFORMATION</A><DD>
-<DT><A HREF="#lbAE">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of ERROR::PASS2</TITLE>
-</HEAD><BODY>
-<H1>ERROR::PASS2</H1>
-Section: Misc. Reference Manual Pages (7stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-error::pass2 - systemtap pass-2 errors
-<P>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-Errors that occur during pass 2 (elaboration) can have a variety of causes.
-Common types include:
-<P>
-<DL COMPACT>
-<DT>unavailable probe point classes<DD>
-Some types of probe points are only available on certain system versions,
-architectures, and configurations. For example, user-space
-<I>process.*</I>
-
-probes may require utrace or uprobes capability in the kernel for this
-architecture.
-<P>
-<DT>unavailable probe points<DD>
-Some probe points may be individually unavailable even when their class is
-fine. For example,
-<I>kprobe.function(foobar)</I>
-
-may fail if function
-<I>foobar</I>
-
-does not exist in the kernel any more. Debugging or symbol data may be absent for
-some types of
-<I>.function</I> or <I>.statement</I>
-
-probes; check for availability of debuginfo. Try the
-<I>stap-prep</I>
-
-program to download possibly-required debuginfo.
-Use a wildcard parameter such as
-<I>stap -l 'kprobe.function(*foo*)'</I>
-
-to locate still-existing variants. Use
-<I>!</I> or <I>?</I>
-
-probe point suffixes to denote optional / preferred-alternatives, to let
-the working parts of a script continue.
-<P>
-<DT>typos<DD>
-There might be a spelling error in the probe point name ("sycsall" vs.
-"syscall"). Wildcard probes may not find a match at all in the
-tapsets. Recheck the names using
-<I>stap -l PROBEPOINT</I>.
-
-Another common mistake is to use the
-<I>.</I>
-
-operator instead of the correct
-<I>-></I>
-
-when dereferencing context variable subfields or pointers:
-<I>$foo->bar->baz</I>
-
-even if in C one would say
-<I>foo->bar.baz</I>.
-
-<P>
-<DT>unavailable context variables<DD>
-Systemtap scripts often wish to refer to variables from the context of the
-probed programs using
-<I>$variable</I>
-
-notation. These variables may not always be available, depending on versions
-of the compiler, debugging/optimization flags used, architecture, etc. Use
-<I>stap -L PROBEPOINT</I>
-
-to list available context variables for given probes. Use the
-<I>@defined()</I>
-
-expression to test for the resolvability of a context variable expression.
-Consider using the
-<I>stap --skip-badvars</I>
-
-option to silently replace misbehaving context variable expressions with zero.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>GATHERING MORE INFORMATION</H2>
-
-Increasing the verbosity of pass-2 with an option such as
-<I>--vp 02</I>
-
-can help pinpoint the problem.
-<P>
-<A NAME="lbAE"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I><A HREF="stap-prep.1.html">stap-prep</A></I>(1),
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap),
-<I>probe::*</I>(3stap),
-<I><A HREF="./error::dwarf.7stap.html">error::dwarf</A></I>(7stap),
-<I><A HREF="./error::inode-uprobes.7stap.html">error::inode-uprobes</A></I>(7stap),
-<I><A HREF="./warning::debuginfo.7stap.html">warning::debuginfo</A></I>(7stap),
-<I><A HREF="./error::reporting.7stap.html">error::reporting</A></I>(7stap)
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">GATHERING MORE INFORMATION</A><DD>
-<DT><A HREF="#lbAE">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of ERROR::PASS3</TITLE>
-</HEAD><BODY>
-<H1>ERROR::PASS3</H1>
-Section: Misc. Reference Manual Pages (7stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-error::pass3 - systemtap pass-3 errors
-<P>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-Errors during pass 3 (translation) occur only rarely.
-<P>
-<DL COMPACT>
-<DT>unsupported code generation<DD>
-Some script language constructs are not available in every
-probe point. For example, the
-<I>@perf()</I>
-
-counter-reading function may only be used in
-<I>process.*</I>
-
-probes.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>GATHERING MORE INFORMATION</H2>
-
-Increasing the verbosity of pass-3 with an option such as
-<I>--vp 002</I>
-
-may help pinpoint the problem.
-<P>
-<A NAME="lbAE"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-<I><A HREF="./error::reporting.7stap.html">error::reporting</A></I>(7stap)
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">GATHERING MORE INFORMATION</A><DD>
-<DT><A HREF="#lbAE">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of ERROR::PASS4</TITLE>
-</HEAD><BODY>
-<H1>ERROR::PASS4</H1>
-Section: Misc. Reference Manual Pages (7stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-error::pass4 - systemtap pass-4 errors
-<P>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-Errors that occur during pass 4 (compilation) have generally only a few
-causes:
-<P>
-<DL COMPACT>
-<DT>kernel or OS version changes<DD>
-The systemtap runtime and embedded-C fragments in the tapset library
-are designed to be portable across a wide range of OS versions. However,
-incompatibilities can occur when some OS changes occur, such as kernel
-modifications that change functions, types, or macros referenced
-by systemtap. Upstream builds of systemtap are often quickly updated to
-include relevant fixes, so try getting or making an updated build.
-If the issue persists, report the problem to the systemtap developers.
-<P>
-<DT>buggy embedded-C code<DD>
-Embedded-C code in your own guru-mode script cannot be checked by systemtap,
-and is passed through verbatim to the compiler. Errors in such snippets of
-code may be found during the pass-4 compiler invocation, though may be hard
-to identify by the compiler errors.
-<P>
-<DT>incompatible embedded-C code<DD>
-The interface standards between systemtap-generated code and embedded-C code
-occasionally change. For example, before version 1.8, arguments were passed
-using macros
-<I>THIS->foo</I> and <I>THIS->__retvalue</I>
-
-but from version 1.8 onward, using
-<I>STAP_ARG_foo</I> and <I>STAP_RETVALUE</I>.
-
-Adjust your embedded-C code to current standards, or use the
-<I>stap --compatible=VERSION</I>
-
-option to make systemtap use a different one.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>GATHERING MORE INFORMATION</H2>
-
-It may be necessary to run systemtap with
-<I>-k</I> or <I>-p3</I>
-
-to examine the generated C code. Increasing the verbosity of pass-4
-with an option such as
-<I>--vp 0001</I>
-
-can also help pinpoint the problem.
-<P>
-<A NAME="lbAE"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I><A HREF="./error::reporting.7stap.html">error::reporting</A></I>(7stap)
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">GATHERING MORE INFORMATION</A><DD>
-<DT><A HREF="#lbAE">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of ERROR::PASS5</TITLE>
-</HEAD><BODY>
-<H1>ERROR::PASS5</H1>
-Section: Misc. Reference Manual Pages (7stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-error::pass5 - systemtap pass-5 errors
-<P>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-Errors that occur during pass 5 (execution) can have a variety of causes.
-<P>
-<DL COMPACT>
-<DT>exceptional events during script execution<DD>
-The systemtap translator and runtime include numerous error checks
-that aim to protect the systems and the users from mistakes or
-transient conditions. The script may deliberately call the
-<I>error()</I>
-
-tapset function to signal a problem. Some memory needed for
-accessing
-<I>$context</I>
-
-variables may be temporarily unavailable. Consider using the
-<I>try</I>/<I>catch</I>
-
-construct to wrap script fragments in exception-handling code.
-Consider using the
-<I>stap --suppress-handler-errors</I>
-
-or
-<I>stap --skip-badvars</I>
-
-option.
-<P>
-<DT>resource exhaustion<DD>
-One of several types of space or time resource limits may be
-exceeded by the script, including system overload, too many tuples
-to be stored in an array, etc. Some of the error messages identify
-the constraint by macro name, which may be individually raised.
-Consider using the
-<I>stap --suppress-handler-errors</I>
-
-option. Extend or disable resource limits using the
-<I>stap -DLIMIT=NNNN</I>
-
-option.
-
-<P>
-<DT>remote execution server problems<DD>
-If you use the
-<I>stap --remote</I>
-
-option to direct a systemtap script to be executed somewhere else,
-ensure that an SSH connection may be made to the remote host, and
-that it has the current systemtap runtime installed & available.
-<P>
-<DT>installation/permission problems<DD>
-It is possible that your installation of systemtap was not correctly
-installed. For example, the
-<I>/usr/bin/staprun</I>
-
-program may lack the necessary setuid permissions, or your invoking
-userid might not have sufficient privileges (root, or
-<I>stapusr</I>
-
-and related group memberships). Environment
-variables may interfere with locating
-<I>/usr/libexec/.../stapio</I>.
-
-<P>
-<DT>errors from target program<DD>
-The program invoked by the
-<I>stap -c CMD</I>
-
-option may exit with a non-zero code.
-<P>
-<DT>uncaught exceptions in the target program<DD>
-When using
-<I>--runtime=dyninst</I>
-
-you may encounter an issue where the target program aborts with a
-message like "terminate called after throwing an instance
-of 'foo_exception'". This is unfortunately a limitation of Dyninst,
-which sometimes prevents exceptions from properly unwinding through
-instrumented code.
-<P>
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>GATHERING MORE INFORMATION</H2>
-
-Increasing the verbosity of pass-5
-with an option such as
-<I>--vp 00001</I>
-
-can help pinpoint the problem.
-<P>
-<A NAME="lbAE"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I><A HREF="http://sourceware.org/systemtap/wiki/TipExhaustedResourceErrors">http://sourceware.org/systemtap/wiki/TipExhaustedResourceErrors</A></I>,
-<I><A HREF="./error::fault.7stap.html">error::fault</A></I>(7stap),
-<I><A HREF="./error::reporting.7stap.html">error::reporting</A></I>(7stap)
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">GATHERING MORE INFORMATION</A><DD>
-<DT><A HREF="#lbAE">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of WARNING::PROCESS-TRACKING</TITLE>
-</HEAD><BODY>
-<H1>WARNING::PROCESS-TRACKING</H1>
-Section: Misc. Reference Manual Pages (7stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-warning::process-tracking - process-tracking facilities are not available
-<P>
-
-
-
-<P>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-These errors and warnings occur when the kernel systemtap is running on
-lacks support for user-space process tracking facilities.
-<P>
-<A NAME="lbAD"> </A>
-<H3>COMPILE-TIME ERROR</H3>
-
-The error
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-ERROR: user-space process-tracking facilities not available
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-occurs when the script contains a uprobes probe point that the current
-kernel does not support.
-<P>
-<A NAME="lbAE"> </A>
-<H3>RUNTIME WARNINGS</H3>
-
-<P>
-
-The warning,
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-WARNING: process-tracking facilities are not available in this kernel
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-and the related message,
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-WARNING: cannot track target in process '...'
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-both occur at runtime when running on a kernel (generally an older
-version) that has neither utrace functionality nor an acceptable
-substitute.
-<P>
-
-The script should still load and run. However, probes that rely on
-availability of process-tracking facilities will silently fail to
-trigger.
-<P>
-<A NAME="lbAF"> </A>
-<H2>RESOLVING THE ISSUE</H2>
-
-If process-tracking functionality is absolutely necessary, either a
-kernel version newer than 3.5 is needed, or an older version must be
-compiled with appropriate utrace patches.
-<P>
-<A NAME="lbAG"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I><A HREF="./error::reporting.7stap.html">error::reporting</A></I>(7stap)
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DL>
-<DT><A HREF="#lbAD">COMPILE-TIME ERROR</A><DD>
-<DT><A HREF="#lbAE">RUNTIME WARNINGS</A><DD>
-</DL>
-<DT><A HREF="#lbAF">RESOLVING THE ISSUE</A><DD>
-<DT><A HREF="#lbAG">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of ERROR::REPORTING</TITLE>
-</HEAD><BODY>
-<H1>ERROR::REPORTING</H1>
-Section: Misc. Reference Manual Pages (7stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-error::reporting - systemtap error reporting
-<P>
-<P>
-<A NAME="lbAC"> </A>
-<H2>COMMERCIAL SUPPORT</H2>
-
-If you have a commercial support agreement with your OS distributor
-that covers this software, we recommend getting your money's worth
-by using their problem reporting systems first.
-<P>
-<A NAME="lbAD"> </A>
-<H2>COMMUNITY SUPPORT</H2>
-
-Systemtap community & volunteer developers are eager to hear problem
-reports, so they can improve the software. Various ways to contact them
-include:
-<P>
-<DL COMPACT>
-<DT>public mailing list<DD>
-<A HREF="mailto:systemtap@sourceware.org">systemtap@sourceware.org</A>
-<P>
-<DT>public IRC<DD>
-#systemtap on irc.freenode.net, use fpaste.org for snippets of text
-<P>
-<DT>public bugzilla<DD>
-<A HREF="http://sourceware.org/bugzilla/">http://sourceware.org/bugzilla/</A>
-<P>
-</DL>
-<A NAME="lbAE"> </A>
-<H2>INFORMATION TO COLLECT</H2>
-
-In general, please include information about your platform,
-systemtap version, your scripts & custom tapsets, systemtap
-invocation, actual behavior / errors seen, and expected behavior.
-The
-<I>stap-report</I>
-
-script collects useful system/kernel information that helps describe
-the OS environment; please include its output.
-<P>
-<A NAME="lbAF"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I><A HREF="stap-report.1.html">stap-report</A></I>(1),
-<I><A HREF="http://sourceware.org/systemtap/wiki/">http://sourceware.org/systemtap/wiki/</A></I>
-
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">COMMERCIAL SUPPORT</A><DD>
-<DT><A HREF="#lbAD">COMMUNITY SUPPORT</A><DD>
-<DT><A HREF="#lbAE">INFORMATION TO COLLECT</A><DD>
-<DT><A HREF="#lbAF">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of ERROR::SDT</TITLE>
-</HEAD><BODY>
-<H1>ERROR::SDT</H1>
-Section: Misc. Reference Manual Pages (7stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-error::sdt - <<A HREF="file:///usr/include/sys/sdt.h">sys/sdt.h</A>> marker failures
-<P>
-
-
-
-<P>
-<P>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-Systemtap's
-<B><<A HREF="file:///usr/include/sys/sdt.h">sys/sdt.h</A>></B>
-
-probes are modeled after the dtrace USDT API, but are implemented
-differently. They leave a only a NOP instruction in the userspace
-program's text segment, and add an ELF note to the binary with
-metadata. This metadata describes the marker's name and parameters.
-This encoding is designed to be parseable by multiple tools (not just
-systemtap: GDB, the GNU Debugger, also contains support). These allow
-the tools to find parameters and their types, wherever they happen to
-reside, even without DWARF debuginfo.
-<P>
-<P>
-
-<P>
-The reason finding parameters is tricky is because the STAP_PROBE /
-DTRACE_PROBE markers store an assembly language expression for each
-operand, as a result of use of gcc inline-assembly directives. The
-compiler is given a broad gcc operand constraint string ("nor") for
-the operands, which usually works well. Usually, it does not force
-the compiler to load the parameters into or out of registers, which
-would slow down an instrumented program. However, some
-instrumentation sites with some parameters do not work well with the
-default "nor" constraint.
-<P>
-<DL COMPACT>
-<DT>unresolveable at run-time<DD>
-GCC may emit strings that an assembler could resolve (from the
-context of compiling the original program), but a run-time tool
-cannot. For example, the operand string might refer to a label of a
-local symbol that is not emitted into the ELF object file at all,
-which leaves no trace for the run-time. Reference to such parameters
-from within systemtap can result in "SDT asm not understood" errors.
-<P>
-<DT>too complicated expression<DD>
-GCC might synthesize very complicated assembly addressing modes from
-complex C data types / pointer expressions. systemtap or gdb may not
-be able to parse some valid but complicated expressions. Reference to
-such parameters from within systemtap can result in "SDT asm not
-understood" errors.
-<P>
-<DT>overly restrictive constraint<DD>
-GCC might not be able to even compile the original program with the
-default "nor" constraint due to shortage of registers or other
-reasons. A compile-time gcc error such as "asm operand has impossible
-constraints" may result.
-<P>
-</DL>
-<P>
-
-<P>
-There are two general workarounds to this family of problems.
-<P>
-<DL COMPACT>
-<DT>change the constraints<DD>
-While compiling the original instrumented program, set the
-<I>STAP_SDT_ARG_CONSTRAINT</I>
-
-macro to different constraint strings. See the GCC manual about
-various options. For example, on many machine architectures, "r" forces
-operands into registers, and "g" leaves operands essentially unconstrained.
-<P>
-<DT>revert to debuginfo<DD>
-As long as the instrumented program compiles, it may be fine simply to
-keep using <<A HREF="file:///usr/include/sys/sdt.h">sys/sdt.h</A>> but eschew extraction of a few individual
-parameters. In the worst case, disable <<A HREF="file:///usr/include/sys/sdt.h">sys/sdt.h</A>> macros entirely to
-eschew the compiled-in instrumentation. If DWARF debuginfo was
-generated and preserved, a systemtap script could refer to the
-underlying source context variables instead of the positional
-STAP_PROBE parameters.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap),
-<I><A HREF="./error::dwarf.7stap.html">error::dwarf</A></I>(7stap),
-<I><A HREF="http://gcc.gnu.org/onlinedocs/gcc/Constraints.html">http://gcc.gnu.org/onlinedocs/gcc/Constraints.html</A></I>,
-<I><A HREF="http://sourceware.org/systemtap/wiki/UserSpaceProbeImplementation">http://sourceware.org/systemtap/wiki/UserSpaceProbeImplementation</A></I>,
-<I><A HREF="./error::reporting.7stap.html">error::reporting</A></I>(7stap)
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::HZ</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::HZ</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::HZ - Kernel HZ
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- HZ:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the value of the kernel HZ macro, which corresponds to the rate of increase of the jiffies value.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::MAJOR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::MAJOR</H1>
-Section: Device Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::MAJOR - Extract major device number from a kernel device number (kdev_t)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- MAJOR:long(dev:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-Kernel device number to query.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::MINOR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::MINOR</H1>
-Section: Device Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::MINOR - Extract minor device number from a kernel device number (kdev_t)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- MINOR:long(dev:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-Kernel device number to query.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::MKDEV</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::MKDEV</H1>
-Section: Device Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::MKDEV - Creates a value that can be compared to a kernel device number (kdev_t)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- MKDEV:long(major:long,minor:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>major</I>
-<DL COMPACT><DT><DD>
-Intended major device number.
-</DL>
-
-<P>
-
-<I>minor</I>
-<DL COMPACT><DT><DD>
-Intended minor device number.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ADDR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ADDR</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::addr - Address of the current probe point.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- addr:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the instruction pointer from the current probe's register state. Not all probe types have registers though, in which case zero is returned. The returned address is suitable for use with functions like
-<B>symname</B>
-and
-<B>symdata</B>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ADDR_TO_NO</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ADDR_TO_NO</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::addr_to_node - Returns which node a given address belongs to within a NUMA system
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- addr_to_node:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the address of the faulting memory access
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function accepts an address, and returns the node that the given address belongs to in a NUMA system.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ANSI_CLEAR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ANSI_CLEAR</H1>
-Section: Utility functions for using an (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ansi_clear_screen - Move cursor to top left and clear screen.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ansi_clear_screen()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Sends ansi code for moving cursor to top left and then the ansi code for clearing the screen from the cursor position to the end.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ANSI_CURSO</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ANSI_CURSO</H1>
-Section: Utility functions for using an (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ansi_cursor_hide - Hides the cursor.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ansi_cursor_hide()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Sends ansi code for hiding the cursor.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ANSI_CURSO</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ANSI_CURSO</H1>
-Section: Utility functions for using an (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ansi_cursor_move - Move cursor to new coordinates.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ansi_cursor_move(x:long,y:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>x</I>
-<DL COMPACT><DT><DD>
-Row to move the cursor to.
-</DL>
-
-<P>
-
-<I>y</I>
-<DL COMPACT><DT><DD>
-Colomn to move the cursor to.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Sends ansi code for positioning the cursor at row x and column y. Coordinates start at one, (1,1) is the top-left corner.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ANSI_CURSO</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ANSI_CURSO</H1>
-Section: Utility functions for using an (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ansi_cursor_restore - Restores a previously saved cursor position.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ansi_cursor_restore()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Sends ansi code for restoring the current cursor position previously saved with
-<B>ansi_cursor_save</B>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ANSI_CURSO</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ANSI_CURSO</H1>
-Section: Utility functions for using an (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ansi_cursor_save - Saves the cursor position.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ansi_cursor_save()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Sends ansi code for saving the current cursor position.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ANSI_CURSO</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ANSI_CURSO</H1>
-Section: Utility functions for using an (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ansi_cursor_show - Shows the cursor.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ansi_cursor_show()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Sends ansi code for showing the cursor.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ANSI_NEW_L</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ANSI_NEW_L</H1>
-Section: Utility functions for using an (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ansi_new_line - Move cursor to new line.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ansi_new_line()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Sends ansi code new line.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ANSI_RESET</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ANSI_RESET</H1>
-Section: Utility functions for using an (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ansi_reset_color - Resets Select Graphic Rendition mode.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ansi_reset_color()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Sends ansi code to reset foreground, background and color attribute to default values.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ANSI_SET_C</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ANSI_SET_C</H1>
-Section: Utility functions for using an (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ansi_set_color - Set the ansi Select Graphic Rendition mode.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ansi_set_color(fg:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>fg</I>
-<DL COMPACT><DT><DD>
-Foreground color to set.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Sends ansi code for Select Graphic Rendition mode for the given forground color. Black (30), Blue (34), Green (32), Cyan (36), Red (31), Purple (35), Brown (33), Light Gray (37).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ANSI_SET_C</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ANSI_SET_C</H1>
-Section: Utility functions for using an (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ansi_set_color2 - Set the ansi Select Graphic Rendition mode.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ansi_set_color2(fg:long,bg:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>fg</I>
-<DL COMPACT><DT><DD>
-Foreground color to set.
-</DL>
-
-<P>
-
-<I>bg</I>
-<DL COMPACT><DT><DD>
-Background color to set.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Sends ansi code for Select Graphic Rendition mode for the given forground color, Black (30), Blue (34), Green (32), Cyan (36), Red (31), Purple (35), Brown (33), Light Gray (37) and the given background color, Black (40), Red (41), Green (42), Yellow (43), Blue (44), Magenta (45), Cyan (46), White (47).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ANSI_SET_C</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ANSI_SET_C</H1>
-Section: Utility functions for using an (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ansi_set_color3 - Set the ansi Select Graphic Rendition mode.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ansi_set_color3(fg:long,bg:long,attr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>fg</I>
-<DL COMPACT><DT><DD>
-Foreground color to set.
-</DL>
-
-<P>
-
-<I>bg</I>
-<DL COMPACT><DT><DD>
-Background color to set.
-</DL>
-
-<P>
-
-<I>attr</I>
-<DL COMPACT><DT><DD>
-Color attribute to set.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Sends ansi code for Select Graphic Rendition mode for the given forground color, Black (30), Blue (34), Green (32), Cyan (36), Red (31), Purple (35), Brown (33), Light Gray (37), the given background color, Black (40), Red (41), Green (42), Yellow (43), Blue (44), Magenta (45), Cyan (46), White (47) and the color attribute All attributes off (0), Intensity Bold (1), Underline Single (4), Blink Slow (5), Blink Rapid (6), Image Negative (7).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ASMLINKAGE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ASMLINKAGE</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::asmlinkage - Mark function as declared asmlinkage
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- asmlinkage()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Call this function before accessing arguments using the *_arg functions if the probed kernel function was declared asmlinkage in the source.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ATOMIC_LON</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ATOMIC_LON</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::atomic_long_read - Retrieves an atomic long variable from kernel memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- atomic_long_read:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-pointer to atomic long variable
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Safely perform the read of an atomic long variable. This will be a NOP on kernels that do not have ATOMIC_LONG_INIT set on the kernel config.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ATOMIC_REA</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ATOMIC_REA</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::atomic_read - Retrieves an atomic variable from kernel memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- atomic_read:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-pointer to atomic variable
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Safely perform the read of an atomic variable.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::BACKTRACE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::BACKTRACE</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::backtrace - Hex backtrace of current kernel stack
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- backtrace:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a string of hex addresses that are a backtrace of the kernel stack. Output may be truncated as per maximum string length (MAXSTRINGLEN). See
-<B>ubacktrace</B>
-for user-space backtrace.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::BYTES_TO_S</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::BYTES_TO_S</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::bytes_to_string - Human readable string for given bytes
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- bytes_to_string:string(bytes:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>bytes</I>
-<DL COMPACT><DT><DD>
-Number of bytes to translate.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns a string representing the number of bytes (up to 1024 bytes), the number of kilobytes (when less than 1024K) postfixed by 'K', the number of megabytes (when less than 1024M) postfixed by 'M' or the number of gigabytes postfixed by 'G'. If representing K, M or G, and the number is amount is less than 100, it includes a '.' plus the remainer. The returned string will be 5 characters wide (padding with whitespace at the front) unless negative or representing more than 9999G bytes.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::CALLER</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::CALLER</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::caller - Return name and address of calling function
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- caller:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the address and name of the calling function. This is equivalent to calling: sprintf("<B>s</B> 0x<B>x</B>", symname(<B>caller_addr</B>),
-<B>caller_addr</B>)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::CALLER_ADD</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::CALLER_ADD</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::caller_addr - Return caller address
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- caller_addr:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the address of the calling function.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::CALLERS</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::CALLERS</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::callers - Return first n elements of kernel stack backtrace
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- callers:string(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-number of levels to descend in the stack (not counting the top level). If n is -1, print the entire stack.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a string of the first n hex addresses from the backtrace of the kernel stack. Output may be truncated as per maximum string length (MAXSTRINGLEN).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::CMDLINE_AR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::CMDLINE_AR</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::cmdline_arg - Fetch a command line argument
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- cmdline_arg:string(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-Argument to get (zero is the program itself)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns argument the requested argument from the current process or the empty string when there are not that many arguments or there is a problem retrieving the argument. Argument zero is traditionally the command itself.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::CMDLINE_AR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::CMDLINE_AR</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::cmdline_args - Fetch command line arguments from current process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- cmdline_args:string(n:long,m:long,delim:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-First argument to get (zero is normally the program itself)
-</DL>
-
-<P>
-
-<I>m</I>
-<DL COMPACT><DT><DD>
-Last argument to get (or minus one for all arguments after n)
-</DL>
-
-<P>
-
-<I>delim</I>
-<DL COMPACT><DT><DD>
-String to use to separate arguments when more than one.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns arguments from the current process starting with argument number n, up to argument m. If there are less than n arguments, or the arguments cannot be retrieved from the current process, the empty string is returned. If m is smaller than n then all arguments starting from argument n are returned. Argument zero is traditionally the command itself.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::CMDLINE_ST</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::CMDLINE_ST</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::cmdline_str - Fetch all command line arguments from current process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- cmdline_str:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns all arguments from the current process delimited by spaces. Returns the empty string when the arguments cannot be retrieved.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::COMMIT</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::COMMIT</H1>
-Section: Speculation (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::commit - Write out all output related to a speculation buffer
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- commit(id:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>id</I>
-<DL COMPACT><DT><DD>
-of the buffer to store the information in
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Output all the output for
-<I>id</I>
-in the order that it was entered into the speculative buffer by
-<B>speculative</B>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::CPU</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::CPU</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::cpu - Returns the current cpu number
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- cpu:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the current cpu number.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::CPU_CLOCK_</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::CPU_CLOCK_</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::cpu_clock_ms - Number of milliseconds on the given cpu's clock
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- cpu_clock_ms:long(cpu:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>cpu</I>
-<DL COMPACT><DT><DD>
-Which processor's clock to read
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the number of milliseconds on the given cpu's clock. This is always monotonic comparing on the same cpu, but may have some drift between cpus (within about a jiffy).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::CPU_CLOCK_</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::CPU_CLOCK_</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::cpu_clock_ns - Number of nanoseconds on the given cpu's clock
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- cpu_clock_ns:long(cpu:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>cpu</I>
-<DL COMPACT><DT><DD>
-Which processor's clock to read
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the number of nanoseconds on the given cpu's clock. This is always monotonic comparing on the same cpu, but may have some drift between cpus (within about a jiffy).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::CPU_CLOCK_</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::CPU_CLOCK_</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::cpu_clock_s - Number of seconds on the given cpu's clock
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- cpu_clock_s:long(cpu:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>cpu</I>
-<DL COMPACT><DT><DD>
-Which processor's clock to read
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the number of seconds on the given cpu's clock. This is always monotonic comparing on the same cpu, but may have some drift between cpus (within about a jiffy).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::CPU_CLOCK_</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::CPU_CLOCK_</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::cpu_clock_us - Number of microseconds on the given cpu's clock
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- cpu_clock_us:long(cpu:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>cpu</I>
-<DL COMPACT><DT><DD>
-Which processor's clock to read
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the number of microseconds on the given cpu's clock. This is always monotonic comparing on the same cpu, but may have some drift between cpus (within about a jiffy).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::CPUID</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::CPUID</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::cpuid - Returns the current cpu number
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- cpuid:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the current cpu number. Deprecated in SystemTap 1.4 and removed in SystemTap 1.5.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::CPUTIME_TO</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::CPUTIME_TO</H1>
-Section: Task Time Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::cputime_to_msecs - Translates the given cputime into milliseconds
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- cputime_to_msecs:long(cputime:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>cputime</I>
-<DL COMPACT><DT><DD>
-Time to convert to milliseconds.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::CPUTIME_TO</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::CPUTIME_TO</H1>
-Section: Task Time Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::cputime_to_string - Human readable string for given cputime
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- cputime_to_string:string(cputime:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>cputime</I>
-<DL COMPACT><DT><DD>
-Time to translate.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Equivalent to calling: msec_to_string (cputime_to_msecs (cputime).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::CPUTIME_TO</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::CPUTIME_TO</H1>
-Section: Task Time Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::cputime_to_usecs - Translates the given cputime into microseconds
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- cputime_to_usecs:long(cputime:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>cputime</I>
-<DL COMPACT><DT><DD>
-Time to convert to microseconds.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::CTIME</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::CTIME</H1>
-Section: Time utility functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ctime - Convert seconds since epoch into human readable date/time string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ctime:string(epochsecs:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>epochsecs</I>
-<DL COMPACT><DT><DD>
-Number of seconds since epoch (as returned by
-<B>gettimeofday_s</B>)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Takes an argument of seconds since the epoch as returned by
-<B>gettimeofday_s</B>. Returns a string of the form
-<P>
-
-"Wed Jun 30 21:49:08 1993"
-<P>
-
-The string will always be exactly 24 characters. If the time would be unreasonable far in the past (before what can be represented with a 32 bit offset in seconds from the epoch) an error will occur (which can be avoided with try/catch). If the time would be unreasonable far in the future, an error will also occur.
-<P>
-
-Note that the epoch (zero) corresponds to
-<P>
-
-"Thu Jan 1 00:00:00 1970"
-<P>
-
-The earliest full date given by ctime, corresponding to epochsecs -2147483648 is
-"Fri Dec 13 20:45:52 1901". The latest full date given by ctime, corresponding to epochsecs 2147483647 is
-"Tue Jan 19 03:14:07 2038".
-<P>
-
-The abbreviations for the days of the week are 'Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', and 'Sat'. The abbreviations for the months are 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', and 'Dec'.
-<P>
-
-Note that the real C library
-<B>ctime</B>
-function puts a newline ('\n') character at the end of the string that this function does not. Also note that since the kernel has no concept of timezones, the returned time is always in GMT.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::D_NAME</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::D_NAME</H1>
-Section: Directory-entry (dentry) Tapse (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::d_name - get the dirent name
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- d_name:string(dentry:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>dentry</I>
-<DL COMPACT><DT><DD>
-Pointer to dentry.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-Returns the dirent name (path basename).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::D_PATH</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::D_PATH</H1>
-Section: Directory-entry (dentry) Tapse (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::d_path - get the full nameidata path
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- d_path:string(nd:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>nd</I>
-<DL COMPACT><DT><DD>
-Pointer to nameidata.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-Returns the full dirent name (full path to the root), like the kernel d_path function.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::DELETE_STO</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::DELETE_STO</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::delete_stopwatch - Remove an existing stopwatch
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- delete_stopwatch(name:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-the stopwatch name
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Remove stopwatch
-<I>name</I>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::DISCARD</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::DISCARD</H1>
-Section: Speculation (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::discard - Discard all output related to a speculation buffer
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- discard(id:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>id</I>
-<DL COMPACT><DT><DD>
-of the buffer to store the information in
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::EGID</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::EGID</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::egid - Returns the effective gid of a target process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- egid:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the effective gid of a target process
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ENV_VAR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ENV_VAR</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::env_var - Fetch environment variable from current process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- env_var:string(name:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the environment variable to fetch
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the contents of the specified environment value for the current process. If the variable isn't set an empty string is returned.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ERRNO_STR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ERRNO_STR</H1>
-Section: Errno Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::errno_str - Symbolic string associated with error code
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- errno_str:string(err:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>err</I>
-<DL COMPACT><DT><DD>
-The error number received
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the symbolic string associated with the giver error code, such as ENOENT for the number 2, or E#3333 for an out-of-range value such as 3333.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ERROR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ERROR</H1>
-Section: Logging Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::error - Send an error message
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- error(msg:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>msg</I>
-<DL COMPACT><DT><DD>
-The formatted message string
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-An implicit end-of-line is added. staprun prepends the string
-"ERROR:". Sending an error message aborts the currently running probe. Depending on the MAXERRORS parameter, it may trigger an
-<B>exit</B>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::EUID</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::EUID</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::euid - Return the effective uid of a target process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- euid:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the effective user ID of the target process.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::EXECNAME</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::EXECNAME</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::execname - Returns the execname of a target process (or group of processes)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- execname:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the execname of a target process (or group of processes).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::EXIT</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::EXIT</H1>
-Section: Logging Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::exit - Start shutting down probing script.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- exit()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This only enqueues a request to start shutting down the script. New probes will not fire (except
-"end"
-probes), but all currently running ones may complete their work.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::FASTCALL</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::FASTCALL</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::fastcall - Mark function as declared fastcall
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- fastcall()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Call this function before accessing arguments using the *_arg functions if the probed kernel function was declared fastcall in the source.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::FORMAT_IPA</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::FORMAT_IPA</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::format_ipaddr - Returns a string representation for an IP address
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- format_ipaddr:string(addr:long,family:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the IP address
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-the IP address family (either AF_INET or AF_INET6)
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::FTRACE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::FTRACE</H1>
-Section: Logging Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ftrace - Send a message to the ftrace ring-buffer
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ftrace(msg:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>msg</I>
-<DL COMPACT><DT><DD>
-The formatted message string
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-If the ftrace ring-buffer is configured & available, see /debugfs/tracing/trace for the message. Otherwise, the message may be quietly dropped. An implicit end-of-line is added.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::GET_CYCLES</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::GET_CYCLES</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::get_cycles - Processor cycle count
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- get_cycles:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the processor cycle counter value if available, else it returns zero. The cycle counter is free running and unsynchronized on each processor. Thus, the order of events cannot determined by comparing the results of the get_cycles function on different processors.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::GET_LOADAV</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::GET_LOADAV</H1>
-Section: Kernel Process Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::get_loadavg_index - Get the load average for a specified interval
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- get_loadavg_index:long(indx:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>indx</I>
-<DL COMPACT><DT><DD>
-The load average interval to capture.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the load average at a specified interval. The three load average values 1, 5 and 15 minute average corresponds to indexes 0, 1 and 2 of the avenrun array - see linux/sched.h. Please note that the truncated-integer portion of the load average is returned. If the specified index is out-of-bounds, then an error message and exception is thrown.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::GET_SA_FLA</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::GET_SA_FLA</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::get_sa_flags - Returns the numeric value of sa_flags
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- get_sa_flags:long(act:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>act</I>
-<DL COMPACT><DT><DD>
-address of the sigaction to query.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::GET_SA_HAN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::GET_SA_HAN</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::get_sa_handler - Returns the numeric value of sa_handler
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- get_sa_handler:long(act:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>act</I>
-<DL COMPACT><DT><DD>
-address of the sigaction to query.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::GETTIMEOFD</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::GETTIMEOFD</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::gettimeofday_ms - Number of milliseconds since UNIX epoch
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- gettimeofday_ms:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the number of milliseconds since the UNIX epoch.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::GETTIMEOFD</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::GETTIMEOFD</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::gettimeofday_ns - Number of nanoseconds since UNIX epoch
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- gettimeofday_ns:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the number of nanoseconds since the UNIX epoch.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::GETTIMEOFD</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::GETTIMEOFD</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::gettimeofday_s - Number of seconds since UNIX epoch
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- gettimeofday_s:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the number of seconds since the UNIX epoch.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::GETTIMEOFD</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::GETTIMEOFD</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::gettimeofday_us - Number of microseconds since UNIX epoch
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- gettimeofday_us:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the number of microseconds since the UNIX epoch.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::GID</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::GID</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::gid - Returns the group ID of a target process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- gid:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the group ID of a target process.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::HTONL</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::HTONL</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::htonl - Convert 32-bit long from host to network order
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- htonl:long(x:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>x</I>
-<DL COMPACT><DT><DD>
-Value to convert
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::HTONLL</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::HTONLL</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::htonll - Convert 64-bit long long from host to network order
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- htonll:long(x:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>x</I>
-<DL COMPACT><DT><DD>
-Value to convert
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::HTONS</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::HTONS</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::htons - Convert 16-bit short from host to network order
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- htons:long(x:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>x</I>
-<DL COMPACT><DT><DD>
-Value to convert
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::INDENT</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::INDENT</H1>
-Section: Utility functions for using an (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::indent - returns an amount of space to indent
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- indent:string(delta:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>delta</I>
-<DL COMPACT><DT><DD>
-the amount of space added/removed for each call
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a string with appropriate indentation. Call it with a small positive or matching negative delta. Unlike the thread_indent function, the indent does not track individual indent values on a per thread basis.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::INDENT_DEP</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::INDENT_DEP</H1>
-Section: Utility functions for using an (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::indent_depth - returns the global nested-depth
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- indent_depth:long(delta:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>delta</I>
-<DL COMPACT><DT><DD>
-the amount of depth added/removed for each call
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a number for appropriate indentation, similar to
-<B>indent</B>. Call it with a small positive or matching negative delta. Unlike the thread_indent_depth function, the indent does not track individual indent values on a per thread basis.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::INET_GET_I</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::INET_GET_I</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::inet_get_ip_source - Provide IP source address string for a kernel socket
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- inet_get_ip_source:string(sock:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>sock</I>
-<DL COMPACT><DT><DD>
-pointer to the kernel socket
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::INET_GET_L</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::INET_GET_L</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::inet_get_local_port - Provide local port number for a kernel socket
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- inet_get_local_port:long(sock:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>sock</I>
-<DL COMPACT><DT><DD>
-pointer to the kernel socket
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::INODE_NAME</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::INODE_NAME</H1>
-Section: Directory-entry (dentry) Tapse (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::inode_name - get the inode name
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- inode_name:string(inode:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>inode</I>
-<DL COMPACT><DT><DD>
-Pointer to inode.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-Returns the first path basename associated with the given inode.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::INODE_PATH</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::INODE_PATH</H1>
-Section: Directory-entry (dentry) Tapse (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::inode_path - get the path to an inode
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- inode_path:string(inode:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>inode</I>
-<DL COMPACT><DT><DD>
-Pointer to inode.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-Returns the full path associated with the given inode.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::INT_ARG</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::INT_ARG</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::int_arg - Return function argument as signed int
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- int_arg:long(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-index of argument to return
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Return the value of argument n as a signed int (i.e., a 32-bit integer sign-extended to 64 bits).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::IP_NTOP</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::IP_NTOP</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ip_ntop - Returns a string representation for an IPv4 address
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ip_ntop:string(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the IPv4 address represented as an integer
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::IPMIB_FILT</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::IPMIB_FILT</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ipmib_filter_key - Default filter function for ipmib.* probes
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ipmib_filter_key:long(skb:long,op:long,SourceIsLocal:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>skb</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sk_buff
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be counted if
-<I>skb</I>
-passes the filter
-</DL>
-
-<P>
-
-<I>SourceIsLocal</I>
-<DL COMPACT><DT><DD>
-1 is local operation and 0 is non-local operation
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function is a default filter function. The user can replace this function with their own. The user-supplied filter function returns an index key based on the values in
-<I>skb</I>. A return value of 0 means this particular
-<I>skb</I>
-should be not be counted.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::IPMIB_GET_</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::IPMIB_GET_</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ipmib_get_proto - Get the protocol value
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ipmib_get_proto:long(skb:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>skb</I>
-<DL COMPACT><DT><DD>
-pointer to a struct sk_buff
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the protocol value from
-<I>skb</I>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::IPMIB_LOCA</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::IPMIB_LOCA</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ipmib_local_addr - Get the local ip address
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ipmib_local_addr:long(skb:long,SourceIsLocal:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>skb</I>
-<DL COMPACT><DT><DD>
-pointer to a struct sk_buff
-</DL>
-
-<P>
-
-<I>SourceIsLocal</I>
-<DL COMPACT><DT><DD>
-flag to indicate whether local operation
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the local ip address
-<I>skb</I>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::IPMIB_REMO</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::IPMIB_REMO</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ipmib_remote_addr - Get the remote ip address
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ipmib_remote_addr:long(skb:long,SourceIsLocal:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>skb</I>
-<DL COMPACT><DT><DD>
-pointer to a struct sk_buff
-</DL>
-
-<P>
-
-<I>SourceIsLocal</I>
-<DL COMPACT><DT><DD>
-flag to indicate whether local operation
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the remote ip address from
-<I>skb</I>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::IPMIB_TCP_</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::IPMIB_TCP_</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ipmib_tcp_local_port - Get the local tcp port
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ipmib_tcp_local_port:long(skb:long,SourceIsLocal:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>skb</I>
-<DL COMPACT><DT><DD>
-pointer to a struct sk_buff
-</DL>
-
-<P>
-
-<I>SourceIsLocal</I>
-<DL COMPACT><DT><DD>
-flag to indicate whether local operation
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the local tcp port from
-<I>skb</I>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::IPMIB_TCP_</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::IPMIB_TCP_</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ipmib_tcp_remote_port - Get the remote tcp port
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ipmib_tcp_remote_port:long(skb:long,SourceIsLocal:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>skb</I>
-<DL COMPACT><DT><DD>
-pointer to a struct sk_buff
-</DL>
-
-<P>
-
-<I>SourceIsLocal</I>
-<DL COMPACT><DT><DD>
-flag to indicate whether local operation
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the remote tcp port from
-<I>skb</I>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::IS_MYPROC</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::IS_MYPROC</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::is_myproc - Determines if the current probe point has occurred in the user's own process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- is_myproc:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns 1 if the current probe point has occurred in the user's own process.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::IS_RETURN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::IS_RETURN</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::is_return - Whether the current probe context is a return probe
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- is_return:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns 1 if the current probe context is a return probe, returns 0 otherwise.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::IS_SIG_BLO</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::IS_SIG_BLO</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::is_sig_blocked - Returns 1 if the signal is currently blocked, or 0 if it is not
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- is_sig_blocked:long(task:long,sig:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-address of the task_struct to query.
-</DL>
-
-<P>
-
-<I>sig</I>
-<DL COMPACT><DT><DD>
-the signal number to test.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ISDIGIT</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ISDIGIT</H1>
-Section: A collection of standard strin (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::isdigit - Checks for a digit
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- isdigit:long(str:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>str</I>
-<DL COMPACT><DT><DD>
-string to check
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Checks for a digit (0 through 9) as the first character of a string. Returns non-zero if true, and a zero if false.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ISINSTR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ISINSTR</H1>
-Section: A collection of standard strin (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::isinstr - Returns whether a string is a substring of another string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- isinstr:long(s1:string,s2:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>s1</I>
-<DL COMPACT><DT><DD>
-string to search in
-</DL>
-
-<P>
-
-<I>s2</I>
-<DL COMPACT><DT><DD>
-substring to find
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns 1 if string
-<I>s1</I>
-contains
-<I>s2</I>, otherwise zero.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::JIFFIES</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::JIFFIES</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::jiffies - Kernel jiffies count
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- jiffies:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the value of the kernel jiffies variable. This value is incremented periodically by timer interrupts, and may wrap around a 32-bit or 64-bit boundary. See
-<B>HZ</B>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::KERNEL_CHA</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::KERNEL_CHA</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::kernel_char - Retrieves a char value stored in kernel memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- kernel_char:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to retrieve the char from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the char value from a given kernel memory address. Reports an error when reading from the given address fails.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::KERNEL_INT</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::KERNEL_INT</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::kernel_int - Retrieves an int value stored in kernel memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- kernel_int:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to retrieve the int from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the int value from a given kernel memory address. Reports an error when reading from the given address fails.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::KERNEL_LON</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::KERNEL_LON</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::kernel_long - Retrieves a long value stored in kernel memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- kernel_long:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to retrieve the long from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the long value from a given kernel memory address. Reports an error when reading from the given address fails.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::KERNEL_POI</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::KERNEL_POI</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::kernel_pointer - Retrieves a pointer value stored in kernel memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- kernel_pointer:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to retrieve the pointer from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the pointer value from a given kernel memory address. Reports an error when reading from the given address fails.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::KERNEL_SHO</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::KERNEL_SHO</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::kernel_short - Retrieves a short value stored in kernel memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- kernel_short:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to retrieve the short from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the short value from a given kernel memory address. Reports an error when reading from the given address fails.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::KERNEL_STR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::KERNEL_STR</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::kernel_string - Retrieves string from kernel memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- kernel_string:string(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to retrieve the string from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the null terminated C string from a given kernel memory address. Reports an error on string copy fault.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::KERNEL_STR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::KERNEL_STR</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::kernel_string2 - Retrieves string from kernel memory with alternative error string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- kernel_string2:string(addr:long,err_msg:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to retrieve the string from
-</DL>
-
-<P>
-
-<I>err_msg</I>
-<DL COMPACT><DT><DD>
-The error message to return when data isn't available
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the null terminated C string from a given kernel memory address. Reports the given error message on string copy fault.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::KERNEL_STR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::KERNEL_STR</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::kernel_string2_utf16 - Retrieves UTF-16 string from kernel memory with alternative error string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- kernel_string2_utf16:string(addr:long,err_msg:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to retrieve the string from
-</DL>
-
-<P>
-
-<I>err_msg</I>
-<DL COMPACT><DT><DD>
-The error message to return when data isn't available
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a null terminated UTF-8 string converted from the UTF-16 string at a given kernel memory address. Reports the given error message on string copy fault or conversion error.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::KERNEL_STR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::KERNEL_STR</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::kernel_string2_utf32 - Retrieves UTF-32 string from kernel memory with alternative error string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- kernel_string2_utf32:string(addr:long,err_msg:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to retrieve the string from
-</DL>
-
-<P>
-
-<I>err_msg</I>
-<DL COMPACT><DT><DD>
-The error message to return when data isn't available
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a null terminated UTF-8 string converted from the UTF-32 string at a given kernel memory address. Reports the given error message on string copy fault or conversion error.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::KERNEL_STR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::KERNEL_STR</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::kernel_string_n - Retrieves string of given length from kernel memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- kernel_string_n:string(addr:long,n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to retrieve the string from
-</DL>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-The maximum length of the string (if not null terminated)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the C string of a maximum given length from a given kernel memory address. Reports an error on string copy fault.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::KERNEL_STR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::KERNEL_STR</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::kernel_string_utf16 - Retrieves UTF-16 string from kernel memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- kernel_string_utf16:string(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to retrieve the string from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a null terminated UTF-8 string converted from the UTF-16 string at a given kernel memory address. Reports an error on string copy fault or conversion error.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::KERNEL_STR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::KERNEL_STR</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::kernel_string_utf32 - Retrieves UTF-32 string from kernel memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- kernel_string_utf32:string(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to retrieve the string from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a null terminated UTF-8 string converted from the UTF-32 string at a given kernel memory address. Reports an error on string copy fault or conversion error.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::LINUXMIB_F</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::LINUXMIB_F</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::linuxmib_filter_key - Default filter function for linuxmib.* probes
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- linuxmib_filter_key:long(sk:long,op:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sock
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be counted if
-<I>sk</I>
-passes the filter
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function is a default filter function. The user can replace this function with their own. The user-supplied filter function returns an index key based on the values in
-<I>sk</I>. A return value of 0 means this particular
-<I>sk</I>
-should be not be counted.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::LOCAL_CLOC</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::LOCAL_CLOC</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::local_clock_ms - Number of milliseconds on the local cpu's clock
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- local_clock_ms:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the number of milliseconds on the local cpu's clock. This is always monotonic comparing on the same cpu, but may have some drift between cpus (within about a jiffy).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::LOCAL_CLOC</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::LOCAL_CLOC</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::local_clock_ns - Number of nanoseconds on the local cpu's clock
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- local_clock_ns:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the number of nanoseconds on the local cpu's clock. This is always monotonic comparing on the same cpu, but may have some drift between cpus (within about a jiffy).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::LOCAL_CLOC</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::LOCAL_CLOC</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::local_clock_s - Number of seconds on the local cpu's clock
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- local_clock_s:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the number of seconds on the local cpu's clock. This is always monotonic comparing on the same cpu, but may have some drift between cpus (within about a jiffy).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::LOCAL_CLOC</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::LOCAL_CLOC</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::local_clock_us - Number of microseconds on the local cpu's clock
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- local_clock_us:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the number of microseconds on the local cpu's clock. This is always monotonic comparing on the same cpu, but may have some drift between cpus (within about a jiffy).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::LOG</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::LOG</H1>
-Section: Logging Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::log - Send a line to the common trace buffer
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- log(msg:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>msg</I>
-<DL COMPACT><DT><DD>
-The formatted message string
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function logs data. log sends the message immediately to staprun and to the bulk transport (relayfs) if it is being used. If the last character given is not a newline, then one is added. This function is not as efficient as printf and should be used only for urgent messages.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::LONG_ARG</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::LONG_ARG</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::long_arg - Return function argument as signed long
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- long_arg:long(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-index of argument to return
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Return the value of argument n as a signed long. On architectures where a long is 32 bits, the value is sign-extended to 64 bits.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::LONGLONG_A</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::LONGLONG_A</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::longlong_arg - Return function argument as 64-bit value
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- longlong_arg:long(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-index of argument to return
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Return the value of argument n as a 64-bit value.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::MDELAY</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::MDELAY</H1>
-Section: Guru tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::mdelay - millisecond delay
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- mdelay(ms:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>ms</I>
-<DL COMPACT><DT><DD>
-Number of milliseconds to delay.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function inserts a multi-millisecond busy-delay into a probe handler. It requires guru mode.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::MEM_PAGE_S</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::MEM_PAGE_S</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::mem_page_size - Number of bytes in a page for this architecture
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- mem_page_size:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::MODNAME</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::MODNAME</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::modname - Return the kernel module name loaded at the address
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- modname:string(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The address to map to a kernel module name
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the module name associated with the given address if known. If not known it will raise an error. If the address was not in a kernel module, but in the kernel itself, then the string
-"kernel"
-will be returned.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::MODULE_NAM</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::MODULE_NAM</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::module_name - The module name of the current script
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- module_name:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the name of the stap module. Either generated randomly (stap_[0-9a-f]+_[0-9a-f]+) or set by stap -m <module_name>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::MSECS_TO_S</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::MSECS_TO_S</H1>
-Section: Task Time Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::msecs_to_string - Human readable string for given milliseconds
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- msecs_to_string:string(msecs:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>msecs</I>
-<DL COMPACT><DT><DD>
-Number of milliseconds to translate.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns a string representing the number of milliseconds as a human readable string consisting of
-"XmY.ZZZs", where X is the number of minutes, Y is the number of seconds and ZZZ is the number of milliseconds.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::NFSDERROR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::NFSDERROR</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::nfsderror - Convert nfsd error number into string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- nfsderror:string(err:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>err</I>
-<DL COMPACT><DT><DD>
-errnum
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a string for the error number passed into the function.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::NSECS_TO_S</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::NSECS_TO_S</H1>
-Section: Task Time Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::nsecs_to_string - Human readable string for given nanoseconds
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- nsecs_to_string:string(nsecs:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>nsecs</I>
-<DL COMPACT><DT><DD>
-Number of nanoseconds to translate.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns a string representing the number of nanoseconds as a human readable string consisting of
-"XmY.ZZZZZZs", where X is the number of minutes, Y is the number of seconds and ZZZZZZZZZ is the number of nanoseconds.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::NTOHL</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::NTOHL</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ntohl - Convert 32-bit long from network to host order
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ntohl:long(x:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>x</I>
-<DL COMPACT><DT><DD>
-Value to convert
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::NTOHLL</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::NTOHLL</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ntohll - Convert 64-bit long long from network to host order
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ntohll:long(x:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>x</I>
-<DL COMPACT><DT><DD>
-Value to convert
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::NTOHS</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::NTOHS</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ntohs - Convert 16-bit short from network to host order
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ntohs:long(x:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>x</I>
-<DL COMPACT><DT><DD>
-Value to convert
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PAGES_TO_S</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PAGES_TO_S</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::pages_to_string - Turns pages into a human readable string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- pages_to_string:string(pages:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>pages</I>
-<DL COMPACT><DT><DD>
-Number of pages to translate.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Multiplies pages by
-<B>page_size</B>
-to get the number of bytes and returns the result of
-<B>bytes_to_string</B>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PANIC</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PANIC</H1>
-Section: Guru tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::panic - trigger a panic
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- panic(msg:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>msg</I>
-<DL COMPACT><DT><DD>
-message to pass to kernel's
-<B>panic</B>
-function
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function triggers an immediate panic of the running kernel with a user-specified panic message. It requires guru mode.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PEXECNAME</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PEXECNAME</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::pexecname - Returns the execname of a target process's parent process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- pexecname:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the execname of a target process's parent procces.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PGRP</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PGRP</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::pgrp - Returns the process group ID of the current process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- pgrp:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the process group ID of the current process.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PID</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PID</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::pid - Returns the ID of a target process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- pid:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the ID of a target process.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PID2EXECNA</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PID2EXECNA</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::pid2execname - The name of the given process identifier
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- pid2execname:string(pid:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>pid</I>
-<DL COMPACT><DT><DD>
-process identifier
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Return the name of the given process id.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PID2TASK</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PID2TASK</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::pid2task - The task_struct of the given process identifier
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- pid2task:long(pid:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>pid</I>
-<DL COMPACT><DT><DD>
-process identifier
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Return the task struct of the given process id.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PN</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::pn - Returns the active probe name
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- pn:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the script-level probe point associated with a currently running probe handler, including wild-card expansion effects. Context: The current probe point.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PNLABEL</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PNLABEL</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::pnlabel - Returns the label name parsed from the probe name
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- pnlabel:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This returns the label name as parsed from the script-level probe point. This function will only work if called directly from the body of a '.label' probe point (i.e. no aliases).
-<A NAME="lbAF"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The current probe point.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAF">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::POINTER_AR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::POINTER_AR</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::pointer_arg - Return function argument as pointer value
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- pointer_arg:long(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-index of argument to return
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Return the unsigned value of argument n, same as ulong_arg. Can be used with any type of pointer.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PP</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PP</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::pp - Returns the active probe point
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- pp:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the fully-resolved probe point associated with a currently running probe handler, including alias and wild-card expansion effects. Context: The current probe point.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PPFUNC</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PPFUNC</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ppfunc - Returns the function name parsed from <B>pp</B>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ppfunc:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This returns the function name from the current
-<B>pp</B>. Not all
-<B>pp</B>
-have functions in them, in which case "" is returned.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PPID</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PPID</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ppid - Returns the process ID of a target process's parent process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ppid:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function return the process ID of the target proccess's parent process.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PRINT_BACK</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PRINT_BACK</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::print_backtrace - Print kernel stack back trace
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- print_backtrace()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function is equivalent to print_stack(<B>backtrace</B>), except that deeper stack nesting may be supported. See print_ubacktrace for user-space backtrace. The function does not return a value.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PRINT_REGS</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PRINT_REGS</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::print_regs - Print a register dump
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- print_regs()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function prints a register dump. Does nothing if no registers are available for the probe point.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PRINT_STAC</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PRINT_STAC</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::print_stack - Print out kernel stack from string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- print_stack(stk:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>stk</I>
-<DL COMPACT><DT><DD>
-String with list of hexadecimal addresses
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function performs a symbolic lookup of the addresses in the given string, which is assumed to be the result of a prior call to
-<B>backtrace</B>.
-<P>
-
-Print one line per address, including the address, the name of the function containing the address, and an estimate of its position within that function. Return nothing.
-<A NAME="lbAF"> </A>
-<H2>NOTE</H2>
-
-<P>
-
-it is recommended to use
-<B>print_syms</B>
-instead of this function.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAF">NOTE</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PRINT_SYMS</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PRINT_SYMS</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::print_syms - Print out kernel stack from string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- print_syms(callers:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>callers</I>
-<DL COMPACT><DT><DD>
-String with list of hexadecimal (kernel) addresses
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function performs a symbolic lookup of the addresses in the given string, which are assumed to be the result of prior calls to
-<B>stack</B>,
-<B>callers</B>, and similar functions.
-<P>
-
-Prints one line per address, including the address, the name of the function containing the address, and an estimate of its position within that function, as obtained by
-<B>symdata</B>. Returns nothing.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PRINT_UBAC</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PRINT_UBAC</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::print_ubacktrace - Print stack back trace for current user-space task.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- print_ubacktrace()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-Equivalent to print_ustack(<B>ubacktrace</B>), except that deeper stack nesting may be supported. Returns nothing. See
-<B>print_backtrace</B>
-for kernel backtrace.
-<A NAME="lbAF"> </A>
-<H2>NOTE</H2>
-
-<P>
-
-To get (full) backtraces for user space applications and shared shared libraries not mentioned in the current script run stap with -d /path/to/exe-or-so and/or add --ldd to load all needed unwind data.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAF">NOTE</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PRINT_UBAC</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PRINT_UBAC</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::print_ubacktrace_brief - Print stack back trace for current user-space task.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- print_ubacktrace_brief()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-Equivalent to
-<B>print_ubacktrace</B>, but output for each symbol is shorter (just name and offset, or just the hex address of no symbol could be found).
-<A NAME="lbAF"> </A>
-<H2>NOTE</H2>
-
-<P>
-
-To get (full) backtraces for user space applications and shared shared libraries not mentioned in the current script run stap with -d /path/to/exe-or-so and/or add --ldd to load all needed unwind data.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAF">NOTE</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PRINT_USTA</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PRINT_USTA</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::print_ustack - Print out stack for the current task from string.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- print_ustack(stk:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>stk</I>
-<DL COMPACT><DT><DD>
-String with list of hexadecimal addresses for the current task.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Perform a symbolic lookup of the addresses in the given string, which is assumed to be the result of a prior call to
-<B>ubacktrace</B>
-for the current task.
-<P>
-
-Print one line per address, including the address, the name of the function containing the address, and an estimate of its position within that function. Return nothing.
-<A NAME="lbAF"> </A>
-<H2>NOTE</H2>
-
-<P>
-
-it is recommended to use
-<B>print_usyms</B>
-instead of this function.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAF">NOTE</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PRINT_USYM</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PRINT_USYM</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::print_usyms - Print out user stack from string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- print_usyms(callers:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>callers</I>
-<DL COMPACT><DT><DD>
-String with list of hexadecimal (user) addresses
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function performs a symbolic lookup of the addresses in the given string, which are assumed to be the result of prior calls to
-<B>ustack</B>,
-<B>ucallers</B>, and similar functions.
-<P>
-
-Prints one line per address, including the address, the name of the function containing the address, and an estimate of its position within that function, as obtained by
-<B>usymdata</B>. Returns nothing.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PRINTK</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PRINTK</H1>
-Section: Logging Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::printk - Send a message to the kernel trace buffer
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- printk(level:long,msg:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>level</I>
-<DL COMPACT><DT><DD>
-an integer for the severity level (0=KERN_EMERG ... 7=KERN_DEBUG)
-</DL>
-
-<P>
-
-<I>msg</I>
-<DL COMPACT><DT><DD>
-The formatted message string
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Print a line of text to the kernel dmesg/console with the given severity. An implicit end-of-line is added. This function may not be safely called from all kernel probe contexts, so is restricted to guru mode only.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PROBE_TYPE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PROBE_TYPE</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::probe_type - The low level probe handler type of the current probe.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- probe_type:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns a short string describing the low level probe handler type for the current probe point. This is for informational purposes only. Depending on the low level probe handler different context functions can or cannot provide information about the current event (for example some probe handlers only trigger in user space and have no associated kernel context). High-level probes might map to the same or different low-level probes (depending on systemtap version and/or kernel used).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PROBEFUNC</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PROBEFUNC</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::probefunc - Return the probe point's function name, if known
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- probefunc:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the name of the function being probed based on the current address, as computed by symname(<B>addr</B>) or usymname(<B>uaddr</B>) depending on probe context (whether the probe is a user probe or a kernel probe).
-<A NAME="lbAF"> </A>
-<H2>PLEASE NOTE</H2>
-
-<P>
-
-this function's behaviour differs between SystemTap 2.0 and earlier versions. Prior to 2.0,
-<B>probefunc</B>
-obtained the function name from the probe point string as returned by
-<B>pp</B>, and used the current address as a fallback.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAF">PLEASE NOTE</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PROBEMOD</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PROBEMOD</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::probemod - Return the probe point's kernel module name
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- probemod:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the name of the kernel module containing the probe point, if known.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PROC_MEM_D</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PROC_MEM_D</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::proc_mem_data - Program data size (data + stack) in pages
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- proc_mem_data:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the current process data size (data + stack) in pages, or zero when there is no current process or the number of pages couldn't be retrieved.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PROC_MEM_D</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PROC_MEM_D</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::proc_mem_data_pid - Program data size (data + stack) in pages
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- proc_mem_data_pid:long(pid:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>pid</I>
-<DL COMPACT><DT><DD>
-The pid of process to examine
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the given process data size (data + stack) in pages, or zero when the process doesn't exist or the number of pages couldn't be retrieved.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PROC_MEM_R</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PROC_MEM_R</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::proc_mem_rss - Program resident set size in pages
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- proc_mem_rss:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the resident set size in pages of the current process, or zero when there is no current process or the number of pages couldn't be retrieved.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PROC_MEM_R</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PROC_MEM_R</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::proc_mem_rss_pid - Program resident set size in pages
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- proc_mem_rss_pid:long(pid:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>pid</I>
-<DL COMPACT><DT><DD>
-The pid of process to examine
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the resident set size in pages of the given process, or zero when the process doesn't exist or the number of pages couldn't be retrieved.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PROC_MEM_S</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PROC_MEM_S</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::proc_mem_shr - Program shared pages (from shared mappings)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- proc_mem_shr:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the shared pages (from shared mappings) of the current process, or zero when there is no current process or the number of pages couldn't be retrieved.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PROC_MEM_S</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PROC_MEM_S</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::proc_mem_shr_pid - Program shared pages (from shared mappings)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- proc_mem_shr_pid:long(pid:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>pid</I>
-<DL COMPACT><DT><DD>
-The pid of process to examine
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the shared pages (from shared mappings) of the given process, or zero when the process doesn't exist or the number of pages couldn't be retrieved.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PROC_MEM_S</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PROC_MEM_S</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::proc_mem_size - Total program virtual memory size in pages
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- proc_mem_size:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the total virtual memory size in pages of the current process, or zero when there is no current process or the number of pages couldn't be retrieved.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PROC_MEM_S</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PROC_MEM_S</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::proc_mem_size_pid - Total program virtual memory size in pages
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- proc_mem_size_pid:long(pid:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>pid</I>
-<DL COMPACT><DT><DD>
-The pid of process to examine
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the total virtual memory size in pages of the given process, or zero when that process doesn't exist or the number of pages couldn't be retrieved.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PROC_MEM_S</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PROC_MEM_S</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::proc_mem_string - Human readable string of current proc memory usage
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- proc_mem_string:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns a human readable string showing the size, rss, shr, txt and data of the memory used by the current process. For example
-"size: 301m, rss: 11m, shr: 8m, txt: 52k, data: 2248k".
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PROC_MEM_S</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PROC_MEM_S</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::proc_mem_string_pid - Human readable string of process memory usage
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- proc_mem_string_pid:string(pid:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>pid</I>
-<DL COMPACT><DT><DD>
-The pid of process to examine
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns a human readable string showing the size, rss, shr, txt and data of the memory used by the given process. For example
-"size: 301m, rss: 11m, shr: 8m, txt: 52k, data: 2248k".
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PROC_MEM_T</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PROC_MEM_T</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::proc_mem_txt - Program text (code) size in pages
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- proc_mem_txt:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the current process text (code) size in pages, or zero when there is no current process or the number of pages couldn't be retrieved.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PROC_MEM_T</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PROC_MEM_T</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::proc_mem_txt_pid - Program text (code) size in pages
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- proc_mem_txt_pid:long(pid:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>pid</I>
-<DL COMPACT><DT><DD>
-The pid of process to examine
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the given process text (code) size in pages, or zero when the process doesn't exist or the number of pages couldn't be retrieved.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::PSTRACE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::PSTRACE</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::pstrace - Chain of processes and pids back to <A HREF="init.1.html">init</A>(1)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- pstrace:string(task:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-Pointer to task struct of process
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a string listing execname and pid for each process starting from
-<I>task</I>
-back to the process ancestor that <A HREF="init.1.html">init</A>(1) spawned.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::QS_DONE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::QS_DONE</H1>
-Section: Queue Statistics Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::qs_done - Function to record finishing request
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- qs_done(qname:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>qname</I>
-<DL COMPACT><DT><DD>
-the name of the service that finished
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function records that a request originally from the given queue has completed being serviced.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::QS_RUN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::QS_RUN</H1>
-Section: Queue Statistics Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::qs_run - Function to record being moved from wait queue to being serviced
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- qs_run(qname:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>qname</I>
-<DL COMPACT><DT><DD>
-the name of the service being moved and started
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function records that the previous enqueued request was removed from the given wait queue and is now being serviced.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::QS_WAIT</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::QS_WAIT</H1>
-Section: Queue Statistics Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::qs_wait - Function to record enqueue requests
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- qs_wait(qname:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>qname</I>
-<DL COMPACT><DT><DD>
-the name of the queue requesting enqueue
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function records that a new request was enqueued for the given queue name.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::QSQ_BLOCKE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::QSQ_BLOCKE</H1>
-Section: Queue Statistics Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::qsq_blocked - Returns the time reqest was on the wait queue
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- qsq_blocked:long(qname:string,scale:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>qname</I>
-<DL COMPACT><DT><DD>
-queue name
-</DL>
-
-<P>
-
-<I>scale</I>
-<DL COMPACT><DT><DD>
-scale variable to take account for interval fraction
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the fraction of elapsed time during which one or more requests were on the wait queue.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::QSQ_PRINT</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::QSQ_PRINT</H1>
-Section: Queue Statistics Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::qsq_print - Prints a line of statistics for the given queue
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- qsq_print(qname:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>qname</I>
-<DL COMPACT><DT><DD>
-queue name
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function prints a line containing the following
-<A NAME="lbAF"> </A>
-<H2>STATISTICS FOR THE GIVEN QUEUE</H2>
-
-<P>
-
-the queue name, the average rate of requests per second, the average wait queue length, the average time on the wait queue, the average time to service a request, the percentage of time the wait queue was used, and the percentage of time request was being serviced.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAF">STATISTICS FOR THE GIVEN QUEUE</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::QSQ_SERVIC</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::QSQ_SERVIC</H1>
-Section: Queue Statistics Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::qsq_service_time - Amount of time per request service
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- qsq_service_time:long(qname:string,scale:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>qname</I>
-<DL COMPACT><DT><DD>
-queue name
-</DL>
-
-<P>
-
-<I>scale</I>
-<DL COMPACT><DT><DD>
-scale variable to take account for interval fraction
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the average time in microseconds required to service a request once it is removed from the wait queue.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::QSQ_START</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::QSQ_START</H1>
-Section: Queue Statistics Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::qsq_start - Function to reset the stats for a queue
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- qsq_start(qname:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>qname</I>
-<DL COMPACT><DT><DD>
-the name of the service that finished
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function resets the statistics counters for the given queue, and restarts tracking from the moment the function was called. This function is also used to create intialize a queue.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::QSQ_THROUG</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::QSQ_THROUG</H1>
-Section: Queue Statistics Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::qsq_throughput - Number of requests served per unit time
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- qsq_throughput:long(qname:string,scale:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>qname</I>
-<DL COMPACT><DT><DD>
-queue name
-</DL>
-
-<P>
-
-<I>scale</I>
-<DL COMPACT><DT><DD>
-scale variable to take account for interval fraction
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the average number or requests served per microsecond.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::QSQ_UTILIZ</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::QSQ_UTILIZ</H1>
-Section: Queue Statistics Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::qsq_utilization - Fraction of time that any request was being serviced
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- qsq_utilization:long(qname:string,scale:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>qname</I>
-<DL COMPACT><DT><DD>
-queue name
-</DL>
-
-<P>
-
-<I>scale</I>
-<DL COMPACT><DT><DD>
-scale variable to take account for interval fraction
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the average time in microseconds that at least one request was being serviced.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::QSQ_WAIT_Q</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::QSQ_WAIT_Q</H1>
-Section: Queue Statistics Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::qsq_wait_queue_length - length of wait queue
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- qsq_wait_queue_length:long(qname:string,scale:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>qname</I>
-<DL COMPACT><DT><DD>
-queue name
-</DL>
-
-<P>
-
-<I>scale</I>
-<DL COMPACT><DT><DD>
-scale variable to take account for interval fraction
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the average length of the wait queue
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::QSQ_WAIT_T</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::QSQ_WAIT_T</H1>
-Section: Queue Statistics Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::qsq_wait_time - Amount of time in queue + service per request
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- qsq_wait_time:long(qname:string,scale:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>qname</I>
-<DL COMPACT><DT><DD>
-queue name
-</DL>
-
-<P>
-
-<I>scale</I>
-<DL COMPACT><DT><DD>
-scale variable to take account for interval fraction
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the average time in microseconds that it took for a request to be serviced (<B>qs_wait</B>
-to
-<B>qa_done</B>).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::RAISE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::RAISE</H1>
-Section: Guru tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::raise - raise a signal in the current thread
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- raise(signo:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>signo</I>
-<DL COMPACT><DT><DD>
-signal number
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function calls the kernel send_sig routine on the current thread, with the given raw unchecked signal number. It may raise an error if
-<B>send_sig</B>
-failed. It requires guru mode.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::RANDINT</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::RANDINT</H1>
-Section: Random functions Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::randint - Return a random number between [0,n)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- randint:long(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-Number past upper limit of range, not larger than 2**20.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::READ_STOPW</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::READ_STOPW</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::read_stopwatch_ms - Reads the time in milliseconds for a stopwatch
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- read_stopwatch_ms:long(name:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-stopwatch name
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns time in milliseconds for stopwatch
-<I>name</I>. Creates stopwatch
-<I>name</I>
-if it does not currently exist.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::READ_STOPW</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::READ_STOPW</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::read_stopwatch_ns - Reads the time in nanoseconds for a stopwatch
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- read_stopwatch_ns:long(name:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-stopwatch name
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns time in nanoseconds for stopwatch
-<I>name</I>. Creates stopwatch
-<I>name</I>
-if it does not currently exist.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::READ_STOPW</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::READ_STOPW</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::read_stopwatch_s - Reads the time in seconds for a stopwatch
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- read_stopwatch_s:long(name:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-stopwatch name
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns time in seconds for stopwatch
-<I>name</I>. Creates stopwatch
-<I>name</I>
-if it does not currently exist.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::READ_STOPW</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::READ_STOPW</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::read_stopwatch_us - Reads the time in microseconds for a stopwatch
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- read_stopwatch_us:long(name:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-stopwatch name
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns time in microseconds for stopwatch
-<I>name</I>. Creates stopwatch
-<I>name</I>
-if it does not currently exist.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::REAL_MOUNT</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::REAL_MOUNT</H1>
-Section: Directory-entry (dentry) Tapse (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::real_mount - get the 'struct mount' pointer
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- real_mount:long(vfsmnt:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>vfsmnt</I>
-<DL COMPACT><DT><DD>
-Pointer to 'struct vfsmount'
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-Returns the 'struct mount' pointer value for a 'struct vfsmount' pointer.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::REGISTER</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::REGISTER</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::register - Return the signed value of the named CPU register
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- register:long(name:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the register to return
-</DL>
-
-<A NAME="lbAE"> </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>
-
-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>
-
-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>
-
-For powerpc, the following names are recognized: r0, r1, ... r31, nip, msr, orig_gpr3, ctr, link, xer, ccr, softe, trap, dar, dsisr, result.
-<P>
-
-For s390x, the following names are recognized: r0, r1, ... r15, args, psw.mask, psw.addr, orig_gpr2, ilc, trap.
-<P>
-
-For AArch64, the following names are recognized: x0, x1, ... x30, fp, lr, sp, pc, and orig_x0.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::REGISTERS_</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::REGISTERS_</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::registers_valid - Determines validity of <B>register</B> and <B>u_register</B> in current context
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- registers_valid:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns 1 if
-<B>register</B>
-and
-<B>u_register</B>
-can be used in the current context, or 0 otherwise. For example,
-<B>registers_valid</B>
-returns 0 when called from a begin or end probe.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::REGPARM</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::REGPARM</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::regparm - Specify regparm value used to compile function
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- regparm(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-original regparm value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Call this function with argument n before accessing function arguments using the *_arg function is the function was build with the gcc -mregparm=n option.
-<P>
-
-(The i386 kernel is built with -mregparm=3, so systemtap considers <A HREF="regparm.3.html">regparm</A>(3) the default for kernel functions on that architecture.) Only valid on i386 and x86_64 (when probing 32bit applications). Produces an error on other architectures.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::REMOTE_ID</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::REMOTE_ID</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::remote_id - The index of this instance in a remote execution.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- remote_id:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a number 0..N, which is the unique index of this particular script execution from a swarm of
-"stap --remote A --remote B ..."
-runs, and is the same number
-"stap --remote-prefix"
-would print. The function returns -1 if the script was not launched with
-"stap --remote", or if the remote staprun/stapsh are older than version 1.7.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::REMOTE_URI</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::REMOTE_URI</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::remote_uri - The name of this instance in a remote execution.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- remote_uri:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the remote host used to invoke this particular script execution from a swarm of
-"stap --remote"
-runs. It may not be unique among the swarm. The function returns an empty string if the script was not launched with
-"stap --remote".
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::RETURN_STR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::RETURN_STR</H1>
-Section: Errno Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::return_str - Formats the return value as a string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- return_str:string(format:long,ret:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>format</I>
-<DL COMPACT><DT><DD>
-Variable to determine return type base value
-</DL>
-
-<P>
-
-<I>ret</I>
-<DL COMPACT><DT><DD>
-Return value (typically
-<B>$return</B>)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function is used by the syscall tapset, and returns a string. Set format equal to 1 for a decimal, 2 for hex, 3 for octal.
-<P>
-
-Note that this function is preferred over
-<B>returnstr</B>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::RETURNSTR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::RETURNSTR</H1>
-Section: Errno Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::returnstr - Formats the return value as a string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- returnstr:string(format:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>format</I>
-<DL COMPACT><DT><DD>
-Variable to determine return type base value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function is used by the nd_syscall tapset, and returns a string. Set format equal to 1 for a decimal, 2 for hex, 3 for octal.
-<P>
-
-Note that this function should only be used in dwarfless probes (i.e. 'kprobe.function("foo")'). Other probes should use
-<B>return_str</B>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::RETURNVAL</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::RETURNVAL</H1>
-Section: Errno Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::returnval - Possible return value of probed function
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- returnval:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Return the value of the register in which function values are typically returned. Can be used in probes where
-<B>$return</B>
-isn't available. This is only a guess of the actual return value and can be totally wrong. Normally only used in dwarfless probes.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::REVERSE_PA</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::REVERSE_PA</H1>
-Section: Directory-entry (dentry) Tapse (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::reverse_path_walk - get the full dirent path
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- reverse_path_walk:string(dentry:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>dentry</I>
-<DL COMPACT><DT><DD>
-Pointer to dentry.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-Returns the path name (partial path to mount point).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::S32_ARG</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::S32_ARG</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::s32_arg - Return function argument as signed 32-bit value
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- s32_arg:long(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-index of argument to return
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Return the signed 32-bit value of argument n, same as int_arg.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::S64_ARG</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::S64_ARG</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::s64_arg - Return function argument as signed 64-bit value
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- s64_arg:long(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-index of argument to return
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Return the signed 64-bit value of argument n, same as longlong_arg.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SA_FLAGS_S</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SA_FLAGS_S</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::sa_flags_str - Returns the string representation of sa_flags
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- sa_flags_str:string(sa_flags:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>sa_flags</I>
-<DL COMPACT><DT><DD>
-the set of flags to convert to string.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SA_HANDLER</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SA_HANDLER</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::sa_handler_str - Returns the string representation of an sa_handler
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- sa_handler_str(handler:)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>handler</I>
-<DL COMPACT><DT><DD>
-the sa_handler to convert to string.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the string representation of an sa_handler. If it is not SIG_DFL, SIG_IGN or SIG_ERR, it will return the address of the handler.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SET_KERNEL</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SET_KERNEL</H1>
-Section: String and data writing functi (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::set_kernel_char - Writes a char value to kernel memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- set_kernel_char(addr:long,val:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to write the char to
-</DL>
-
-<P>
-
-<I>val</I>
-<DL COMPACT><DT><DD>
-The char which is to be written
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Writes the char value to a given kernel memory address. Reports an error when writing to the given address fails. Requires the use of guru mode (-g).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SET_KERNEL</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SET_KERNEL</H1>
-Section: String and data writing functi (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::set_kernel_int - Writes an int value to kernel memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- set_kernel_int(addr:long,val:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to write the int to
-</DL>
-
-<P>
-
-<I>val</I>
-<DL COMPACT><DT><DD>
-The int which is to be written
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Writes the int value to a given kernel memory address. Reports an error when writing to the given address fails. Requires the use of guru mode (-g).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SET_KERNEL</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SET_KERNEL</H1>
-Section: String and data writing functi (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::set_kernel_long - Writes a long value to kernel memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- set_kernel_long(addr:long,val:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to write the long to
-</DL>
-
-<P>
-
-<I>val</I>
-<DL COMPACT><DT><DD>
-The long which is to be written
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Writes the long value to a given kernel memory address. Reports an error when writing to the given address fails. Requires the use of guru mode (-g).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SET_KERNEL</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SET_KERNEL</H1>
-Section: String and data writing functi (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::set_kernel_pointer - Writes a pointer value to kernel memory.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- set_kernel_pointer(addr:long,val:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to write the pointer to
-</DL>
-
-<P>
-
-<I>val</I>
-<DL COMPACT><DT><DD>
-The pointer which is to be written
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Writes the pointer value to a given kernel memory address. Reports an error when writing to the given address fails. Requires the use of guru mode (-g).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SET_KERNEL</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SET_KERNEL</H1>
-Section: String and data writing functi (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::set_kernel_short - Writes a short value to kernel memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- set_kernel_short(addr:long,val:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to write the short to
-</DL>
-
-<P>
-
-<I>val</I>
-<DL COMPACT><DT><DD>
-The short which is to be written
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Writes the short value to a given kernel memory address. Reports an error when writing to the given address fails. Requires the use of guru mode (-g).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SET_KERNEL</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SET_KERNEL</H1>
-Section: String and data writing functi (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::set_kernel_string - Writes a string to kernel memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- set_kernel_string(addr:long,val:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to write the string to
-</DL>
-
-<P>
-
-<I>val</I>
-<DL COMPACT><DT><DD>
-The string which is to be written
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Writes the given string to a given kernel memory address. Reports an error on string copy fault. Requires the use of guru mode (-g).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SET_KERNEL</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SET_KERNEL</H1>
-Section: String and data writing functi (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::set_kernel_string_n - Writes a string of given length to kernel memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- set_kernel_string_n(addr:long,n:long,val:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The kernel address to write the string to
-</DL>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-The maximum length of the string
-</DL>
-
-<P>
-
-<I>val</I>
-<DL COMPACT><DT><DD>
-The string which is to be written
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Writes the given string up to a maximum given length to a given kernel memory address. Reports an error on string copy fault. Requires the use of guru mode (-g).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SID</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SID</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::sid - Returns the session ID of the current process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- sid:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The session ID of a process is the process group ID of the session leader. Session ID is stored in the signal_struct since Kernel 2.6.0.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SIGNAL_STR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SIGNAL_STR</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::signal_str - Returns the string representation of a signal number
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- signal_str(num:)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>num</I>
-<DL COMPACT><DT><DD>
-the signal number to convert to string.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SIGSET_MAS</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SIGSET_MAS</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::sigset_mask_str - Returns the string representation of a sigset
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- sigset_mask_str:string(mask:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>mask</I>
-<DL COMPACT><DT><DD>
-the sigset to convert to string.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SOCK_FAM_N</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SOCK_FAM_N</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::sock_fam_num2str - Given a protocol family number, return a string representation
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- sock_fam_num2str:string(family:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-The family number
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SOCK_FAM_S</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SOCK_FAM_S</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::sock_fam_str2num - Given a protocol family name (string), return the corresponding protocol family number
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- sock_fam_str2num:long(family:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-The family name
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SOCK_PROT_</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SOCK_PROT_</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::sock_prot_num2str - Given a protocol number, return a string representation
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- sock_prot_num2str:string(proto:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>proto</I>
-<DL COMPACT><DT><DD>
-The protocol number
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SOCK_PROT_</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SOCK_PROT_</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::sock_prot_str2num - Given a protocol name (string), return the corresponding protocol number
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- sock_prot_str2num:long(proto:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>proto</I>
-<DL COMPACT><DT><DD>
-The protocol name
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SOCK_STATE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SOCK_STATE</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::sock_state_num2str - Given a socket state number, return a string representation
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- sock_state_num2str:string(state:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-The state number
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SOCK_STATE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SOCK_STATE</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::sock_state_str2num - Given a socket state string, return the corresponding state number
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- sock_state_str2num:long(state:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-The state name
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SPECULATE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SPECULATE</H1>
-Section: Speculation (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::speculate - Store a string for possible output later
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- speculate(id:long,output:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>id</I>
-<DL COMPACT><DT><DD>
-buffer id to store the information in
-</DL>
-
-<P>
-
-<I>output</I>
-<DL COMPACT><DT><DD>
-string to write out when commit occurs
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Add a string to the speculaive buffer for id.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SPECULATIO</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SPECULATIO</H1>
-Section: Speculation (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::speculation - Allocate a new id for speculative output
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- speculation:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-The
-<B>speculation</B>
-function is called when a new speculation buffer is needed. It returns an id for the speculative output. There can be multiple threads being speculated on concurrently. This id is used by other speculation functions to keep the threads separate.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SPRINT_BAC</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SPRINT_BAC</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::sprint_backtrace - Return stack back trace as string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- sprint_backtrace:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-Returns a simple (kernel) backtrace. One line per address. Includes the symbol name (or hex address if symbol couldn't be resolved) and module name (if found). Includes the offset from the start of the function if found, otherwise the offset will be added to the module (if found, between brackets). Returns the backtrace as string (each line terminated by a newline character). Note that the returned stack will be truncated to MAXSTRINGLEN, to print fuller and richer stacks use
-<B>print_backtrace</B>. Equivalent to sprint_stack(<B>backtrace</B>), but more efficient (no need to translate between hex strings and final backtrace string).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SPRINT_LOA</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SPRINT_LOA</H1>
-Section: Kernel Process Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::sprint_loadavg - Report a pretty-printed load average
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- sprint_loadavg:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the a string with three decimal numbers in the usual format for 1-, 5- and 15-minute load averages.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SPRINT_STA</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SPRINT_STA</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::sprint_stack - Return stack for kernel addresses from string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- sprint_stack:string(stk:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>stk</I>
-<DL COMPACT><DT><DD>
-String with list of hexadecimal (kernel) addresses
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Perform a symbolic lookup of the addresses in the given string, which is assumed to be the result of a prior call to
-<B>backtrace</B>.
-<P>
-
-Returns a simple backtrace from the given hex string. One line per address. Includes the symbol name (or hex address if symbol couldn't be resolved) and module name (if found). Includes the offset from the start of the function if found, otherwise the offset will be added to the module (if found, between brackets). Returns the backtrace as string (each line terminated by a newline character). Note that the returned stack will be truncated to MAXSTRINGLEN, to print fuller and richer stacks use print_stack.
-<A NAME="lbAF"> </A>
-<H2>NOTE</H2>
-
-<P>
-
-it is recommended to use
-<B>sprint_syms</B>
-instead of this function.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAF">NOTE</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SPRINT_SYM</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SPRINT_SYM</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::sprint_syms - Return stack for kernel addresses from string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- sprint_syms(callers:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>callers</I>
-<DL COMPACT><DT><DD>
-String with list of hexadecimal (kernel) addresses
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Perform a symbolic lookup of the addresses in the given string, which are assumed to be the result of a prior calls to
-<B>stack</B>,
-<B>callers</B>, and similar functions.
-<P>
-
-Returns a simple backtrace from the given hex string. One line per address. Includes the symbol name (or hex address if symbol couldn't be resolved) and module name (if found), as obtained from
-<B>symdata</B>. Includes the offset from the start of the function if found, otherwise the offset will be added to the module (if found, between brackets). Returns the backtrace as string (each line terminated by a newline character). Note that the returned stack will be truncated to MAXSTRINGLEN, to print fuller and richer stacks use
-<B>print_syms</B>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SPRINT_UBA</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SPRINT_UBA</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::sprint_ubacktrace - Return stack back trace for current user-space task as string.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- sprint_ubacktrace:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-Returns a simple backtrace for the current task. One line per address. Includes the symbol name (or hex address if symbol couldn't be resolved) and module name (if found). Includes the offset from the start of the function if found, otherwise the offset will be added to the module (if found, between brackets). Returns the backtrace as string (each line terminated by a newline character). Note that the returned stack will be truncated to MAXSTRINGLEN, to print fuller and richer stacks use
-<B>print_ubacktrace</B>. Equivalent to sprint_ustack(<B>ubacktrace</B>), but more efficient (no need to translate between hex strings and final backtrace string).
-<A NAME="lbAF"> </A>
-<H2>NOTE</H2>
-
-<P>
-
-To get (full) backtraces for user space applications and shared shared libraries not mentioned in the current script run stap with -d /path/to/exe-or-so and/or add --ldd to load all needed unwind data.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAF">NOTE</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SPRINT_UST</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SPRINT_UST</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::sprint_ustack - Return stack for the current task from string.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- sprint_ustack:string(stk:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>stk</I>
-<DL COMPACT><DT><DD>
-String with list of hexadecimal addresses for the current task.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Perform a symbolic lookup of the addresses in the given string, which is assumed to be the result of a prior call to
-<B>ubacktrace</B>
-for the current task.
-<P>
-
-Returns a simple backtrace from the given hex string. One line per address. Includes the symbol name (or hex address if symbol couldn't be resolved) and module name (if found). Includes the offset from the start of the function if found, otherwise the offset will be added to the module (if found, between brackets). Returns the backtrace as string (each line terminated by a newline character). Note that the returned stack will be truncated to MAXSTRINGLEN, to print fuller and richer stacks use print_ustack.
-<A NAME="lbAF"> </A>
-<H2>NOTE</H2>
-
-<P>
-
-it is recommended to use
-<B>sprint_usyms</B>
-instead of this function.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAF">NOTE</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SPRINT_USY</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SPRINT_USY</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::sprint_usyms - Return stack for user addresses from string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- sprint_usyms(callers:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>callers</I>
-<DL COMPACT><DT><DD>
-String with list of hexadecimal (user) addresses
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Perform a symbolic lookup of the addresses in the given string, which are assumed to be the result of a prior calls to
-<B>ustack</B>,
-<B>ucallers</B>, and similar functions.
-<P>
-
-Returns a simple backtrace from the given hex string. One line per address. Includes the symbol name (or hex address if symbol couldn't be resolved) and module name (if found), as obtained from
-<B>usymdata</B>. Includes the offset from the start of the function if found, otherwise the offset will be added to the module (if found, between brackets). Returns the backtrace as string (each line terminated by a newline character). Note that the returned stack will be truncated to MAXSTRINGLEN, to print fuller and richer stacks use
-<B>print_usyms</B>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::STACK</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::STACK</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::stack - Return address at given depth of kernel stack backtrace
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- stack:long(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-number of levels to descend in the stack.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Performs a simple (kernel) backtrace, and returns the element at the specified position. The results of the backtrace itself are cached, so that the backtrace computation is performed at most once no matter how many times
-<B>stack</B>
-is called, or in what order.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::STACK_SIZE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::STACK_SIZE</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::stack_size - Return the size of the kernel stack
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- stack_size:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the size of the kernel stack.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::STACK_UNUS</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::STACK_UNUS</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::stack_unused - Returns the amount of kernel stack currently available
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- stack_unused:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function determines how many bytes are currently available in the kernel stack.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::STACK_USED</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::STACK_USED</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::stack_used - Returns the amount of kernel stack used
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- stack_used:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function determines how many bytes are currently used in the kernel stack.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::START_STOP</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::START_STOP</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::start_stopwatch - Start a stopwatch
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- start_stopwatch(name:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-the stopwatch name
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Start stopwatch
-<I>name</I>. Creates stopwatch
-<I>name</I>
-if it does not currently exist.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::STOP_STOPW</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::STOP_STOPW</H1>
-Section: Timestamp Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::stop_stopwatch - Stop a stopwatch
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- stop_stopwatch(name:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-the stopwatch name
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Stop stopwatch
-<I>name</I>. Creates stopwatch
-<I>name</I>
-if it does not currently exist.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::STP_PID</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::STP_PID</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::stp_pid - The process id of the stapio process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- stp_pid:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the process id of the stapio process that launched this script. There could be other SystemTap scripts and stapio processes running on the system.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::STR_REPLAC</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::STR_REPLAC</H1>
-Section: A collection of standard strin (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::str_replace - str_replace Replaces all instances of a substring with another
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- str_replace:string(prnt_str:string,srch_str:string,rplc_str:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>prnt_str</I>
-<DL COMPACT><DT><DD>
-the string to search and replace in
-</DL>
-
-<P>
-
-<I>srch_str</I>
-<DL COMPACT><DT><DD>
-the substring which is used to search in
-<I>prnt_str</I>
-string
-</DL>
-
-<P>
-
-<I>rplc_str</I>
-<DL COMPACT><DT><DD>
-the substring which is used to replace
-<I>srch_str</I>
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the given string with substrings replaced.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::STRINGAT</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::STRINGAT</H1>
-Section: A collection of standard strin (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::stringat - Returns the char at a given position in the string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- stringat:long(str:string,pos:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>str</I>
-<DL COMPACT><DT><DD>
-the string to fetch the character from
-</DL>
-
-<P>
-
-<I>pos</I>
-<DL COMPACT><DT><DD>
-the position to get the character from (first character is 0)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the character at a given position in the string or zero if the string doesn't have as many characters. Reports an error if pos is out of bounds.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::STRLEN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::STRLEN</H1>
-Section: A collection of standard strin (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::strlen - Returns the length of a string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- strlen:long(s:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>s</I>
-<DL COMPACT><DT><DD>
-the string
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the length of the string, which can be zero up to MAXSTRINGLEN.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::STRTOL</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::STRTOL</H1>
-Section: A collection of standard strin (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::strtol - strtol - Convert a string to a long
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- strtol:long(str:string,base:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>str</I>
-<DL COMPACT><DT><DD>
-string to convert
-</DL>
-
-<P>
-
-<I>base</I>
-<DL COMPACT><DT><DD>
-the base to use
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function converts the string representation of a number to an integer. The
-<I>base</I>
-parameter indicates the number base to assume for the string (eg. 16 for hex, 8 for octal, 2 for binary).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SUBSTR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SUBSTR</H1>
-Section: A collection of standard strin (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::substr - Returns a substring
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- substr:string(str:string,start:long,length:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>str</I>
-<DL COMPACT><DT><DD>
-the string to take a substring from
-</DL>
-
-<P>
-
-<I>start</I>
-<DL COMPACT><DT><DD>
-starting position of the extracted string (first character is 0)
-</DL>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-length of string to return
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the substring of the given string at the given start position with the given length (or smaller if the length of the original string is less than start + length, or length is bigger than MAXSTRINGLEN).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SYMDATA</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SYMDATA</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::symdata - Return the kernel symbol and module offset for the address
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- symdata:string(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The address to translate
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the (function) symbol name associated with the given address if known, the offset from the start and size of the symbol, plus module name (between brackets). If symbol is unknown, but module is known, the offset inside the module, plus the size of the module is added. If any element is not known it will be omitted and if the symbol name is unknown it will return the hex string for the given address.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SYMNAME</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SYMNAME</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::symname - Return the kernel symbol associated with the given address
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- symname:string(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The address to translate
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the (function) symbol name associated with the given address if known. If not known it will return the hex string representation of addr.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::SYSTEM</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::SYSTEM</H1>
-Section: Shell command functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::system - Issue a command to the system
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- system(cmd:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>cmd</I>
-<DL COMPACT><DT><DD>
-the command to issue to the system
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function runs a command on the system. The command is started in the background some time after the current probe completes. The command is run with the same UID as the user running the stap or staprun command.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TARGET</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TARGET</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::target - Return the process ID of the target process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- target:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the process ID of the target process. This is useful in conjunction with the -x PID or -c CMD command-line options to stap. An example of its use is to create scripts that filter on a specific process.
-<P>
-
--x <pid>
-<B>target</B>
-returns the pid specified by -x
-<P>
-
--c <command>
-<B>target</B>
-returns the pid for the executed command specified by -c
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TARGET_SET</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TARGET_SET</H1>
-Section: Kernel Process Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::target_set_pid - Does pid descend from target process?
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- target_set_pid(pid:)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>pid</I>
-<DL COMPACT><DT><DD>
-The pid of the process to query
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns whether the given process-id is within the
-"target set", that is whether it is a descendant of the top-level
-<B>target</B>
-process.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TARGET_SET</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TARGET_SET</H1>
-Section: Kernel Process Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::target_set_report - Print a report about the target set
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- target_set_report()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function prints a report about the processes in the target set, and their ancestry.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_ANCES</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_ANCES</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_ancestry - The ancestry of the given task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_ancestry:string(task:long,with_time:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-task_struct pointer
-</DL>
-
-<P>
-
-<I>with_time</I>
-<DL COMPACT><DT><DD>
-set to 1 to also print the start time of processes (given as a delta from boot time)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Return the ancestry of the given task in the form of
-"grandparent_process=>parent_process=>process".
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_BACKT</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_BACKT</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_backtrace - Hex backtrace of an arbitrary task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_backtrace:string(task:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-pointer to task_struct
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a string of hex addresses that are a backtrace of the stack of a particular task Output may be truncated as per maximum string length. Deprecated in SystemTap 1.6.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_CPU</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_CPU</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_cpu - The scheduled cpu of the task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_cpu:long(task:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-task_struct pointer
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the scheduled cpu for the given task.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_CURRE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_CURRE</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_current - The current task_struct of the current task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_current:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the task_struct representing the current process. This address can be passed to the various task_*() functions to extract more task-specific data.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_DENTR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_DENTR</H1>
-Section: Directory-entry (dentry) Tapse (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_dentry_path - get the full dentry path
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_dentry_path:string(task:long,dentry:long,vfsmnt:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-task_struct pointer.
-</DL>
-
-<P>
-
-<I>dentry</I>
-<DL COMPACT><DT><DD>
-direntry pointer.
-</DL>
-
-<P>
-
-<I>vfsmnt</I>
-<DL COMPACT><DT><DD>
-vfsmnt pointer.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-Returns the full dirent name (full path to the root), like the kernel d_path function.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_EGID</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_EGID</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_egid - The effective group identifier of the task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_egid:long(task:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-task_struct pointer
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the effective group id of the given task.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_EUID</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_EUID</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_euid - The effective user identifier of the task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_euid:long(task:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-task_struct pointer
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the effective user id of the given task.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_EXECN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_EXECN</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_execname - The name of the task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_execname:string(task:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-task_struct pointer
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Return the name of the given task.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_GID</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_GID</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_gid - The group identifier of the task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_gid:long(task:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-task_struct pointer
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the group id of the given task.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_MAX_F</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_MAX_F</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_max_file_handles - The max number of open files for the task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_max_file_handles:long(task:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-task_struct pointer
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the maximum number of file handlers for the given task.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_NICE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_NICE</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_nice - The nice value of the task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_nice:long(task:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-task_struct pointer
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the nice value of the given task.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_OPEN_</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_OPEN_</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_open_file_handles - The number of open files of the task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_open_file_handles:long(task:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-task_struct pointer
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the number of open file handlers for the given task.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_PAREN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_PAREN</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_parent - The task_struct of the parent task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_parent:long(task:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-task_struct pointer
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the parent task_struct of the given task. This address can be passed to the various task_*() functions to extract more task-specific data.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_PID</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_PID</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_pid - The process identifier of the task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_pid:long(task:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-task_struct pointer
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This fucntion returns the process id of the given task.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_PRIO</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_PRIO</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_prio - The priority value of the task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_prio:long(task:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-task_struct pointer
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the priority value of the given task.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_START</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_START</H1>
-Section: Task Time Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_start_time - Start time of the given task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_start_time:long(tid:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>tid</I>
-<DL COMPACT><DT><DD>
-Thread id of the given task
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the start time of the given task in nanoseconds since boot time or 0 if the task does not exist.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_STATE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_STATE</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_state - The state of the task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_state:long(task:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-task_struct pointer
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Return the state of the given task, one of: TASK_RUNNING (0), TASK_INTERRUPTIBLE (1), TASK_UNINTERRUPTIBLE (2), TASK_STOPPED (4), TASK_TRACED (8), EXIT_ZOMBIE (16), or EXIT_DEAD (32).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_STIME</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_STIME</H1>
-Section: Task Time Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_stime - System time of the current task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_stime:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the system time of the current task in cputime. Does not include any time used by other tasks in this process, nor does it include any time of the children of this task.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_STIME</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_STIME</H1>
-Section: Task Time Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_stime_tid - System time of the given task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_stime_tid:long(tid:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>tid</I>
-<DL COMPACT><DT><DD>
-Thread id of the given task
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the system time of the given task in cputime, or zero if the task doesn't exist. Does not include any time used by other tasks in this process, nor does it include any time of the children of this task.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_TID</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_TID</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_tid - The thread identifier of the task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_tid:long(task:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-task_struct pointer
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the thread id of the given task.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_TIME_</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_TIME_</H1>
-Section: Task Time Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_time_string - Human readable string of task time usage
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_time_string:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns a human readable string showing the user and system time the current task has used up to now. For example
-"usr: 0m12.908s, sys: 1m6.851s".
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_TIME_</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_TIME_</H1>
-Section: Task Time Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_time_string_tid - Human readable string of task time usage
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_time_string_tid:string(tid:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>tid</I>
-<DL COMPACT><DT><DD>
-Thread id of the given task
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns a human readable string showing the user and system time the given task has used up to now. For example
-"usr: 0m12.908s, sys: 1m6.851s".
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_UID</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_UID</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_uid - The user identifier of the task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_uid:long(task:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-task_struct pointer
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the user id of the given task.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_UTIME</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_UTIME</H1>
-Section: Task Time Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_utime - User time of the current task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_utime:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the user time of the current task in cputime. Does not include any time used by other tasks in this process, nor does it include any time of the children of this task.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TASK_UTIME</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TASK_UTIME</H1>
-Section: Task Time Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::task_utime_tid - User time of the given task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- task_utime_tid:long(tid:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>tid</I>
-<DL COMPACT><DT><DD>
-Thread id of the given task
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the user time of the given task in cputime, or zero if the task doesn't exist. Does not include any time used by other tasks in this process, nor does it include any time of the children of this task.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TCPMIB_FIL</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TCPMIB_FIL</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::tcpmib_filter_key - Default filter function for tcpmib.* probes
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- tcpmib_filter_key:long(sk:long,op:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sock being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be counted if
-<I>sk</I>
-passes the filter
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function is a default filter function. The user can replace this function with their own. The user-supplied filter function returns an index key based on the values in
-<I>sk</I>. A return value of 0 means this particular
-<I>sk</I>
-should be not be counted.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TCPMIB_GET</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TCPMIB_GET</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::tcpmib_get_state - Get a socket's state
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- tcpmib_get_state:long(sk:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-pointer to a struct sock
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the sk_state from a struct sock.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TCPMIB_LOC</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TCPMIB_LOC</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::tcpmib_local_addr - Get the source address
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- tcpmib_local_addr:long(sk:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-pointer to a struct inet_sock
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the saddr from a struct inet_sock in host order.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TCPMIB_LOC</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TCPMIB_LOC</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::tcpmib_local_port - Get the local port
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- tcpmib_local_port:long(sk:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-pointer to a struct inet_sock
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the sport from a struct inet_sock in host order.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TCPMIB_REM</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TCPMIB_REM</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::tcpmib_remote_addr - Get the remote address
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- tcpmib_remote_addr:long(sk:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-pointer to a struct inet_sock
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the daddr from a struct inet_sock in host order.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TCPMIB_REM</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TCPMIB_REM</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::tcpmib_remote_port - Get the remote port
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- tcpmib_remote_port:long(sk:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-pointer to a struct inet_sock
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the dport from a struct inet_sock in host order.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TEXT_STR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TEXT_STR</H1>
-Section: A collection of standard strin (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::text_str - Escape any non-printable chars in a string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- text_str:string(input:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>input</I>
-<DL COMPACT><DT><DD>
-the string to escape
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function accepts a string argument, and any ASCII characters that are not printable are replaced by the corresponding escape sequence in the returned string.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TEXT_STRN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TEXT_STRN</H1>
-Section: A collection of standard strin (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::text_strn - Escape any non-printable chars in a string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- text_strn:string(input:string,len:long,quoted:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>input</I>
-<DL COMPACT><DT><DD>
-the string to escape
-</DL>
-
-<P>
-
-<I>len</I>
-<DL COMPACT><DT><DD>
-maximum length of string to return (0 implies MAXSTRINGLEN)
-</DL>
-
-<P>
-
-<I>quoted</I>
-<DL COMPACT><DT><DD>
-put double quotes around the string. If input string is truncated it will have
-"..."
-after the second quote
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function accepts a string of designated length, and any ASCII characters that are not printable are replaced by the corresponding escape sequence in the returned string.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::THREAD_IND</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::THREAD_IND</H1>
-Section: Utility functions for using an (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::thread_indent - returns an amount of space with the current task information
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- thread_indent:string(delta:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>delta</I>
-<DL COMPACT><DT><DD>
-the amount of space added/removed for each call
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a string with appropriate indentation for a thread. Call it with a small positive or matching negative delta. If this is the real outermost, initial level of indentation, then the function resets the relative timestamp base to zero. An example is shown at the end of this file.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::THREAD_IND</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::THREAD_IND</H1>
-Section: Utility functions for using an (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::thread_indent_depth - returns the nested-depth of the current task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- thread_indent_depth:long(delta:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>delta</I>
-<DL COMPACT><DT><DD>
-the amount of depth added/removed for each call
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns an integer equal to the nested function-call depth starting from the outermost initial level. This function is useful for saving space (consumed by whitespace) in traces with long nested function calls. Use this function in a similar fashion to
-<B>thread_indent</B>, i.e., in call-probe, use <A HREF="thread_indent_depth.1.html">thread_indent_depth</A>(1) and in return-probe, use thread_indent_depth(-1)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TID</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TID</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::tid - Returns the thread ID of a target process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- tid:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the thread ID of the target process.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TOKENIZE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TOKENIZE</H1>
-Section: A collection of standard strin (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::tokenize - Return the next non-empty token in a string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- tokenize:string(input:string,delim:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>input</I>
-<DL COMPACT><DT><DD>
-string to tokenize. If empty, returns the next non-empty token in the string passed in the previous call to
-<B>tokenize</B>.
-</DL>
-
-<P>
-
-<I>delim</I>
-<DL COMPACT><DT><DD>
-set of characters that delimit the tokens
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the next non-empty token in the given input string, where the tokens are delimited by characters in the delim string. If the input string is non-empty, it returns the first token. If the input string is empty, it returns the next token in the string passed in the previous call to tokenize. If no delimiter is found, the entire remaining input string is returned. It returns empty when no more tokens are available.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TZ_CTIME</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TZ_CTIME</H1>
-Section: Time utility functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::tz_ctime - Convert seconds since epoch into human readable date/time string, with local time zone
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- tz_ctime(epochsecs:)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>epochsecs</I>
-<DL COMPACT><DT><DD>
-number of seconds since epoch (as returned by
-<B>gettimeofday_s</B>)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Takes an argument of seconds since the epoch as returned by
-<B>gettimeofday_s</B>. Returns a string of the same form as
-<B>ctime</B>, but offsets the epoch time for the local time zone, and appends the name of the local time zone. The string length may vary. The time zone information is passed by staprun at script startup only.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TZ_GMTOFF</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TZ_GMTOFF</H1>
-Section: Time utility functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::tz_gmtoff - Return local time zone offset
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- tz_gmtoff()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the local time zone offset (seconds west of UTC), as passed by staprun at script startup only.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::TZ_NAME</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::TZ_NAME</H1>
-Section: Time utility functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::tz_name - Return local time zone name
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- tz_name()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the local time zone name, as passed by staprun at script startup only.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::U32_ARG</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::U32_ARG</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::u32_arg - Return function argument as unsigned 32-bit value
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- u32_arg:long(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-index of argument to return
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Return the unsigned 32-bit value of argument n, same as uint_arg.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::U64_ARG</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::U64_ARG</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::u64_arg - Return function argument as unsigned 64-bit value
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- u64_arg:long(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-index of argument to return
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Return the unsigned 64-bit value of argument n, same as ulonglong_arg.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::U_REGISTER</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::U_REGISTER</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::u_register - Return the unsigned value of the named CPU register
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- u_register:long(name:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the register to return
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Same as register(name), except that if the register is 32 bits wide, it is zero-extended to 64 bits.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::UADDR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::UADDR</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::uaddr - User space address of current running task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- uaddr:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the address in userspace that the current task was at when the probe occurred. When the current running task isn't a user space thread, or the address cannot be found, zero is returned. Can be used to see where the current task is combined with
-<B>usymname</B>
-or
-<B>usymdata</B>. Often the task will be in the VDSO where it entered the kernel.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::UBACKTRACE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::UBACKTRACE</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ubacktrace - Hex backtrace of current user-space task stack.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ubacktrace:string()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-Return a string of hex addresses that are a backtrace of the stack of the current task. Output may be truncated as per maximum string length. Returns empty string when current probe point cannot determine user backtrace. See
-<B>backtrace</B>
-for kernel traceback.
-<A NAME="lbAF"> </A>
-<H2>NOTE</H2>
-
-<P>
-
-To get (full) backtraces for user space applications and shared shared libraries not mentioned in the current script run stap with -d /path/to/exe-or-so and/or add --ldd to load all needed unwind data.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAF">NOTE</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::UCALLERS</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::UCALLERS</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ucallers - Return first n elements of user stack backtrace
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ucallers:string(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-number of levels to descend in the stack (not counting the top level). If n is -1, print the entire stack.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a string of the first n hex addresses from the backtrace of the user stack. Output may be truncated as per maximum string length (MAXSTRINGLEN).
-<A NAME="lbAF"> </A>
-<H2>NOTE</H2>
-
-<P>
-
-To get (full) backtraces for user space applications and shared shared libraries not mentioned in the current script run stap with -d /path/to/exe-or-so and/or add --ldd to load all needed unwind data.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAF">NOTE</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::UDELAY</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::UDELAY</H1>
-Section: Guru tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::udelay - microsecond delay
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- udelay(us:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>us</I>
-<DL COMPACT><DT><DD>
-Number of microseconds to delay.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function inserts a multi-microsecond busy-delay into a probe handler. It requires guru mode.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::UID</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::UID</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::uid - Returns the user ID of a target process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- uid:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns the user ID of the target process.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::UINT_ARG</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::UINT_ARG</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::uint_arg - Return function argument as unsigned int
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- uint_arg:long(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-index of argument to return
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Return the value of argument n as an unsigned int (i.e., a 32-bit integer zero-extended to 64 bits).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ULONG_ARG</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ULONG_ARG</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ulong_arg - Return function argument as unsigned long
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ulong_arg:long(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-index of argument to return
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Return the value of argument n as an unsigned long. On architectures where a long is 32 bits, the value is zero-extended to 64 bits.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::ULONGLONG_</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::ULONGLONG_</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ulonglong_arg - Return function argument as 64-bit value
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ulonglong_arg:long(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-index of argument to return
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Return the value of argument n as a 64-bit value. (Same as longlong_arg.)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::UMODNAME</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::UMODNAME</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::umodname - Returns the (short) name of the user module.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- umodname:string(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-User-space address
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the short name of the user space module for the current task that that the given address is part of. Reports an error when the address isn't in a (mapped in) module, or the module cannot be found for some reason.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USECS_TO_S</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USECS_TO_S</H1>
-Section: Task Time Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::usecs_to_string - Human readable string for given microseconds
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- usecs_to_string:string(usecs:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>usecs</I>
-<DL COMPACT><DT><DD>
-Number of microseconds to translate.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns a string representing the number of microseconds as a human readable string consisting of
-"XmY.ZZZZZZs", where X is the number of minutes, Y is the number of seconds and ZZZZZZ is the number of microseconds.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_CHAR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_CHAR</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_char - Retrieves a char value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_char:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the char from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the char value from a given user space address. Returns zero when user space data is not accessible.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_CHAR_</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_CHAR_</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_char_warn - Retrieves a char value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_char_warn:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the char from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the char value from a given user space address. Returns zero when user space and warns (but does not abort) about the failure.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_INT</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_INT</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_int - Retrieves an int value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_int:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the int from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the int value from a given user space address. Returns zero when user space data is not accessible.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_INT16</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_INT16</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_int16 - Retrieves a 16-bit integer value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_int16:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the 16-bit integer from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the 16-bit integer value from a given user space address. Returns zero when user space data is not accessible.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_INT32</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_INT32</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_int32 - Retrieves a 32-bit integer value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_int32:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the 32-bit integer from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the 32-bit integer value from a given user space address. Returns zero when user space data is not accessible.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_INT64</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_INT64</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_int64 - Retrieves a 64-bit integer value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_int64:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the 64-bit integer from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the 64-bit integer value from a given user space address. Returns zero when user space data is not accessible.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_INT8</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_INT8</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_int8 - Retrieves a 8-bit integer value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_int8:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the 8-bit integer from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the 8-bit integer value from a given user space address. Returns zero when user space data is not accessible.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_INT_W</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_INT_W</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_int_warn - Retrieves an int value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_int_warn:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the int from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the int value from a given user space address. Returns zero when user space and warns (but does not abort) about the failure.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_LONG</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_LONG</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_long - Retrieves a long value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_long:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the long from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the long value from a given user space address. Returns zero when user space data is not accessible. Note that the size of the long depends on the architecture of the current user space task (for those architectures that support both 64/32 bit compat tasks).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_LONG_</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_LONG_</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_long_warn - Retrieves a long value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_long_warn:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the long from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the long value from a given user space address. Returns zero when user space and warns (but does not abort) about the failure. Note that the size of the long depends on the architecture of the current user space task (for those architectures that support both 64/32 bit compat tasks).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_MODE</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_MODE</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_mode - Determines if probe point occurs in user-mode
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_mode:long()
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-Return 1 if the probe point occurred in user-mode.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_SHORT</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_SHORT</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_short - Retrieves a short value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_short:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the short from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the short value from a given user space address. Returns zero when user space data is not accessible.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_SHORT</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_SHORT</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_short_warn - Retrieves a short value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_short_warn:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the short from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the short value from a given user space address. Returns zero when user space and warns (but does not abort) about the failure.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_STRIN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_STRIN</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_string - Retrieves string from user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_string:string(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the string from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the null terminated C string from a given user space memory address. Reports an error on the rare cases when userspace data is not accessible.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_STRIN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_STRIN</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_string2 - Retrieves string from user space with alternative error string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_string2:string(addr:long,err_msg:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the string from
-</DL>
-
-<P>
-
-<I>err_msg</I>
-<DL COMPACT><DT><DD>
-the error message to return when data isn't available
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the null terminated C string from a given user space memory address. Reports the given error message on the rare cases when userspace data is not accessible.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_STRIN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_STRIN</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_string2_n_warn - Retrieves string from user space with alternative warning string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_string2_n_warn:string(addr:long,n:long,warn_msg:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the string from
-</DL>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-the maximum length of the string (if not null terminated)
-</DL>
-
-<P>
-
-<I>warn_msg</I>
-<DL COMPACT><DT><DD>
-the warning message to return when data isn't available
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns up to n characters of a C string from a given user space memory address. Reports the given warning message on the rare cases when userspace data is not accessible and warns (but does not abort) about the failure.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_STRIN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_STRIN</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_string2_utf16 - Retrieves UTF-16 string from user memory with alternative error string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_string2_utf16:string(addr:long,err_msg:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The user address to retrieve the string from
-</DL>
-
-<P>
-
-<I>err_msg</I>
-<DL COMPACT><DT><DD>
-The error message to return when data isn't available
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a null terminated UTF-8 string converted from the UTF-16 string at a given user memory address. Reports the given error message on string copy fault or conversion error.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_STRIN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_STRIN</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_string2_utf32 - Retrieves UTF-32 string from user memory with alternative error string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_string2_utf32:string(addr:long,err_msg:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The user address to retrieve the string from
-</DL>
-
-<P>
-
-<I>err_msg</I>
-<DL COMPACT><DT><DD>
-The error message to return when data isn't available
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a null terminated UTF-8 string converted from the UTF-32 string at a given user memory address. Reports the given error message on string copy fault or conversion error.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_STRIN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_STRIN</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_string2_warn - Retrieves string from user space with alternative warning string
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_string2_warn:string(addr:long,warn_msg:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the string from
-</DL>
-
-<P>
-
-<I>warn_msg</I>
-<DL COMPACT><DT><DD>
-the warning message to return when data isn't available
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the null terminated C string from a given user space memory address. Reports the given warning message on the rare cases when userspace data is not accessible and warns (but does not abort) about the failure.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_STRIN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_STRIN</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_string_n - Retrieves string of given length from user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_string_n:string(addr:long,n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the string from
-</DL>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-the maximum length of the string (if not null terminated)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the C string of a maximum given length from a given user space address. Reports an error on the rare cases when userspace data is not accessible at the given address.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_STRIN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_STRIN</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_string_n2 - Retrieves string of given length from user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_string_n2:string(addr:long,n:long,err_msg:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the string from
-</DL>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-the maximum length of the string (if not null terminated)
-</DL>
-
-<P>
-
-<I>err_msg</I>
-<DL COMPACT><DT><DD>
-the error message to return when data isn't available
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the C string of a maximum given length from a given user space address. Returns the given error message string on the rare cases when userspace data is not accessible at the given address.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_STRIN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_STRIN</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_string_n2_quoted - Retrieves and quotes string from user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_string_n2_quoted:string(addr:long,inlen:long,outlen:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the string from
-</DL>
-
-<P>
-
-<I>inlen</I>
-<DL COMPACT><DT><DD>
-the maximum length of the string to read (if not null terminated)
-</DL>
-
-<P>
-
-<I>outlen</I>
-<DL COMPACT><DT><DD>
-the maximum length of the output string
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Reads up to inlen characters of a C string from the given user space memory address, and returns up to outlen characters, where any ASCII characters that are not printable are replaced by the corresponding escape sequence in the returned string. Note that the string will be surrounded by double quotes. On the rare cases when userspace data is not accessible at the given address, the address itself is returned as a string, without double quotes.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_STRIN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_STRIN</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_string_n_quoted - Retrieves and quotes string from user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_string_n_quoted:string(addr:long,n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the string from
-</DL>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-the maximum length of the string (if not null terminated)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns up to n characters of a C string from the given user space memory address where any ASCII characters that are not printable are replaced by the corresponding escape sequence in the returned string. Note that the string will be surrounded by double quotes. On the rare cases when userspace data is not accessible at the given address, the address itself is returned as a string, without double quotes.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_STRIN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_STRIN</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_string_n_warn - Retrieves string from user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_string_n_warn:string(addr:long,n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the string from
-</DL>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-the maximum length of the string (if not null terminated)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns up to n characters of a C string from a given user space memory address. Reports
-"<unknown>"
-on the rare cases when userspace data is not accessible and warns (but does not abort) about the failure.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_STRIN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_STRIN</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_string_quoted - Retrieves and quotes string from user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_string_quoted:string(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the string from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the null terminated C string from a given user space memory address where any ASCII characters that are not printable are replaced by the corresponding escape sequence in the returned string. Note that the string will be surrounded by double quotes. On the rare cases when userspace data is not accessible at the given address, the address itself is returned as a string, without double quotes.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_STRIN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_STRIN</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_string_utf16 - Retrieves UTF-16 string from user memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_string_utf16:string(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The user address to retrieve the string from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a null terminated UTF-8 string converted from the UTF-16 string at a given user memory address. Reports an error on string copy fault or conversion error.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_STRIN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_STRIN</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_string_utf32 - Retrieves UTF-32 string from user memory
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_string_utf32:string(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The user address to retrieve the string from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function returns a null terminated UTF-8 string converted from the UTF-32 string at a given user memory address. Reports an error on string copy fault or conversion error.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_STRIN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_STRIN</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_string_warn - Retrieves string from user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_string_warn:string(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the string from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the null terminated C string from a given user space memory address. Reports "" on the rare cases when userspace data is not accessible and warns (but does not abort) about the failure.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_UINT1</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_UINT1</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_uint16 - Retrieves an unsigned 16-bit integer value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_uint16:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the unsigned 16-bit integer from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the unsigned 16-bit integer value from a given user space address. Returns zero when user space data is not accessible.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_UINT3</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_UINT3</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_uint32 - Retrieves an unsigned 32-bit integer value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_uint32:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the unsigned 32-bit integer from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the unsigned 32-bit integer value from a given user space address. Returns zero when user space data is not accessible.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:27 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_UINT6</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_UINT6</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_uint64 - Retrieves an unsigned 64-bit integer value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_uint64:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the unsigned 64-bit integer from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the unsigned 64-bit integer value from a given user space address. Returns zero when user space data is not accessible.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_UINT8</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_UINT8</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_uint8 - Retrieves an unsigned 8-bit integer value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_uint8:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the unsigned 8-bit integer from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the unsigned 8-bit integer value from a given user space address. Returns zero when user space data is not accessible.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_USHOR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_USHOR</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_ushort - Retrieves an unsigned short value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_ushort:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the unsigned short from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the unsigned short value from a given user space address. Returns zero when user space data is not accessible.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USER_USHOR</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USER_USHOR</H1>
-Section: String and data retrieving fun (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::user_ushort_warn - Retrieves an unsigned short value stored in user space
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- user_ushort_warn:long(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-the user space address to retrieve the unsigned short from
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the unsigned short value from a given user space address. Returns zero when user space and warns (but does not abort) about the failure.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USRDEV2KER</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USRDEV2KER</H1>
-Section: Device Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::usrdev2kerndev - Converts a user-space device number into the format used in the kernel
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- usrdev2kerndev:long(dev:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-Device number in user-space format.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USTACK</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USTACK</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::ustack - Return address at given depth of user stack backtrace
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- ustack:long(n:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>n</I>
-<DL COMPACT><DT><DD>
-number of levels to descend in the stack.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Performs a simple (user space) backtrace, and returns the element at the specified position. The results of the backtrace itself are cached, so that the backtrace computation is performed at most once no matter how many times
-<B>ustack</B>
-is called, or in what order.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USYMDATA</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USYMDATA</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::usymdata - Return the symbol and module offset of an address.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- usymdata:string(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The address to translate.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the (function) symbol name associated with the given address in the current task if known, the offset from the start and the size of the symbol, plus the module name (between brackets). If symbol is unknown, but module is known, the offset inside the module, plus the size of the module is added. If any element is not known it will be omitted and if the symbol name is unknown it will return the hex string for the given address.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::USYMNAME</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::USYMNAME</H1>
-Section: Context Functions (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::usymname - Return the symbol of an address in the current task.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- usymname:string(addr:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>addr</I>
-<DL COMPACT><DT><DD>
-The address to translate.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Returns the (function) symbol name associated with the given address if known. If not known it will return the hex string representation of addr.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::VM_FAULT_C</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::VM_FAULT_C</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::vm_fault_contains - Test return value for page fault reason
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- vm_fault_contains:long(value:long,test:long)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>value</I>
-<DL COMPACT><DT><DD>
-the fault_type returned by vm.page_fault.return
-</DL>
-
-<P>
-
-<I>test</I>
-<DL COMPACT><DT><DD>
-the type of fault to test for (VM_FAULT_OOM or similar)
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of FUNCTION::WARN</TITLE>
-</HEAD><BODY>
-<H1>FUNCTION::WARN</H1>
-Section: Logging Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-function::warn - Send a line to the warning stream
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
- warn(msg:string)
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-
-<I>msg</I>
-<DL COMPACT><DT><DD>
-The formatted message string
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This function sends a warning message immediately to staprun. It is also sent over the bulk transport (relayfs) if it is being used. If the last characater is not a newline, the one is added.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-<html><head><title>systemtap man page index</title></head><body><ul>
-<li><a href="./dtrace.1.html">dtrace.1</a></li>
-<li><a href="./stap.1.html">stap.1</a></li>
-<li><a href="./stap-merge.1.html">stap-merge.1</a></li>
-<li><a href="./stap-prep.1.html">stap-prep.1</a></li>
-<li><a href="./stap-report.1.html">stap-report.1</a></li>
-<li><a href="./stapvirt.1.html">stapvirt.1</a></li>
-<li><a href="./function::addr.3stap.html">function::addr.3stap</a></li>
-<li><a href="./function::addr_to_node.3stap.html">function::addr_to_node.3stap</a></li>
-<li><a href="./function::ansi_clear_screen.3stap.html">function::ansi_clear_screen.3stap</a></li>
-<li><a href="./function::ansi_cursor_hide.3stap.html">function::ansi_cursor_hide.3stap</a></li>
-<li><a href="./function::ansi_cursor_move.3stap.html">function::ansi_cursor_move.3stap</a></li>
-<li><a href="./function::ansi_cursor_restore.3stap.html">function::ansi_cursor_restore.3stap</a></li>
-<li><a href="./function::ansi_cursor_save.3stap.html">function::ansi_cursor_save.3stap</a></li>
-<li><a href="./function::ansi_cursor_show.3stap.html">function::ansi_cursor_show.3stap</a></li>
-<li><a href="./function::ansi_new_line.3stap.html">function::ansi_new_line.3stap</a></li>
-<li><a href="./function::ansi_reset_color.3stap.html">function::ansi_reset_color.3stap</a></li>
-<li><a href="./function::ansi_set_color2.3stap.html">function::ansi_set_color2.3stap</a></li>
-<li><a href="./function::ansi_set_color3.3stap.html">function::ansi_set_color3.3stap</a></li>
-<li><a href="./function::ansi_set_color.3stap.html">function::ansi_set_color.3stap</a></li>
-<li><a href="./function::asmlinkage.3stap.html">function::asmlinkage.3stap</a></li>
-<li><a href="./function::atomic_long_read.3stap.html">function::atomic_long_read.3stap</a></li>
-<li><a href="./function::atomic_read.3stap.html">function::atomic_read.3stap</a></li>
-<li><a href="./function::backtrace.3stap.html">function::backtrace.3stap</a></li>
-<li><a href="./function::bytes_to_string.3stap.html">function::bytes_to_string.3stap</a></li>
-<li><a href="./function::caller.3stap.html">function::caller.3stap</a></li>
-<li><a href="./function::caller_addr.3stap.html">function::caller_addr.3stap</a></li>
-<li><a href="./function::callers.3stap.html">function::callers.3stap</a></li>
-<li><a href="./function::cmdline_arg.3stap.html">function::cmdline_arg.3stap</a></li>
-<li><a href="./function::cmdline_args.3stap.html">function::cmdline_args.3stap</a></li>
-<li><a href="./function::cmdline_str.3stap.html">function::cmdline_str.3stap</a></li>
-<li><a href="./function::commit.3stap.html">function::commit.3stap</a></li>
-<li><a href="./function::cpu.3stap.html">function::cpu.3stap</a></li>
-<li><a href="./function::cpu_clock_ms.3stap.html">function::cpu_clock_ms.3stap</a></li>
-<li><a href="./function::cpu_clock_ns.3stap.html">function::cpu_clock_ns.3stap</a></li>
-<li><a href="./function::cpu_clock_s.3stap.html">function::cpu_clock_s.3stap</a></li>
-<li><a href="./function::cpu_clock_us.3stap.html">function::cpu_clock_us.3stap</a></li>
-<li><a href="./function::cpuid.3stap.html">function::cpuid.3stap</a></li>
-<li><a href="./function::cputime_to_msecs.3stap.html">function::cputime_to_msecs.3stap</a></li>
-<li><a href="./function::cputime_to_string.3stap.html">function::cputime_to_string.3stap</a></li>
-<li><a href="./function::cputime_to_usecs.3stap.html">function::cputime_to_usecs.3stap</a></li>
-<li><a href="./function::ctime.3stap.html">function::ctime.3stap</a></li>
-<li><a href="./function::delete_stopwatch.3stap.html">function::delete_stopwatch.3stap</a></li>
-<li><a href="./function::discard.3stap.html">function::discard.3stap</a></li>
-<li><a href="./function::d_name.3stap.html">function::d_name.3stap</a></li>
-<li><a href="./function::d_path.3stap.html">function::d_path.3stap</a></li>
-<li><a href="./function::egid.3stap.html">function::egid.3stap</a></li>
-<li><a href="./function::env_var.3stap.html">function::env_var.3stap</a></li>
-<li><a href="./function::errno_str.3stap.html">function::errno_str.3stap</a></li>
-<li><a href="./function::error.3stap.html">function::error.3stap</a></li>
-<li><a href="./function::euid.3stap.html">function::euid.3stap</a></li>
-<li><a href="./function::execname.3stap.html">function::execname.3stap</a></li>
-<li><a href="./function::exit.3stap.html">function::exit.3stap</a></li>
-<li><a href="./function::fastcall.3stap.html">function::fastcall.3stap</a></li>
-<li><a href="./function::format_ipaddr.3stap.html">function::format_ipaddr.3stap</a></li>
-<li><a href="./function::ftrace.3stap.html">function::ftrace.3stap</a></li>
-<li><a href="./function::get_cycles.3stap.html">function::get_cycles.3stap</a></li>
-<li><a href="./function::get_loadavg_index.3stap.html">function::get_loadavg_index.3stap</a></li>
-<li><a href="./function::get_sa_flags.3stap.html">function::get_sa_flags.3stap</a></li>
-<li><a href="./function::get_sa_handler.3stap.html">function::get_sa_handler.3stap</a></li>
-<li><a href="./function::gettimeofday_ms.3stap.html">function::gettimeofday_ms.3stap</a></li>
-<li><a href="./function::gettimeofday_ns.3stap.html">function::gettimeofday_ns.3stap</a></li>
-<li><a href="./function::gettimeofday_s.3stap.html">function::gettimeofday_s.3stap</a></li>
-<li><a href="./function::gettimeofday_us.3stap.html">function::gettimeofday_us.3stap</a></li>
-<li><a href="./function::gid.3stap.html">function::gid.3stap</a></li>
-<li><a href="./function::htonl.3stap.html">function::htonl.3stap</a></li>
-<li><a href="./function::htonll.3stap.html">function::htonll.3stap</a></li>
-<li><a href="./function::htons.3stap.html">function::htons.3stap</a></li>
-<li><a href="./function::HZ.3stap.html">function::HZ.3stap</a></li>
-<li><a href="./function::indent.3stap.html">function::indent.3stap</a></li>
-<li><a href="./function::indent_depth.3stap.html">function::indent_depth.3stap</a></li>
-<li><a href="./function::inet_get_ip_source.3stap.html">function::inet_get_ip_source.3stap</a></li>
-<li><a href="./function::inet_get_local_port.3stap.html">function::inet_get_local_port.3stap</a></li>
-<li><a href="./function::inode_name.3stap.html">function::inode_name.3stap</a></li>
-<li><a href="./function::inode_path.3stap.html">function::inode_path.3stap</a></li>
-<li><a href="./function::int_arg.3stap.html">function::int_arg.3stap</a></li>
-<li><a href="./function::ipmib_filter_key.3stap.html">function::ipmib_filter_key.3stap</a></li>
-<li><a href="./function::ipmib_get_proto.3stap.html">function::ipmib_get_proto.3stap</a></li>
-<li><a href="./function::ipmib_local_addr.3stap.html">function::ipmib_local_addr.3stap</a></li>
-<li><a href="./function::ipmib_remote_addr.3stap.html">function::ipmib_remote_addr.3stap</a></li>
-<li><a href="./function::ipmib_tcp_local_port.3stap.html">function::ipmib_tcp_local_port.3stap</a></li>
-<li><a href="./function::ipmib_tcp_remote_port.3stap.html">function::ipmib_tcp_remote_port.3stap</a></li>
-<li><a href="./function::ip_ntop.3stap.html">function::ip_ntop.3stap</a></li>
-<li><a href="./function::isdigit.3stap.html">function::isdigit.3stap</a></li>
-<li><a href="./function::isinstr.3stap.html">function::isinstr.3stap</a></li>
-<li><a href="./function::is_myproc.3stap.html">function::is_myproc.3stap</a></li>
-<li><a href="./function::is_return.3stap.html">function::is_return.3stap</a></li>
-<li><a href="./function::is_sig_blocked.3stap.html">function::is_sig_blocked.3stap</a></li>
-<li><a href="./function::jiffies.3stap.html">function::jiffies.3stap</a></li>
-<li><a href="./function::kernel_char.3stap.html">function::kernel_char.3stap</a></li>
-<li><a href="./function::kernel_int.3stap.html">function::kernel_int.3stap</a></li>
-<li><a href="./function::kernel_long.3stap.html">function::kernel_long.3stap</a></li>
-<li><a href="./function::kernel_pointer.3stap.html">function::kernel_pointer.3stap</a></li>
-<li><a href="./function::kernel_short.3stap.html">function::kernel_short.3stap</a></li>
-<li><a href="./function::kernel_string2.3stap.html">function::kernel_string2.3stap</a></li>
-<li><a href="./function::kernel_string2_utf16.3stap.html">function::kernel_string2_utf16.3stap</a></li>
-<li><a href="./function::kernel_string2_utf32.3stap.html">function::kernel_string2_utf32.3stap</a></li>
-<li><a href="./function::kernel_string.3stap.html">function::kernel_string.3stap</a></li>
-<li><a href="./function::kernel_string_n.3stap.html">function::kernel_string_n.3stap</a></li>
-<li><a href="./function::kernel_string_utf16.3stap.html">function::kernel_string_utf16.3stap</a></li>
-<li><a href="./function::kernel_string_utf32.3stap.html">function::kernel_string_utf32.3stap</a></li>
-<li><a href="./function::linuxmib_filter_key.3stap.html">function::linuxmib_filter_key.3stap</a></li>
-<li><a href="./function::local_clock_ms.3stap.html">function::local_clock_ms.3stap</a></li>
-<li><a href="./function::local_clock_ns.3stap.html">function::local_clock_ns.3stap</a></li>
-<li><a href="./function::local_clock_s.3stap.html">function::local_clock_s.3stap</a></li>
-<li><a href="./function::local_clock_us.3stap.html">function::local_clock_us.3stap</a></li>
-<li><a href="./function::log.3stap.html">function::log.3stap</a></li>
-<li><a href="./function::long_arg.3stap.html">function::long_arg.3stap</a></li>
-<li><a href="./function::longlong_arg.3stap.html">function::longlong_arg.3stap</a></li>
-<li><a href="./function::MAJOR.3stap.html">function::MAJOR.3stap</a></li>
-<li><a href="./function::mdelay.3stap.html">function::mdelay.3stap</a></li>
-<li><a href="./function::mem_page_size.3stap.html">function::mem_page_size.3stap</a></li>
-<li><a href="./function::MINOR.3stap.html">function::MINOR.3stap</a></li>
-<li><a href="./function::MKDEV.3stap.html">function::MKDEV.3stap</a></li>
-<li><a href="./function::modname.3stap.html">function::modname.3stap</a></li>
-<li><a href="./function::module_name.3stap.html">function::module_name.3stap</a></li>
-<li><a href="./function::msecs_to_string.3stap.html">function::msecs_to_string.3stap</a></li>
-<li><a href="./function::nfsderror.3stap.html">function::nfsderror.3stap</a></li>
-<li><a href="./function::nsecs_to_string.3stap.html">function::nsecs_to_string.3stap</a></li>
-<li><a href="./function::ntohl.3stap.html">function::ntohl.3stap</a></li>
-<li><a href="./function::ntohll.3stap.html">function::ntohll.3stap</a></li>
-<li><a href="./function::ntohs.3stap.html">function::ntohs.3stap</a></li>
-<li><a href="./function::pages_to_string.3stap.html">function::pages_to_string.3stap</a></li>
-<li><a href="./function::panic.3stap.html">function::panic.3stap</a></li>
-<li><a href="./function::pexecname.3stap.html">function::pexecname.3stap</a></li>
-<li><a href="./function::pgrp.3stap.html">function::pgrp.3stap</a></li>
-<li><a href="./function::pid2execname.3stap.html">function::pid2execname.3stap</a></li>
-<li><a href="./function::pid2task.3stap.html">function::pid2task.3stap</a></li>
-<li><a href="./function::pid.3stap.html">function::pid.3stap</a></li>
-<li><a href="./function::pn.3stap.html">function::pn.3stap</a></li>
-<li><a href="./function::pnlabel.3stap.html">function::pnlabel.3stap</a></li>
-<li><a href="./function::pointer_arg.3stap.html">function::pointer_arg.3stap</a></li>
-<li><a href="./function::pp.3stap.html">function::pp.3stap</a></li>
-<li><a href="./function::ppfunc.3stap.html">function::ppfunc.3stap</a></li>
-<li><a href="./function::ppid.3stap.html">function::ppid.3stap</a></li>
-<li><a href="./function::print_backtrace.3stap.html">function::print_backtrace.3stap</a></li>
-<li><a href="./function::printk.3stap.html">function::printk.3stap</a></li>
-<li><a href="./function::print_regs.3stap.html">function::print_regs.3stap</a></li>
-<li><a href="./function::print_stack.3stap.html">function::print_stack.3stap</a></li>
-<li><a href="./function::print_syms.3stap.html">function::print_syms.3stap</a></li>
-<li><a href="./function::print_ubacktrace.3stap.html">function::print_ubacktrace.3stap</a></li>
-<li><a href="./function::print_ubacktrace_brief.3stap.html">function::print_ubacktrace_brief.3stap</a></li>
-<li><a href="./function::print_ustack.3stap.html">function::print_ustack.3stap</a></li>
-<li><a href="./function::print_usyms.3stap.html">function::print_usyms.3stap</a></li>
-<li><a href="./function::probefunc.3stap.html">function::probefunc.3stap</a></li>
-<li><a href="./function::probemod.3stap.html">function::probemod.3stap</a></li>
-<li><a href="./function::probe_type.3stap.html">function::probe_type.3stap</a></li>
-<li><a href="./function::proc_mem_data.3stap.html">function::proc_mem_data.3stap</a></li>
-<li><a href="./function::proc_mem_data_pid.3stap.html">function::proc_mem_data_pid.3stap</a></li>
-<li><a href="./function::proc_mem_rss.3stap.html">function::proc_mem_rss.3stap</a></li>
-<li><a href="./function::proc_mem_rss_pid.3stap.html">function::proc_mem_rss_pid.3stap</a></li>
-<li><a href="./function::proc_mem_shr.3stap.html">function::proc_mem_shr.3stap</a></li>
-<li><a href="./function::proc_mem_shr_pid.3stap.html">function::proc_mem_shr_pid.3stap</a></li>
-<li><a href="./function::proc_mem_size.3stap.html">function::proc_mem_size.3stap</a></li>
-<li><a href="./function::proc_mem_size_pid.3stap.html">function::proc_mem_size_pid.3stap</a></li>
-<li><a href="./function::proc_mem_string.3stap.html">function::proc_mem_string.3stap</a></li>
-<li><a href="./function::proc_mem_string_pid.3stap.html">function::proc_mem_string_pid.3stap</a></li>
-<li><a href="./function::proc_mem_txt.3stap.html">function::proc_mem_txt.3stap</a></li>
-<li><a href="./function::proc_mem_txt_pid.3stap.html">function::proc_mem_txt_pid.3stap</a></li>
-<li><a href="./function::pstrace.3stap.html">function::pstrace.3stap</a></li>
-<li><a href="./function::qs_done.3stap.html">function::qs_done.3stap</a></li>
-<li><a href="./function::qsq_blocked.3stap.html">function::qsq_blocked.3stap</a></li>
-<li><a href="./function::qsq_print.3stap.html">function::qsq_print.3stap</a></li>
-<li><a href="./function::qsq_service_time.3stap.html">function::qsq_service_time.3stap</a></li>
-<li><a href="./function::qsq_start.3stap.html">function::qsq_start.3stap</a></li>
-<li><a href="./function::qsq_throughput.3stap.html">function::qsq_throughput.3stap</a></li>
-<li><a href="./function::qsq_utilization.3stap.html">function::qsq_utilization.3stap</a></li>
-<li><a href="./function::qsq_wait_queue_length.3stap.html">function::qsq_wait_queue_length.3stap</a></li>
-<li><a href="./function::qsq_wait_time.3stap.html">function::qsq_wait_time.3stap</a></li>
-<li><a href="./function::qs_run.3stap.html">function::qs_run.3stap</a></li>
-<li><a href="./function::qs_wait.3stap.html">function::qs_wait.3stap</a></li>
-<li><a href="./function::raise.3stap.html">function::raise.3stap</a></li>
-<li><a href="./function::randint.3stap.html">function::randint.3stap</a></li>
-<li><a href="./function::read_stopwatch_ms.3stap.html">function::read_stopwatch_ms.3stap</a></li>
-<li><a href="./function::read_stopwatch_ns.3stap.html">function::read_stopwatch_ns.3stap</a></li>
-<li><a href="./function::read_stopwatch_s.3stap.html">function::read_stopwatch_s.3stap</a></li>
-<li><a href="./function::read_stopwatch_us.3stap.html">function::read_stopwatch_us.3stap</a></li>
-<li><a href="./function::real_mount.3stap.html">function::real_mount.3stap</a></li>
-<li><a href="./function::register.3stap.html">function::register.3stap</a></li>
-<li><a href="./function::registers_valid.3stap.html">function::registers_valid.3stap</a></li>
-<li><a href="./function::regparm.3stap.html">function::regparm.3stap</a></li>
-<li><a href="./function::remote_id.3stap.html">function::remote_id.3stap</a></li>
-<li><a href="./function::remote_uri.3stap.html">function::remote_uri.3stap</a></li>
-<li><a href="./function::return_str.3stap.html">function::return_str.3stap</a></li>
-<li><a href="./function::returnstr.3stap.html">function::returnstr.3stap</a></li>
-<li><a href="./function::returnval.3stap.html">function::returnval.3stap</a></li>
-<li><a href="./function::reverse_path_walk.3stap.html">function::reverse_path_walk.3stap</a></li>
-<li><a href="./function::s32_arg.3stap.html">function::s32_arg.3stap</a></li>
-<li><a href="./function::s64_arg.3stap.html">function::s64_arg.3stap</a></li>
-<li><a href="./function::sa_flags_str.3stap.html">function::sa_flags_str.3stap</a></li>
-<li><a href="./function::sa_handler_str.3stap.html">function::sa_handler_str.3stap</a></li>
-<li><a href="./function::set_kernel_char.3stap.html">function::set_kernel_char.3stap</a></li>
-<li><a href="./function::set_kernel_int.3stap.html">function::set_kernel_int.3stap</a></li>
-<li><a href="./function::set_kernel_long.3stap.html">function::set_kernel_long.3stap</a></li>
-<li><a href="./function::set_kernel_pointer.3stap.html">function::set_kernel_pointer.3stap</a></li>
-<li><a href="./function::set_kernel_short.3stap.html">function::set_kernel_short.3stap</a></li>
-<li><a href="./function::set_kernel_string.3stap.html">function::set_kernel_string.3stap</a></li>
-<li><a href="./function::set_kernel_string_n.3stap.html">function::set_kernel_string_n.3stap</a></li>
-<li><a href="./function::sid.3stap.html">function::sid.3stap</a></li>
-<li><a href="./function::signal_str.3stap.html">function::signal_str.3stap</a></li>
-<li><a href="./function::sigset_mask_str.3stap.html">function::sigset_mask_str.3stap</a></li>
-<li><a href="./function::sock_fam_num2str.3stap.html">function::sock_fam_num2str.3stap</a></li>
-<li><a href="./function::sock_fam_str2num.3stap.html">function::sock_fam_str2num.3stap</a></li>
-<li><a href="./function::sock_prot_num2str.3stap.html">function::sock_prot_num2str.3stap</a></li>
-<li><a href="./function::sock_prot_str2num.3stap.html">function::sock_prot_str2num.3stap</a></li>
-<li><a href="./function::sock_state_num2str.3stap.html">function::sock_state_num2str.3stap</a></li>
-<li><a href="./function::sock_state_str2num.3stap.html">function::sock_state_str2num.3stap</a></li>
-<li><a href="./function::speculate.3stap.html">function::speculate.3stap</a></li>
-<li><a href="./function::speculation.3stap.html">function::speculation.3stap</a></li>
-<li><a href="./function::sprint_backtrace.3stap.html">function::sprint_backtrace.3stap</a></li>
-<li><a href="./function::sprint_loadavg.3stap.html">function::sprint_loadavg.3stap</a></li>
-<li><a href="./function::sprint_stack.3stap.html">function::sprint_stack.3stap</a></li>
-<li><a href="./function::sprint_syms.3stap.html">function::sprint_syms.3stap</a></li>
-<li><a href="./function::sprint_ubacktrace.3stap.html">function::sprint_ubacktrace.3stap</a></li>
-<li><a href="./function::sprint_ustack.3stap.html">function::sprint_ustack.3stap</a></li>
-<li><a href="./function::sprint_usyms.3stap.html">function::sprint_usyms.3stap</a></li>
-<li><a href="./function::stack.3stap.html">function::stack.3stap</a></li>
-<li><a href="./function::stack_size.3stap.html">function::stack_size.3stap</a></li>
-<li><a href="./function::stack_unused.3stap.html">function::stack_unused.3stap</a></li>
-<li><a href="./function::stack_used.3stap.html">function::stack_used.3stap</a></li>
-<li><a href="./function::start_stopwatch.3stap.html">function::start_stopwatch.3stap</a></li>
-<li><a href="./function::stop_stopwatch.3stap.html">function::stop_stopwatch.3stap</a></li>
-<li><a href="./function::stp_pid.3stap.html">function::stp_pid.3stap</a></li>
-<li><a href="./function::stringat.3stap.html">function::stringat.3stap</a></li>
-<li><a href="./function::strlen.3stap.html">function::strlen.3stap</a></li>
-<li><a href="./function::str_replace.3stap.html">function::str_replace.3stap</a></li>
-<li><a href="./function::strtol.3stap.html">function::strtol.3stap</a></li>
-<li><a href="./function::substr.3stap.html">function::substr.3stap</a></li>
-<li><a href="./function::symdata.3stap.html">function::symdata.3stap</a></li>
-<li><a href="./function::symname.3stap.html">function::symname.3stap</a></li>
-<li><a href="./function::system.3stap.html">function::system.3stap</a></li>
-<li><a href="./function::target.3stap.html">function::target.3stap</a></li>
-<li><a href="./function::target_set_pid.3stap.html">function::target_set_pid.3stap</a></li>
-<li><a href="./function::target_set_report.3stap.html">function::target_set_report.3stap</a></li>
-<li><a href="./function::task_ancestry.3stap.html">function::task_ancestry.3stap</a></li>
-<li><a href="./function::task_backtrace.3stap.html">function::task_backtrace.3stap</a></li>
-<li><a href="./function::task_cpu.3stap.html">function::task_cpu.3stap</a></li>
-<li><a href="./function::task_current.3stap.html">function::task_current.3stap</a></li>
-<li><a href="./function::task_dentry_path.3stap.html">function::task_dentry_path.3stap</a></li>
-<li><a href="./function::task_egid.3stap.html">function::task_egid.3stap</a></li>
-<li><a href="./function::task_euid.3stap.html">function::task_euid.3stap</a></li>
-<li><a href="./function::task_execname.3stap.html">function::task_execname.3stap</a></li>
-<li><a href="./function::task_gid.3stap.html">function::task_gid.3stap</a></li>
-<li><a href="./function::task_max_file_handles.3stap.html">function::task_max_file_handles.3stap</a></li>
-<li><a href="./function::task_nice.3stap.html">function::task_nice.3stap</a></li>
-<li><a href="./function::task_open_file_handles.3stap.html">function::task_open_file_handles.3stap</a></li>
-<li><a href="./function::task_parent.3stap.html">function::task_parent.3stap</a></li>
-<li><a href="./function::task_pid.3stap.html">function::task_pid.3stap</a></li>
-<li><a href="./function::task_prio.3stap.html">function::task_prio.3stap</a></li>
-<li><a href="./function::task_start_time.3stap.html">function::task_start_time.3stap</a></li>
-<li><a href="./function::task_state.3stap.html">function::task_state.3stap</a></li>
-<li><a href="./function::task_stime.3stap.html">function::task_stime.3stap</a></li>
-<li><a href="./function::task_stime_tid.3stap.html">function::task_stime_tid.3stap</a></li>
-<li><a href="./function::task_tid.3stap.html">function::task_tid.3stap</a></li>
-<li><a href="./function::task_time_string.3stap.html">function::task_time_string.3stap</a></li>
-<li><a href="./function::task_time_string_tid.3stap.html">function::task_time_string_tid.3stap</a></li>
-<li><a href="./function::task_uid.3stap.html">function::task_uid.3stap</a></li>
-<li><a href="./function::task_utime.3stap.html">function::task_utime.3stap</a></li>
-<li><a href="./function::task_utime_tid.3stap.html">function::task_utime_tid.3stap</a></li>
-<li><a href="./function::tcpmib_filter_key.3stap.html">function::tcpmib_filter_key.3stap</a></li>
-<li><a href="./function::tcpmib_get_state.3stap.html">function::tcpmib_get_state.3stap</a></li>
-<li><a href="./function::tcpmib_local_addr.3stap.html">function::tcpmib_local_addr.3stap</a></li>
-<li><a href="./function::tcpmib_local_port.3stap.html">function::tcpmib_local_port.3stap</a></li>
-<li><a href="./function::tcpmib_remote_addr.3stap.html">function::tcpmib_remote_addr.3stap</a></li>
-<li><a href="./function::tcpmib_remote_port.3stap.html">function::tcpmib_remote_port.3stap</a></li>
-<li><a href="./function::text_str.3stap.html">function::text_str.3stap</a></li>
-<li><a href="./function::text_strn.3stap.html">function::text_strn.3stap</a></li>
-<li><a href="./function::thread_indent.3stap.html">function::thread_indent.3stap</a></li>
-<li><a href="./function::thread_indent_depth.3stap.html">function::thread_indent_depth.3stap</a></li>
-<li><a href="./function::tid.3stap.html">function::tid.3stap</a></li>
-<li><a href="./function::tokenize.3stap.html">function::tokenize.3stap</a></li>
-<li><a href="./function::tz_ctime.3stap.html">function::tz_ctime.3stap</a></li>
-<li><a href="./function::tz_gmtoff.3stap.html">function::tz_gmtoff.3stap</a></li>
-<li><a href="./function::tz_name.3stap.html">function::tz_name.3stap</a></li>
-<li><a href="./function::u32_arg.3stap.html">function::u32_arg.3stap</a></li>
-<li><a href="./function::u64_arg.3stap.html">function::u64_arg.3stap</a></li>
-<li><a href="./function::uaddr.3stap.html">function::uaddr.3stap</a></li>
-<li><a href="./function::ubacktrace.3stap.html">function::ubacktrace.3stap</a></li>
-<li><a href="./function::ucallers.3stap.html">function::ucallers.3stap</a></li>
-<li><a href="./function::udelay.3stap.html">function::udelay.3stap</a></li>
-<li><a href="./function::uid.3stap.html">function::uid.3stap</a></li>
-<li><a href="./function::uint_arg.3stap.html">function::uint_arg.3stap</a></li>
-<li><a href="./function::ulong_arg.3stap.html">function::ulong_arg.3stap</a></li>
-<li><a href="./function::ulonglong_arg.3stap.html">function::ulonglong_arg.3stap</a></li>
-<li><a href="./function::umodname.3stap.html">function::umodname.3stap</a></li>
-<li><a href="./function::u_register.3stap.html">function::u_register.3stap</a></li>
-<li><a href="./function::usecs_to_string.3stap.html">function::usecs_to_string.3stap</a></li>
-<li><a href="./function::user_char.3stap.html">function::user_char.3stap</a></li>
-<li><a href="./function::user_char_warn.3stap.html">function::user_char_warn.3stap</a></li>
-<li><a href="./function::user_int16.3stap.html">function::user_int16.3stap</a></li>
-<li><a href="./function::user_int32.3stap.html">function::user_int32.3stap</a></li>
-<li><a href="./function::user_int.3stap.html">function::user_int.3stap</a></li>
-<li><a href="./function::user_int64.3stap.html">function::user_int64.3stap</a></li>
-<li><a href="./function::user_int8.3stap.html">function::user_int8.3stap</a></li>
-<li><a href="./function::user_int_warn.3stap.html">function::user_int_warn.3stap</a></li>
-<li><a href="./function::user_long.3stap.html">function::user_long.3stap</a></li>
-<li><a href="./function::user_long_warn.3stap.html">function::user_long_warn.3stap</a></li>
-<li><a href="./function::user_mode.3stap.html">function::user_mode.3stap</a></li>
-<li><a href="./function::user_short.3stap.html">function::user_short.3stap</a></li>
-<li><a href="./function::user_short_warn.3stap.html">function::user_short_warn.3stap</a></li>
-<li><a href="./function::user_string2.3stap.html">function::user_string2.3stap</a></li>
-<li><a href="./function::user_string2_n_warn.3stap.html">function::user_string2_n_warn.3stap</a></li>
-<li><a href="./function::user_string2_utf16.3stap.html">function::user_string2_utf16.3stap</a></li>
-<li><a href="./function::user_string2_utf32.3stap.html">function::user_string2_utf32.3stap</a></li>
-<li><a href="./function::user_string2_warn.3stap.html">function::user_string2_warn.3stap</a></li>
-<li><a href="./function::user_string.3stap.html">function::user_string.3stap</a></li>
-<li><a href="./function::user_string_n2.3stap.html">function::user_string_n2.3stap</a></li>
-<li><a href="./function::user_string_n2_quoted.3stap.html">function::user_string_n2_quoted.3stap</a></li>
-<li><a href="./function::user_string_n.3stap.html">function::user_string_n.3stap</a></li>
-<li><a href="./function::user_string_n_quoted.3stap.html">function::user_string_n_quoted.3stap</a></li>
-<li><a href="./function::user_string_n_warn.3stap.html">function::user_string_n_warn.3stap</a></li>
-<li><a href="./function::user_string_quoted.3stap.html">function::user_string_quoted.3stap</a></li>
-<li><a href="./function::user_string_utf16.3stap.html">function::user_string_utf16.3stap</a></li>
-<li><a href="./function::user_string_utf32.3stap.html">function::user_string_utf32.3stap</a></li>
-<li><a href="./function::user_string_warn.3stap.html">function::user_string_warn.3stap</a></li>
-<li><a href="./function::user_uint16.3stap.html">function::user_uint16.3stap</a></li>
-<li><a href="./function::user_uint32.3stap.html">function::user_uint32.3stap</a></li>
-<li><a href="./function::user_uint64.3stap.html">function::user_uint64.3stap</a></li>
-<li><a href="./function::user_uint8.3stap.html">function::user_uint8.3stap</a></li>
-<li><a href="./function::user_ushort.3stap.html">function::user_ushort.3stap</a></li>
-<li><a href="./function::user_ushort_warn.3stap.html">function::user_ushort_warn.3stap</a></li>
-<li><a href="./function::usrdev2kerndev.3stap.html">function::usrdev2kerndev.3stap</a></li>
-<li><a href="./function::ustack.3stap.html">function::ustack.3stap</a></li>
-<li><a href="./function::usymdata.3stap.html">function::usymdata.3stap</a></li>
-<li><a href="./function::usymname.3stap.html">function::usymname.3stap</a></li>
-<li><a href="./function::vm_fault_contains.3stap.html">function::vm_fault_contains.3stap</a></li>
-<li><a href="./function::warn.3stap.html">function::warn.3stap</a></li>
-<li><a href="./probe::ioblock.end.3stap.html">probe::ioblock.end.3stap</a></li>
-<li><a href="./probe::ioblock.request.3stap.html">probe::ioblock.request.3stap</a></li>
-<li><a href="./probe::ioblock_trace.bounce.3stap.html">probe::ioblock_trace.bounce.3stap</a></li>
-<li><a href="./probe::ioblock_trace.end.3stap.html">probe::ioblock_trace.end.3stap</a></li>
-<li><a href="./probe::ioblock_trace.request.3stap.html">probe::ioblock_trace.request.3stap</a></li>
-<li><a href="./probe::ioscheduler.elv_add_request.3stap.html">probe::ioscheduler.elv_add_request.3stap</a></li>
-<li><a href="./probe::ioscheduler.elv_add_request.kp.3stap.html">probe::ioscheduler.elv_add_request.kp.3stap</a></li>
-<li><a href="./probe::ioscheduler.elv_add_request.tp.3stap.html">probe::ioscheduler.elv_add_request.tp.3stap</a></li>
-<li><a href="./probe::ioscheduler.elv_completed_request.3stap.html">probe::ioscheduler.elv_completed_request.3stap</a></li>
-<li><a href="./probe::ioscheduler.elv_next_request.3stap.html">probe::ioscheduler.elv_next_request.3stap</a></li>
-<li><a href="./probe::ioscheduler.elv_next_request.return.3stap.html">probe::ioscheduler.elv_next_request.return.3stap</a></li>
-<li><a href="./probe::ioscheduler_trace.elv_abort_request.3stap.html">probe::ioscheduler_trace.elv_abort_request.3stap</a></li>
-<li><a href="./probe::ioscheduler_trace.elv_completed_request.3stap.html">probe::ioscheduler_trace.elv_completed_request.3stap</a></li>
-<li><a href="./probe::ioscheduler_trace.elv_issue_request.3stap.html">probe::ioscheduler_trace.elv_issue_request.3stap</a></li>
-<li><a href="./probe::ioscheduler_trace.elv_requeue_request.3stap.html">probe::ioscheduler_trace.elv_requeue_request.3stap</a></li>
-<li><a href="./probe::ioscheduler_trace.plug.3stap.html">probe::ioscheduler_trace.plug.3stap</a></li>
-<li><a href="./probe::ioscheduler_trace.unplug_io.3stap.html">probe::ioscheduler_trace.unplug_io.3stap</a></li>
-<li><a href="./probe::ioscheduler_trace.unplug_timer.3stap.html">probe::ioscheduler_trace.unplug_timer.3stap</a></li>
-<li><a href="./probe::ipmib.ForwDatagrams.3stap.html">probe::ipmib.ForwDatagrams.3stap</a></li>
-<li><a href="./probe::ipmib.FragFails.3stap.html">probe::ipmib.FragFails.3stap</a></li>
-<li><a href="./probe::ipmib.FragOKs.3stap.html">probe::ipmib.FragOKs.3stap</a></li>
-<li><a href="./probe::ipmib.InAddrErrors.3stap.html">probe::ipmib.InAddrErrors.3stap</a></li>
-<li><a href="./probe::ipmib.InDiscards.3stap.html">probe::ipmib.InDiscards.3stap</a></li>
-<li><a href="./probe::ipmib.InNoRoutes.3stap.html">probe::ipmib.InNoRoutes.3stap</a></li>
-<li><a href="./probe::ipmib.InReceives.3stap.html">probe::ipmib.InReceives.3stap</a></li>
-<li><a href="./probe::ipmib.InUnknownProtos.3stap.html">probe::ipmib.InUnknownProtos.3stap</a></li>
-<li><a href="./probe::ipmib.OutRequests.3stap.html">probe::ipmib.OutRequests.3stap</a></li>
-<li><a href="./probe::ipmib.ReasmReqds.3stap.html">probe::ipmib.ReasmReqds.3stap</a></li>
-<li><a href="./probe::ipmib.ReasmTimeout.3stap.html">probe::ipmib.ReasmTimeout.3stap</a></li>
-<li><a href="./probe::irq_handler.entry.3stap.html">probe::irq_handler.entry.3stap</a></li>
-<li><a href="./probe::irq_handler.exit.3stap.html">probe::irq_handler.exit.3stap</a></li>
-<li><a href="./probe::kprocess.create.3stap.html">probe::kprocess.create.3stap</a></li>
-<li><a href="./probe::kprocess.exec.3stap.html">probe::kprocess.exec.3stap</a></li>
-<li><a href="./probe::kprocess.exec_complete.3stap.html">probe::kprocess.exec_complete.3stap</a></li>
-<li><a href="./probe::kprocess.exit.3stap.html">probe::kprocess.exit.3stap</a></li>
-<li><a href="./probe::kprocess.release.3stap.html">probe::kprocess.release.3stap</a></li>
-<li><a href="./probe::kprocess.start.3stap.html">probe::kprocess.start.3stap</a></li>
-<li><a href="./probe::linuxmib.DelayedACKs.3stap.html">probe::linuxmib.DelayedACKs.3stap</a></li>
-<li><a href="./probe::linuxmib.ListenDrops.3stap.html">probe::linuxmib.ListenDrops.3stap</a></li>
-<li><a href="./probe::linuxmib.ListenOverflows.3stap.html">probe::linuxmib.ListenOverflows.3stap</a></li>
-<li><a href="./probe::linuxmib.TCPMemoryPressures.3stap.html">probe::linuxmib.TCPMemoryPressures.3stap</a></li>
-<li><a href="./probe::netdev.change_mac.3stap.html">probe::netdev.change_mac.3stap</a></li>
-<li><a href="./probe::netdev.change_mtu.3stap.html">probe::netdev.change_mtu.3stap</a></li>
-<li><a href="./probe::netdev.change_rx_flag.3stap.html">probe::netdev.change_rx_flag.3stap</a></li>
-<li><a href="./probe::netdev.close.3stap.html">probe::netdev.close.3stap</a></li>
-<li><a href="./probe::netdev.get_stats.3stap.html">probe::netdev.get_stats.3stap</a></li>
-<li><a href="./probe::netdev.hard_transmit.3stap.html">probe::netdev.hard_transmit.3stap</a></li>
-<li><a href="./probe::netdev.ioctl.3stap.html">probe::netdev.ioctl.3stap</a></li>
-<li><a href="./probe::netdev.open.3stap.html">probe::netdev.open.3stap</a></li>
-<li><a href="./probe::netdev.receive.3stap.html">probe::netdev.receive.3stap</a></li>
-<li><a href="./probe::netdev.register.3stap.html">probe::netdev.register.3stap</a></li>
-<li><a href="./probe::netdev.rx.3stap.html">probe::netdev.rx.3stap</a></li>
-<li><a href="./probe::netdev.set_promiscuity.3stap.html">probe::netdev.set_promiscuity.3stap</a></li>
-<li><a href="./probe::netdev.transmit.3stap.html">probe::netdev.transmit.3stap</a></li>
-<li><a href="./probe::netdev.unregister.3stap.html">probe::netdev.unregister.3stap</a></li>
-<li><a href="./probe::netfilter.arp.forward.3stap.html">probe::netfilter.arp.forward.3stap</a></li>
-<li><a href="./probe::netfilter.arp.in.3stap.html">probe::netfilter.arp.in.3stap</a></li>
-<li><a href="./probe::netfilter.arp.out.3stap.html">probe::netfilter.arp.out.3stap</a></li>
-<li><a href="./probe::netfilter.bridge.forward.3stap.html">probe::netfilter.bridge.forward.3stap</a></li>
-<li><a href="./probe::netfilter.bridge.local_in.3stap.html">probe::netfilter.bridge.local_in.3stap</a></li>
-<li><a href="./probe::netfilter.bridge.local_out.3stap.html">probe::netfilter.bridge.local_out.3stap</a></li>
-<li><a href="./probe::netfilter.bridge.post_routing.3stap.html">probe::netfilter.bridge.post_routing.3stap</a></li>
-<li><a href="./probe::netfilter.bridge.pre_routing.3stap.html">probe::netfilter.bridge.pre_routing.3stap</a></li>
-<li><a href="./probe::netfilter.ip.forward.3stap.html">probe::netfilter.ip.forward.3stap</a></li>
-<li><a href="./probe::netfilter.ip.local_in.3stap.html">probe::netfilter.ip.local_in.3stap</a></li>
-<li><a href="./probe::netfilter.ip.local_out.3stap.html">probe::netfilter.ip.local_out.3stap</a></li>
-<li><a href="./probe::netfilter.ip.post_routing.3stap.html">probe::netfilter.ip.post_routing.3stap</a></li>
-<li><a href="./probe::netfilter.ip.pre_routing.3stap.html">probe::netfilter.ip.pre_routing.3stap</a></li>
-<li><a href="./probe::nfs.aop.readpage.3stap.html">probe::nfs.aop.readpage.3stap</a></li>
-<li><a href="./probe::nfs.aop.readpages.3stap.html">probe::nfs.aop.readpages.3stap</a></li>
-<li><a href="./probe::nfs.aop.release_page.3stap.html">probe::nfs.aop.release_page.3stap</a></li>
-<li><a href="./probe::nfs.aop.set_page_dirty.3stap.html">probe::nfs.aop.set_page_dirty.3stap</a></li>
-<li><a href="./probe::nfs.aop.write_begin.3stap.html">probe::nfs.aop.write_begin.3stap</a></li>
-<li><a href="./probe::nfs.aop.write_end.3stap.html">probe::nfs.aop.write_end.3stap</a></li>
-<li><a href="./probe::nfs.aop.writepage.3stap.html">probe::nfs.aop.writepage.3stap</a></li>
-<li><a href="./probe::nfs.aop.writepages.3stap.html">probe::nfs.aop.writepages.3stap</a></li>
-<li><a href="./probe::nfsd.close.3stap.html">probe::nfsd.close.3stap</a></li>
-<li><a href="./probe::nfsd.commit.3stap.html">probe::nfsd.commit.3stap</a></li>
-<li><a href="./probe::nfsd.create.3stap.html">probe::nfsd.create.3stap</a></li>
-<li><a href="./probe::nfsd.createv3.3stap.html">probe::nfsd.createv3.3stap</a></li>
-<li><a href="./probe::nfsd.dispatch.3stap.html">probe::nfsd.dispatch.3stap</a></li>
-<li><a href="./probe::nfsd.lookup.3stap.html">probe::nfsd.lookup.3stap</a></li>
-<li><a href="./probe::nfsd.open.3stap.html">probe::nfsd.open.3stap</a></li>
-<li><a href="./probe::nfsd.proc.commit.3stap.html">probe::nfsd.proc.commit.3stap</a></li>
-<li><a href="./probe::nfsd.proc.create.3stap.html">probe::nfsd.proc.create.3stap</a></li>
-<li><a href="./probe::nfsd.proc.lookup.3stap.html">probe::nfsd.proc.lookup.3stap</a></li>
-<li><a href="./probe::nfsd.proc.read.3stap.html">probe::nfsd.proc.read.3stap</a></li>
-<li><a href="./probe::nfsd.proc.remove.3stap.html">probe::nfsd.proc.remove.3stap</a></li>
-<li><a href="./probe::nfsd.proc.rename.3stap.html">probe::nfsd.proc.rename.3stap</a></li>
-<li><a href="./probe::nfsd.proc.write.3stap.html">probe::nfsd.proc.write.3stap</a></li>
-<li><a href="./probe::nfsd.read.3stap.html">probe::nfsd.read.3stap</a></li>
-<li><a href="./probe::nfsd.rename.3stap.html">probe::nfsd.rename.3stap</a></li>
-<li><a href="./probe::nfsd.unlink.3stap.html">probe::nfsd.unlink.3stap</a></li>
-<li><a href="./probe::nfsd.write.3stap.html">probe::nfsd.write.3stap</a></li>
-<li><a href="./probe::nfs.fop.aio_read.3stap.html">probe::nfs.fop.aio_read.3stap</a></li>
-<li><a href="./probe::nfs.fop.aio_write.3stap.html">probe::nfs.fop.aio_write.3stap</a></li>
-<li><a href="./probe::nfs.fop.check_flags.3stap.html">probe::nfs.fop.check_flags.3stap</a></li>
-<li><a href="./probe::nfs.fop.flush.3stap.html">probe::nfs.fop.flush.3stap</a></li>
-<li><a href="./probe::nfs.fop.fsync.3stap.html">probe::nfs.fop.fsync.3stap</a></li>
-<li><a href="./probe::nfs.fop.llseek.3stap.html">probe::nfs.fop.llseek.3stap</a></li>
-<li><a href="./probe::nfs.fop.lock.3stap.html">probe::nfs.fop.lock.3stap</a></li>
-<li><a href="./probe::nfs.fop.mmap.3stap.html">probe::nfs.fop.mmap.3stap</a></li>
-<li><a href="./probe::nfs.fop.open.3stap.html">probe::nfs.fop.open.3stap</a></li>
-<li><a href="./probe::nfs.fop.read.3stap.html">probe::nfs.fop.read.3stap</a></li>
-<li><a href="./probe::nfs.fop.release.3stap.html">probe::nfs.fop.release.3stap</a></li>
-<li><a href="./probe::nfs.fop.sendfile.3stap.html">probe::nfs.fop.sendfile.3stap</a></li>
-<li><a href="./probe::nfs.fop.write.3stap.html">probe::nfs.fop.write.3stap</a></li>
-<li><a href="./probe::nfs.proc.commit.3stap.html">probe::nfs.proc.commit.3stap</a></li>
-<li><a href="./probe::nfs.proc.commit_done.3stap.html">probe::nfs.proc.commit_done.3stap</a></li>
-<li><a href="./probe::nfs.proc.commit_setup.3stap.html">probe::nfs.proc.commit_setup.3stap</a></li>
-<li><a href="./probe::nfs.proc.create.3stap.html">probe::nfs.proc.create.3stap</a></li>
-<li><a href="./probe::nfs.proc.handle_exception.3stap.html">probe::nfs.proc.handle_exception.3stap</a></li>
-<li><a href="./probe::nfs.proc.lookup.3stap.html">probe::nfs.proc.lookup.3stap</a></li>
-<li><a href="./probe::nfs.proc.open.3stap.html">probe::nfs.proc.open.3stap</a></li>
-<li><a href="./probe::nfs.proc.read.3stap.html">probe::nfs.proc.read.3stap</a></li>
-<li><a href="./probe::nfs.proc.read_done.3stap.html">probe::nfs.proc.read_done.3stap</a></li>
-<li><a href="./probe::nfs.proc.read_setup.3stap.html">probe::nfs.proc.read_setup.3stap</a></li>
-<li><a href="./probe::nfs.proc.release.3stap.html">probe::nfs.proc.release.3stap</a></li>
-<li><a href="./probe::nfs.proc.remove.3stap.html">probe::nfs.proc.remove.3stap</a></li>
-<li><a href="./probe::nfs.proc.rename.3stap.html">probe::nfs.proc.rename.3stap</a></li>
-<li><a href="./probe::nfs.proc.write.3stap.html">probe::nfs.proc.write.3stap</a></li>
-<li><a href="./probe::nfs.proc.write_done.3stap.html">probe::nfs.proc.write_done.3stap</a></li>
-<li><a href="./probe::nfs.proc.write_setup.3stap.html">probe::nfs.proc.write_setup.3stap</a></li>
-<li><a href="./probe::scheduler.balance.3stap.html">probe::scheduler.balance.3stap</a></li>
-<li><a href="./probe::scheduler.cpu_off.3stap.html">probe::scheduler.cpu_off.3stap</a></li>
-<li><a href="./probe::scheduler.cpu_on.3stap.html">probe::scheduler.cpu_on.3stap</a></li>
-<li><a href="./probe::scheduler.ctxswitch.3stap.html">probe::scheduler.ctxswitch.3stap</a></li>
-<li><a href="./probe::scheduler.kthread_stop.3stap.html">probe::scheduler.kthread_stop.3stap</a></li>
-<li><a href="./probe::scheduler.kthread_stop.return.3stap.html">probe::scheduler.kthread_stop.return.3stap</a></li>
-<li><a href="./probe::scheduler.migrate.3stap.html">probe::scheduler.migrate.3stap</a></li>
-<li><a href="./probe::scheduler.process_exit.3stap.html">probe::scheduler.process_exit.3stap</a></li>
-<li><a href="./probe::scheduler.process_fork.3stap.html">probe::scheduler.process_fork.3stap</a></li>
-<li><a href="./probe::scheduler.process_free.3stap.html">probe::scheduler.process_free.3stap</a></li>
-<li><a href="./probe::scheduler.process_wait.3stap.html">probe::scheduler.process_wait.3stap</a></li>
-<li><a href="./probe::scheduler.signal_send.3stap.html">probe::scheduler.signal_send.3stap</a></li>
-<li><a href="./probe::scheduler.tick.3stap.html">probe::scheduler.tick.3stap</a></li>
-<li><a href="./probe::scheduler.wait_task.3stap.html">probe::scheduler.wait_task.3stap</a></li>
-<li><a href="./probe::scheduler.wakeup.3stap.html">probe::scheduler.wakeup.3stap</a></li>
-<li><a href="./probe::scheduler.wakeup_new.3stap.html">probe::scheduler.wakeup_new.3stap</a></li>
-<li><a href="./probe::scsi.iocompleted.3stap.html">probe::scsi.iocompleted.3stap</a></li>
-<li><a href="./probe::scsi.iodispatching.3stap.html">probe::scsi.iodispatching.3stap</a></li>
-<li><a href="./probe::scsi.iodone.3stap.html">probe::scsi.iodone.3stap</a></li>
-<li><a href="./probe::scsi.ioentry.3stap.html">probe::scsi.ioentry.3stap</a></li>
-<li><a href="./probe::scsi.ioexecute.3stap.html">probe::scsi.ioexecute.3stap</a></li>
-<li><a href="./probe::scsi.set_state.3stap.html">probe::scsi.set_state.3stap</a></li>
-<li><a href="./probe::signal.check_ignored.3stap.html">probe::signal.check_ignored.3stap</a></li>
-<li><a href="./probe::signal.check_ignored.return.3stap.html">probe::signal.check_ignored.return.3stap</a></li>
-<li><a href="./probe::signal.checkperm.3stap.html">probe::signal.checkperm.3stap</a></li>
-<li><a href="./probe::signal.checkperm.return.3stap.html">probe::signal.checkperm.return.3stap</a></li>
-<li><a href="./probe::signal.do_action.3stap.html">probe::signal.do_action.3stap</a></li>
-<li><a href="./probe::signal.do_action.return.3stap.html">probe::signal.do_action.return.3stap</a></li>
-<li><a href="./probe::signal.flush.3stap.html">probe::signal.flush.3stap</a></li>
-<li><a href="./probe::signal.force_segv.3stap.html">probe::signal.force_segv.3stap</a></li>
-<li><a href="./probe::signal.force_segv.return.3stap.html">probe::signal.force_segv.return.3stap</a></li>
-<li><a href="./probe::signal.handle.3stap.html">probe::signal.handle.3stap</a></li>
-<li><a href="./probe::signal.handle.return.3stap.html">probe::signal.handle.return.3stap</a></li>
-<li><a href="./probe::signal.pending.3stap.html">probe::signal.pending.3stap</a></li>
-<li><a href="./probe::signal.pending.return.3stap.html">probe::signal.pending.return.3stap</a></li>
-<li><a href="./probe::signal.procmask.3stap.html">probe::signal.procmask.3stap</a></li>
-<li><a href="./probe::signal.procmask.return.3stap.html">probe::signal.procmask.return.3stap</a></li>
-<li><a href="./probe::signal.send.3stap.html">probe::signal.send.3stap</a></li>
-<li><a href="./probe::signal.send.return.3stap.html">probe::signal.send.return.3stap</a></li>
-<li><a href="./probe::signal.send_sig_queue.3stap.html">probe::signal.send_sig_queue.3stap</a></li>
-<li><a href="./probe::signal.send_sig_queue.return.3stap.html">probe::signal.send_sig_queue.return.3stap</a></li>
-<li><a href="./probe::signal.syskill.3stap.html">probe::signal.syskill.3stap</a></li>
-<li><a href="./probe::signal.syskill.return.3stap.html">probe::signal.syskill.return.3stap</a></li>
-<li><a href="./probe::signal.sys_tgkill.3stap.html">probe::signal.sys_tgkill.3stap</a></li>
-<li><a href="./probe::signal.sys_tgkill.return.3stap.html">probe::signal.sys_tgkill.return.3stap</a></li>
-<li><a href="./probe::signal.sys_tkill.3stap.html">probe::signal.sys_tkill.3stap</a></li>
-<li><a href="./probe::signal.systkill.return.3stap.html">probe::signal.systkill.return.3stap</a></li>
-<li><a href="./probe::signal.wakeup.3stap.html">probe::signal.wakeup.3stap</a></li>
-<li><a href="./probe::socket.aio_read.3stap.html">probe::socket.aio_read.3stap</a></li>
-<li><a href="./probe::socket.aio_read.return.3stap.html">probe::socket.aio_read.return.3stap</a></li>
-<li><a href="./probe::socket.aio_write.3stap.html">probe::socket.aio_write.3stap</a></li>
-<li><a href="./probe::socket.aio_write.return.3stap.html">probe::socket.aio_write.return.3stap</a></li>
-<li><a href="./probe::socket.close.3stap.html">probe::socket.close.3stap</a></li>
-<li><a href="./probe::socket.close.return.3stap.html">probe::socket.close.return.3stap</a></li>
-<li><a href="./probe::socket.create.3stap.html">probe::socket.create.3stap</a></li>
-<li><a href="./probe::socket.create.return.3stap.html">probe::socket.create.return.3stap</a></li>
-<li><a href="./probe::socket.readv.3stap.html">probe::socket.readv.3stap</a></li>
-<li><a href="./probe::socket.readv.return.3stap.html">probe::socket.readv.return.3stap</a></li>
-<li><a href="./probe::socket.receive.3stap.html">probe::socket.receive.3stap</a></li>
-<li><a href="./probe::socket.recvmsg.3stap.html">probe::socket.recvmsg.3stap</a></li>
-<li><a href="./probe::socket.recvmsg.return.3stap.html">probe::socket.recvmsg.return.3stap</a></li>
-<li><a href="./probe::socket.send.3stap.html">probe::socket.send.3stap</a></li>
-<li><a href="./probe::socket.sendmsg.3stap.html">probe::socket.sendmsg.3stap</a></li>
-<li><a href="./probe::socket.sendmsg.return.3stap.html">probe::socket.sendmsg.return.3stap</a></li>
-<li><a href="./probe::socket.writev.3stap.html">probe::socket.writev.3stap</a></li>
-<li><a href="./probe::socket.writev.return.3stap.html">probe::socket.writev.return.3stap</a></li>
-<li><a href="./probe::softirq.entry.3stap.html">probe::softirq.entry.3stap</a></li>
-<li><a href="./probe::softirq.exit.3stap.html">probe::softirq.exit.3stap</a></li>
-<li><a href="./probe::stap.cache_add_mod.3stap.html">probe::stap.cache_add_mod.3stap</a></li>
-<li><a href="./probe::stap.cache_add_nss.3stap.html">probe::stap.cache_add_nss.3stap</a></li>
-<li><a href="./probe::stap.cache_add_src.3stap.html">probe::stap.cache_add_src.3stap</a></li>
-<li><a href="./probe::stap.cache_clean.3stap.html">probe::stap.cache_clean.3stap</a></li>
-<li><a href="./probe::stap.cache_get.3stap.html">probe::stap.cache_get.3stap</a></li>
-<li><a href="./probe::stapio.receive_control_message.3stap.html">probe::stapio.receive_control_message.3stap</a></li>
-<li><a href="./probe::stap.pass0.3stap.html">probe::stap.pass0.3stap</a></li>
-<li><a href="./probe::stap.pass0.end.3stap.html">probe::stap.pass0.end.3stap</a></li>
-<li><a href="./probe::stap.pass1a.3stap.html">probe::stap.pass1a.3stap</a></li>
-<li><a href="./probe::stap.pass1b.3stap.html">probe::stap.pass1b.3stap</a></li>
-<li><a href="./probe::stap.pass1.end.3stap.html">probe::stap.pass1.end.3stap</a></li>
-<li><a href="./probe::stap.pass2.3stap.html">probe::stap.pass2.3stap</a></li>
-<li><a href="./probe::stap.pass2.end.3stap.html">probe::stap.pass2.end.3stap</a></li>
-<li><a href="./probe::stap.pass3.3stap.html">probe::stap.pass3.3stap</a></li>
-<li><a href="./probe::stap.pass3.end.3stap.html">probe::stap.pass3.end.3stap</a></li>
-<li><a href="./probe::stap.pass4.3stap.html">probe::stap.pass4.3stap</a></li>
-<li><a href="./probe::stap.pass4.end.3stap.html">probe::stap.pass4.end.3stap</a></li>
-<li><a href="./probe::stap.pass5.3stap.html">probe::stap.pass5.3stap</a></li>
-<li><a href="./probe::stap.pass5.end.3stap.html">probe::stap.pass5.end.3stap</a></li>
-<li><a href="./probe::stap.pass6.3stap.html">probe::stap.pass6.3stap</a></li>
-<li><a href="./probe::stap.pass6.end.3stap.html">probe::stap.pass6.end.3stap</a></li>
-<li><a href="./probe::staprun.insert_module.3stap.html">probe::staprun.insert_module.3stap</a></li>
-<li><a href="./probe::staprun.remove_module.3stap.html">probe::staprun.remove_module.3stap</a></li>
-<li><a href="./probe::staprun.send_control_message.3stap.html">probe::staprun.send_control_message.3stap</a></li>
-<li><a href="./probe::stap.system.3stap.html">probe::stap.system.3stap</a></li>
-<li><a href="./probe::stap.system.return.3stap.html">probe::stap.system.return.3stap</a></li>
-<li><a href="./probe::stap.system.spawn.3stap.html">probe::stap.system.spawn.3stap</a></li>
-<li><a href="./probe::sunrpc.clnt.bind_new_program.3stap.html">probe::sunrpc.clnt.bind_new_program.3stap</a></li>
-<li><a href="./probe::sunrpc.clnt.call_async.3stap.html">probe::sunrpc.clnt.call_async.3stap</a></li>
-<li><a href="./probe::sunrpc.clnt.call_sync.3stap.html">probe::sunrpc.clnt.call_sync.3stap</a></li>
-<li><a href="./probe::sunrpc.clnt.clone_client.3stap.html">probe::sunrpc.clnt.clone_client.3stap</a></li>
-<li><a href="./probe::sunrpc.clnt.create_client.3stap.html">probe::sunrpc.clnt.create_client.3stap</a></li>
-<li><a href="./probe::sunrpc.clnt.restart_call.3stap.html">probe::sunrpc.clnt.restart_call.3stap</a></li>
-<li><a href="./probe::sunrpc.clnt.shutdown_client.3stap.html">probe::sunrpc.clnt.shutdown_client.3stap</a></li>
-<li><a href="./probe::sunrpc.sched.delay.3stap.html">probe::sunrpc.sched.delay.3stap</a></li>
-<li><a href="./probe::sunrpc.sched.execute.3stap.html">probe::sunrpc.sched.execute.3stap</a></li>
-<li><a href="./probe::sunrpc.sched.new_task.3stap.html">probe::sunrpc.sched.new_task.3stap</a></li>
-<li><a href="./probe::sunrpc.sched.release_task.3stap.html">probe::sunrpc.sched.release_task.3stap</a></li>
-<li><a href="./probe::sunrpc.svc.create.3stap.html">probe::sunrpc.svc.create.3stap</a></li>
-<li><a href="./probe::sunrpc.svc.destroy.3stap.html">probe::sunrpc.svc.destroy.3stap</a></li>
-<li><a href="./probe::sunrpc.svc.drop.3stap.html">probe::sunrpc.svc.drop.3stap</a></li>
-<li><a href="./probe::sunrpc.svc.process.3stap.html">probe::sunrpc.svc.process.3stap</a></li>
-<li><a href="./probe::sunrpc.svc.recv.3stap.html">probe::sunrpc.svc.recv.3stap</a></li>
-<li><a href="./probe::sunrpc.svc.register.3stap.html">probe::sunrpc.svc.register.3stap</a></li>
-<li><a href="./probe::sunrpc.svc.send.3stap.html">probe::sunrpc.svc.send.3stap</a></li>
-<li><a href="./probe::tcp.disconnect.3stap.html">probe::tcp.disconnect.3stap</a></li>
-<li><a href="./probe::tcp.disconnect.return.3stap.html">probe::tcp.disconnect.return.3stap</a></li>
-<li><a href="./probe::tcpmib.ActiveOpens.3stap.html">probe::tcpmib.ActiveOpens.3stap</a></li>
-<li><a href="./probe::tcpmib.AttemptFails.3stap.html">probe::tcpmib.AttemptFails.3stap</a></li>
-<li><a href="./probe::tcpmib.CurrEstab.3stap.html">probe::tcpmib.CurrEstab.3stap</a></li>
-<li><a href="./probe::tcpmib.EstabResets.3stap.html">probe::tcpmib.EstabResets.3stap</a></li>
-<li><a href="./probe::tcpmib.InSegs.3stap.html">probe::tcpmib.InSegs.3stap</a></li>
-<li><a href="./probe::tcpmib.OutRsts.3stap.html">probe::tcpmib.OutRsts.3stap</a></li>
-<li><a href="./probe::tcpmib.OutSegs.3stap.html">probe::tcpmib.OutSegs.3stap</a></li>
-<li><a href="./probe::tcpmib.PassiveOpens.3stap.html">probe::tcpmib.PassiveOpens.3stap</a></li>
-<li><a href="./probe::tcpmib.RetransSegs.3stap.html">probe::tcpmib.RetransSegs.3stap</a></li>
-<li><a href="./probe::tcp.receive.3stap.html">probe::tcp.receive.3stap</a></li>
-<li><a href="./probe::tcp.recvmsg.3stap.html">probe::tcp.recvmsg.3stap</a></li>
-<li><a href="./probe::tcp.recvmsg.return.3stap.html">probe::tcp.recvmsg.return.3stap</a></li>
-<li><a href="./probe::tcp.sendmsg.3stap.html">probe::tcp.sendmsg.3stap</a></li>
-<li><a href="./probe::tcp.sendmsg.return.3stap.html">probe::tcp.sendmsg.return.3stap</a></li>
-<li><a href="./probe::tcp.setsockopt.3stap.html">probe::tcp.setsockopt.3stap</a></li>
-<li><a href="./probe::tcp.setsockopt.return.3stap.html">probe::tcp.setsockopt.return.3stap</a></li>
-<li><a href="./probe::tty.init.3stap.html">probe::tty.init.3stap</a></li>
-<li><a href="./probe::tty.ioctl.3stap.html">probe::tty.ioctl.3stap</a></li>
-<li><a href="./probe::tty.open.3stap.html">probe::tty.open.3stap</a></li>
-<li><a href="./probe::tty.poll.3stap.html">probe::tty.poll.3stap</a></li>
-<li><a href="./probe::tty.read.3stap.html">probe::tty.read.3stap</a></li>
-<li><a href="./probe::tty.receive.3stap.html">probe::tty.receive.3stap</a></li>
-<li><a href="./probe::tty.register.3stap.html">probe::tty.register.3stap</a></li>
-<li><a href="./probe::tty.release.3stap.html">probe::tty.release.3stap</a></li>
-<li><a href="./probe::tty.resize.3stap.html">probe::tty.resize.3stap</a></li>
-<li><a href="./probe::tty.unregister.3stap.html">probe::tty.unregister.3stap</a></li>
-<li><a href="./probe::tty.write.3stap.html">probe::tty.write.3stap</a></li>
-<li><a href="./probe::udp.disconnect.3stap.html">probe::udp.disconnect.3stap</a></li>
-<li><a href="./probe::udp.disconnect.return.3stap.html">probe::udp.disconnect.return.3stap</a></li>
-<li><a href="./probe::udp.recvmsg.3stap.html">probe::udp.recvmsg.3stap</a></li>
-<li><a href="./probe::udp.recvmsg.return.3stap.html">probe::udp.recvmsg.return.3stap</a></li>
-<li><a href="./probe::udp.sendmsg.3stap.html">probe::udp.sendmsg.3stap</a></li>
-<li><a href="./probe::udp.sendmsg.return.3stap.html">probe::udp.sendmsg.return.3stap</a></li>
-<li><a href="./probe::vm.brk.3stap.html">probe::vm.brk.3stap</a></li>
-<li><a href="./probe::vm.kfree.3stap.html">probe::vm.kfree.3stap</a></li>
-<li><a href="./probe::vm.kmalloc.3stap.html">probe::vm.kmalloc.3stap</a></li>
-<li><a href="./probe::vm.kmalloc_node.3stap.html">probe::vm.kmalloc_node.3stap</a></li>
-<li><a href="./probe::vm.kmem_cache_alloc.3stap.html">probe::vm.kmem_cache_alloc.3stap</a></li>
-<li><a href="./probe::vm.kmem_cache_alloc_node.3stap.html">probe::vm.kmem_cache_alloc_node.3stap</a></li>
-<li><a href="./probe::vm.kmem_cache_free.3stap.html">probe::vm.kmem_cache_free.3stap</a></li>
-<li><a href="./probe::vm.mmap.3stap.html">probe::vm.mmap.3stap</a></li>
-<li><a href="./probe::vm.munmap.3stap.html">probe::vm.munmap.3stap</a></li>
-<li><a href="./probe::vm.oom_kill.3stap.html">probe::vm.oom_kill.3stap</a></li>
-<li><a href="./probe::vm.pagefault.3stap.html">probe::vm.pagefault.3stap</a></li>
-<li><a href="./probe::vm.pagefault.return.3stap.html">probe::vm.pagefault.return.3stap</a></li>
-<li><a href="./probe::vm.write_shared.3stap.html">probe::vm.write_shared.3stap</a></li>
-<li><a href="./probe::vm.write_shared_copy.3stap.html">probe::vm.write_shared_copy.3stap</a></li>
-<li><a href="./probe::workqueue.create.3stap.html">probe::workqueue.create.3stap</a></li>
-<li><a href="./probe::workqueue.destroy.3stap.html">probe::workqueue.destroy.3stap</a></li>
-<li><a href="./probe::workqueue.execute.3stap.html">probe::workqueue.execute.3stap</a></li>
-<li><a href="./probe::workqueue.insert.3stap.html">probe::workqueue.insert.3stap</a></li>
-<li><a href="./stapex.3stap.html">stapex.3stap</a></li>
-<li><a href="./stapfuncs.3stap.html">stapfuncs.3stap</a></li>
-<li><a href="./stapprobes.3stap.html">stapprobes.3stap</a></li>
-<li><a href="./stapvars.3stap.html">stapvars.3stap</a></li>
-<li><a href="./tapset::ansi.3stap.html">tapset::ansi.3stap</a></li>
-<li><a href="./tapset::atomic.3stap.html">tapset::atomic.3stap</a></li>
-<li><a href="./tapset::context.3stap.html">tapset::context.3stap</a></li>
-<li><a href="./tapset::context-caller.3stap.html">tapset::context-caller.3stap</a></li>
-<li><a href="./tapset::context-envvar.3stap.html">tapset::context-envvar.3stap</a></li>
-<li><a href="./tapset::context-symbols.3stap.html">tapset::context-symbols.3stap</a></li>
-<li><a href="./tapset::context-unwind.3stap.html">tapset::context-unwind.3stap</a></li>
-<li><a href="./tapset::conversions.3stap.html">tapset::conversions.3stap</a></li>
-<li><a href="./tapset::conversions-guru.3stap.html">tapset::conversions-guru.3stap</a></li>
-<li><a href="./tapset::ctime.3stap.html">tapset::ctime.3stap</a></li>
-<li><a href="./tapset::dentry.3stap.html">tapset::dentry.3stap</a></li>
-<li><a href="./tapset::dev.3stap.html">tapset::dev.3stap</a></li>
-<li><a href="./tapset::errno.3stap.html">tapset::errno.3stap</a></li>
-<li><a href="./tapset::guru-delay.3stap.html">tapset::guru-delay.3stap</a></li>
-<li><a href="./tapset::guru-signal.3stap.html">tapset::guru-signal.3stap</a></li>
-<li><a href="./tapset::indent.3stap.html">tapset::indent.3stap</a></li>
-<li><a href="./tapset::inet.3stap.html">tapset::inet.3stap</a></li>
-<li><a href="./tapset::inet_sock.3stap.html">tapset::inet_sock.3stap</a></li>
-<li><a href="./tapset::ioblock.3stap.html">tapset::ioblock.3stap</a></li>
-<li><a href="./tapset::ioscheduler.3stap.html">tapset::ioscheduler.3stap</a></li>
-<li><a href="./tapset::ip.3stap.html">tapset::ip.3stap</a></li>
-<li><a href="./tapset::ipmib.3stap.html">tapset::ipmib.3stap</a></li>
-<li><a href="./tapset::ipmib-filter-default.3stap.html">tapset::ipmib-filter-default.3stap</a></li>
-<li><a href="./tapset::irq.3stap.html">tapset::irq.3stap</a></li>
-<li><a href="./tapset::kprocess.3stap.html">tapset::kprocess.3stap</a></li>
-<li><a href="./tapset::linuxmib.3stap.html">tapset::linuxmib.3stap</a></li>
-<li><a href="./tapset::linuxmib-filter-default.3stap.html">tapset::linuxmib-filter-default.3stap</a></li>
-<li><a href="./tapset::loadavg.3stap.html">tapset::loadavg.3stap</a></li>
-<li><a href="./tapset::logging.3stap.html">tapset::logging.3stap</a></li>
-<li><a href="./tapset::memory.3stap.html">tapset::memory.3stap</a></li>
-<li><a href="./tapset::netfilter.3stap.html">tapset::netfilter.3stap</a></li>
-<li><a href="./tapset::networking.3stap.html">tapset::networking.3stap</a></li>
-<li><a href="./tapset::nfs.3stap.html">tapset::nfs.3stap</a></li>
-<li><a href="./tapset::nfsd.3stap.html">tapset::nfsd.3stap</a></li>
-<li><a href="./tapset::nfsderrno.3stap.html">tapset::nfsderrno.3stap</a></li>
-<li><a href="./tapset::nfs_proc.3stap.html">tapset::nfs_proc.3stap</a></li>
-<li><a href="./tapset::panic.3stap.html">tapset::panic.3stap</a></li>
-<li><a href="./tapset::pn.3stap.html">tapset::pn.3stap</a></li>
-<li><a href="./tapset::proc_mem.3stap.html">tapset::proc_mem.3stap</a></li>
-<li><a href="./tapset::pstrace.3stap.html">tapset::pstrace.3stap</a></li>
-<li><a href="./tapset::queue_stats.3stap.html">tapset::queue_stats.3stap</a></li>
-<li><a href="./tapset::random.3stap.html">tapset::random.3stap</a></li>
-<li><a href="./tapset::registers.3stap.html">tapset::registers.3stap</a></li>
-<li><a href="./tapset::rpc.3stap.html">tapset::rpc.3stap</a></li>
-<li><a href="./tapset::scheduler.3stap.html">tapset::scheduler.3stap</a></li>
-<li><a href="./tapset::scsi.3stap.html">tapset::scsi.3stap</a></li>
-<li><a href="./tapset::signal.3stap.html">tapset::signal.3stap</a></li>
-<li><a href="./tapset::socket.3stap.html">tapset::socket.3stap</a></li>
-<li><a href="./tapset::speculative.3stap.html">tapset::speculative.3stap</a></li>
-<li><a href="./tapset::stap_staticmarkers.3stap.html">tapset::stap_staticmarkers.3stap</a></li>
-<li><a href="./tapset::stopwatch.3stap.html">tapset::stopwatch.3stap</a></li>
-<li><a href="./tapset::string.3stap.html">tapset::string.3stap</a></li>
-<li><a href="./tapset::system.3stap.html">tapset::system.3stap</a></li>
-<li><a href="./tapset::target_set.3stap.html">tapset::target_set.3stap</a></li>
-<li><a href="./tapset::task.3stap.html">tapset::task.3stap</a></li>
-<li><a href="./tapset::task_ancestry.3stap.html">tapset::task_ancestry.3stap</a></li>
-<li><a href="./tapset::task_time.3stap.html">tapset::task_time.3stap</a></li>
-<li><a href="./tapset::tcp.3stap.html">tapset::tcp.3stap</a></li>
-<li><a href="./tapset::tcpmib.3stap.html">tapset::tcpmib.3stap</a></li>
-<li><a href="./tapset::tcpmib-filter-default.3stap.html">tapset::tcpmib-filter-default.3stap</a></li>
-<li><a href="./tapset::timestamp.3stap.html">tapset::timestamp.3stap</a></li>
-<li><a href="./tapset::timestamp_gtod.3stap.html">tapset::timestamp_gtod.3stap</a></li>
-<li><a href="./tapset::timestamp_monotonic.3stap.html">tapset::timestamp_monotonic.3stap</a></li>
-<li><a href="./tapset::tokenize.3stap.html">tapset::tokenize.3stap</a></li>
-<li><a href="./tapset::tty.3stap.html">tapset::tty.3stap</a></li>
-<li><a href="./tapset::tzinfo.3stap.html">tapset::tzinfo.3stap</a></li>
-<li><a href="./tapset::ucontext.3stap.html">tapset::ucontext.3stap</a></li>
-<li><a href="./tapset::ucontext-symbols.3stap.html">tapset::ucontext-symbols.3stap</a></li>
-<li><a href="./tapset::ucontext-unwind.3stap.html">tapset::ucontext-unwind.3stap</a></li>
-<li><a href="./tapset::uconversions.3stap.html">tapset::uconversions.3stap</a></li>
-<li><a href="./tapset::udp.3stap.html">tapset::udp.3stap</a></li>
-<li><a href="./error::buildid.7stap.html">error::buildid.7stap</a></li>
-<li><a href="./error::dwarf.7stap.html">error::dwarf.7stap</a></li>
-<li><a href="./error::fault.7stap.html">error::fault.7stap</a></li>
-<li><a href="./error::inode-uprobes.7stap.html">error::inode-uprobes.7stap</a></li>
-<li><a href="./error::pass1.7stap.html">error::pass1.7stap</a></li>
-<li><a href="./error::pass2.7stap.html">error::pass2.7stap</a></li>
-<li><a href="./error::pass3.7stap.html">error::pass3.7stap</a></li>
-<li><a href="./error::pass4.7stap.html">error::pass4.7stap</a></li>
-<li><a href="./error::pass5.7stap.html">error::pass5.7stap</a></li>
-<li><a href="./error::process-tracking.7stap.html">error::process-tracking.7stap</a></li>
-<li><a href="./error::reporting.7stap.html">error::reporting.7stap</a></li>
-<li><a href="./error::sdt.7stap.html">error::sdt.7stap</a></li>
-<li><a href="./stappaths.7.html">stappaths.7</a></li>
-<li><a href="./warning::debuginfo.7stap.html">warning::debuginfo.7stap</a></li>
-<li><a href="./warning::process-tracking.7stap.html">warning::process-tracking.7stap</a></li>
-<li><a href="./stapdyn.8.html">stapdyn.8</a></li>
-<li><a href="./staprun.8.html">staprun.8</a></li>
-<li><a href="./stap-server.8.html">stap-server.8</a></li>
-<li><a href="./stapsh.8.html">stapsh.8</a></li>
-<li><a href="./systemtap.8.html">systemtap.8</a></li>
-</ul></body></html>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOBLOCK\&.END</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOBLOCK\&.END</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioblock.end - Fires whenever a block I/O transfer is complete.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioblock.end
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-<I>name</I>
-- name of the probe point
-<I>devname</I>
-- block device name
-<I>ino</I>
-- i-node number of the mapped file
-<I>bytes_done</I>
-- number of bytes transferred
-<I>sector</I>
-- beginning sector for the entire bio
-<I>flags</I>
-- see below BIO_UPTODATE 0 ok after I/O completion BIO_RW_BLOCK 1 RW_AHEAD set, and read/write would block BIO_EOF 2 out-out-bounds error BIO_SEG_VALID 3 nr_hw_seg valid BIO_CLONED 4 doesn't own data BIO_BOUNCED 5 bio is a bounce bio BIO_USER_MAPPED 6 contains user pages BIO_EOPNOTSUPP 7 not supported
-<I>error</I>
-- 0 on success
-<I>rw</I>
-- binary trace for read/write request
-<I>vcnt</I>
-- bio vector count which represents number of array element (page, offset, length) which makes up this I/O request
-<I>idx</I>
-- offset into the bio vector array
-<I>phys_segments</I>
-- number of segments in this bio after physical address coalescing is performed.
-<I>hw_segments</I>
-- number of segments after physical and DMA remapping hardware coalescing is performed
-<I>size</I>
-- total size in bytes
-<A NAME="lbAF"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process signals the transfer is done.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAF">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOBLOCK\&.REQ</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOBLOCK\&.REQ</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioblock.request - Fires whenever making a generic block I/O request.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioblock.request
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-<I>name</I>
-- name of the probe point
-<I>devname</I>
-- block device name
-<I>ino</I>
-- i-node number of the mapped file
-<I>sector</I>
-- beginning sector for the entire bio
-<I>flags</I>
-- see below BIO_UPTODATE 0 ok after I/O completion BIO_RW_BLOCK 1 RW_AHEAD set, and read/write would block BIO_EOF 2 out-out-bounds error BIO_SEG_VALID 3 nr_hw_seg valid BIO_CLONED 4 doesn't own data BIO_BOUNCED 5 bio is a bounce bio BIO_USER_MAPPED 6 contains user pages BIO_EOPNOTSUPP 7 not supported
-<P>
-
-<I>rw</I>
-- binary trace for read/write request
-<I>vcnt</I>
-- bio vector count which represents number of array element (page, offset, length) which make up this I/O request
-<I>idx</I>
-- offset into the bio vector array
-<I>phys_segments</I>
-- number of segments in this bio after physical address coalescing is performed
-<I>hw_segments</I>
-- number of segments after physical and DMA remapping hardware coalescing is performed
-<I>size</I>
-- total size in bytes
-<I>bdev</I>
-- target block device
-<I>bdev_contains</I>
-- points to the device object which contains the partition (when bio structure represents a partition)
-<I>p_start_sect</I>
-- points to the start sector of the partition structure of the device
-<A NAME="lbAF"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process makes block I/O request
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAF">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOBLOCK_TRACE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOBLOCK_TRACE</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioblock_trace.bounce - Fires whenever a buffer bounce is needed for at least one page of a block IO request.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioblock_trace.bounce
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-<I>name</I>
-- name of the probe point
-<I>q</I>
-- request queue on which this bio was queued.
-<I>devname</I>
-- device for which a buffer bounce was needed.
-<I>ino</I>
-- i-node number of the mapped file
-<I>bytes_done</I>
-- number of bytes transferred
-<I>sector</I>
-- beginning sector for the entire bio
-<I>flags</I>
-- see below BIO_UPTODATE 0 ok after I/O completion BIO_RW_BLOCK 1 RW_AHEAD set, and read/write would block BIO_EOF 2 out-out-bounds error BIO_SEG_VALID 3 nr_hw_seg valid BIO_CLONED 4 doesn't own data BIO_BOUNCED 5 bio is a bounce bio BIO_USER_MAPPED 6 contains user pages BIO_EOPNOTSUPP 7 not supported
-<I>rw</I>
-- binary trace for read/write request
-<I>vcnt</I>
-- bio vector count which represents number of array element (page, offset, length) which makes up this I/O request
-<I>idx</I>
-- offset into the bio vector array
-<I>phys_segments</I>
-- number of segments in this bio after physical address coalescing is performed.
-<I>size</I>
-- total size in bytes
-<I>bdev</I>
-- target block device
-<I>bdev_contains</I>
-- points to the device object which contains the partition (when bio structure represents a partition)
-<I>p_start_sect</I>
-- points to the start sector of the partition structure of the device
-<A NAME="lbAF"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process creating a block IO request.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAF">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOBLOCK_TRACE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOBLOCK_TRACE</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioblock_trace.end - Fires whenever a block I/O transfer is complete.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioblock_trace.end
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-<I>name</I>
-- name of the probe point
-<I>q</I>
-- request queue on which this bio was queued.
-<I>devname</I>
-- block device name
-<I>ino</I>
-- i-node number of the mapped file
-<I>bytes_done</I>
-- number of bytes transferred
-<I>sector</I>
-- beginning sector for the entire bio
-<I>flags</I>
-- see below BIO_UPTODATE 0 ok after I/O completion BIO_RW_BLOCK 1 RW_AHEAD set, and read/write would block BIO_EOF 2 out-out-bounds error BIO_SEG_VALID 3 nr_hw_seg valid BIO_CLONED 4 doesn't own data BIO_BOUNCED 5 bio is a bounce bio BIO_USER_MAPPED 6 contains user pages BIO_EOPNOTSUPP 7 not supported
-<P>
-
-<I>rw</I>
-- binary trace for read/write request
-<I>vcnt</I>
-- bio vector count which represents number of array element (page, offset, length) which makes up this I/O request
-<I>idx</I>
-- offset into the bio vector array
-<I>phys_segments</I>
-- number of segments in this bio after physical address coalescing is performed.
-<I>size</I>
-- total size in bytes
-<I>bdev</I>
-- target block device
-<I>bdev_contains</I>
-- points to the device object which contains the partition (when bio structure represents a partition)
-<I>p_start_sect</I>
-- points to the start sector of the partition structure of the device
-<A NAME="lbAF"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process signals the transfer is done.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAF">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOBLOCK_TRACE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOBLOCK_TRACE</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioblock_trace.request - Fires just as a generic block I/O request is created for a bio.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioblock_trace.request
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<P>
-
-<I>name</I>
-- name of the probe point
-<I>q</I>
-- request queue on which this bio was queued.
-<I>devname</I>
-- block device name
-<I>ino</I>
-- i-node number of the mapped file
-<I>bytes_done</I>
-- number of bytes transferred
-<I>sector</I>
-- beginning sector for the entire bio
-<I>flags</I>
-- see below BIO_UPTODATE 0 ok after I/O completion BIO_RW_BLOCK 1 RW_AHEAD set, and read/write would block BIO_EOF 2 out-out-bounds error BIO_SEG_VALID 3 nr_hw_seg valid BIO_CLONED 4 doesn't own data BIO_BOUNCED 5 bio is a bounce bio BIO_USER_MAPPED 6 contains user pages BIO_EOPNOTSUPP 7 not supported
-<P>
-
-<I>rw</I>
-- binary trace for read/write request
-<I>vcnt</I>
-- bio vector count which represents number of array element (page, offset, length) which make up this I/O request
-<I>idx</I>
-- offset into the bio vector array
-<I>phys_segments</I>
-- number of segments in this bio after physical address coalescing is performed.
-<I>size</I>
-- total size in bytes
-<I>bdev</I>
-- target block device
-<I>bdev_contains</I>
-- points to the device object which contains the partition (when bio structure represents a partition)
-<I>p_start_sect</I>
-- points to the start sector of the partition structure of the device
-<A NAME="lbAF"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process makes block I/O request
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAF">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOSCHEDULER\&</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOSCHEDULER\&</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioscheduler.elv_add_request - probe to indicate request is added to the request queue.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioscheduler.elv_add_request
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>disk_major</I>
-<DL COMPACT><DT><DD>
-Disk major no of request.
-</DL>
-
-<P>
-
-<I>rq</I>
-<DL COMPACT><DT><DD>
-Address of request.
-</DL>
-
-<P>
-
-<I>q</I>
-<DL COMPACT><DT><DD>
-Pointer to request queue.
-</DL>
-
-<P>
-
-<I>elevator_name</I>
-<DL COMPACT><DT><DD>
-The type of I/O elevator currently enabled.
-</DL>
-
-<P>
-
-<I>disk_minor</I>
-<DL COMPACT><DT><DD>
-Disk minor number of request.
-</DL>
-
-<P>
-
-<I>rq_flags</I>
-<DL COMPACT><DT><DD>
-Request flags.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOSCHEDULER\&</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOSCHEDULER\&</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioscheduler.elv_add_request.kp - kprobe based probe to indicate that a request was added to the request queue
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioscheduler.elv_add_request.kp
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>disk_major</I>
-<DL COMPACT><DT><DD>
-Disk major number of the request
-</DL>
-
-<P>
-
-<I>rq</I>
-<DL COMPACT><DT><DD>
-Address of the request
-</DL>
-
-<P>
-
-<I>q</I>
-<DL COMPACT><DT><DD>
-pointer to request queue
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>elevator_name</I>
-<DL COMPACT><DT><DD>
-The type of I/O elevator currently enabled
-</DL>
-
-<P>
-
-<I>disk_minor</I>
-<DL COMPACT><DT><DD>
-Disk minor number of the request
-</DL>
-
-<P>
-
-<I>rq_flags</I>
-<DL COMPACT><DT><DD>
-Request flags
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOSCHEDULER\&</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOSCHEDULER\&</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioscheduler.elv_add_request.tp - tracepoint based probe to indicate a request is added to the request queue.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioscheduler.elv_add_request.tp
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>disk_major</I>
-<DL COMPACT><DT><DD>
-Disk major no of request.
-</DL>
-
-<P>
-
-<I>rq</I>
-<DL COMPACT><DT><DD>
-Address of request.
-</DL>
-
-<P>
-
-<I>q</I>
-<DL COMPACT><DT><DD>
-Pointer to request queue.
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>elevator_name</I>
-<DL COMPACT><DT><DD>
-The type of I/O elevator currently enabled.
-</DL>
-
-<P>
-
-<I>disk_minor</I>
-<DL COMPACT><DT><DD>
-Disk minor number of request.
-</DL>
-
-<P>
-
-<I>rq_flags</I>
-<DL COMPACT><DT><DD>
-Request flags.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOSCHEDULER\&</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOSCHEDULER\&</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioscheduler.elv_completed_request - Fires when a request is completed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioscheduler.elv_completed_request
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>disk_major</I>
-<DL COMPACT><DT><DD>
-Disk major number of the request
-</DL>
-
-<P>
-
-<I>rq</I>
-<DL COMPACT><DT><DD>
-Address of the request
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>elevator_name</I>
-<DL COMPACT><DT><DD>
-The type of I/O elevator currently enabled
-</DL>
-
-<P>
-
-<I>disk_minor</I>
-<DL COMPACT><DT><DD>
-Disk minor number of the request
-</DL>
-
-<P>
-
-<I>rq_flags</I>
-<DL COMPACT><DT><DD>
-Request flags
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOSCHEDULER\&</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOSCHEDULER\&</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioscheduler.elv_next_request - Fires when a request is retrieved from the request queue
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioscheduler.elv_next_request
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>elevator_name</I>
-<DL COMPACT><DT><DD>
-The type of I/O elevator currently enabled
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOSCHEDULER\&</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOSCHEDULER\&</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioscheduler.elv_next_request.return - Fires when a request retrieval issues a return signal
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioscheduler.elv_next_request.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>disk_major</I>
-<DL COMPACT><DT><DD>
-Disk major number of the request
-</DL>
-
-<P>
-
-<I>rq</I>
-<DL COMPACT><DT><DD>
-Address of the request
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>disk_minor</I>
-<DL COMPACT><DT><DD>
-Disk minor number of the request
-</DL>
-
-<P>
-
-<I>rq_flags</I>
-<DL COMPACT><DT><DD>
-Request flags
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOSCHEDULER_T</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOSCHEDULER_T</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioscheduler_trace.elv_abort_request - Fires when a request is aborted.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioscheduler_trace.elv_abort_request
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>disk_major</I>
-<DL COMPACT><DT><DD>
-Disk major no of request.
-</DL>
-
-<P>
-
-<I>rq</I>
-<DL COMPACT><DT><DD>
-Address of request.
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>elevator_name</I>
-<DL COMPACT><DT><DD>
-The type of I/O elevator currently enabled.
-</DL>
-
-<P>
-
-<I>disk_minor</I>
-<DL COMPACT><DT><DD>
-Disk minor number of request.
-</DL>
-
-<P>
-
-<I>rq_flags</I>
-<DL COMPACT><DT><DD>
-Request flags.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOSCHEDULER_T</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOSCHEDULER_T</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioscheduler_trace.elv_completed_request - Fires when a request is
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioscheduler_trace.elv_completed_request
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>disk_major</I>
-<DL COMPACT><DT><DD>
-Disk major no of request.
-</DL>
-
-<P>
-
-<I>rq</I>
-<DL COMPACT><DT><DD>
-Address of request.
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>elevator_name</I>
-<DL COMPACT><DT><DD>
-The type of I/O elevator currently enabled.
-</DL>
-
-<P>
-
-<I>disk_minor</I>
-<DL COMPACT><DT><DD>
-Disk minor number of request.
-</DL>
-
-<P>
-
-<I>rq_flags</I>
-<DL COMPACT><DT><DD>
-Request flags.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-completed.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOSCHEDULER_T</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOSCHEDULER_T</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioscheduler_trace.elv_issue_request - Fires when a request is
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioscheduler_trace.elv_issue_request
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>disk_major</I>
-<DL COMPACT><DT><DD>
-Disk major no of request.
-</DL>
-
-<P>
-
-<I>rq</I>
-<DL COMPACT><DT><DD>
-Address of request.
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>elevator_name</I>
-<DL COMPACT><DT><DD>
-The type of I/O elevator currently enabled.
-</DL>
-
-<P>
-
-<I>disk_minor</I>
-<DL COMPACT><DT><DD>
-Disk minor number of request.
-</DL>
-
-<P>
-
-<I>rq_flags</I>
-<DL COMPACT><DT><DD>
-Request flags.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-scheduled.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOSCHEDULER_T</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOSCHEDULER_T</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioscheduler_trace.elv_requeue_request - Fires when a request is
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioscheduler_trace.elv_requeue_request
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>disk_major</I>
-<DL COMPACT><DT><DD>
-Disk major no of request.
-</DL>
-
-<P>
-
-<I>rq</I>
-<DL COMPACT><DT><DD>
-Address of request.
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>elevator_name</I>
-<DL COMPACT><DT><DD>
-The type of I/O elevator currently enabled.
-</DL>
-
-<P>
-
-<I>disk_minor</I>
-<DL COMPACT><DT><DD>
-Disk minor number of request.
-</DL>
-
-<P>
-
-<I>rq_flags</I>
-<DL COMPACT><DT><DD>
-Request flags.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-put back on the queue, when the hadware cannot accept more requests.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOSCHEDULER_T</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOSCHEDULER_T</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioscheduler_trace.plug - Fires when a request queue is plugged;
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioscheduler_trace.plug
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>rq_queue</I>
-<DL COMPACT><DT><DD>
-request queue
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-ie, requests in the queue cannot be serviced by block driver.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOSCHEDULER_T</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOSCHEDULER_T</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioscheduler_trace.unplug_io - Fires when a request queue is unplugged;
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioscheduler_trace.unplug_io
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>rq_queue</I>
-<DL COMPACT><DT><DD>
-request queue
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Either, when number of pending requests in the queue exceeds threshold or, upon expiration of timer that was activated when queue was plugged.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IOSCHEDULER_T</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IOSCHEDULER_T</H1>
-Section: IO Scheduler and block IO Taps (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ioscheduler_trace.unplug_timer - Fires when unplug timer associated
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ioscheduler_trace.unplug_timer
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>rq_queue</I>
-<DL COMPACT><DT><DD>
-request queue
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-with a request queue expires.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IPMIB\&.FORWD</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IPMIB\&.FORWD</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ipmib.ForwDatagrams - Count forwarded packet
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ipmib.ForwDatagrams
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>skb</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sk_buff being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>ipmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>ForwDatagrams</I>
-(equivalent to SNMP's MIB IPSTATS_MIB_OUTFORWDATAGRAMS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IPMIB\&.FRAGF</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IPMIB\&.FRAGF</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ipmib.FragFails - Count datagram fragmented unsuccessfully
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ipmib.FragFails
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>skb</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sk_buff being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-Value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>ipmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>FragFails</I>
-(equivalent to SNMP's MIB IPSTATS_MIB_FRAGFAILS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IPMIB\&.FRAGO</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IPMIB\&.FRAGO</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ipmib.FragOKs - Count datagram fragmented successfully
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ipmib.FragOKs
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>skb</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sk_buff being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>ipmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>FragOKs</I>
-(equivalent to SNMP's MIB IPSTATS_MIB_FRAGOKS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IPMIB\&.INADD</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IPMIB\&.INADD</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ipmib.InAddrErrors - Count arriving packets with an incorrect address
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ipmib.InAddrErrors
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>skb</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sk_buff being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>ipmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>InAddrErrors</I>
-(equivalent to SNMP's MIB IPSTATS_MIB_INADDRERRORS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IPMIB\&.INDIS</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IPMIB\&.INDIS</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ipmib.InDiscards - Count discarded inbound packets
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ipmib.InDiscards
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>skb</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sk_buff being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>ipmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>InDiscards</I>
-(equivalent to SNMP's MIB STATS_MIB_INDISCARDS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IPMIB\&.INNOR</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IPMIB\&.INNOR</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ipmib.InNoRoutes - Count an arriving packet with no matching socket
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ipmib.InNoRoutes
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>skb</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sk_buff being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>ipmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>InNoRoutes</I>
-(equivalent to SNMP's MIB IPSTATS_MIB_INNOROUTES)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IPMIB\&.INREC</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IPMIB\&.INREC</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ipmib.InReceives - Count an arriving packet
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ipmib.InReceives
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>skb</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sk_buff being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>ipmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>InReceives</I>
-(equivalent to SNMP's MIB IPSTATS_MIB_INRECEIVES)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IPMIB\&.INUNK</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IPMIB\&.INUNK</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ipmib.InUnknownProtos - Count arriving packets with an unbound proto
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ipmib.InUnknownProtos
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>skb</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sk_buff being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>ipmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>InUnknownProtos</I>
-(equivalent to SNMP's MIB IPSTATS_MIB_INUNKNOWNPROTOS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IPMIB\&.OUTRE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IPMIB\&.OUTRE</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ipmib.OutRequests - Count a request to send a packet
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ipmib.OutRequests
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>skb</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sk_buff being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>ipmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>OutRequests</I>
-(equivalent to SNMP's MIB IPSTATS_MIB_OUTREQUESTS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IPMIB\&.REASM</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IPMIB\&.REASM</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ipmib.ReasmReqds - Count number of packet fragments reassembly requests
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ipmib.ReasmReqds
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>skb</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sk_buff being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>ipmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>ReasmReqds</I>
-(equivalent to SNMP's MIB IPSTATS_MIB_REASMREQDS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IPMIB\&.REASM</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IPMIB\&.REASM</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::ipmib.ReasmTimeout - Count Reassembly Timeouts
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-ipmib.ReasmTimeout
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>skb</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sk_buff being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>ipmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>ReasmTimeout</I>
-(equivalent to SNMP's MIB IPSTATS_MIB_REASMTIMEOUT)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IRQ_HANDLER\&</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IRQ_HANDLER\&</H1>
-Section: Interrupt Request (IRQ) Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::irq_handler.entry - Execution of interrupt handler starting
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-irq_handler.entry
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dev_name</I>
-<DL COMPACT><DT><DD>
-name of device
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-Flags for IRQ handler
-</DL>
-
-<P>
-
-<I>dev_id</I>
-<DL COMPACT><DT><DD>
-Cookie to identify device
-</DL>
-
-<P>
-
-<I>dir</I>
-<DL COMPACT><DT><DD>
-pointer to the proc/irq/NN/name entry
-</DL>
-
-<P>
-
-<I>irq</I>
-<DL COMPACT><DT><DD>
-irq number
-</DL>
-
-<P>
-
-<I>next_irqaction</I>
-<DL COMPACT><DT><DD>
-pointer to next irqaction for shared interrupts
-</DL>
-
-<P>
-
-<I>thread_flags</I>
-<DL COMPACT><DT><DD>
-Flags related to thread
-</DL>
-
-<P>
-
-<I>thread</I>
-<DL COMPACT><DT><DD>
-thread pointer for threaded interrupts
-</DL>
-
-<P>
-
-<I>thread_fn</I>
-<DL COMPACT><DT><DD>
-interrupt handler function for threaded interrupts
-</DL>
-
-<P>
-
-<I>handler</I>
-<DL COMPACT><DT><DD>
-interrupt handler function
-</DL>
-
-<P>
-
-<I>flags_str</I>
-<DL COMPACT><DT><DD>
-symbolic string representation of IRQ flags
-</DL>
-
-<P>
-
-<I>action</I>
-<DL COMPACT><DT><DD>
-struct irqaction* for this interrupt num
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::IRQ_HANDLER\&</TITLE>
-</HEAD><BODY>
-<H1>PROBE::IRQ_HANDLER\&</H1>
-Section: Interrupt Request (IRQ) Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::irq_handler.exit - Execution of interrupt handler completed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-irq_handler.exit
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dev_name</I>
-<DL COMPACT><DT><DD>
-name of device
-</DL>
-
-<P>
-
-<I>ret</I>
-<DL COMPACT><DT><DD>
-return value of the handler
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-flags for IRQ handler
-</DL>
-
-<P>
-
-<I>dev_id</I>
-<DL COMPACT><DT><DD>
-Cookie to identify device
-</DL>
-
-<P>
-
-<I>dir</I>
-<DL COMPACT><DT><DD>
-pointer to the proc/irq/NN/name entry
-</DL>
-
-<P>
-
-<I>next_irqaction</I>
-<DL COMPACT><DT><DD>
-pointer to next irqaction for shared interrupts
-</DL>
-
-<P>
-
-<I>irq</I>
-<DL COMPACT><DT><DD>
-interrupt number
-</DL>
-
-<P>
-
-<I>thread_flags</I>
-<DL COMPACT><DT><DD>
-Flags related to thread
-</DL>
-
-<P>
-
-<I>thread</I>
-<DL COMPACT><DT><DD>
-thread pointer for threaded interrupts
-</DL>
-
-<P>
-
-<I>thread_fn</I>
-<DL COMPACT><DT><DD>
-interrupt handler function for threaded interrupts
-</DL>
-
-<P>
-
-<I>flags_str</I>
-<DL COMPACT><DT><DD>
-symbolic string representation of IRQ flags
-</DL>
-
-<P>
-
-<I>handler</I>
-<DL COMPACT><DT><DD>
-interrupt handler function that was executed
-</DL>
-
-<P>
-
-<I>action</I>
-<DL COMPACT><DT><DD>
-struct irqaction*
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::KPROCESS\&.CR</TITLE>
-</HEAD><BODY>
-<H1>PROBE::KPROCESS\&.CR</H1>
-Section: Kernel Process Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::kprocess.create - Fires whenever a new process or thread is successfully created
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-kprocess.create
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>new_tid</I>
-<DL COMPACT><DT><DD>
-The TID of the newly created task
-</DL>
-
-<P>
-
-<I>new_pid</I>
-<DL COMPACT><DT><DD>
-The PID of the newly created process
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-Parent of the created process.
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires whenever a new process is successfully created, either as a result of fork (or one of its syscall variants), or a new kernel thread.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::KPROCESS\&.EX</TITLE>
-</HEAD><BODY>
-<H1>PROBE::KPROCESS\&.EX</H1>
-Section: Kernel Process Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::kprocess.exec - Attempt to exec to a new program
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-kprocess.exec
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>argstr</I>
-<DL COMPACT><DT><DD>
-A string containing the filename followed by the arguments to pass, excluding 0th arg (SystemTap v2.5+)
-</DL>
-
-<P>
-
-<I>filename</I>
-<DL COMPACT><DT><DD>
-The path to the new executable
-</DL>
-
-<P>
-
-<I>args</I>
-<DL COMPACT><DT><DD>
-The arguments to pass to the new executable, including the 0th arg (SystemTap v2.5+)
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the system call ("execve") (SystemTap v2.5+)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The caller of exec.
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires whenever a process attempts to exec to a new program. Aliased to the syscall.execve probe in SystemTap v2.5+.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::KPROCESS\&.EX</TITLE>
-</HEAD><BODY>
-<H1>PROBE::KPROCESS\&.EX</H1>
-Section: Kernel Process Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::kprocess.exec_complete - Return from exec to a new program
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-kprocess.exec_complete
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>retstr</I>
-<DL COMPACT><DT><DD>
-A string representation of errno (SystemTap v2.5+)
-</DL>
-
-<P>
-
-<I>success</I>
-<DL COMPACT><DT><DD>
-A boolean indicating whether the exec was successful
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the system call ("execve") (SystemTap v2.5+)
-</DL>
-
-<P>
-
-<I>errno</I>
-<DL COMPACT><DT><DD>
-The error number resulting from the exec
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-On success, the context of the new executable. On failure, remains in the context of the caller.
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the completion of an exec call. Aliased to the syscall.execve.return probe in SystemTap v2.5+.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::KPROCESS\&.EX</TITLE>
-</HEAD><BODY>
-<H1>PROBE::KPROCESS\&.EX</H1>
-Section: Kernel Process Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::kprocess.exit - Exit from process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-kprocess.exit
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>code</I>
-<DL COMPACT><DT><DD>
-The exit code of the process
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process which is terminating.
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires when a process terminates. This will always be followed by a kprocess.release, though the latter may be delayed if the process waits in a zombie state.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::KPROCESS\&.RE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::KPROCESS\&.RE</H1>
-Section: Kernel Process Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::kprocess.release - Process released
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-kprocess.release
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>pid</I>
-<DL COMPACT><DT><DD>
-Same as
-<I>released_pid</I>
-for compatibility (deprecated)
-</DL>
-
-<P>
-
-<I>released_pid</I>
-<DL COMPACT><DT><DD>
-PID of the process being released
-</DL>
-
-<P>
-
-<I>released_tid</I>
-<DL COMPACT><DT><DD>
-TID of the task being released
-</DL>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-A task handle to the process being released
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The context of the parent, if it wanted notification of this process' termination, else the context of the process itself.
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires when a process is released from the kernel. This always follows a kprocess.exit, though it may be delayed somewhat if the process waits in a zombie state.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::KPROCESS\&.ST</TITLE>
-</HEAD><BODY>
-<H1>PROBE::KPROCESS\&.ST</H1>
-Section: Kernel Process Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::kprocess.start - Starting new process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-kprocess.start
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-None
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-Newly created process.
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires immediately before a new process begins execution.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::LINUXMIB\&.DE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::LINUXMIB\&.DE</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::linuxmib.DelayedACKs - Count of delayed acks
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-linuxmib.DelayedACKs
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-Pointer to the struct sock being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-Value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>linuxmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>DelayedACKs</I>
-(equivalent to SNMP's MIB LINUX_MIB_DELAYEDACKS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::LINUXMIB\&.LI</TITLE>
-</HEAD><BODY>
-<H1>PROBE::LINUXMIB\&.LI</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::linuxmib.ListenDrops - Count of times conn request that were dropped
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-linuxmib.ListenDrops
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-Pointer to the struct sock being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-Value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>linuxmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>ListenDrops</I>
-(equivalent to SNMP's MIB LINUX_MIB_LISTENDROPS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::LINUXMIB\&.LI</TITLE>
-</HEAD><BODY>
-<H1>PROBE::LINUXMIB\&.LI</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::linuxmib.ListenOverflows - Count of times a listen queue overflowed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-linuxmib.ListenOverflows
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-Pointer to the struct sock being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-Value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>linuxmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>ListenOverflows</I>
-(equivalent to SNMP's MIB LINUX_MIB_LISTENOVERFLOWS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::LINUXMIB\&.TC</TITLE>
-</HEAD><BODY>
-<H1>PROBE::LINUXMIB\&.TC</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::linuxmib.TCPMemoryPressures - Count of times memory pressure was used
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-linuxmib.TCPMemoryPressures
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-Pointer to the struct sock being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-Value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>linuxmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>TCPMemoryPressures</I>
-(equivalent to SNMP's MIB LINUX_MIB_TCPMEMORYPRESSURES)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETDEV\&.CHAN</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETDEV\&.CHAN</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netdev.change_mac - Called when the netdev_name has the MAC changed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netdev.change_mac
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dev_name</I>
-<DL COMPACT><DT><DD>
-The device that will have the MAC changed
-</DL>
-
-<P>
-
-<I>new_mac</I>
-<DL COMPACT><DT><DD>
-The new MAC address
-</DL>
-
-<P>
-
-<I>mac_len</I>
-<DL COMPACT><DT><DD>
-The MAC length
-</DL>
-
-<P>
-
-<I>old_mac</I>
-<DL COMPACT><DT><DD>
-The current MAC address
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETDEV\&.CHAN</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETDEV\&.CHAN</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netdev.change_mtu - Called when the netdev MTU is changed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netdev.change_mtu
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dev_name</I>
-<DL COMPACT><DT><DD>
-The device that will have the MTU changed
-</DL>
-
-<P>
-
-<I>new_mtu</I>
-<DL COMPACT><DT><DD>
-The new MTU
-</DL>
-
-<P>
-
-<I>old_mtu</I>
-<DL COMPACT><DT><DD>
-The current MTU
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETDEV\&.CHAN</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETDEV\&.CHAN</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netdev.change_rx_flag - Called when the device RX flag will be changed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netdev.change_rx_flag
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dev_name</I>
-<DL COMPACT><DT><DD>
-The device that will be changed
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-The new flags
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETDEV\&.CLOS</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETDEV\&.CLOS</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netdev.close - Called when the device is closed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netdev.close
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dev_name</I>
-<DL COMPACT><DT><DD>
-The device that is going to be closed
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETDEV\&.GET_</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETDEV\&.GET_</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netdev.get_stats - Called when someone asks the device statistics
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netdev.get_stats
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dev_name</I>
-<DL COMPACT><DT><DD>
-The device that is going to provide the statistics
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETDEV\&.HARD</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETDEV\&.HARD</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netdev.hard_transmit - Called when the devices is going to TX (hard)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netdev.hard_transmit
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-The protocol used in the transmission
-</DL>
-
-<P>
-
-<I>dev_name</I>
-<DL COMPACT><DT><DD>
-The device scheduled to transmit
-</DL>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-The length of the transmit buffer.
-</DL>
-
-<P>
-
-<I>truesize</I>
-<DL COMPACT><DT><DD>
-The size of the data to be transmitted.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETDEV\&.IOCT</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETDEV\&.IOCT</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netdev.ioctl - Called when the device suffers an IOCTL
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netdev.ioctl
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>cmd</I>
-<DL COMPACT><DT><DD>
-The IOCTL request
-</DL>
-
-<P>
-
-<I>arg</I>
-<DL COMPACT><DT><DD>
-The IOCTL argument (usually the netdev interface)
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETDEV\&.OPEN</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETDEV\&.OPEN</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netdev.open - Called when the device is opened
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netdev.open
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dev_name</I>
-<DL COMPACT><DT><DD>
-The device that is going to be opened
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETDEV\&.RECE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETDEV\&.RECE</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netdev.receive - Data received from network device.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netdev.receive
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol of received packet.
-</DL>
-
-<P>
-
-<I>dev_name</I>
-<DL COMPACT><DT><DD>
-The name of the device. e.g: eth0, ath1.
-</DL>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-The length of the receiving buffer.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETDEV\&.REGI</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETDEV\&.REGI</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netdev.register - Called when the device is registered
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netdev.register
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dev_name</I>
-<DL COMPACT><DT><DD>
-The device that is going to be registered
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETDEV\&.RX</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETDEV\&.RX</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netdev.rx - Called when the device is going to receive a packet
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netdev.rx
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-The packet protocol
-</DL>
-
-<P>
-
-<I>dev_name</I>
-<DL COMPACT><DT><DD>
-The device received the packet
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETDEV\&.SET_</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETDEV\&.SET_</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netdev.set_promiscuity - Called when the device enters/leaves promiscuity
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netdev.set_promiscuity
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dev_name</I>
-<DL COMPACT><DT><DD>
-The device that is entering/leaving promiscuity mode
-</DL>
-
-<P>
-
-<I>enable</I>
-<DL COMPACT><DT><DD>
-If the device is entering promiscuity mode
-</DL>
-
-<P>
-
-<I>inc</I>
-<DL COMPACT><DT><DD>
-Count the number of promiscuity openers
-</DL>
-
-<P>
-
-<I>disable</I>
-<DL COMPACT><DT><DD>
-If the device is leaving promiscuity mode
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETDEV\&.TRAN</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETDEV\&.TRAN</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netdev.transmit - Network device transmitting buffer
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netdev.transmit
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-The protocol of this packet(defined in include/linux/if_ether.h).
-</DL>
-
-<P>
-
-<I>dev_name</I>
-<DL COMPACT><DT><DD>
-The name of the device. e.g: eth0, ath1.
-</DL>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-The length of the transmit buffer.
-</DL>
-
-<P>
-
-<I>truesize</I>
-<DL COMPACT><DT><DD>
-The size of the data to be transmitted.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETDEV\&.UNRE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETDEV\&.UNRE</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netdev.unregister - Called when the device is being unregistered
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netdev.unregister
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dev_name</I>
-<DL COMPACT><DT><DD>
-The device that is going to be unregistered
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETFILTER\&.A</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETFILTER\&.A</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netfilter.arp.forward - - Called for each ARP packet to be forwarded
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netfilter.arp.forward
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>indev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing input device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_accept</I>
-<DL COMPACT><DT><DD>
-Constant used to signify an 'accept' verdict
-</DL>
-
-<P>
-
-<I>ar_sha</I>
-<DL COMPACT><DT><DD>
-Ethernet+IP only (ar_pro==0x800): source hardware (MAC) address
-</DL>
-
-<P>
-
-<I>pf</I>
-<DL COMPACT><DT><DD>
-Protocol family -- always
-"arp"
-</DL>
-
-<P>
-
-<I>ar_sip</I>
-<DL COMPACT><DT><DD>
-Ethernet+IP only (ar_pro==0x800): source IP address
-</DL>
-
-<P>
-
-<I>nf_queue</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'queue' verdict
-</DL>
-
-<P>
-
-<I>ar_op</I>
-<DL COMPACT><DT><DD>
-ARP opcode (command)
-</DL>
-
-<P>
-
-<I>nf_stolen</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stolen' verdict
-</DL>
-
-<P>
-
-<I>outdev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet will be routed to (if known)
-</DL>
-
-<P>
-
-<I>nf_drop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'drop' verdict
-</DL>
-
-<P>
-
-<I>ar_hln</I>
-<DL COMPACT><DT><DD>
-Length of hardware address
-</DL>
-
-<P>
-
-<I>ar_pro</I>
-<DL COMPACT><DT><DD>
-Format of protocol address
-</DL>
-
-<P>
-
-<I>ar_pln</I>
-<DL COMPACT><DT><DD>
-Length of protocol address
-</DL>
-
-<P>
-
-<I>ar_tip</I>
-<DL COMPACT><DT><DD>
-Ethernet+IP only (ar_pro==0x800): target IP address
-</DL>
-
-<P>
-
-<I>nf_stop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stop' verdict
-</DL>
-
-<P>
-
-<I>arphdr</I>
-<DL COMPACT><DT><DD>
-Address of ARP header
-</DL>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-The length of the packet buffer contents, in bytes
-</DL>
-
-<P>
-
-<I>outdev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing output device, 0 if unknown
-</DL>
-
-<P>
-
-<I>ar_tha</I>
-<DL COMPACT><DT><DD>
-Ethernet+IP only (ar_pro==0x800): target hardware (MAC) address
-</DL>
-
-<P>
-
-<I>ar_data</I>
-<DL COMPACT><DT><DD>
-Address of ARP packet data region (after the header)
-</DL>
-
-<P>
-
-<I>nf_repeat</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'repeat' verdict
-</DL>
-
-<P>
-
-<I>indev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet was received on (if known)
-</DL>
-
-<P>
-
-<I>ar_hrd</I>
-<DL COMPACT><DT><DD>
-Format of hardware address
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETFILTER\&.A</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETFILTER\&.A</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netfilter.arp.in - - Called for each incoming ARP packet
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netfilter.arp.in
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>indev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing input device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_accept</I>
-<DL COMPACT><DT><DD>
-Constant used to signify an 'accept' verdict
-</DL>
-
-<P>
-
-<I>ar_sha</I>
-<DL COMPACT><DT><DD>
-Ethernet+IP only (ar_pro==0x800): source hardware (MAC) address
-</DL>
-
-<P>
-
-<I>pf</I>
-<DL COMPACT><DT><DD>
-Protocol family -- always
-"arp"
-</DL>
-
-<P>
-
-<I>ar_sip</I>
-<DL COMPACT><DT><DD>
-Ethernet+IP only (ar_pro==0x800): source IP address
-</DL>
-
-<P>
-
-<I>nf_queue</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'queue' verdict
-</DL>
-
-<P>
-
-<I>ar_op</I>
-<DL COMPACT><DT><DD>
-ARP opcode (command)
-</DL>
-
-<P>
-
-<I>nf_stolen</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stolen' verdict
-</DL>
-
-<P>
-
-<I>outdev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet will be routed to (if known)
-</DL>
-
-<P>
-
-<I>nf_drop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'drop' verdict
-</DL>
-
-<P>
-
-<I>ar_hln</I>
-<DL COMPACT><DT><DD>
-Length of hardware address
-</DL>
-
-<P>
-
-<I>ar_pro</I>
-<DL COMPACT><DT><DD>
-Format of protocol address
-</DL>
-
-<P>
-
-<I>ar_pln</I>
-<DL COMPACT><DT><DD>
-Length of protocol address
-</DL>
-
-<P>
-
-<I>ar_tip</I>
-<DL COMPACT><DT><DD>
-Ethernet+IP only (ar_pro==0x800): target IP address
-</DL>
-
-<P>
-
-<I>nf_stop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stop' verdict
-</DL>
-
-<P>
-
-<I>arphdr</I>
-<DL COMPACT><DT><DD>
-Address of ARP header
-</DL>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-The length of the packet buffer contents, in bytes
-</DL>
-
-<P>
-
-<I>outdev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing output device, 0 if unknown
-</DL>
-
-<P>
-
-<I>ar_tha</I>
-<DL COMPACT><DT><DD>
-Ethernet+IP only (ar_pro==0x800): target hardware (MAC) address
-</DL>
-
-<P>
-
-<I>ar_data</I>
-<DL COMPACT><DT><DD>
-Address of ARP packet data region (after the header)
-</DL>
-
-<P>
-
-<I>nf_repeat</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'repeat' verdict
-</DL>
-
-<P>
-
-<I>indev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet was received on (if known)
-</DL>
-
-<P>
-
-<I>ar_hrd</I>
-<DL COMPACT><DT><DD>
-Format of hardware address
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETFILTER\&.A</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETFILTER\&.A</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netfilter.arp.out - - Called for each outgoing ARP packet
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netfilter.arp.out
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>indev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing input device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_accept</I>
-<DL COMPACT><DT><DD>
-Constant used to signify an 'accept' verdict
-</DL>
-
-<P>
-
-<I>ar_sha</I>
-<DL COMPACT><DT><DD>
-Ethernet+IP only (ar_pro==0x800): source hardware (MAC) address
-</DL>
-
-<P>
-
-<I>pf</I>
-<DL COMPACT><DT><DD>
-Protocol family -- always
-"arp"
-</DL>
-
-<P>
-
-<I>ar_sip</I>
-<DL COMPACT><DT><DD>
-Ethernet+IP only (ar_pro==0x800): source IP address
-</DL>
-
-<P>
-
-<I>nf_queue</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'queue' verdict
-</DL>
-
-<P>
-
-<I>ar_op</I>
-<DL COMPACT><DT><DD>
-ARP opcode (command)
-</DL>
-
-<P>
-
-<I>nf_stolen</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stolen' verdict
-</DL>
-
-<P>
-
-<I>outdev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet will be routed to (if known)
-</DL>
-
-<P>
-
-<I>nf_drop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'drop' verdict
-</DL>
-
-<P>
-
-<I>ar_hln</I>
-<DL COMPACT><DT><DD>
-Length of hardware address
-</DL>
-
-<P>
-
-<I>ar_pro</I>
-<DL COMPACT><DT><DD>
-Format of protocol address
-</DL>
-
-<P>
-
-<I>ar_pln</I>
-<DL COMPACT><DT><DD>
-Length of protocol address
-</DL>
-
-<P>
-
-<I>ar_tip</I>
-<DL COMPACT><DT><DD>
-Ethernet+IP only (ar_pro==0x800): target IP address
-</DL>
-
-<P>
-
-<I>nf_stop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stop' verdict
-</DL>
-
-<P>
-
-<I>arphdr</I>
-<DL COMPACT><DT><DD>
-Address of ARP header
-</DL>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-The length of the packet buffer contents, in bytes
-</DL>
-
-<P>
-
-<I>outdev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing output device, 0 if unknown
-</DL>
-
-<P>
-
-<I>ar_tha</I>
-<DL COMPACT><DT><DD>
-Ethernet+IP only (ar_pro==0x800): target hardware (MAC) address
-</DL>
-
-<P>
-
-<I>ar_data</I>
-<DL COMPACT><DT><DD>
-Address of ARP packet data region (after the header)
-</DL>
-
-<P>
-
-<I>nf_repeat</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'repeat' verdict
-</DL>
-
-<P>
-
-<I>indev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet was received on (if known)
-</DL>
-
-<P>
-
-<I>ar_hrd</I>
-<DL COMPACT><DT><DD>
-Format of hardware address
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETFILTER\&.B</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETFILTER\&.B</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netfilter.bridge.forward - Called on an incoming bridging packet destined for some other computer
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netfilter.bridge.forward
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>indev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing input device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_accept</I>
-<DL COMPACT><DT><DD>
-Constant used to signify an 'accept' verdict
-</DL>
-
-<P>
-
-<I>pf</I>
-<DL COMPACT><DT><DD>
-Protocol family -- always
-"bridge"
-</DL>
-
-<P>
-
-<I>nf_queue</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'queue' verdict
-</DL>
-
-<P>
-
-<I>nf_stolen</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stolen' verdict
-</DL>
-
-<P>
-
-<I>outdev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet will be routed to (if known)
-</DL>
-
-<P>
-
-<I>nf_drop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'drop' verdict
-</DL>
-
-<P>
-
-<I>nf_stop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stop' verdict
-</DL>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-The length of the packet buffer contents, in bytes
-</DL>
-
-<P>
-
-<I>outdev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing output device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_repeat</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'repeat' verdict
-</DL>
-
-<P>
-
-<I>indev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet was received on (if known)
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETFILTER\&.B</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETFILTER\&.B</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netfilter.bridge.local_in - Called on a bridging packet destined for the local computer
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netfilter.bridge.local_in
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>indev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing input device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_accept</I>
-<DL COMPACT><DT><DD>
-Constant used to signify an 'accept' verdict
-</DL>
-
-<P>
-
-<I>pf</I>
-<DL COMPACT><DT><DD>
-Protocol family -- always
-"bridge"
-</DL>
-
-<P>
-
-<I>nf_queue</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'queue' verdict
-</DL>
-
-<P>
-
-<I>nf_stolen</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stolen' verdict
-</DL>
-
-<P>
-
-<I>outdev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet will be routed to (if known)
-</DL>
-
-<P>
-
-<I>nf_drop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'drop' verdict
-</DL>
-
-<P>
-
-<I>nf_stop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stop' verdict
-</DL>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-The length of the packet buffer contents, in bytes
-</DL>
-
-<P>
-
-<I>outdev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing output device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_repeat</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'repeat' verdict
-</DL>
-
-<P>
-
-<I>indev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet was received on (if known)
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETFILTER\&.B</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETFILTER\&.B</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netfilter.bridge.local_out - Called on a bridging packet coming from a local process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netfilter.bridge.local_out
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>indev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing input device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_accept</I>
-<DL COMPACT><DT><DD>
-Constant used to signify an 'accept' verdict
-</DL>
-
-<P>
-
-<I>pf</I>
-<DL COMPACT><DT><DD>
-Protocol family -- always
-"bridge"
-</DL>
-
-<P>
-
-<I>nf_queue</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'queue' verdict
-</DL>
-
-<P>
-
-<I>nf_stolen</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stolen' verdict
-</DL>
-
-<P>
-
-<I>outdev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet will be routed to (if known)
-</DL>
-
-<P>
-
-<I>nf_drop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'drop' verdict
-</DL>
-
-<P>
-
-<I>nf_stop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stop' verdict
-</DL>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-The length of the packet buffer contents, in bytes
-</DL>
-
-<P>
-
-<I>outdev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing output device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_repeat</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'repeat' verdict
-</DL>
-
-<P>
-
-<I>indev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet was received on (if known)
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETFILTER\&.B</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETFILTER\&.B</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netfilter.bridge.post_routing - - Called before a bridging packet hits the wire
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netfilter.bridge.post_routing
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>indev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing input device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_accept</I>
-<DL COMPACT><DT><DD>
-Constant used to signify an 'accept' verdict
-</DL>
-
-<P>
-
-<I>pf</I>
-<DL COMPACT><DT><DD>
-Protocol family -- always
-"bridge"
-</DL>
-
-<P>
-
-<I>nf_queue</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'queue' verdict
-</DL>
-
-<P>
-
-<I>nf_stolen</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stolen' verdict
-</DL>
-
-<P>
-
-<I>outdev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet will be routed to (if known)
-</DL>
-
-<P>
-
-<I>nf_drop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'drop' verdict
-</DL>
-
-<P>
-
-<I>nf_stop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stop' verdict
-</DL>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-The length of the packet buffer contents, in bytes
-</DL>
-
-<P>
-
-<I>outdev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing output device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_repeat</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'repeat' verdict
-</DL>
-
-<P>
-
-<I>indev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet was received on (if known)
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETFILTER\&.B</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETFILTER\&.B</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netfilter.bridge.pre_routing - - Called before a bridging packet is routed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netfilter.bridge.pre_routing
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>indev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing input device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_accept</I>
-<DL COMPACT><DT><DD>
-Constant used to signify an 'accept' verdict
-</DL>
-
-<P>
-
-<I>pf</I>
-<DL COMPACT><DT><DD>
-Protocol family -- always
-"bridge"
-</DL>
-
-<P>
-
-<I>nf_queue</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'queue' verdict
-</DL>
-
-<P>
-
-<I>nf_stolen</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stolen' verdict
-</DL>
-
-<P>
-
-<I>outdev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet will be routed to (if known)
-</DL>
-
-<P>
-
-<I>nf_drop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'drop' verdict
-</DL>
-
-<P>
-
-<I>nf_stop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stop' verdict
-</DL>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-The length of the packet buffer contents, in bytes
-</DL>
-
-<P>
-
-<I>outdev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing output device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_repeat</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'repeat' verdict
-</DL>
-
-<P>
-
-<I>indev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet was received on (if known)
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETFILTER\&.I</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETFILTER\&.I</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netfilter.ip.forward - Called on an incoming IP packet addressed to some other computer
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netfilter.ip.forward
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>urg</I>
-<DL COMPACT><DT><DD>
-TCP URG flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Packet protocol from driver (ipv4 only)
-</DL>
-
-<P>
-
-<I>indev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing input device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_accept</I>
-<DL COMPACT><DT><DD>
-Constant used to signify an 'accept' verdict
-</DL>
-
-<P>
-
-<I>pf</I>
-<DL COMPACT><DT><DD>
-Protocol family -- either
-"ipv4"
-or
-"ipv6"
-</DL>
-
-<P>
-
-<I>ipproto_tcp</I>
-<DL COMPACT><DT><DD>
-Constant used to signify that the packet protocol is TCP
-</DL>
-
-<P>
-
-<I>rst</I>
-<DL COMPACT><DT><DD>
-TCP RST flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>dport</I>
-<DL COMPACT><DT><DD>
-TCP or UDP destination port (ipv4 only)
-</DL>
-
-<P>
-
-<I>nf_queue</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'queue' verdict
-</DL>
-
-<P>
-
-<I>nf_stolen</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stolen' verdict
-</DL>
-
-<P>
-
-<I>ipproto_udp</I>
-<DL COMPACT><DT><DD>
-Constant used to signify that the packet protocol is UDP
-</DL>
-
-<P>
-
-<I>outdev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet will be routed to (if known)
-</DL>
-
-<P>
-
-<I>ack</I>
-<DL COMPACT><DT><DD>
-TCP ACK flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>fin</I>
-<DL COMPACT><DT><DD>
-TCP FIN flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>nf_drop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'drop' verdict
-</DL>
-
-<P>
-
-<I>psh</I>
-<DL COMPACT><DT><DD>
-TCP PSH flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>saddr</I>
-<DL COMPACT><DT><DD>
-A string representing the source IP address
-</DL>
-
-<P>
-
-<I>nf_stop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stop' verdict
-</DL>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-The length of the packet buffer contents, in bytes
-</DL>
-
-<P>
-
-<I>daddr</I>
-<DL COMPACT><DT><DD>
-A string representing the destination IP address
-</DL>
-
-<P>
-
-<I>outdev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing output device, 0 if unknown
-</DL>
-
-<P>
-
-<I>syn</I>
-<DL COMPACT><DT><DD>
-TCP SYN flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>sport</I>
-<DL COMPACT><DT><DD>
-TCP or UDP source port (ipv4 only)
-</DL>
-
-<P>
-
-<I>nf_repeat</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'repeat' verdict
-</DL>
-
-<P>
-
-<I>indev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet was received on (if known)
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-IP address family
-</DL>
-
-<P>
-
-<I>iphdr</I>
-<DL COMPACT><DT><DD>
-Address of IP header
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETFILTER\&.I</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETFILTER\&.I</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netfilter.ip.local_in - Called on an incoming IP packet addressed to the local computer
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netfilter.ip.local_in
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>urg</I>
-<DL COMPACT><DT><DD>
-TCP URG flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Packet protocol from driver (ipv4 only)
-</DL>
-
-<P>
-
-<I>indev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing input device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_accept</I>
-<DL COMPACT><DT><DD>
-Constant used to signify an 'accept' verdict
-</DL>
-
-<P>
-
-<I>pf</I>
-<DL COMPACT><DT><DD>
-Protocol family -- either
-"ipv4"
-or
-"ipv6"
-</DL>
-
-<P>
-
-<I>ipproto_tcp</I>
-<DL COMPACT><DT><DD>
-Constant used to signify that the packet protocol is TCP
-</DL>
-
-<P>
-
-<I>rst</I>
-<DL COMPACT><DT><DD>
-TCP RST flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>dport</I>
-<DL COMPACT><DT><DD>
-TCP or UDP destination port (ipv4 only)
-</DL>
-
-<P>
-
-<I>nf_queue</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'queue' verdict
-</DL>
-
-<P>
-
-<I>nf_stolen</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stolen' verdict
-</DL>
-
-<P>
-
-<I>ipproto_udp</I>
-<DL COMPACT><DT><DD>
-Constant used to signify that the packet protocol is UDP
-</DL>
-
-<P>
-
-<I>outdev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet will be routed to (if known)
-</DL>
-
-<P>
-
-<I>ack</I>
-<DL COMPACT><DT><DD>
-TCP ACK flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>fin</I>
-<DL COMPACT><DT><DD>
-TCP FIN flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>nf_drop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'drop' verdict
-</DL>
-
-<P>
-
-<I>psh</I>
-<DL COMPACT><DT><DD>
-TCP PSH flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>saddr</I>
-<DL COMPACT><DT><DD>
-A string representing the source IP address
-</DL>
-
-<P>
-
-<I>nf_stop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stop' verdict
-</DL>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-The length of the packet buffer contents, in bytes
-</DL>
-
-<P>
-
-<I>daddr</I>
-<DL COMPACT><DT><DD>
-A string representing the destination IP address
-</DL>
-
-<P>
-
-<I>outdev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing output device, 0 if unknown
-</DL>
-
-<P>
-
-<I>syn</I>
-<DL COMPACT><DT><DD>
-TCP SYN flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>sport</I>
-<DL COMPACT><DT><DD>
-TCP or UDP source port (ipv4 only)
-</DL>
-
-<P>
-
-<I>nf_repeat</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'repeat' verdict
-</DL>
-
-<P>
-
-<I>indev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet was received on (if known)
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-IP address family
-</DL>
-
-<P>
-
-<I>iphdr</I>
-<DL COMPACT><DT><DD>
-Address of IP header
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETFILTER\&.I</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETFILTER\&.I</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netfilter.ip.local_out - Called on an outgoing IP packet
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netfilter.ip.local_out
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>urg</I>
-<DL COMPACT><DT><DD>
-TCP URG flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Packet protocol from driver (ipv4 only)
-</DL>
-
-<P>
-
-<I>indev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing input device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_accept</I>
-<DL COMPACT><DT><DD>
-Constant used to signify an 'accept' verdict
-</DL>
-
-<P>
-
-<I>pf</I>
-<DL COMPACT><DT><DD>
-Protocol family -- either
-"ipv4"
-or
-"ipv6"
-</DL>
-
-<P>
-
-<I>ipproto_tcp</I>
-<DL COMPACT><DT><DD>
-Constant used to signify that the packet protocol is TCP
-</DL>
-
-<P>
-
-<I>rst</I>
-<DL COMPACT><DT><DD>
-TCP RST flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>dport</I>
-<DL COMPACT><DT><DD>
-TCP or UDP destination port (ipv4 only)
-</DL>
-
-<P>
-
-<I>nf_queue</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'queue' verdict
-</DL>
-
-<P>
-
-<I>nf_stolen</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stolen' verdict
-</DL>
-
-<P>
-
-<I>ipproto_udp</I>
-<DL COMPACT><DT><DD>
-Constant used to signify that the packet protocol is UDP
-</DL>
-
-<P>
-
-<I>outdev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet will be routed to (if known)
-</DL>
-
-<P>
-
-<I>ack</I>
-<DL COMPACT><DT><DD>
-TCP ACK flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>fin</I>
-<DL COMPACT><DT><DD>
-TCP FIN flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>nf_drop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'drop' verdict
-</DL>
-
-<P>
-
-<I>psh</I>
-<DL COMPACT><DT><DD>
-TCP PSH flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>saddr</I>
-<DL COMPACT><DT><DD>
-A string representing the source IP address
-</DL>
-
-<P>
-
-<I>nf_stop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stop' verdict
-</DL>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-The length of the packet buffer contents, in bytes
-</DL>
-
-<P>
-
-<I>daddr</I>
-<DL COMPACT><DT><DD>
-A string representing the destination IP address
-</DL>
-
-<P>
-
-<I>outdev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing output device, 0 if unknown
-</DL>
-
-<P>
-
-<I>syn</I>
-<DL COMPACT><DT><DD>
-TCP SYN flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>sport</I>
-<DL COMPACT><DT><DD>
-TCP or UDP source port (ipv4 only)
-</DL>
-
-<P>
-
-<I>nf_repeat</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'repeat' verdict
-</DL>
-
-<P>
-
-<I>indev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet was received on (if known)
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-IP address family
-</DL>
-
-<P>
-
-<I>iphdr</I>
-<DL COMPACT><DT><DD>
-Address of IP header
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETFILTER\&.I</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETFILTER\&.I</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netfilter.ip.post_routing - Called immediately before an outgoing IP packet leaves the computer
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netfilter.ip.post_routing
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>urg</I>
-<DL COMPACT><DT><DD>
-TCP URG flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Packet protocol from driver (ipv4 only)
-</DL>
-
-<P>
-
-<I>indev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing input device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_accept</I>
-<DL COMPACT><DT><DD>
-Constant used to signify an 'accept' verdict
-</DL>
-
-<P>
-
-<I>pf</I>
-<DL COMPACT><DT><DD>
-Protocol family -- either
-"ipv4"
-or
-"ipv6"
-</DL>
-
-<P>
-
-<I>ipproto_tcp</I>
-<DL COMPACT><DT><DD>
-Constant used to signify that the packet protocol is TCP
-</DL>
-
-<P>
-
-<I>rst</I>
-<DL COMPACT><DT><DD>
-TCP RST flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>dport</I>
-<DL COMPACT><DT><DD>
-TCP or UDP destination port (ipv4 only)
-</DL>
-
-<P>
-
-<I>nf_queue</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'queue' verdict
-</DL>
-
-<P>
-
-<I>nf_stolen</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stolen' verdict
-</DL>
-
-<P>
-
-<I>ipproto_udp</I>
-<DL COMPACT><DT><DD>
-Constant used to signify that the packet protocol is UDP
-</DL>
-
-<P>
-
-<I>outdev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet will be routed to (if known)
-</DL>
-
-<P>
-
-<I>ack</I>
-<DL COMPACT><DT><DD>
-TCP ACK flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>fin</I>
-<DL COMPACT><DT><DD>
-TCP FIN flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>nf_drop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'drop' verdict
-</DL>
-
-<P>
-
-<I>psh</I>
-<DL COMPACT><DT><DD>
-TCP PSH flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>saddr</I>
-<DL COMPACT><DT><DD>
-A string representing the source IP address
-</DL>
-
-<P>
-
-<I>nf_stop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stop' verdict
-</DL>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-The length of the packet buffer contents, in bytes
-</DL>
-
-<P>
-
-<I>daddr</I>
-<DL COMPACT><DT><DD>
-A string representing the destination IP address
-</DL>
-
-<P>
-
-<I>outdev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing output device, 0 if unknown
-</DL>
-
-<P>
-
-<I>syn</I>
-<DL COMPACT><DT><DD>
-TCP SYN flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>sport</I>
-<DL COMPACT><DT><DD>
-TCP or UDP source port (ipv4 only)
-</DL>
-
-<P>
-
-<I>nf_repeat</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'repeat' verdict
-</DL>
-
-<P>
-
-<I>indev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet was received on (if known)
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-IP address family
-</DL>
-
-<P>
-
-<I>iphdr</I>
-<DL COMPACT><DT><DD>
-Address of IP header
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NETFILTER\&.I</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NETFILTER\&.I</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::netfilter.ip.pre_routing - Called before an IP packet is routed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-netfilter.ip.pre_routing
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>urg</I>
-<DL COMPACT><DT><DD>
-TCP URG flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Packet protocol from driver (ipv4 only)
-</DL>
-
-<P>
-
-<I>indev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing input device, 0 if unknown
-</DL>
-
-<P>
-
-<I>nf_accept</I>
-<DL COMPACT><DT><DD>
-Constant used to signify an 'accept' verdict
-</DL>
-
-<P>
-
-<I>pf</I>
-<DL COMPACT><DT><DD>
-Protocol family - either 'ipv4' or 'ipv6'
-</DL>
-
-<P>
-
-<I>ipproto_tcp</I>
-<DL COMPACT><DT><DD>
-Constant used to signify that the packet protocol is TCP
-</DL>
-
-<P>
-
-<I>rst</I>
-<DL COMPACT><DT><DD>
-TCP RST flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>dport</I>
-<DL COMPACT><DT><DD>
-TCP or UDP destination port (ipv4 only)
-</DL>
-
-<P>
-
-<I>nf_queue</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'queue' verdict
-</DL>
-
-<P>
-
-<I>nf_stolen</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stolen' verdict
-</DL>
-
-<P>
-
-<I>ipproto_udp</I>
-<DL COMPACT><DT><DD>
-Constant used to signify that the packet protocol is UDP
-</DL>
-
-<P>
-
-<I>outdev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet will be routed to (if known)
-</DL>
-
-<P>
-
-<I>ack</I>
-<DL COMPACT><DT><DD>
-TCP ACK flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>fin</I>
-<DL COMPACT><DT><DD>
-TCP FIN flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>nf_drop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'drop' verdict
-</DL>
-
-<P>
-
-<I>psh</I>
-<DL COMPACT><DT><DD>
-TCP PSH flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>saddr</I>
-<DL COMPACT><DT><DD>
-A string representing the source IP address
-</DL>
-
-<P>
-
-<I>nf_stop</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'stop' verdict
-</DL>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-The length of the packet buffer contents, in bytes
-</DL>
-
-<P>
-
-<I>daddr</I>
-<DL COMPACT><DT><DD>
-A string representing the destination IP address
-</DL>
-
-<P>
-
-<I>outdev</I>
-<DL COMPACT><DT><DD>
-Address of net_device representing output device, 0 if unknown
-</DL>
-
-<P>
-
-<I>syn</I>
-<DL COMPACT><DT><DD>
-TCP SYN flag (if protocol is TCP; ipv4 only)
-</DL>
-
-<P>
-
-<I>sport</I>
-<DL COMPACT><DT><DD>
-TCP or UDP source port (ipv4 only)
-</DL>
-
-<P>
-
-<I>indev_name</I>
-<DL COMPACT><DT><DD>
-Name of network device packet was received on (if known)
-</DL>
-
-<P>
-
-<I>nf_repeat</I>
-<DL COMPACT><DT><DD>
-Constant used to signify a 'repeat' verdict
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-IP address family
-</DL>
-
-<P>
-
-<I>iphdr</I>
-<DL COMPACT><DT><DD>
-Address of IP header
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.AOP\&.R</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.AOP\&.R</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.aop.readpage - NFS client synchronously reading a page
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.aop.readpage
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>i_size</I>
-<DL COMPACT><DT><DD>
-file length in bytes
-</DL>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-device identifier
-</DL>
-
-<P>
-
-<I>rsize</I>
-<DL COMPACT><DT><DD>
-read size (in bytes)
-</DL>
-
-<P>
-
-<I>sb_flag</I>
-<DL COMPACT><DT><DD>
-super block flags
-</DL>
-
-<P>
-
-<I>file</I>
-<DL COMPACT><DT><DD>
-file argument
-</DL>
-
-<P>
-
-<I>page_index</I>
-<DL COMPACT><DT><DD>
-offset within mapping, can used a page identifier and position identifier in the page frame
-</DL>
-
-<P>
-
-<I>__page</I>
-<DL COMPACT><DT><DD>
-the address of page
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-number of pages to be read in this execution
-</DL>
-
-<P>
-
-<I>i_flag</I>
-<DL COMPACT><DT><DD>
-file flags
-</DL>
-
-<P>
-
-<I>ino</I>
-<DL COMPACT><DT><DD>
-inode number
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Read the page over, only fires when a previous async read operation failed
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.AOP\&.R</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.AOP\&.R</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.aop.readpages - NFS client reading multiple pages
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.aop.readpages
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-device identifier
-</DL>
-
-<P>
-
-<I>rsize</I>
-<DL COMPACT><DT><DD>
-read size (in bytes)
-</DL>
-
-<P>
-
-<I>file</I>
-<DL COMPACT><DT><DD>
-filp argument
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-number of pages attempted to read in this execution
-</DL>
-
-<P>
-
-<I>nr_pages</I>
-<DL COMPACT><DT><DD>
-number of pages attempted to read in this execution
-</DL>
-
-<P>
-
-<I>rpages</I>
-<DL COMPACT><DT><DD>
-read size (in pages)
-</DL>
-
-<P>
-
-<I>ino</I>
-<DL COMPACT><DT><DD>
-inode number
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires when in readahead way, read several pages once
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.AOP\&.R</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.AOP\&.R</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.aop.release_page - NFS client releasing page
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.aop.release_page
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-device identifier
-</DL>
-
-<P>
-
-<I>page_index</I>
-<DL COMPACT><DT><DD>
-offset within mapping, can used a page identifier and position identifier in the page frame
-</DL>
-
-<P>
-
-<I>__page</I>
-<DL COMPACT><DT><DD>
-the address of page
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-release pages
-</DL>
-
-<P>
-
-<I>ino</I>
-<DL COMPACT><DT><DD>
-inode number
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires when do a release operation on NFS.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.AOP\&.S</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.AOP\&.S</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.aop.set_page_dirty - NFS client marking page as dirty
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.aop.set_page_dirty
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>__page</I>
-<DL COMPACT><DT><DD>
-the address of page
-</DL>
-
-<P>
-
-<I>page_flag</I>
-<DL COMPACT><DT><DD>
-page flags
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This probe attaches to the generic __set_page_dirty_nobuffers function. Thus, this probe is going to fire on many other file systems in addition to the NFS client.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.AOP\&.W</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.AOP\&.W</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.aop.write_begin - NFS client begin to write data
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.aop.write_begin
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-device identifier
-</DL>
-
-<P>
-
-<I>page_index</I>
-<DL COMPACT><DT><DD>
-offset within mapping, can used a page identifier and position identifier in the page frame
-</DL>
-
-<P>
-
-<I>__page</I>
-<DL COMPACT><DT><DD>
-the address of page
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-write bytes
-</DL>
-
-<P>
-
-<I>to</I>
-<DL COMPACT><DT><DD>
-end address of this write operation
-</DL>
-
-<P>
-
-<I>ino</I>
-<DL COMPACT><DT><DD>
-inode number
-</DL>
-
-<P>
-
-<I>offset</I>
-<DL COMPACT><DT><DD>
-start address of this write operation
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Occurs when write operation occurs on nfs. It prepare a page for writing, look for a request corresponding to the page. If there is one, and it belongs to another file, it flush it out before it tries to copy anything into the page. Also do the same if it finds a request from an existing dropped page
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.AOP\&.W</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.AOP\&.W</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.aop.write_end - NFS client complete writing data
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.aop.write_end
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>i_size</I>
-<DL COMPACT><DT><DD>
-file length in bytes
-</DL>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-device identifier
-</DL>
-
-<P>
-
-<I>sb_flag</I>
-<DL COMPACT><DT><DD>
-super block flags
-</DL>
-
-<P>
-
-<I>page_index</I>
-<DL COMPACT><DT><DD>
-offset within mapping, can used a page identifier and position identifier in the page frame
-</DL>
-
-<P>
-
-<I>__page</I>
-<DL COMPACT><DT><DD>
-the address of page
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-write bytes
-</DL>
-
-<P>
-
-<I>i_flag</I>
-<DL COMPACT><DT><DD>
-file flags
-</DL>
-
-<P>
-
-<I>to</I>
-<DL COMPACT><DT><DD>
-end address of this write operation
-</DL>
-
-<P>
-
-<I>ino</I>
-<DL COMPACT><DT><DD>
-inode number
-</DL>
-
-<P>
-
-<I>offset</I>
-<DL COMPACT><DT><DD>
-start address of this write operation
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires when do a write operation on nfs, often after prepare_write
-<P>
-
-Update and possibly write a cached page of an NFS file.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.AOP\&.W</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.AOP\&.W</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.aop.writepage - NFS client writing a mapped page to the NFS server
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.aop.writepage
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>for_reclaim</I>
-<DL COMPACT><DT><DD>
-a flag of writeback_control, indicates if it's invoked from the page allocator
-</DL>
-
-<P>
-
-<I>i_size</I>
-<DL COMPACT><DT><DD>
-file length in bytes
-</DL>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-device identifier
-</DL>
-
-<P>
-
-<I>sb_flag</I>
-<DL COMPACT><DT><DD>
-super block flags
-</DL>
-
-<P>
-
-<I>page_index</I>
-<DL COMPACT><DT><DD>
-offset within mapping, can used a page identifier and position identifier in the page frame
-</DL>
-
-<P>
-
-<I>__page</I>
-<DL COMPACT><DT><DD>
-the address of page
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-number of pages to be written in this execution
-</DL>
-
-<P>
-
-<I>for_kupdate</I>
-<DL COMPACT><DT><DD>
-a flag of writeback_control, indicates if it's a kupdate writeback
-</DL>
-
-<P>
-
-<I>wsize</I>
-<DL COMPACT><DT><DD>
-write size
-</DL>
-
-<P>
-
-<I>i_flag</I>
-<DL COMPACT><DT><DD>
-file flags
-</DL>
-
-<P>
-
-<I>i_state</I>
-<DL COMPACT><DT><DD>
-inode state flags
-</DL>
-
-<P>
-
-<I>ino</I>
-<DL COMPACT><DT><DD>
-inode number
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The priority of wb is decided by the flags
-<I>for_reclaim</I>
-and
-<I>for_kupdate</I>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.AOP\&.W</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.AOP\&.W</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.aop.writepages - NFS client writing several dirty pages to the NFS server
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.aop.writepages
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>for_reclaim</I>
-<DL COMPACT><DT><DD>
-a flag of writeback_control, indicates if it's invoked from the page allocator
-</DL>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-device identifier
-</DL>
-
-<P>
-
-<I>wpages</I>
-<DL COMPACT><DT><DD>
-write size (in pages)
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-number of pages attempted to be written in this execution
-</DL>
-
-<P>
-
-<I>for_kupdate</I>
-<DL COMPACT><DT><DD>
-a flag of writeback_control, indicates if it's a kupdate writeback
-</DL>
-
-<P>
-
-<I>wsize</I>
-<DL COMPACT><DT><DD>
-write size
-</DL>
-
-<P>
-
-<I>nr_to_write</I>
-<DL COMPACT><DT><DD>
-number of pages attempted to be written in this execution
-</DL>
-
-<P>
-
-<I>ino</I>
-<DL COMPACT><DT><DD>
-inode number
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The priority of wb is decided by the flags
-<I>for_reclaim</I>
-and
-<I>for_kupdate</I>.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.FOP\&.A</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.FOP\&.A</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.fop.aio_read - NFS client aio_read file operation
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.fop.aio_read
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>attrtimeo</I>
-<DL COMPACT><DT><DD>
-how long the cached information is assumed to be valid. We need to revalidate the cached attrs for this inode if jiffies - read_cache_jiffies > attrtimeo.
-</DL>
-
-<P>
-
-<I>cache_valid</I>
-<DL COMPACT><DT><DD>
-cache related bit mask flag
-</DL>
-
-<P>
-
-<I>count</I>
-<DL COMPACT><DT><DD>
-read bytes
-</DL>
-
-<P>
-
-<I>parent_name</I>
-<DL COMPACT><DT><DD>
-parent dir name
-</DL>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-device identifier
-</DL>
-
-<P>
-
-<I>buf</I>
-<DL COMPACT><DT><DD>
-the address of buf in user space
-</DL>
-
-<P>
-
-<I>cache_time</I>
-<DL COMPACT><DT><DD>
-when we started read-caching this inode
-</DL>
-
-<P>
-
-<I>file_name</I>
-<DL COMPACT><DT><DD>
-file name
-</DL>
-
-<P>
-
-<I>pos</I>
-<DL COMPACT><DT><DD>
-current position of file
-</DL>
-
-<P>
-
-<I>ino</I>
-<DL COMPACT><DT><DD>
-inode number
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.FOP\&.A</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.FOP\&.A</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.fop.aio_write - NFS client aio_write file operation
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.fop.aio_write
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>count</I>
-<DL COMPACT><DT><DD>
-read bytes
-</DL>
-
-<P>
-
-<I>parent_name</I>
-<DL COMPACT><DT><DD>
-parent dir name
-</DL>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-device identifier
-</DL>
-
-<P>
-
-<I>buf</I>
-<DL COMPACT><DT><DD>
-the address of buf in user space
-</DL>
-
-<P>
-
-<I>file_name</I>
-<DL COMPACT><DT><DD>
-file name
-</DL>
-
-<P>
-
-<I>pos</I>
-<DL COMPACT><DT><DD>
-offset of the file
-</DL>
-
-<P>
-
-<I>ino</I>
-<DL COMPACT><DT><DD>
-inode number
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.FOP\&.C</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.FOP\&.C</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.fop.check_flags - NFS client checking flag operation
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.fop.check_flags
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>flag</I>
-<DL COMPACT><DT><DD>
-file flag
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.FOP\&.F</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.FOP\&.F</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.fop.flush - NFS client flush file operation
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.fop.flush
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-device identifier
-</DL>
-
-<P>
-
-<I>mode</I>
-<DL COMPACT><DT><DD>
-file mode
-</DL>
-
-<P>
-
-<I>ndirty</I>
-<DL COMPACT><DT><DD>
-number of dirty page
-</DL>
-
-<P>
-
-<I>ino</I>
-<DL COMPACT><DT><DD>
-inode number
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.FOP\&.F</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.FOP\&.F</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.fop.fsync - NFS client fsync operation
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.fop.fsync
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-device identifier
-</DL>
-
-<P>
-
-<I>ndirty</I>
-<DL COMPACT><DT><DD>
-number of dirty pages
-</DL>
-
-<P>
-
-<I>ino</I>
-<DL COMPACT><DT><DD>
-inode number
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.FOP\&.L</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.FOP\&.L</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.fop.llseek - NFS client llseek operation
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.fop.llseek
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>whence_str</I>
-<DL COMPACT><DT><DD>
-symbolic string representation of the position to seek from
-</DL>
-
-<P>
-
-<I>whence</I>
-<DL COMPACT><DT><DD>
-the position to seek from
-</DL>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-device identifier
-</DL>
-
-<P>
-
-<I>ino</I>
-<DL COMPACT><DT><DD>
-inode number
-</DL>
-
-<P>
-
-<I>offset</I>
-<DL COMPACT><DT><DD>
-the offset of the file will be repositioned
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.FOP\&.L</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.FOP\&.L</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.fop.lock - NFS client file lock operation
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.fop.lock
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>cmd</I>
-<DL COMPACT><DT><DD>
-cmd arguments
-</DL>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-device identifier
-</DL>
-
-<P>
-
-<I>fl_type</I>
-<DL COMPACT><DT><DD>
-lock type
-</DL>
-
-<P>
-
-<I>fl_end</I>
-<DL COMPACT><DT><DD>
-ending offset of locked region
-</DL>
-
-<P>
-
-<I>fl_flag</I>
-<DL COMPACT><DT><DD>
-lock flags
-</DL>
-
-<P>
-
-<I>i_mode</I>
-<DL COMPACT><DT><DD>
-file type and access rights
-</DL>
-
-<P>
-
-<I>fl_start</I>
-<DL COMPACT><DT><DD>
-starting offset of locked region
-</DL>
-
-<P>
-
-<I>ino</I>
-<DL COMPACT><DT><DD>
-inode number
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.FOP\&.M</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.FOP\&.M</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.fop.mmap - NFS client mmap operation
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.fop.mmap
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>attrtimeo</I>
-<DL COMPACT><DT><DD>
-how long the cached information is assumed to be valid. We need to revalidate the cached attrs for this inode if jiffies - read_cache_jiffies > attrtimeo.
-</DL>
-
-<P>
-
-<I>cache_valid</I>
-<DL COMPACT><DT><DD>
-cache related bit mask flag
-</DL>
-
-<P>
-
-<I>parent_name</I>
-<DL COMPACT><DT><DD>
-parent dir name
-</DL>
-
-<P>
-
-<I>vm_flag</I>
-<DL COMPACT><DT><DD>
-vm flags
-</DL>
-
-<P>
-
-<I>vm_start</I>
-<DL COMPACT><DT><DD>
-start address within vm_mm
-</DL>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-device identifier
-</DL>
-
-<P>
-
-<I>buf</I>
-<DL COMPACT><DT><DD>
-the address of buf in user space
-</DL>
-
-<P>
-
-<I>vm_end</I>
-<DL COMPACT><DT><DD>
-the first byte after end address within vm_mm
-</DL>
-
-<P>
-
-<I>cache_time</I>
-<DL COMPACT><DT><DD>
-when we started read-caching this inode
-</DL>
-
-<P>
-
-<I>file_name</I>
-<DL COMPACT><DT><DD>
-file name
-</DL>
-
-<P>
-
-<I>ino</I>
-<DL COMPACT><DT><DD>
-inode number
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.FOP\&.O</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.FOP\&.O</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.fop.open - NFS client file open operation
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.fop.open
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>i_size</I>
-<DL COMPACT><DT><DD>
-file length in bytes
-</DL>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-device identifier
-</DL>
-
-<P>
-
-<I>flag</I>
-<DL COMPACT><DT><DD>
-file flag
-</DL>
-
-<P>
-
-<I>file_name</I>
-<DL COMPACT><DT><DD>
-file name
-</DL>
-
-<P>
-
-<I>ino</I>
-<DL COMPACT><DT><DD>
-inode number
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.FOP\&.R</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.FOP\&.R</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.fop.read - NFS client read operation
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.fop.read
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>devname</I>
-<DL COMPACT><DT><DD>
-block device name
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-SystemTap uses the vfs.do_sync_read probe to implement this probe and as a result will get operations other than the NFS client read operations.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.FOP\&.R</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.FOP\&.R</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.fop.release - NFS client release page operation
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.fop.release
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-device identifier
-</DL>
-
-<P>
-
-<I>mode</I>
-<DL COMPACT><DT><DD>
-file mode
-</DL>
-
-<P>
-
-<I>ino</I>
-<DL COMPACT><DT><DD>
-inode number
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.FOP\&.S</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.FOP\&.S</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.fop.sendfile - NFS client send file operation
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.fop.sendfile
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>attrtimeo</I>
-<DL COMPACT><DT><DD>
-how long the cached information is assumed to be valid. We need to revalidate the cached attrs for this inode if jiffies - read_cache_jiffies > attrtimeo.
-</DL>
-
-<P>
-
-<I>cache_valid</I>
-<DL COMPACT><DT><DD>
-cache related bit mask flag
-</DL>
-
-<P>
-
-<I>count</I>
-<DL COMPACT><DT><DD>
-read bytes
-</DL>
-
-<P>
-
-<I>ppos</I>
-<DL COMPACT><DT><DD>
-current position of file
-</DL>
-
-<P>
-
-<I>dev</I>
-<DL COMPACT><DT><DD>
-device identifier
-</DL>
-
-<P>
-
-<I>cache_time</I>
-<DL COMPACT><DT><DD>
-when we started read-caching this inode
-</DL>
-
-<P>
-
-<I>ino</I>
-<DL COMPACT><DT><DD>
-inode number
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.FOP\&.W</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.FOP\&.W</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.fop.write - NFS client write operation
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.fop.write
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>devname</I>
-<DL COMPACT><DT><DD>
-block device name
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-SystemTap uses the vfs.do_sync_write probe to implement this probe and as a result will get operations other than the NFS client write operations.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.PROC\&.</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.PROC\&.</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.proc.commit - NFS client committing data on server
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.proc.commit
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>bitmask1</I>
-<DL COMPACT><DT><DD>
-V4 bitmask representing the set of attributes supported on this filesystem
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-NFS version
-</DL>
-
-<P>
-
-<I>bitmask0</I>
-<DL COMPACT><DT><DD>
-V4 bitmask representing the set of attributes supported on this filesystem
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-read bytes in this execution
-</DL>
-
-<P>
-
-<I>offset</I>
-<DL COMPACT><DT><DD>
-the file offset
-</DL>
-
-<P>
-
-<I>server_ip</I>
-<DL COMPACT><DT><DD>
-IP address of server
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-All the nfs.proc.commit kernel functions were removed in kernel commit 200baa in December 2006, so these probes do not exist on Linux 2.6.21 and newer kernels.
-<P>
-
-Fires when client writes the buffered data to disk. The buffered data is asynchronously written by client earlier. The commit function works in sync way. This probe point does not exist in NFSv2.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.PROC\&.</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.PROC\&.</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.proc.commit_done - NFS client response to a commit RPC task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.proc.commit_done
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>count</I>
-<DL COMPACT><DT><DD>
-number of bytes committed
-</DL>
-
-<P>
-
-<I>status</I>
-<DL COMPACT><DT><DD>
-result of last operation
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-NFS version
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>valid</I>
-<DL COMPACT><DT><DD>
-fattr->valid, indicates which fields are valid
-</DL>
-
-<P>
-
-<I>timestamp</I>
-<DL COMPACT><DT><DD>
-V4 timestamp, which is used for lease renewal
-</DL>
-
-<P>
-
-<I>server_ip</I>
-<DL COMPACT><DT><DD>
-IP address of server
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires when a reply to a commit RPC task is received or some commit operation error occur (timeout or socket shutdown).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.PROC\&.</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.PROC\&.</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.proc.commit_setup - NFS client setting up a commit RPC task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.proc.commit_setup
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>count</I>
-<DL COMPACT><DT><DD>
-bytes in this commit
-</DL>
-
-<P>
-
-<I>bitmask1</I>
-<DL COMPACT><DT><DD>
-V4 bitmask representing the set of attributes supported on this filesystem
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-NFS version
-</DL>
-
-<P>
-
-<I>bitmask0</I>
-<DL COMPACT><DT><DD>
-V4 bitmask representing the set of attributes supported on this filesystem
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-bytes in this commit
-</DL>
-
-<P>
-
-<I>offset</I>
-<DL COMPACT><DT><DD>
-the file offset
-</DL>
-
-<P>
-
-<I>server_ip</I>
-<DL COMPACT><DT><DD>
-IP address of server
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The commit_setup function is used to setup a commit RPC task. Is is not doing the actual commit operation. It is does not exist in NFSv2.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.PROC\&.</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.PROC\&.</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.proc.create - NFS client creating file on server
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.proc.create
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-NFS version (the function is used for all NFS version)
-</DL>
-
-<P>
-
-<I>flag</I>
-<DL COMPACT><DT><DD>
-indicates create mode (only for NFSv3 and NFSv4)
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>filelen</I>
-<DL COMPACT><DT><DD>
-length of file name
-</DL>
-
-<P>
-
-<I>filename</I>
-<DL COMPACT><DT><DD>
-file name
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handler of parent dir
-</DL>
-
-<P>
-
-<I>server_ip</I>
-<DL COMPACT><DT><DD>
-IP address of server
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.PROC\&.</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.PROC\&.</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.proc.handle_exception - NFS client handling an NFSv4 exception
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.proc.handle_exception
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>errorcode</I>
-<DL COMPACT><DT><DD>
-indicates the type of error
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This is the error handling routine for processes for NFSv4.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.PROC\&.</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.PROC\&.</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.proc.lookup - NFS client opens/searches a file on server
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.proc.lookup
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name_len</I>
-<DL COMPACT><DT><DD>
-the length of file name
-</DL>
-
-<P>
-
-<I>filename</I>
-<DL COMPACT><DT><DD>
-the name of file which client opens/searches on server
-</DL>
-
-<P>
-
-<I>bitmask1</I>
-<DL COMPACT><DT><DD>
-V4 bitmask representing the set of attributes supported on this filesystem
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-NFS version
-</DL>
-
-<P>
-
-<I>bitmask0</I>
-<DL COMPACT><DT><DD>
-V4 bitmask representing the set of attributes supported on this filesystem
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>server_ip</I>
-<DL COMPACT><DT><DD>
-IP address of server
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.PROC\&.</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.PROC\&.</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.proc.open - NFS client allocates file read/write context information
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.proc.open
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>mode</I>
-<DL COMPACT><DT><DD>
-file mode
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-NFS version (the function is used for all NFS version)
-</DL>
-
-<P>
-
-<I>flag</I>
-<DL COMPACT><DT><DD>
-file flag
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>filename</I>
-<DL COMPACT><DT><DD>
-file name
-</DL>
-
-<P>
-
-<I>server_ip</I>
-<DL COMPACT><DT><DD>
-IP address of server
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Allocate file read/write context information
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.PROC\&.</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.PROC\&.</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.proc.read - NFS client synchronously reads file from server
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.proc.read
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>count</I>
-<DL COMPACT><DT><DD>
-read bytes in this execution
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-used to set task->tk_flags in rpc_init_task function
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-NFS version
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>offset</I>
-<DL COMPACT><DT><DD>
-the file offset
-</DL>
-
-<P>
-
-<I>server_ip</I>
-<DL COMPACT><DT><DD>
-IP address of server
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-All the nfs.proc.read kernel functions were removed in kernel commit 8e0969 in December 2006, so these probes do not exist on Linux 2.6.21 and newer kernels.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.PROC\&.</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.PROC\&.</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.proc.read_done - NFS client response to a read RPC task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.proc.read_done
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>count</I>
-<DL COMPACT><DT><DD>
-number of bytes read
-</DL>
-
-<P>
-
-<I>status</I>
-<DL COMPACT><DT><DD>
-result of last operation
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-NFS version
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>timestamp</I>
-<DL COMPACT><DT><DD>
-V4 timestamp, which is used for lease renewal
-</DL>
-
-<P>
-
-<I>server_ip</I>
-<DL COMPACT><DT><DD>
-IP address of server
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires when a reply to a read RPC task is received or some read error occurs (timeout or socket shutdown).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.PROC\&.</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.PROC\&.</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.proc.read_setup - NFS client setting up a read RPC task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.proc.read_setup
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>count</I>
-<DL COMPACT><DT><DD>
-read bytes in this execution
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-NFS version
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-read bytes in this execution
-</DL>
-
-<P>
-
-<I>offset</I>
-<DL COMPACT><DT><DD>
-the file offset
-</DL>
-
-<P>
-
-<I>server_ip</I>
-<DL COMPACT><DT><DD>
-IP address of server
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The read_setup function is used to setup a read RPC task. It is not doing the actual read operation.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.PROC\&.</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.PROC\&.</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.proc.release - NFS client releases file read/write context information
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.proc.release
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>mode</I>
-<DL COMPACT><DT><DD>
-file mode
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-NFS version (the function is used for all NFS version)
-</DL>
-
-<P>
-
-<I>flag</I>
-<DL COMPACT><DT><DD>
-file flag
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>filename</I>
-<DL COMPACT><DT><DD>
-file name
-</DL>
-
-<P>
-
-<I>server_ip</I>
-<DL COMPACT><DT><DD>
-IP address of server
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Release file read/write context information
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.PROC\&.</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.PROC\&.</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.proc.remove - NFS client removes a file on server
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.proc.remove
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-NFS version (the function is used for all NFS version)
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>filelen</I>
-<DL COMPACT><DT><DD>
-length of file name
-</DL>
-
-<P>
-
-<I>filename</I>
-<DL COMPACT><DT><DD>
-file name
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handler of parent dir
-</DL>
-
-<P>
-
-<I>server_ip</I>
-<DL COMPACT><DT><DD>
-IP address of server
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.PROC\&.</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.PROC\&.</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.proc.rename - NFS client renames a file on server
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.proc.rename
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>new_fh</I>
-<DL COMPACT><DT><DD>
-file handler of new parent dir
-</DL>
-
-<P>
-
-<I>old_filelen</I>
-<DL COMPACT><DT><DD>
-length of old file name
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-NFS version (the function is used for all NFS version)
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>new_filelen</I>
-<DL COMPACT><DT><DD>
-length of new file name
-</DL>
-
-<P>
-
-<I>old_fh</I>
-<DL COMPACT><DT><DD>
-file handler of old parent dir
-</DL>
-
-<P>
-
-<I>new_name</I>
-<DL COMPACT><DT><DD>
-new file name
-</DL>
-
-<P>
-
-<I>old_name</I>
-<DL COMPACT><DT><DD>
-old file name
-</DL>
-
-<P>
-
-<I>server_ip</I>
-<DL COMPACT><DT><DD>
-IP address of server
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.PROC\&.</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.PROC\&.</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.proc.write - NFS client synchronously writes file to server
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.proc.write
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-used to set task->tk_flags in rpc_init_task function
-</DL>
-
-<P>
-
-<I>bitmask1</I>
-<DL COMPACT><DT><DD>
-V4 bitmask representing the set of attributes supported on this filesystem
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-NFS version
-</DL>
-
-<P>
-
-<I>bitmask0</I>
-<DL COMPACT><DT><DD>
-V4 bitmask representing the set of attributes supported on this filesystem
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-read bytes in this execution
-</DL>
-
-<P>
-
-<I>server_ip</I>
-<DL COMPACT><DT><DD>
-IP address of server
-</DL>
-
-<P>
-
-<I>offset</I>
-<DL COMPACT><DT><DD>
-the file offset
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-All the nfs.proc.write kernel functions were removed in kernel commit 200baa in December 2006, so these probes do not exist on Linux 2.6.21 and newer kernels.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.PROC\&.</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.PROC\&.</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.proc.write_done - NFS client response to a write RPC task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.proc.write_done
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>count</I>
-<DL COMPACT><DT><DD>
-number of bytes written
-</DL>
-
-<P>
-
-<I>status</I>
-<DL COMPACT><DT><DD>
-result of last operation
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-NFS version
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>valid</I>
-<DL COMPACT><DT><DD>
-fattr->valid, indicates which fields are valid
-</DL>
-
-<P>
-
-<I>timestamp</I>
-<DL COMPACT><DT><DD>
-V4 timestamp, which is used for lease renewal
-</DL>
-
-<P>
-
-<I>server_ip</I>
-<DL COMPACT><DT><DD>
-IP address of server
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires when a reply to a write RPC task is received or some write error occurs (timeout or socket shutdown).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFS\&.PROC\&.</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFS\&.PROC\&.</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfs.proc.write_setup - NFS client setting up a write RPC task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfs.proc.write_setup
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>count</I>
-<DL COMPACT><DT><DD>
-bytes written in this execution
-</DL>
-
-<P>
-
-<I>bitmask1</I>
-<DL COMPACT><DT><DD>
-V4 bitmask representing the set of attributes supported on this filesystem
-</DL>
-
-<P>
-
-<I>how</I>
-<DL COMPACT><DT><DD>
-used to set args.stable. The stable value could be: NFS_UNSTABLE,NFS_DATA_SYNC,NFS_FILE_SYNC (in nfs.proc3.write_setup and nfs.proc4.write_setup)
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-NFS version
-</DL>
-
-<P>
-
-<I>bitmask0</I>
-<DL COMPACT><DT><DD>
-V4 bitmask representing the set of attributes supported on this filesystem
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-bytes written in this execution
-</DL>
-
-<P>
-
-<I>offset</I>
-<DL COMPACT><DT><DD>
-the file offset
-</DL>
-
-<P>
-
-<I>server_ip</I>
-<DL COMPACT><DT><DD>
-IP address of server
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The write_setup function is used to setup a write RPC task. It is not doing the actual write operation.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.CLOSE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.CLOSE</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.close - NFS server closing a file for client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.close
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>filename</I>
-<DL COMPACT><DT><DD>
-file name
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.COMMIT</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.COMMIT</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.commit - NFS server committing all pending writes to stable storage
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.commit
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>count</I>
-<DL COMPACT><DT><DD>
-read bytes
-</DL>
-
-<P>
-
-<I>flag</I>
-<DL COMPACT><DT><DD>
-indicates whether this execution is a sync operation
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-read bytes
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handle (the first part is the length of the file handle)
-</DL>
-
-<P>
-
-<I>client_ip</I>
-<DL COMPACT><DT><DD>
-the ip address of client
-</DL>
-
-<P>
-
-<I>offset</I>
-<DL COMPACT><DT><DD>
-the offset of file
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.CREATE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.CREATE</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.create - NFS server creating a file(regular,dir,device,fifo) for client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.create
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>iap_mode</I>
-<DL COMPACT><DT><DD>
-file access mode
-</DL>
-
-<P>
-
-<I>iap_valid</I>
-<DL COMPACT><DT><DD>
-Attribute flags
-</DL>
-
-<P>
-
-<I>filelen</I>
-<DL COMPACT><DT><DD>
-the length of file name
-</DL>
-
-<P>
-
-<I>filename</I>
-<DL COMPACT><DT><DD>
-file name
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handle (the first part is the length of the file handle)
-</DL>
-
-<P>
-
-<I>client_ip</I>
-<DL COMPACT><DT><DD>
-the ip address of client
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-file type(regular,dir,device,fifo ...)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Sometimes nfsd will call nfsd_create_v3 instead of this this probe point.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.CREATE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.CREATE</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.createv3 - NFS server creating a regular file or set file attributes for client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.createv3
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>iap_mode</I>
-<DL COMPACT><DT><DD>
-file access mode
-</DL>
-
-<P>
-
-<I>createmode</I>
-<DL COMPACT><DT><DD>
-create mode .The possible values could be: NFS3_CREATE_EXCLUSIVE, NFS3_CREATE_UNCHECKED, or NFS3_CREATE_GUARDED
-</DL>
-
-<P>
-
-<I>verifier</I>
-<DL COMPACT><DT><DD>
-file attributes (atime,mtime,mode). It's used to reset file attributes for CREATE_EXCLUSIVE
-</DL>
-
-<P>
-
-<I>iap_valid</I>
-<DL COMPACT><DT><DD>
-Attribute flags
-</DL>
-
-<P>
-
-<I>truncp</I>
-<DL COMPACT><DT><DD>
-trunp arguments, indicates if the file shouldbe truncate
-</DL>
-
-<P>
-
-<I>filelen</I>
-<DL COMPACT><DT><DD>
-the length of file name
-</DL>
-
-<P>
-
-<I>filename</I>
-<DL COMPACT><DT><DD>
-file name
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handle (the first part is the length of the file handle)
-</DL>
-
-<P>
-
-<I>client_ip</I>
-<DL COMPACT><DT><DD>
-the ip address of client
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This probepoints is only called by nfsd3_proc_create and nfsd4_open when op_claim_type is NFS4_OPEN_CLAIM_NULL.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.DISPAT</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.DISPAT</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.dispatch - NFS server receives an operation from client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.dispatch
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>proto</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>proc</I>
-<DL COMPACT><DT><DD>
-procedure number
-</DL>
-
-<P>
-
-<I>prog</I>
-<DL COMPACT><DT><DD>
-program number
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-nfs version
-</DL>
-
-<P>
-
-<I>client_ip</I>
-<DL COMPACT><DT><DD>
-the ip address of client
-</DL>
-
-<P>
-
-<I>xid</I>
-<DL COMPACT><DT><DD>
-transmission id
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.LOOKUP</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.LOOKUP</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.lookup - NFS server opening or searching file for a file for client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.lookup
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>filelen</I>
-<DL COMPACT><DT><DD>
-the length of file name
-</DL>
-
-<P>
-
-<I>filename</I>
-<DL COMPACT><DT><DD>
-file name
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handle of parent dir(the first part is the length of the file handle)
-</DL>
-
-<P>
-
-<I>client_ip</I>
-<DL COMPACT><DT><DD>
-the ip address of client
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.OPEN</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.OPEN</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.open - NFS server opening a file for client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.open
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>access</I>
-<DL COMPACT><DT><DD>
-indicates the type of open (read/write/commit/readdir...)
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handle (the first part is the length of the file handle)
-</DL>
-
-<P>
-
-<I>client_ip</I>
-<DL COMPACT><DT><DD>
-the ip address of client
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-type of file (regular file or dir)
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.PROC\&</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.PROC\&</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.proc.commit - NFS server performing a commit operation for client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.proc.commit
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>count</I>
-<DL COMPACT><DT><DD>
-read bytes
-</DL>
-
-<P>
-
-<I>proto</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>uid</I>
-<DL COMPACT><DT><DD>
-requester's user id
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-nfs version
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-read bytes
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handle (the first part is the length of the file handle)
-</DL>
-
-<P>
-
-<I>client_ip</I>
-<DL COMPACT><DT><DD>
-the ip address of client
-</DL>
-
-<P>
-
-<I>gid</I>
-<DL COMPACT><DT><DD>
-requester's group id
-</DL>
-
-<P>
-
-<I>offset</I>
-<DL COMPACT><DT><DD>
-the offset of file
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.PROC\&</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.PROC\&</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.proc.create - NFS server creating a file for client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.proc.create
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>proto</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>uid</I>
-<DL COMPACT><DT><DD>
-requester's user id
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-nfs version
-</DL>
-
-<P>
-
-<I>filelen</I>
-<DL COMPACT><DT><DD>
-length of file name
-</DL>
-
-<P>
-
-<I>filename</I>
-<DL COMPACT><DT><DD>
-file name
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handle (the first part is the length of the file handle)
-</DL>
-
-<P>
-
-<I>client_ip</I>
-<DL COMPACT><DT><DD>
-the ip address of client
-</DL>
-
-<P>
-
-<I>gid</I>
-<DL COMPACT><DT><DD>
-requester's group id
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.PROC\&</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.PROC\&</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.proc.lookup - NFS server opening or searching for a file for client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.proc.lookup
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>proto</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>uid</I>
-<DL COMPACT><DT><DD>
-requester's user id
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-nfs version
-</DL>
-
-<P>
-
-<I>filename</I>
-<DL COMPACT><DT><DD>
-file name
-</DL>
-
-<P>
-
-<I>filelen</I>
-<DL COMPACT><DT><DD>
-the length of file name
-</DL>
-
-<P>
-
-<I>client_ip</I>
-<DL COMPACT><DT><DD>
-the ip address of client
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handle of parent dir (the first part is the length of the file handle)
-</DL>
-
-<P>
-
-<I>gid</I>
-<DL COMPACT><DT><DD>
-requester's group id
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.PROC\&</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.PROC\&</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.proc.read - NFS server reading file for client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.proc.read
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>count</I>
-<DL COMPACT><DT><DD>
-read bytes
-</DL>
-
-<P>
-
-<I>proto</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>uid</I>
-<DL COMPACT><DT><DD>
-requester's user id
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-nfs version
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-read bytes
-</DL>
-
-<P>
-
-<I>vec</I>
-<DL COMPACT><DT><DD>
-struct kvec, includes buf address in kernel address and length of each buffer
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handle (the first part is the length of the file handle)
-</DL>
-
-<P>
-
-<I>client_ip</I>
-<DL COMPACT><DT><DD>
-the ip address of client
-</DL>
-
-<P>
-
-<I>vlen</I>
-<DL COMPACT><DT><DD>
-read blocks
-</DL>
-
-<P>
-
-<I>gid</I>
-<DL COMPACT><DT><DD>
-requester's group id
-</DL>
-
-<P>
-
-<I>offset</I>
-<DL COMPACT><DT><DD>
-the offset of file
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.PROC\&</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.PROC\&</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.proc.remove - NFS server removing a file for client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.proc.remove
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>proto</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>uid</I>
-<DL COMPACT><DT><DD>
-requester's user id
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-nfs version
-</DL>
-
-<P>
-
-<I>filelen</I>
-<DL COMPACT><DT><DD>
-length of file name
-</DL>
-
-<P>
-
-<I>filename</I>
-<DL COMPACT><DT><DD>
-file name
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handle (the first part is the length of the file handle)
-</DL>
-
-<P>
-
-<I>client_ip</I>
-<DL COMPACT><DT><DD>
-the ip address of client
-</DL>
-
-<P>
-
-<I>gid</I>
-<DL COMPACT><DT><DD>
-requester's group id
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.PROC\&</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.PROC\&</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.proc.rename - NFS Server renaming a file for client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.proc.rename
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>tlen</I>
-<DL COMPACT><DT><DD>
-length of new file name
-</DL>
-
-<P>
-
-<I>uid</I>
-<DL COMPACT><DT><DD>
-requester's user id
-</DL>
-
-<P>
-
-<I>flen</I>
-<DL COMPACT><DT><DD>
-length of old file name
-</DL>
-
-<P>
-
-<I>tfh</I>
-<DL COMPACT><DT><DD>
-file handler of new path
-</DL>
-
-<P>
-
-<I>filename</I>
-<DL COMPACT><DT><DD>
-old file name
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handler of old path
-</DL>
-
-<P>
-
-<I>client_ip</I>
-<DL COMPACT><DT><DD>
-the ip address of client
-</DL>
-
-<P>
-
-<I>gid</I>
-<DL COMPACT><DT><DD>
-requester's group id
-</DL>
-
-<P>
-
-<I>tname</I>
-<DL COMPACT><DT><DD>
-new file name
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.PROC\&</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.PROC\&</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.proc.write - NFS server writing data to file for client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.proc.write
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>count</I>
-<DL COMPACT><DT><DD>
-read bytes
-</DL>
-
-<P>
-
-<I>proto</I>
-<DL COMPACT><DT><DD>
-transfer protocol
-</DL>
-
-<P>
-
-<I>uid</I>
-<DL COMPACT><DT><DD>
-requester's user id
-</DL>
-
-<P>
-
-<I>version</I>
-<DL COMPACT><DT><DD>
-nfs version
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-read bytes
-</DL>
-
-<P>
-
-<I>vec</I>
-<DL COMPACT><DT><DD>
-struct kvec, includes buf address in kernel address and length of each buffer
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handle (the first part is the length of the file handle)
-</DL>
-
-<P>
-
-<I>client_ip</I>
-<DL COMPACT><DT><DD>
-the ip address of client
-</DL>
-
-<P>
-
-<I>vlen</I>
-<DL COMPACT><DT><DD>
-read blocks
-</DL>
-
-<P>
-
-<I>gid</I>
-<DL COMPACT><DT><DD>
-requester's group id
-</DL>
-
-<P>
-
-<I>stable</I>
-<DL COMPACT><DT><DD>
-argp->stable
-</DL>
-
-<P>
-
-<I>offset</I>
-<DL COMPACT><DT><DD>
-the offset of file
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.READ</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.READ</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.read - NFS server reading data from a file for client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.read
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>count</I>
-<DL COMPACT><DT><DD>
-read bytes
-</DL>
-
-<P>
-
-<I>file</I>
-<DL COMPACT><DT><DD>
-argument file, indicates if the file has been opened.
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-read bytes
-</DL>
-
-<P>
-
-<I>vec</I>
-<DL COMPACT><DT><DD>
-struct kvec, includes buf address in kernel address and length of each buffer
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handle (the first part is the length of the file handle)
-</DL>
-
-<P>
-
-<I>client_ip</I>
-<DL COMPACT><DT><DD>
-the ip address of client
-</DL>
-
-<P>
-
-<I>vlen</I>
-<DL COMPACT><DT><DD>
-read blocks
-</DL>
-
-<P>
-
-<I>offset</I>
-<DL COMPACT><DT><DD>
-the offset of file
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.RENAME</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.RENAME</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.rename - NFS server renaming a file for client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.rename
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>tlen</I>
-<DL COMPACT><DT><DD>
-length of new file name
-</DL>
-
-<P>
-
-<I>flen</I>
-<DL COMPACT><DT><DD>
-length of old file name
-</DL>
-
-<P>
-
-<I>tfh</I>
-<DL COMPACT><DT><DD>
-file handler of new path
-</DL>
-
-<P>
-
-<I>filename</I>
-<DL COMPACT><DT><DD>
-old file name
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handler of old path
-</DL>
-
-<P>
-
-<I>client_ip</I>
-<DL COMPACT><DT><DD>
-the ip address of client
-</DL>
-
-<P>
-
-<I>tname</I>
-<DL COMPACT><DT><DD>
-new file name
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.UNLINK</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.UNLINK</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.unlink - NFS server removing a file or a directory for client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.unlink
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>filelen</I>
-<DL COMPACT><DT><DD>
-the length of file name
-</DL>
-
-<P>
-
-<I>filename</I>
-<DL COMPACT><DT><DD>
-file name
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handle (the first part is the length of the file handle)
-</DL>
-
-<P>
-
-<I>client_ip</I>
-<DL COMPACT><DT><DD>
-the ip address of client
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-file type (file or dir)
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::NFSD\&.WRITE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::NFSD\&.WRITE</H1>
-Section: Network File Storage Tapsets (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::nfsd.write - NFS server writing data to a file for client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-nfsd.write
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>count</I>
-<DL COMPACT><DT><DD>
-read bytes
-</DL>
-
-<P>
-
-<I>file</I>
-<DL COMPACT><DT><DD>
-argument file, indicates if the file has been opened.
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-read bytes
-</DL>
-
-<P>
-
-<I>vec</I>
-<DL COMPACT><DT><DD>
-struct kvec, includes buf address in kernel address and length of each buffer
-</DL>
-
-<P>
-
-<I>fh</I>
-<DL COMPACT><DT><DD>
-file handle (the first part is the length of the file handle)
-</DL>
-
-<P>
-
-<I>client_ip</I>
-<DL COMPACT><DT><DD>
-the ip address of client
-</DL>
-
-<P>
-
-<I>vlen</I>
-<DL COMPACT><DT><DD>
-read blocks
-</DL>
-
-<P>
-
-<I>offset</I>
-<DL COMPACT><DT><DD>
-the offset of file
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCHEDULER\&.B</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCHEDULER\&.B</H1>
-Section: Scheduler Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scheduler.balance - A cpu attempting to find more work.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scheduler.balance
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The cpu looking for more work.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCHEDULER\&.C</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCHEDULER\&.C</H1>
-Section: Scheduler Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scheduler.cpu_off - Process is about to stop running on a cpu
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scheduler.cpu_off
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>task_prev</I>
-<DL COMPACT><DT><DD>
-the process leaving the cpu (same as current)
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>idle</I>
-<DL COMPACT><DT><DD>
-boolean indicating whether current is the idle process
-</DL>
-
-<P>
-
-<I>task_next</I>
-<DL COMPACT><DT><DD>
-the process replacing current
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process leaving the cpu.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCHEDULER\&.C</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCHEDULER\&.C</H1>
-Section: Scheduler Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scheduler.cpu_on - Process is beginning execution on a cpu
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scheduler.cpu_on
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>task_prev</I>
-<DL COMPACT><DT><DD>
-the process that was previously running on this cpu
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>idle</I>
-<DL COMPACT><DT><DD>
-- boolean indicating whether current is the idle process
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The resuming process.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCHEDULER\&.C</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCHEDULER\&.C</H1>
-Section: Scheduler Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scheduler.ctxswitch - A context switch is occuring.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scheduler.ctxswitch
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>prev_pid</I>
-<DL COMPACT><DT><DD>
-The PID of the process to be switched out
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>next_task_name</I>
-<DL COMPACT><DT><DD>
-The name of the process to be switched in
-</DL>
-
-<P>
-
-<I>nexttsk_state</I>
-<DL COMPACT><DT><DD>
-the state of the process to be switched in
-</DL>
-
-<P>
-
-<I>prev_priority</I>
-<DL COMPACT><DT><DD>
-The priority of the process to be switched out
-</DL>
-
-<P>
-
-<I>next_priority</I>
-<DL COMPACT><DT><DD>
-The priority of the process to be switched in
-</DL>
-
-<P>
-
-<I>next_pid</I>
-<DL COMPACT><DT><DD>
-The PID of the process to be switched in
-</DL>
-
-<P>
-
-<I>prevtsk_state</I>
-<DL COMPACT><DT><DD>
-the state of the process to be switched out
-</DL>
-
-<P>
-
-<I>next_tid</I>
-<DL COMPACT><DT><DD>
-The TID of the process to be switched in
-</DL>
-
-<P>
-
-<I>prev_task_name</I>
-<DL COMPACT><DT><DD>
-The name of the process to be switched out
-</DL>
-
-<P>
-
-<I>prev_tid</I>
-<DL COMPACT><DT><DD>
-The TID of the process to be switched out
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCHEDULER\&.K</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCHEDULER\&.K</H1>
-Section: Scheduler Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scheduler.kthread_stop - A thread created by kthread_create is being stopped
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scheduler.kthread_stop
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>thread_priority</I>
-<DL COMPACT><DT><DD>
-priority of the thread
-</DL>
-
-<P>
-
-<I>thread_pid</I>
-<DL COMPACT><DT><DD>
-PID of the thread being stopped
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCHEDULER\&.K</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCHEDULER\&.K</H1>
-Section: Scheduler Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scheduler.kthread_stop.return - A kthread is stopped and gets the return value
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scheduler.kthread_stop.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>return_value</I>
-<DL COMPACT><DT><DD>
-return value after stopping the thread
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCHEDULER\&.M</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCHEDULER\&.M</H1>
-Section: Scheduler Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scheduler.migrate - Task migrating across cpus
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scheduler.migrate
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>priority</I>
-<DL COMPACT><DT><DD>
-priority of the task being migrated
-</DL>
-
-<P>
-
-<I>cpu_from</I>
-<DL COMPACT><DT><DD>
-the original cpu
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-the process that is being migrated
-</DL>
-
-<P>
-
-<I>cpu_to</I>
-<DL COMPACT><DT><DD>
-the destination cpu
-</DL>
-
-<P>
-
-<I>pid</I>
-<DL COMPACT><DT><DD>
-PID of the task being migrated
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCHEDULER\&.P</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCHEDULER\&.P</H1>
-Section: Scheduler Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scheduler.process_exit - Process exiting
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scheduler.process_exit
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>priority</I>
-<DL COMPACT><DT><DD>
-priority of the process exiting
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>pid</I>
-<DL COMPACT><DT><DD>
-PID of the process exiting
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCHEDULER\&.P</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCHEDULER\&.P</H1>
-Section: Scheduler Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scheduler.process_fork - Process forked
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scheduler.process_fork
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>parent_pid</I>
-<DL COMPACT><DT><DD>
-PID of the parent process
-</DL>
-
-<P>
-
-<I>child_pid</I>
-<DL COMPACT><DT><DD>
-PID of the child process
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCHEDULER\&.P</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCHEDULER\&.P</H1>
-Section: Scheduler Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scheduler.process_free - Scheduler freeing a data structure for a process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scheduler.process_free
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>priority</I>
-<DL COMPACT><DT><DD>
-priority of the process getting freed
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>pid</I>
-<DL COMPACT><DT><DD>
-PID of the process getting freed
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCHEDULER\&.P</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCHEDULER\&.P</H1>
-Section: Scheduler Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scheduler.process_wait - Scheduler starting to wait on a process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scheduler.process_wait
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>pid</I>
-<DL COMPACT><DT><DD>
-PID of the process scheduler is waiting on
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCHEDULER\&.S</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCHEDULER\&.S</H1>
-Section: Scheduler Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scheduler.signal_send - Sending a signal
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scheduler.signal_send
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>signal_number</I>
-<DL COMPACT><DT><DD>
-signal number
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>pid</I>
-<DL COMPACT><DT><DD>
-pid of the process sending signal
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCHEDULER\&.T</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCHEDULER\&.T</H1>
-Section: Scheduler Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scheduler.tick - Schedulers internal tick, a processes timeslice accounting is updated
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scheduler.tick
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>idle</I>
-<DL COMPACT><DT><DD>
-boolean indicating whether current is the idle process
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process whose accounting will be updated.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCHEDULER\&.W</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCHEDULER\&.W</H1>
-Section: Scheduler Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scheduler.wait_task - Waiting on a task to unschedule (become inactive)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scheduler.wait_task
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>task_pid</I>
-<DL COMPACT><DT><DD>
-PID of the task the scheduler is waiting on
-</DL>
-
-<P>
-
-<I>task_priority</I>
-<DL COMPACT><DT><DD>
-priority of the task
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCHEDULER\&.W</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCHEDULER\&.W</H1>
-Section: Scheduler Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scheduler.wakeup - Task is woken up
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scheduler.wakeup
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>task_cpu</I>
-<DL COMPACT><DT><DD>
-cpu of the task being woken up
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>task_pid</I>
-<DL COMPACT><DT><DD>
-PID of the task being woken up
-</DL>
-
-<P>
-
-<I>task_priority</I>
-<DL COMPACT><DT><DD>
-priority of the task being woken up
-</DL>
-
-<P>
-
-<I>task_state</I>
-<DL COMPACT><DT><DD>
-state of the task being woken up
-</DL>
-
-<P>
-
-<I>task_tid</I>
-<DL COMPACT><DT><DD>
-tid of the task being woken up
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCHEDULER\&.W</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCHEDULER\&.W</H1>
-Section: Scheduler Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scheduler.wakeup_new - Newly created task is woken up for the first time
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scheduler.wakeup_new
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>task_cpu</I>
-<DL COMPACT><DT><DD>
-cpu of the task woken up
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>task_pid</I>
-<DL COMPACT><DT><DD>
-PID of the new task woken up
-</DL>
-
-<P>
-
-<I>task_priority</I>
-<DL COMPACT><DT><DD>
-priority of the new task
-</DL>
-
-<P>
-
-<I>task_state</I>
-<DL COMPACT><DT><DD>
-state of the task woken up
-</DL>
-
-<P>
-
-<I>task_tid</I>
-<DL COMPACT><DT><DD>
-TID of the new task woken up
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCSI\&.IOCOMP</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCSI\&.IOCOMP</H1>
-Section: SCSI Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scsi.iocompleted - SCSI mid-layer running the completion processing for block device I/O requests
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scsi.iocompleted
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>device_state_str</I>
-<DL COMPACT><DT><DD>
-The current state of the device, as a string
-</DL>
-
-<P>
-
-<I>dev_id</I>
-<DL COMPACT><DT><DD>
-The scsi device id
-</DL>
-
-<P>
-
-<I>channel</I>
-<DL COMPACT><DT><DD>
-The channel number
-</DL>
-
-<P>
-
-<I>data_direction</I>
-<DL COMPACT><DT><DD>
-The data_direction specifies whether this command is from/to the device
-</DL>
-
-<P>
-
-<I>lun</I>
-<DL COMPACT><DT><DD>
-The lun number
-</DL>
-
-<P>
-
-<I>host_no</I>
-<DL COMPACT><DT><DD>
-The host number
-</DL>
-
-<P>
-
-<I>data_direction_str</I>
-<DL COMPACT><DT><DD>
-Data direction, as a string
-</DL>
-
-<P>
-
-<I>device_state</I>
-<DL COMPACT><DT><DD>
-The current state of the device
-</DL>
-
-<P>
-
-<I>req_addr</I>
-<DL COMPACT><DT><DD>
-The current struct request pointer, as a number
-</DL>
-
-<P>
-
-<I>goodbytes</I>
-<DL COMPACT><DT><DD>
-The bytes completed
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCSI\&.IODISP</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCSI\&.IODISP</H1>
-Section: SCSI Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scsi.iodispatching - SCSI mid-layer dispatched low-level SCSI command
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scsi.iodispatching
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>device_state_str</I>
-<DL COMPACT><DT><DD>
-The current state of the device, as a string
-</DL>
-
-<P>
-
-<I>dev_id</I>
-<DL COMPACT><DT><DD>
-The scsi device id
-</DL>
-
-<P>
-
-<I>channel</I>
-<DL COMPACT><DT><DD>
-The channel number
-</DL>
-
-<P>
-
-<I>data_direction</I>
-<DL COMPACT><DT><DD>
-The data_direction specifies whether this command is from/to the device 0 (DMA_BIDIRECTIONAL), 1 (DMA_TO_DEVICE), 2 (DMA_FROM_DEVICE), 3 (DMA_NONE)
-</DL>
-
-<P>
-
-<I>lun</I>
-<DL COMPACT><DT><DD>
-The lun number
-</DL>
-
-<P>
-
-<I>request_bufflen</I>
-<DL COMPACT><DT><DD>
-The request buffer length
-</DL>
-
-<P>
-
-<I>host_no</I>
-<DL COMPACT><DT><DD>
-The host number
-</DL>
-
-<P>
-
-<I>device_state</I>
-<DL COMPACT><DT><DD>
-The current state of the device
-</DL>
-
-<P>
-
-<I>data_direction_str</I>
-<DL COMPACT><DT><DD>
-Data direction, as a string
-</DL>
-
-<P>
-
-<I>req_addr</I>
-<DL COMPACT><DT><DD>
-The current struct request pointer, as a number
-</DL>
-
-<P>
-
-<I>request_buffer</I>
-<DL COMPACT><DT><DD>
-The request buffer address
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCSI\&.IODONE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCSI\&.IODONE</H1>
-Section: SCSI Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scsi.iodone - SCSI command completed by low level driver and enqueued into the done queue.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scsi.iodone
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>device_state_str</I>
-<DL COMPACT><DT><DD>
-The current state of the device, as a string
-</DL>
-
-<P>
-
-<I>dev_id</I>
-<DL COMPACT><DT><DD>
-The scsi device id
-</DL>
-
-<P>
-
-<I>channel</I>
-<DL COMPACT><DT><DD>
-The channel number
-</DL>
-
-<P>
-
-<I>data_direction</I>
-<DL COMPACT><DT><DD>
-The data_direction specifies whether this command is from/to the device.
-</DL>
-
-<P>
-
-<I>lun</I>
-<DL COMPACT><DT><DD>
-The lun number
-</DL>
-
-<P>
-
-<I>host_no</I>
-<DL COMPACT><DT><DD>
-The host number
-</DL>
-
-<P>
-
-<I>data_direction_str</I>
-<DL COMPACT><DT><DD>
-Data direction, as a string
-</DL>
-
-<P>
-
-<I>device_state</I>
-<DL COMPACT><DT><DD>
-The current state of the device
-</DL>
-
-<P>
-
-<I>scsi_timer_pending</I>
-<DL COMPACT><DT><DD>
-1 if a timer is pending on this request
-</DL>
-
-<P>
-
-<I>req_addr</I>
-<DL COMPACT><DT><DD>
-The current struct request pointer, as a number
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCSI\&.IOENTR</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCSI\&.IOENTR</H1>
-Section: SCSI Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scsi.ioentry - Prepares a SCSI mid-layer request
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scsi.ioentry
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>disk_major</I>
-<DL COMPACT><DT><DD>
-The major number of the disk (-1 if no information)
-</DL>
-
-<P>
-
-<I>device_state_str</I>
-<DL COMPACT><DT><DD>
-The current state of the device, as a string
-</DL>
-
-<P>
-
-<I>device_state</I>
-<DL COMPACT><DT><DD>
-The current state of the device
-</DL>
-
-<P>
-
-<I>req_addr</I>
-<DL COMPACT><DT><DD>
-The current struct request pointer, as a number
-</DL>
-
-<P>
-
-<I>disk_minor</I>
-<DL COMPACT><DT><DD>
-The minor number of the disk (-1 if no information)
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCSI\&.IOEXEC</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCSI\&.IOEXEC</H1>
-Section: SCSI Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scsi.ioexecute - Create mid-layer SCSI request and wait for the result
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scsi.ioexecute
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>retries</I>
-<DL COMPACT><DT><DD>
-Number of times to retry request
-</DL>
-
-<P>
-
-<I>device_state_str</I>
-<DL COMPACT><DT><DD>
-The current state of the device, as a string
-</DL>
-
-<P>
-
-<I>dev_id</I>
-<DL COMPACT><DT><DD>
-The scsi device id
-</DL>
-
-<P>
-
-<I>channel</I>
-<DL COMPACT><DT><DD>
-The channel number
-</DL>
-
-<P>
-
-<I>data_direction</I>
-<DL COMPACT><DT><DD>
-The data_direction specifies whether this command is from/to the device.
-</DL>
-
-<P>
-
-<I>lun</I>
-<DL COMPACT><DT><DD>
-The lun number
-</DL>
-
-<P>
-
-<I>timeout</I>
-<DL COMPACT><DT><DD>
-Request timeout in seconds
-</DL>
-
-<P>
-
-<I>request_bufflen</I>
-<DL COMPACT><DT><DD>
-The data buffer buffer length
-</DL>
-
-<P>
-
-<I>host_no</I>
-<DL COMPACT><DT><DD>
-The host number
-</DL>
-
-<P>
-
-<I>data_direction_str</I>
-<DL COMPACT><DT><DD>
-Data direction, as a string
-</DL>
-
-<P>
-
-<I>device_state</I>
-<DL COMPACT><DT><DD>
-The current state of the device
-</DL>
-
-<P>
-
-<I>request_buffer</I>
-<DL COMPACT><DT><DD>
-The data buffer address
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:28 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SCSI\&.SET_ST</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SCSI\&.SET_ST</H1>
-Section: SCSI Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::scsi.set_state - Order SCSI device state change
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-scsi.set_state
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>state_str</I>
-<DL COMPACT><DT><DD>
-The new state of the device, as a string
-</DL>
-
-<P>
-
-<I>dev_id</I>
-<DL COMPACT><DT><DD>
-The scsi device id
-</DL>
-
-<P>
-
-<I>channel</I>
-<DL COMPACT><DT><DD>
-The channel number
-</DL>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-The new state of the device
-</DL>
-
-<P>
-
-<I>old_state_str</I>
-<DL COMPACT><DT><DD>
-The current state of the device, as a string
-</DL>
-
-<P>
-
-<I>lun</I>
-<DL COMPACT><DT><DD>
-The lun number
-</DL>
-
-<P>
-
-<I>old_state</I>
-<DL COMPACT><DT><DD>
-The current state of the device
-</DL>
-
-<P>
-
-<I>host_no</I>
-<DL COMPACT><DT><DD>
-The host number
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.CHEC</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.CHEC</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.check_ignored - Checking to see signal is ignored
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.check_ignored
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>sig_name</I>
-<DL COMPACT><DT><DD>
-A string representation of the signal
-</DL>
-
-<P>
-
-<I>sig</I>
-<DL COMPACT><DT><DD>
-The number of the signal
-</DL>
-
-<P>
-
-<I>pid_name</I>
-<DL COMPACT><DT><DD>
-Name of the process receiving the signal
-</DL>
-
-<P>
-
-<I>sig_pid</I>
-<DL COMPACT><DT><DD>
-The PID of the process receiving the signal
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.CHEC</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.CHEC</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.check_ignored.return - Check to see signal is ignored completed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.check_ignored.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>retstr</I>
-<DL COMPACT><DT><DD>
-Return value as a string
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.CHEC</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.CHEC</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.checkperm - Check being performed on a sent signal
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.checkperm
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-A task handle to the signal recipient
-</DL>
-
-<P>
-
-<I>sinfo</I>
-<DL COMPACT><DT><DD>
-The address of the siginfo structure
-</DL>
-
-<P>
-
-<I>si_code</I>
-<DL COMPACT><DT><DD>
-Indicates the signal type
-</DL>
-
-<P>
-
-<I>sig_name</I>
-<DL COMPACT><DT><DD>
-A string representation of the signal
-</DL>
-
-<P>
-
-<I>sig</I>
-<DL COMPACT><DT><DD>
-The number of the signal
-</DL>
-
-<P>
-
-<I>pid_name</I>
-<DL COMPACT><DT><DD>
-Name of the process receiving the signal
-</DL>
-
-<P>
-
-<I>sig_pid</I>
-<DL COMPACT><DT><DD>
-The PID of the process receiving the signal
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.CHEC</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.CHEC</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.checkperm.return - Check performed on a sent signal completed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.checkperm.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>retstr</I>
-<DL COMPACT><DT><DD>
-Return value as a string
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.DO_A</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.DO_A</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.do_action - Examining or changing a signal action
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.do_action
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>sa_mask</I>
-<DL COMPACT><DT><DD>
-The new mask of the signal
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>sig_name</I>
-<DL COMPACT><DT><DD>
-A string representation of the signal
-</DL>
-
-<P>
-
-<I>oldsigact_addr</I>
-<DL COMPACT><DT><DD>
-The address of the old sigaction struct associated with the signal
-</DL>
-
-<P>
-
-<I>sig</I>
-<DL COMPACT><DT><DD>
-The signal to be examined/changed
-</DL>
-
-<P>
-
-<I>sa_handler</I>
-<DL COMPACT><DT><DD>
-The new handler of the signal
-</DL>
-
-<P>
-
-<I>sigact_addr</I>
-<DL COMPACT><DT><DD>
-The address of the new sigaction struct associated with the signal
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.DO_A</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.DO_A</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.do_action.return - Examining or changing a signal action completed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.do_action.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>retstr</I>
-<DL COMPACT><DT><DD>
-Return value as a string
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.FLUS</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.FLUS</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.flush - Flushing all pending signals for a task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.flush
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-The task handler of the process performing the flush
-</DL>
-
-<P>
-
-<I>pid_name</I>
-<DL COMPACT><DT><DD>
-The name of the process associated with the task performing the flush
-</DL>
-
-<P>
-
-<I>sig_pid</I>
-<DL COMPACT><DT><DD>
-The PID of the process associated with the task performing the flush
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.FORC</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.FORC</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.force_segv - Forcing send of SIGSEGV
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.force_segv
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>sig_name</I>
-<DL COMPACT><DT><DD>
-A string representation of the signal
-</DL>
-
-<P>
-
-<I>sig</I>
-<DL COMPACT><DT><DD>
-The number of the signal
-</DL>
-
-<P>
-
-<I>pid_name</I>
-<DL COMPACT><DT><DD>
-Name of the process receiving the signal
-</DL>
-
-<P>
-
-<I>sig_pid</I>
-<DL COMPACT><DT><DD>
-The PID of the process receiving the signal
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.FORC</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.FORC</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.force_segv.return - Forcing send of SIGSEGV complete
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.force_segv.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>retstr</I>
-<DL COMPACT><DT><DD>
-Return value as a string
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.HAND</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.HAND</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.handle - Signal handler being invoked
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.handle
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>regs</I>
-<DL COMPACT><DT><DD>
-The address of the kernel-mode stack area (deprecated in SystemTap 2.1)
-</DL>
-
-<P>
-
-<I>sig_code</I>
-<DL COMPACT><DT><DD>
-The si_code value of the siginfo signal
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>sig_mode</I>
-<DL COMPACT><DT><DD>
-Indicates whether the signal was a user-mode or kernel-mode signal
-</DL>
-
-<P>
-
-<I>sinfo</I>
-<DL COMPACT><DT><DD>
-The address of the siginfo table
-</DL>
-
-<P>
-
-<I>sig_name</I>
-<DL COMPACT><DT><DD>
-A string representation of the signal
-</DL>
-
-<P>
-
-<I>oldset_addr</I>
-<DL COMPACT><DT><DD>
-The address of the bitmask array of blocked signals (deprecated in SystemTap 2.1)
-</DL>
-
-<P>
-
-<I>sig</I>
-<DL COMPACT><DT><DD>
-The signal number that invoked the signal handler
-</DL>
-
-<P>
-
-<I>ka_addr</I>
-<DL COMPACT><DT><DD>
-The address of the k_sigaction table associated with the signal
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.HAND</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.HAND</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.handle.return - Signal handler invocation completed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.handle.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>retstr</I>
-<DL COMPACT><DT><DD>
-Return value as a string
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-(deprecated in SystemTap 2.1)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.PEND</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.PEND</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.pending - Examining pending signal
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.pending
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>sigset_size</I>
-<DL COMPACT><DT><DD>
-The size of the user-space signal set
-</DL>
-
-<P>
-
-<I>sigset_add</I>
-<DL COMPACT><DT><DD>
-The address of the user-space signal set (sigset_t)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-This probe is used to examine a set of signals pending for delivery to a specific thread. This normally occurs when the do_sigpending kernel function is executed.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.PEND</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.PEND</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.pending.return - Examination of pending signal completed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.pending.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>retstr</I>
-<DL COMPACT><DT><DD>
-Return value as a string
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.PROC</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.PROC</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.procmask - Examining or changing blocked signals
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.procmask
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>how</I>
-<DL COMPACT><DT><DD>
-Indicates how to change the blocked signals; possible values are SIG_BLOCK=0 (for blocking signals), SIG_UNBLOCK=1 (for unblocking signals), and SIG_SETMASK=2 for setting the signal mask.
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>oldsigset_addr</I>
-<DL COMPACT><DT><DD>
-The old address of the signal set (sigset_t)
-</DL>
-
-<P>
-
-<I>sigset</I>
-<DL COMPACT><DT><DD>
-The actual value to be set for sigset_t (correct?)
-</DL>
-
-<P>
-
-<I>sigset_addr</I>
-<DL COMPACT><DT><DD>
-The address of the signal set (sigset_t) to be implemented
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.PROC</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.PROC</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.procmask.return - Examining or changing blocked signals completed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.procmask.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>retstr</I>
-<DL COMPACT><DT><DD>
-Return value as a string
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.SEND</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.SEND</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.send - Signal being sent to a process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.send
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>send2queue</I>
-<DL COMPACT><DT><DD>
-Indicates whether the signal is sent to an existing sigqueue (deprecated in SystemTap 2.1)
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-The name of the function used to send out the signal
-</DL>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-A task handle to the signal recipient
-</DL>
-
-<P>
-
-<I>sinfo</I>
-<DL COMPACT><DT><DD>
-The address of siginfo struct
-</DL>
-
-<P>
-
-<I>si_code</I>
-<DL COMPACT><DT><DD>
-Indicates the signal type
-</DL>
-
-<P>
-
-<I>sig_name</I>
-<DL COMPACT><DT><DD>
-A string representation of the signal
-</DL>
-
-<P>
-
-<I>sig</I>
-<DL COMPACT><DT><DD>
-The number of the signal
-</DL>
-
-<P>
-
-<I>shared</I>
-<DL COMPACT><DT><DD>
-Indicates whether the signal is shared by the thread group
-</DL>
-
-<P>
-
-<I>sig_pid</I>
-<DL COMPACT><DT><DD>
-The PID of the process receiving the signal
-</DL>
-
-<P>
-
-<I>pid_name</I>
-<DL COMPACT><DT><DD>
-The name of the signal recipient
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The signal's sender.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.SEND</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.SEND</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.send.return - Signal being sent to a process completed (deprecated in SystemTap 2.1)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.send.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>retstr</I>
-<DL COMPACT><DT><DD>
-The return value to either __group_send_sig_info, specific_send_sig_info, or send_sigqueue
-</DL>
-
-<P>
-
-<I>send2queue</I>
-<DL COMPACT><DT><DD>
-Indicates whether the sent signal was sent to an existing sigqueue
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-The name of the function used to send out the signal
-</DL>
-
-<P>
-
-<I>shared</I>
-<DL COMPACT><DT><DD>
-Indicates whether the sent signal is shared by the thread group.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The signal's sender. (correct?)
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Possible __group_send_sig_info and specific_send_sig_info return values are as follows;
-<P>
-
-0 -- The signal is successfully sent to a process, which means that, (1) the signal was ignored by the receiving process, (2) this is a non-RT signal and the system already has one queued, and (3) the signal was successfully added to the sigqueue of the receiving process.
-<P>
-
--EAGAIN -- The sigqueue of the receiving process is overflowing, the signal was RT, and the signal was sent by a user using something other than
-<B>kill</B>.
-<P>
-
-Possible send_group_sigqueue and send_sigqueue return values are as follows;
-<P>
-
-0 -- The signal was either successfully added into the sigqueue of the receiving process, or a SI_TIMER entry is already queued (in which case, the overrun count will be simply incremented).
-<P>
-
-1 -- The signal was ignored by the receiving process.
-<P>
-
--1 -- (send_sigqueue only) The task was marked exiting, allowing * posix_timer_event to redirect it to the group leader.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.SEND</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.SEND</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.send_sig_queue - Queuing a signal to a process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.send_sig_queue
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>sigqueue_addr</I>
-<DL COMPACT><DT><DD>
-The address of the signal queue
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>sig_name</I>
-<DL COMPACT><DT><DD>
-A string representation of the signal
-</DL>
-
-<P>
-
-<I>sig</I>
-<DL COMPACT><DT><DD>
-The queued signal
-</DL>
-
-<P>
-
-<I>pid_name</I>
-<DL COMPACT><DT><DD>
-Name of the process to which the signal is queued
-</DL>
-
-<P>
-
-<I>sig_pid</I>
-<DL COMPACT><DT><DD>
-The PID of the process to which the signal is queued
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.SEND</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.SEND</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.send_sig_queue.return - Queuing a signal to a process completed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.send_sig_queue.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>retstr</I>
-<DL COMPACT><DT><DD>
-Return value as a string
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.SYS_</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.SYS_</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.sys_tgkill - Sending kill signal to a thread group
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.sys_tgkill
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>sig_name</I>
-<DL COMPACT><DT><DD>
-A string representation of the signal
-</DL>
-
-<P>
-
-<I>sig</I>
-<DL COMPACT><DT><DD>
-The specific kill signal sent to the process
-</DL>
-
-<P>
-
-<I>tgid</I>
-<DL COMPACT><DT><DD>
-The thread group ID of the thread receiving the kill signal
-</DL>
-
-<P>
-
-<I>pid_name</I>
-<DL COMPACT><DT><DD>
-The name of the signal recipient
-</DL>
-
-<P>
-
-<I>sig_pid</I>
-<DL COMPACT><DT><DD>
-The PID of the thread receiving the kill signal
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The tgkill call is similar to tkill, except that it also allows the caller to specify the thread group ID of the thread to be signalled. This protects against TID reuse.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.SYS_</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.SYS_</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.sys_tgkill.return - Sending kill signal to a thread group completed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.sys_tgkill.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>retstr</I>
-<DL COMPACT><DT><DD>
-The return value to either __group_send_sig_info,
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.SYS_</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.SYS_</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.sys_tkill - Sending a kill signal to a thread
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.sys_tkill
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>sig_name</I>
-<DL COMPACT><DT><DD>
-A string representation of the signal
-</DL>
-
-<P>
-
-<I>sig</I>
-<DL COMPACT><DT><DD>
-The specific signal sent to the process
-</DL>
-
-<P>
-
-<I>pid_name</I>
-<DL COMPACT><DT><DD>
-The name of the signal recipient
-</DL>
-
-<P>
-
-<I>sig_pid</I>
-<DL COMPACT><DT><DD>
-The PID of the process receiving the kill signal
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The tkill call is analogous to <A HREF="kill.2.html">kill</A>(2), except that it also allows a process within a specific thread group to be targeted. Such processes are targeted through their unique thread IDs (TID).
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.SYSK</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.SYSK</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.syskill - Sending kill signal to a process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.syskill
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>sig_name</I>
-<DL COMPACT><DT><DD>
-A string representation of the signal
-</DL>
-
-<P>
-
-<I>sig</I>
-<DL COMPACT><DT><DD>
-The specific signal sent to the process
-</DL>
-
-<P>
-
-<I>pid_name</I>
-<DL COMPACT><DT><DD>
-The name of the signal recipient
-</DL>
-
-<P>
-
-<I>sig_pid</I>
-<DL COMPACT><DT><DD>
-The PID of the process receiving the signal
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.SYSK</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.SYSK</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.syskill.return - Sending kill signal completed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.syskill.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-None
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.SYST</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.SYST</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.systkill.return - Sending kill signal to a thread completed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.systkill.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>retstr</I>
-<DL COMPACT><DT><DD>
-The return value to either __group_send_sig_info,
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SIGNAL\&.WAKE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SIGNAL\&.WAKE</H1>
-Section: Signal Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::signal.wakeup - Sleeping process being wakened for signal
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-signal.wakeup
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>resume</I>
-<DL COMPACT><DT><DD>
-Indicates whether to wake up a task in a STOPPED or TRACED state
-</DL>
-
-<P>
-
-<I>state_mask</I>
-<DL COMPACT><DT><DD>
-A string representation indicating the mask of task states to wake. Possible values are TASK_INTERRUPTIBLE, TASK_STOPPED, TASK_TRACED, TASK_WAKEKILL, and TASK_INTERRUPTIBLE.
-</DL>
-
-<P>
-
-<I>pid_name</I>
-<DL COMPACT><DT><DD>
-Name of the process to wake
-</DL>
-
-<P>
-
-<I>sig_pid</I>
-<DL COMPACT><DT><DD>
-The PID of the process to wake
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.AIO_</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.AIO_</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.aio_read - Receiving message via <B>sock_aio_read</B>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.aio_read
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol value
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-Socket flags value
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-Socket state value
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Message size in bytes
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-Socket type value
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-Protocol family value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The message sender
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the beginning of receiving a message on a socket via the
-<B>sock_aio_read</B>
-function
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.AIO_</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.AIO_</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.aio_read.return - Conclusion of message received via <B>sock_aio_read</B>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.aio_read.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>success</I>
-<DL COMPACT><DT><DD>
-Was receive successful? (1 = yes, 0 = no)
-</DL>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol value
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-Socket flags value
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-Socket state value
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Size of message received (in bytes) or error code if success = 0
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-Socket type value
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-Protocol family value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The message receiver.
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the conclusion of receiving a message on a socket via the
-<B>sock_aio_read</B>
-function
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.AIO_</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.AIO_</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.aio_write - Message send via <B>sock_aio_write</B>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.aio_write
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol value
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-Socket flags value
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-Socket state value
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Message size in bytes
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-Socket type value
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-Protocol family value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The message sender
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the beginning of sending a message on a socket via the
-<B>sock_aio_write</B>
-function
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.AIO_</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.AIO_</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.aio_write.return - Conclusion of message send via <B>sock_aio_write</B>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.aio_write.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>success</I>
-<DL COMPACT><DT><DD>
-Was receive successful? (1 = yes, 0 = no)
-</DL>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol value
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-Socket flags value
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-Socket state value
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Size of message received (in bytes) or error code if success = 0
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-Socket type value
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-Protocol family value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The message receiver.
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the conclusion of sending a message on a socket via the
-<B>sock_aio_write</B>
-function
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.CLOS</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.CLOS</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.close - Close a socket
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.close
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol value
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-Socket flags value
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-Socket state value
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-Socket type value
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-Protocol family value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The requester (user process or kernel)
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the beginning of closing a socket.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.CLOS</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.CLOS</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.close.return - Return from closing a socket
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.close.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The requester (user process or kernel)
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the conclusion of closing a socket.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.CREA</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.CREA</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.create - Creation of a socket
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.create
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol value
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>requester</I>
-<DL COMPACT><DT><DD>
-Requested by user process or the kernel (1 = kernel, 0 = user)
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-Socket type value
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-Protocol family value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The requester (see requester variable)
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the beginning of creating a socket.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.CREA</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.CREA</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.create.return - Return from Creation of a socket
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.create.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>success</I>
-<DL COMPACT><DT><DD>
-Was socket creation successful? (1 = yes, 0 = no)
-</DL>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol value
-</DL>
-
-<P>
-
-<I>err</I>
-<DL COMPACT><DT><DD>
-Error code if success == 0
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>requester</I>
-<DL COMPACT><DT><DD>
-Requested by user process or the kernel (1 = kernel, 0 = user)
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-Socket type value
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-Protocol family value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The requester (user process or kernel)
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the conclusion of creating a socket.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.READ</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.READ</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.readv - Receiving a message via <B>sock_readv</B>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.readv
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol value
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-Socket flags value
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-Socket state value
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Message size in bytes
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-Socket type value
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-Protocol family value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The message sender
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the beginning of receiving a message on a socket via the
-<B>sock_readv</B>
-function
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.READ</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.READ</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.readv.return - Conclusion of receiving a message via <B>sock_readv</B>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.readv.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>success</I>
-<DL COMPACT><DT><DD>
-Was receive successful? (1 = yes, 0 = no)
-</DL>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol value
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-Socket flags value
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-Socket state value
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Size of message received (in bytes) or error code if success = 0
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-Socket type value
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-Protocol family value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The message receiver.
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the conclusion of receiving a message on a socket via the
-<B>sock_readv</B>
-function
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.RECE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.RECE</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.receive - Message received on a socket.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.receive
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>success</I>
-<DL COMPACT><DT><DD>
-Was send successful? (1 = yes, 0 = no)
-</DL>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol value
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-Socket flags value
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-Socket state value
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Size of message received (in bytes) or error code if success = 0
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-Socket type value
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-Protocol family value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The message receiver
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.RECV</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.RECV</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.recvmsg - Message being received on socket
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.recvmsg
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol value
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-Socket flags value
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-Socket state value
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Message size in bytes
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-Socket type value
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-Protocol family value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The message receiver.
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the beginning of receiving a message on a socket via the
-<B>sock_recvmsg</B>
-function
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.RECV</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.RECV</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.recvmsg.return - Return from Message being received on socket
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.recvmsg.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>success</I>
-<DL COMPACT><DT><DD>
-Was receive successful? (1 = yes, 0 = no)
-</DL>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol value
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-Socket flags value
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-Socket state value
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Size of message received (in bytes) or error code if success = 0
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-Socket type value
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-Protocol family value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The message receiver.
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the conclusion of receiving a message on a socket via the
-<B>sock_recvmsg</B>
-function.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.SEND</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.SEND</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.send - Message sent on a socket.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.send
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>success</I>
-<DL COMPACT><DT><DD>
-Was send successful? (1 = yes, 0 = no)
-</DL>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol value
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-Socket flags value
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-Socket state value
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Size of message sent (in bytes) or error code if success = 0
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-Socket type value
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-Protocol family value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The message sender
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.SEND</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.SEND</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.sendmsg - Message is currently being sent on a socket.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.sendmsg
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol value
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-Socket flags value
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-Socket state value
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Message size in bytes
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-Socket type value
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-Protocol family value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The message sender
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the beginning of sending a message on a socket via the
-<B>sock_sendmsg</B>
-function
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.SEND</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.SEND</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.sendmsg.return - Return from socket.sendmsg.
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.sendmsg.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>success</I>
-<DL COMPACT><DT><DD>
-Was send successful? (1 = yes, 0 = no)
-</DL>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol value
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-Socket flags value
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-Socket state value
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Size of message sent (in bytes) or error code if success = 0
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-Socket type value
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-Protocol family value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The message sender.
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the conclusion of sending a message on a socket via the
-<B>sock_sendmsg</B>
-function
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.WRIT</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.WRIT</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.writev - Message sent via <B>socket_writev</B>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.writev
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol value
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-Socket flags value
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-Socket state value
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Message size in bytes
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-Socket type value
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-Protocol family value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The message sender
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the beginning of sending a message on a socket via the
-<B>sock_writev</B>
-function
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOCKET\&.WRIT</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOCKET\&.WRIT</H1>
-Section: Socket Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::socket.writev.return - Conclusion of message sent via <B>socket_writev</B>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-socket.writev.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>success</I>
-<DL COMPACT><DT><DD>
-Was send successful? (1 = yes, 0 = no)
-</DL>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Protocol value
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-Socket flags value
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>state</I>
-<DL COMPACT><DT><DD>
-Socket state value
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Size of message sent (in bytes) or error code if success = 0
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-Socket type value
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-Protocol family value
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The message receiver.
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the conclusion of sending a message on a socket via the
-<B>sock_writev</B>
-function
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOFTIRQ\&.ENT</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOFTIRQ\&.ENT</H1>
-Section: Interrupt Request (IRQ) Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::softirq.entry - Execution of handler for a pending softirq starting
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-softirq.entry
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>vec</I>
-<DL COMPACT><DT><DD>
-softirq_action vector
-</DL>
-
-<P>
-
-<I>h</I>
-<DL COMPACT><DT><DD>
-struct softirq_action* for current pending softirq
-</DL>
-
-<P>
-
-<I>vec_nr</I>
-<DL COMPACT><DT><DD>
-softirq vector number
-</DL>
-
-<P>
-
-<I>action</I>
-<DL COMPACT><DT><DD>
-pointer to softirq handler just about to execute
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SOFTIRQ\&.EXI</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SOFTIRQ\&.EXI</H1>
-Section: Interrupt Request (IRQ) Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::softirq.exit - Execution of handler for a pending softirq completed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-softirq.exit
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>vec</I>
-<DL COMPACT><DT><DD>
-softirq_action vector
-</DL>
-
-<P>
-
-<I>h</I>
-<DL COMPACT><DT><DD>
-struct softirq_action* for just executed softirq
-</DL>
-
-<P>
-
-<I>vec_nr</I>
-<DL COMPACT><DT><DD>
-softirq vector number
-</DL>
-
-<P>
-
-<I>action</I>
-<DL COMPACT><DT><DD>
-pointer to softirq handler that just finished execution
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAP\&.CACHE_</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAP\&.CACHE_</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::stap.cache_add_mod - Adding kernel instrumentation module to cache
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-stap.cache_add_mod
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dest_path</I>
-<DL COMPACT><DT><DD>
-the path the .ko file is going to (incl filename)
-</DL>
-
-<P>
-
-<I>source_path</I>
-<DL COMPACT><DT><DD>
-the path the .ko file is coming from (incl filename)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires just before the file is actually moved. Note: if moving fails, cache_add_src and cache_add_nss will not fire.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAP\&.CACHE_</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAP\&.CACHE_</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::stap.cache_add_nss - Add NSS (Network Security Services) information to cache
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-stap.cache_add_nss
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dest_path</I>
-<DL COMPACT><DT><DD>
-the path the .sgn file is coming from (incl filename)
-</DL>
-
-<P>
-
-<I>source_path</I>
-<DL COMPACT><DT><DD>
-the path the .sgn file is coming from (incl filename)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires just before the file is actually moved. Note: stap must compiled with NSS support; if moving the kernel module fails, this probe will not fire.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAP\&.CACHE_</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAP\&.CACHE_</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::stap.cache_add_src - Adding C code translation to cache
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-stap.cache_add_src
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>dest_path</I>
-<DL COMPACT><DT><DD>
-the path the .c file is going to (incl filename)
-</DL>
-
-<P>
-
-<I>source_path</I>
-<DL COMPACT><DT><DD>
-the path the .c file is coming from (incl filename)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires just before the file is actually moved. Note: if moving the kernel module fails, this probe will not fire.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAP\&.CACHE_</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAP\&.CACHE_</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::stap.cache_clean - Removing file from stap cache
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-stap.cache_clean
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>path</I>
-<DL COMPACT><DT><DD>
-the path to the .ko/.c file being removed
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires just before the call to unlink the module/source file.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAP\&.CACHE_</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAP\&.CACHE_</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::stap.cache_get - Found item in stap cache
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-stap.cache_get
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>source_path</I>
-<DL COMPACT><DT><DD>
-the path of the .c source file
-</DL>
-
-<P>
-
-<I>module_path</I>
-<DL COMPACT><DT><DD>
-the path of the .ko kernel module file
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires just before the return of get_from_cache, when the cache grab is successful.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAP\&.PASS0</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAP\&.PASS0</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::stap.pass0 - Starting stap pass0 (parsing command line arguments)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-stap.pass0
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>session</I>
-<DL COMPACT><DT><DD>
-the systemtap_session variable s
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-pass0 fires after command line arguments have been parsed.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Invalid Manpage</TITLE></HEAD>
-<BODY>
-<H1>Invalid Manpage</H1>
-The requested file (stdin) is not a valid (unformatted) man page.</BODY></HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Invalid Manpage</TITLE></HEAD>
-<BODY>
-<H1>Invalid Manpage</H1>
-The requested file (stdin) is not a valid (unformatted) man page.</BODY></HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAP\&.PASS1A</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAP\&.PASS1A</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::stap.pass1a - Starting stap pass1 (parsing user script)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-stap.pass1a
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>session</I>
-<DL COMPACT><DT><DD>
-the systemtap_session variable s
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-pass1a fires just after the call to
-<B>gettimeofday</B>, before the user script is parsed.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAP\&.PASS1B</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAP\&.PASS1B</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::stap.pass1b - Starting stap pass1 (parsing library scripts)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-stap.pass1b
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>session</I>
-<DL COMPACT><DT><DD>
-the systemtap_session variable s
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-pass1b fires just before the library scripts are parsed.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAP\&.PASS2</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAP\&.PASS2</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::stap.pass2 - Starting stap pass2 (elaboration)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-stap.pass2
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>session</I>
-<DL COMPACT><DT><DD>
-the systemtap_session variable s
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-pass2 fires just after the call to
-<B>gettimeofday</B>, just before the call to semantic_pass.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Invalid Manpage</TITLE></HEAD>
-<BODY>
-<H1>Invalid Manpage</H1>
-The requested file (stdin) is not a valid (unformatted) man page.</BODY></HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAP\&.PASS3</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAP\&.PASS3</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::stap.pass3 - Starting stap pass3 (translation to C)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-stap.pass3
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>session</I>
-<DL COMPACT><DT><DD>
-the systemtap_session variable s
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-pass3 fires just after the call to
-<B>gettimeofday</B>, just before the call to translate_pass.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Invalid Manpage</TITLE></HEAD>
-<BODY>
-<H1>Invalid Manpage</H1>
-The requested file (stdin) is not a valid (unformatted) man page.</BODY></HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAP\&.PASS4</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAP\&.PASS4</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::stap.pass4 - Starting stap pass4 (compile C code into kernel module)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-stap.pass4
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>session</I>
-<DL COMPACT><DT><DD>
-the systemtap_session variable s
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-pass4 fires just after the call to
-<B>gettimeofday</B>, just before the call to compile_pass.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Invalid Manpage</TITLE></HEAD>
-<BODY>
-<H1>Invalid Manpage</H1>
-The requested file (stdin) is not a valid (unformatted) man page.</BODY></HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAP\&.PASS5</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAP\&.PASS5</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::stap.pass5 - Starting stap pass5 (running the instrumentation)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-stap.pass5
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>session</I>
-<DL COMPACT><DT><DD>
-the systemtap_session variable s
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-pass5 fires just after the call to
-<B>gettimeofday</B>, just before the call to run_pass.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Invalid Manpage</TITLE></HEAD>
-<BODY>
-<H1>Invalid Manpage</H1>
-The requested file (stdin) is not a valid (unformatted) man page.</BODY></HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAP\&.PASS6</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAP\&.PASS6</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::stap.pass6 - Starting stap pass6 (cleanup)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-stap.pass6
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>session</I>
-<DL COMPACT><DT><DD>
-the systemtap_session variable s
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-pass6 fires just after the cleanup label, essentially the same spot as pass5.end
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Invalid Manpage</TITLE></HEAD>
-<BODY>
-<H1>Invalid Manpage</H1>
-The requested file (stdin) is not a valid (unformatted) man page.</BODY></HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAP\&.SYSTEM</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAP\&.SYSTEM</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::stap.system - Starting a command from stap
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-stap.system
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>command</I>
-<DL COMPACT><DT><DD>
-the command string to be run by posix_spawn (as sh -c <str>)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the entry of the stap_system command.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAP\&.SYSTEM</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAP\&.SYSTEM</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::stap.system.return - Finished a command from stap
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-stap.system.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>ret</I>
-<DL COMPACT><DT><DD>
-a return code associated with running waitpid on the spawned process; a non-zero value indicates error
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires just before the return of the stap_system function, after waitpid.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAP\&.SYSTEM</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAP\&.SYSTEM</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::stap.system.spawn - stap spawned new process
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-stap.system.spawn
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>ret</I>
-<DL COMPACT><DT><DD>
-the return value from posix_spawn
-</DL>
-
-<P>
-
-<I>pid</I>
-<DL COMPACT><DT><DD>
-the pid of the spawned process
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires just after the call to posix_spawn.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAPIO\&.RECE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAPIO\&.RECE</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::stapio.receive_control_message - Received a control message
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-stapio.receive_control_message
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>len</I>
-<DL COMPACT><DT><DD>
-the length (in bytes) of the data blob
-</DL>
-
-<P>
-
-<I>data</I>
-<DL COMPACT><DT><DD>
-a ptr to a binary blob of data sent as the control message
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-type of message being send; defined in runtime/transport/transport_msgs.h
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires just after a message was receieved and before it's processed.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAPRUN\&.INS</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAPRUN\&.INS</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::staprun.insert_module - Inserting SystemTap instrumentation module
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-staprun.insert_module
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>path</I>
-<DL COMPACT><DT><DD>
-the full path to the .ko kernel module about to be inserted
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires just before the call to insert the module.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAPRUN\&.REM</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAPRUN\&.REM</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::staprun.remove_module - Removing SystemTap instrumentation module
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-staprun.remove_module
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-the stap module name to be removed (without the .ko extension)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires just before the call to remove the module.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::STAPRUN\&.SEN</TITLE>
-</HEAD><BODY>
-<H1>PROBE::STAPRUN\&.SEN</H1>
-Section: SystemTap Translator Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::staprun.send_control_message - Sending a control message
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-staprun.send_control_message
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>len</I>
-<DL COMPACT><DT><DD>
-the length (in bytes) of the data blob
-</DL>
-
-<P>
-
-<I>data</I>
-<DL COMPACT><DT><DD>
-a ptr to a binary blob of data sent as the control message
-</DL>
-
-<P>
-
-<I>type</I>
-<DL COMPACT><DT><DD>
-type of message being send; defined in runtime/transport/transport_msgs.h
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires at the beginning of the send_request function.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SUNRPC\&.CLNT</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SUNRPC\&.CLNT</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::sunrpc.clnt.bind_new_program - Bind a new RPC program to an existing client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-sunrpc.clnt.bind_new_program
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>prog</I>
-<DL COMPACT><DT><DD>
-the number of new RPC program
-</DL>
-
-<P>
-
-<I>progname</I>
-<DL COMPACT><DT><DD>
-the name of new RPC program
-</DL>
-
-<P>
-
-<I>old_vers</I>
-<DL COMPACT><DT><DD>
-the version of old RPC program
-</DL>
-
-<P>
-
-<I>old_progname</I>
-<DL COMPACT><DT><DD>
-the name of old RPC program
-</DL>
-
-<P>
-
-<I>vers</I>
-<DL COMPACT><DT><DD>
-the version of new RPC program
-</DL>
-
-<P>
-
-<I>servername</I>
-<DL COMPACT><DT><DD>
-the server machine name
-</DL>
-
-<P>
-
-<I>old_prog</I>
-<DL COMPACT><DT><DD>
-the number of old RPC program
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SUNRPC\&.CLNT</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SUNRPC\&.CLNT</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::sunrpc.clnt.call_async - Make an asynchronous RPC call
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-sunrpc.clnt.call_async
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>prog</I>
-<DL COMPACT><DT><DD>
-the RPC program number
-</DL>
-
-<P>
-
-<I>progname</I>
-<DL COMPACT><DT><DD>
-the RPC program name
-</DL>
-
-<P>
-
-<I>procname</I>
-<DL COMPACT><DT><DD>
-the procedure name in this RPC call
-</DL>
-
-<P>
-
-<I>proc</I>
-<DL COMPACT><DT><DD>
-the procedure number in this RPC call
-</DL>
-
-<P>
-
-<I>dead</I>
-<DL COMPACT><DT><DD>
-whether this client is abandoned
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-flags
-</DL>
-
-<P>
-
-<I>vers</I>
-<DL COMPACT><DT><DD>
-the RPC program version number
-</DL>
-
-<P>
-
-<I>port</I>
-<DL COMPACT><DT><DD>
-the port number
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-the IP protocol number
-</DL>
-
-<P>
-
-<I>servername</I>
-<DL COMPACT><DT><DD>
-the server machine name
-</DL>
-
-<P>
-
-<I>xid</I>
-<DL COMPACT><DT><DD>
-current transmission id
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SUNRPC\&.CLNT</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SUNRPC\&.CLNT</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::sunrpc.clnt.call_sync - Make a synchronous RPC call
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-sunrpc.clnt.call_sync
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>prog</I>
-<DL COMPACT><DT><DD>
-the RPC program number
-</DL>
-
-<P>
-
-<I>progname</I>
-<DL COMPACT><DT><DD>
-the RPC program name
-</DL>
-
-<P>
-
-<I>procname</I>
-<DL COMPACT><DT><DD>
-the procedure name in this RPC call
-</DL>
-
-<P>
-
-<I>proc</I>
-<DL COMPACT><DT><DD>
-the procedure number in this RPC call
-</DL>
-
-<P>
-
-<I>dead</I>
-<DL COMPACT><DT><DD>
-whether this client is abandoned
-</DL>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-flags
-</DL>
-
-<P>
-
-<I>vers</I>
-<DL COMPACT><DT><DD>
-the RPC program version number
-</DL>
-
-<P>
-
-<I>port</I>
-<DL COMPACT><DT><DD>
-the port number
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-the IP protocol number
-</DL>
-
-<P>
-
-<I>servername</I>
-<DL COMPACT><DT><DD>
-the server machine name
-</DL>
-
-<P>
-
-<I>xid</I>
-<DL COMPACT><DT><DD>
-current transmission id
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SUNRPC\&.CLNT</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SUNRPC\&.CLNT</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::sunrpc.clnt.clone_client - Clone an RPC client structure
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-sunrpc.clnt.clone_client
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>servername</I>
-<DL COMPACT><DT><DD>
-the server machine name
-</DL>
-
-<P>
-
-<I>vers</I>
-<DL COMPACT><DT><DD>
-the RPC program version number
-</DL>
-
-<P>
-
-<I>prog</I>
-<DL COMPACT><DT><DD>
-the RPC program number
-</DL>
-
-<P>
-
-<I>authflavor</I>
-<DL COMPACT><DT><DD>
-the authentication flavor
-</DL>
-
-<P>
-
-<I>progname</I>
-<DL COMPACT><DT><DD>
-the RPC program name
-</DL>
-
-<P>
-
-<I>port</I>
-<DL COMPACT><DT><DD>
-the port number
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-the IP protocol number
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SUNRPC\&.CLNT</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SUNRPC\&.CLNT</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::sunrpc.clnt.create_client - Create an RPC client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-sunrpc.clnt.create_client
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>servername</I>
-<DL COMPACT><DT><DD>
-the server machine name
-</DL>
-
-<P>
-
-<I>vers</I>
-<DL COMPACT><DT><DD>
-the RPC program version number
-</DL>
-
-<P>
-
-<I>prog</I>
-<DL COMPACT><DT><DD>
-the RPC program number
-</DL>
-
-<P>
-
-<I>authflavor</I>
-<DL COMPACT><DT><DD>
-the authentication flavor
-</DL>
-
-<P>
-
-<I>progname</I>
-<DL COMPACT><DT><DD>
-the RPC program name
-</DL>
-
-<P>
-
-<I>port</I>
-<DL COMPACT><DT><DD>
-the port number
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-the IP protocol number
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SUNRPC\&.CLNT</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SUNRPC\&.CLNT</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::sunrpc.clnt.restart_call - Restart an asynchronous RPC call
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-sunrpc.clnt.restart_call
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>tk_priority</I>
-<DL COMPACT><DT><DD>
-the task priority
-</DL>
-
-<P>
-
-<I>prog</I>
-<DL COMPACT><DT><DD>
-the RPC program number
-</DL>
-
-<P>
-
-<I>tk_pid</I>
-<DL COMPACT><DT><DD>
-the debugging aid of task
-</DL>
-
-<P>
-
-<I>tk_flags</I>
-<DL COMPACT><DT><DD>
-the task flags
-</DL>
-
-<P>
-
-<I>servername</I>
-<DL COMPACT><DT><DD>
-the server machine name
-</DL>
-
-<P>
-
-<I>tk_runstate</I>
-<DL COMPACT><DT><DD>
-the task run status
-</DL>
-
-<P>
-
-<I>xid</I>
-<DL COMPACT><DT><DD>
-the transmission id
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SUNRPC\&.CLNT</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SUNRPC\&.CLNT</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::sunrpc.clnt.shutdown_client - Shutdown an RPC client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-sunrpc.clnt.shutdown_client
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>om_ops</I>
-<DL COMPACT><DT><DD>
-the count of operations
-</DL>
-
-<P>
-
-<I>om_bytes_sent</I>
-<DL COMPACT><DT><DD>
-the count of bytes out
-</DL>
-
-<P>
-
-<I>prog</I>
-<DL COMPACT><DT><DD>
-the RPC program number
-</DL>
-
-<P>
-
-<I>authflavor</I>
-<DL COMPACT><DT><DD>
-the authentication flavor
-</DL>
-
-<P>
-
-<I>progname</I>
-<DL COMPACT><DT><DD>
-the RPC program name
-</DL>
-
-<P>
-
-<I>om_queue</I>
-<DL COMPACT><DT><DD>
-the jiffies queued for xmit
-</DL>
-
-<P>
-
-<I>om_rtt</I>
-<DL COMPACT><DT><DD>
-the RPC RTT jiffies
-</DL>
-
-<P>
-
-<I>om_bytes_recv</I>
-<DL COMPACT><DT><DD>
-the count of bytes in
-</DL>
-
-<P>
-
-<I>tasks</I>
-<DL COMPACT><DT><DD>
-the number of references
-</DL>
-
-<P>
-
-<I>netreconn</I>
-<DL COMPACT><DT><DD>
-the count of reconnections
-</DL>
-
-<P>
-
-<I>vers</I>
-<DL COMPACT><DT><DD>
-the RPC program version number
-</DL>
-
-<P>
-
-<I>om_execute</I>
-<DL COMPACT><DT><DD>
-the RPC execution jiffies
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-the IP protocol number
-</DL>
-
-<P>
-
-<I>port</I>
-<DL COMPACT><DT><DD>
-the port number
-</DL>
-
-<P>
-
-<I>clones</I>
-<DL COMPACT><DT><DD>
-the number of clones
-</DL>
-
-<P>
-
-<I>servername</I>
-<DL COMPACT><DT><DD>
-the server machine name
-</DL>
-
-<P>
-
-<I>rpccnt</I>
-<DL COMPACT><DT><DD>
-the count of RPC calls
-</DL>
-
-<P>
-
-<I>om_ntrans</I>
-<DL COMPACT><DT><DD>
-the count of RPC transmissions
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SUNRPC\&.SCHE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SUNRPC\&.SCHE</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::sunrpc.sched.delay - Delay an RPC task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-sunrpc.sched.delay
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>prog</I>
-<DL COMPACT><DT><DD>
-the program number in the RPC call
-</DL>
-
-<P>
-
-<I>delay</I>
-<DL COMPACT><DT><DD>
-the time delayed
-</DL>
-
-<P>
-
-<I>tk_pid</I>
-<DL COMPACT><DT><DD>
-the debugging id of the task
-</DL>
-
-<P>
-
-<I>tk_flags</I>
-<DL COMPACT><DT><DD>
-the flags of the task
-</DL>
-
-<P>
-
-<I>vers</I>
-<DL COMPACT><DT><DD>
-the program version in the RPC call
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-the IP protocol in the RPC call
-</DL>
-
-<P>
-
-<I>xid</I>
-<DL COMPACT><DT><DD>
-the transmission id in the RPC call
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SUNRPC\&.SCHE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SUNRPC\&.SCHE</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::sunrpc.sched.execute - Execute the RPC `scheduler'
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-sunrpc.sched.execute
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>prog</I>
-<DL COMPACT><DT><DD>
-the program number in the RPC call
-</DL>
-
-<P>
-
-<I>tk_pid</I>
-<DL COMPACT><DT><DD>
-the debugging id of the task
-</DL>
-
-<P>
-
-<I>tk_flags</I>
-<DL COMPACT><DT><DD>
-the flags of the task
-</DL>
-
-<P>
-
-<I>vers</I>
-<DL COMPACT><DT><DD>
-the program version in the RPC call
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-the IP protocol in the RPC call
-</DL>
-
-<P>
-
-<I>xid</I>
-<DL COMPACT><DT><DD>
-the transmission id in the RPC call
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SUNRPC\&.SCHE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SUNRPC\&.SCHE</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::sunrpc.sched.new_task - Create new task for the specified client
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-sunrpc.sched.new_task
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>prog</I>
-<DL COMPACT><DT><DD>
-the program number in the RPC call
-</DL>
-
-<P>
-
-<I>tk_flags</I>
-<DL COMPACT><DT><DD>
-the flags of the task
-</DL>
-
-<P>
-
-<I>vers</I>
-<DL COMPACT><DT><DD>
-the program version in the RPC call
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-the IP protocol in the RPC call
-</DL>
-
-<P>
-
-<I>xid</I>
-<DL COMPACT><DT><DD>
-the transmission id in the RPC call
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::SUNRPC\&.SCHE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::SUNRPC\&.SCHE</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::sunrpc.sched.release_task - Release all resources associated with a task
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-sunrpc.sched.release_task
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>prog</I>
-<DL COMPACT><DT><DD>
-the program number in the RPC call
-</DL>
-
-<P>
-
-<I>tk_flags</I>
-<DL COMPACT><DT><DD>
-the flags of the task
-</DL>
-
-<P>
-
-<I>vers</I>
-<DL COMPACT><DT><DD>
-the program version in the RPC call
-</DL>
-
-<P>
-
-<I>prot</I>
-<DL COMPACT><DT><DD>
-the IP protocol in the RPC call
-</DL>
-
-<P>
-
-<I>xid</I>
-<DL COMPACT><DT><DD>
-the transmission id in the RPC call
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-<B>rpc_release_task</B>
-function might not be found for a particular kernel. So, if we can't find it, just return '-1' for everything.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Invalid Manpage</TITLE></HEAD>
-<BODY>
-<H1>Invalid Manpage</H1>
-The requested file (stdin) is not a valid (unformatted) man page.</BODY></HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Invalid Manpage</TITLE></HEAD>
-<BODY>
-<H1>Invalid Manpage</H1>
-The requested file (stdin) is not a valid (unformatted) man page.</BODY></HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Invalid Manpage</TITLE></HEAD>
-<BODY>
-<H1>Invalid Manpage</H1>
-The requested file (stdin) is not a valid (unformatted) man page.</BODY></HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Invalid Manpage</TITLE></HEAD>
-<BODY>
-<H1>Invalid Manpage</H1>
-The requested file (stdin) is not a valid (unformatted) man page.</BODY></HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Invalid Manpage</TITLE></HEAD>
-<BODY>
-<H1>Invalid Manpage</H1>
-The requested file (stdin) is not a valid (unformatted) man page.</BODY></HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Invalid Manpage</TITLE></HEAD>
-<BODY>
-<H1>Invalid Manpage</H1>
-The requested file (stdin) is not a valid (unformatted) man page.</BODY></HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Invalid Manpage</TITLE></HEAD>
-<BODY>
-<H1>Invalid Manpage</H1>
-The requested file (stdin) is not a valid (unformatted) man page.</BODY></HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCP\&.DISCONN</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCP\&.DISCONN</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcp.disconnect - TCP socket disconnection
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcp.disconnect
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-TCP flags (e.g. FIN, etc)
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>dport</I>
-<DL COMPACT><DT><DD>
-TCP destination port
-</DL>
-
-<P>
-
-<I>saddr</I>
-<DL COMPACT><DT><DD>
-A string representing the source IP address
-</DL>
-
-<P>
-
-<I>daddr</I>
-<DL COMPACT><DT><DD>
-A string representing the destination IP address
-</DL>
-
-<P>
-
-<I>sport</I>
-<DL COMPACT><DT><DD>
-TCP source port
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-IP address family
-</DL>
-
-<P>
-
-<I>sock</I>
-<DL COMPACT><DT><DD>
-Network socket
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process which disconnects tcp
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCP\&.DISCONN</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCP\&.DISCONN</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcp.disconnect.return - TCP socket disconnection complete
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcp.disconnect.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>ret</I>
-<DL COMPACT><DT><DD>
-Error code (0: no error)
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process which disconnects tcp
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCP\&.RECEIVE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCP\&.RECEIVE</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcp.receive - Called when a TCP packet is received
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcp.receive
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>urg</I>
-<DL COMPACT><DT><DD>
-TCP URG flag
-</DL>
-
-<P>
-
-<I>protocol</I>
-<DL COMPACT><DT><DD>
-Packet protocol from driver
-</DL>
-
-<P>
-
-<I>psh</I>
-<DL COMPACT><DT><DD>
-TCP PSH flag
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>rst</I>
-<DL COMPACT><DT><DD>
-TCP RST flag
-</DL>
-
-<P>
-
-<I>dport</I>
-<DL COMPACT><DT><DD>
-TCP destination port
-</DL>
-
-<P>
-
-<I>saddr</I>
-<DL COMPACT><DT><DD>
-A string representing the source IP address
-</DL>
-
-<P>
-
-<I>daddr</I>
-<DL COMPACT><DT><DD>
-A string representing the destination IP address
-</DL>
-
-<P>
-
-<I>ack</I>
-<DL COMPACT><DT><DD>
-TCP ACK flag
-</DL>
-
-<P>
-
-<I>fin</I>
-<DL COMPACT><DT><DD>
-TCP FIN flag
-</DL>
-
-<P>
-
-<I>syn</I>
-<DL COMPACT><DT><DD>
-TCP SYN flag
-</DL>
-
-<P>
-
-<I>sport</I>
-<DL COMPACT><DT><DD>
-TCP source port
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-IP address family
-</DL>
-
-<P>
-
-<I>iphdr</I>
-<DL COMPACT><DT><DD>
-IP header address
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCP\&.RECVMSG</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCP\&.RECVMSG</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcp.recvmsg - Receiving TCP message
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcp.recvmsg
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>dport</I>
-<DL COMPACT><DT><DD>
-TCP destination port
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Number of bytes to be received
-</DL>
-
-<P>
-
-<I>saddr</I>
-<DL COMPACT><DT><DD>
-A string representing the source IP address
-</DL>
-
-<P>
-
-<I>daddr</I>
-<DL COMPACT><DT><DD>
-A string representing the destination IP address
-</DL>
-
-<P>
-
-<I>sport</I>
-<DL COMPACT><DT><DD>
-TCP source port
-</DL>
-
-<P>
-
-<I>sock</I>
-<DL COMPACT><DT><DD>
-Network socket
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-IP address family
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process which receives a tcp message
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCP\&.RECVMSG</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCP\&.RECVMSG</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcp.recvmsg.return - Receiving TCP message complete
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcp.recvmsg.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>dport</I>
-<DL COMPACT><DT><DD>
-TCP destination port
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Number of bytes received or error code if an error occurred.
-</DL>
-
-<P>
-
-<I>saddr</I>
-<DL COMPACT><DT><DD>
-A string representing the source IP address
-</DL>
-
-<P>
-
-<I>daddr</I>
-<DL COMPACT><DT><DD>
-A string representing the destination IP address
-</DL>
-
-<P>
-
-<I>sport</I>
-<DL COMPACT><DT><DD>
-TCP source port
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-IP address family
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process which receives a tcp message
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCP\&.SENDMSG</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCP\&.SENDMSG</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcp.sendmsg - Sending a tcp message
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcp.sendmsg
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Number of bytes to send
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-IP address family
-</DL>
-
-<P>
-
-<I>sock</I>
-<DL COMPACT><DT><DD>
-Network socket
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process which sends a tcp message
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCP\&.SENDMSG</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCP\&.SENDMSG</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcp.sendmsg.return - Sending TCP message is done
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcp.sendmsg.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Number of bytes sent or error code if an error occurred.
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process which sends a tcp message
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCP\&.SETSOCK</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCP\&.SETSOCK</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcp.setsockopt - Call to <B>setsockopt</B>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcp.setsockopt
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>optlen</I>
-<DL COMPACT><DT><DD>
-Used to access values for
-<B>setsockopt</B>
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<P>
-
-<I>optname</I>
-<DL COMPACT><DT><DD>
-TCP socket options (e.g. TCP_NODELAY, TCP_MAXSEG, etc)
-</DL>
-
-<P>
-
-<I>optstr</I>
-<DL COMPACT><DT><DD>
-Resolves optname to a human-readable format
-</DL>
-
-<P>
-
-<I>level</I>
-<DL COMPACT><DT><DD>
-The level at which the socket options will be manipulated
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-IP address family
-</DL>
-
-<P>
-
-<I>sock</I>
-<DL COMPACT><DT><DD>
-Network socket
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process which calls setsockopt
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCP\&.SETSOCK</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCP\&.SETSOCK</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcp.setsockopt.return - Return from <B>setsockopt</B>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcp.setsockopt.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>ret</I>
-<DL COMPACT><DT><DD>
-Error code (0: no error)
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of this probe
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process which calls setsockopt
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCPMIB\&.ACTI</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCPMIB\&.ACTI</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcpmib.ActiveOpens - Count an active opening of a socket
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcpmib.ActiveOpens
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sock being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>tcpmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>ActiveOpens</I>
-(equivalent to SNMP's MIB TCP_MIB_ACTIVEOPENS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCPMIB\&.ATTE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCPMIB\&.ATTE</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcpmib.AttemptFails - Count a failed attempt to open a socket
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcpmib.AttemptFails
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sock being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>tcpmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>AttemptFails</I>
-(equivalent to SNMP's MIB TCP_MIB_ATTEMPTFAILS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCPMIB\&.CURR</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCPMIB\&.CURR</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcpmib.CurrEstab - Update the count of open sockets
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcpmib.CurrEstab
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sock being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>tcpmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>CurrEstab</I>
-(equivalent to SNMP's MIB TCP_MIB_CURRESTAB)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCPMIB\&.ESTA</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCPMIB\&.ESTA</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcpmib.EstabResets - Count the reset of a socket
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcpmib.EstabResets
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sock being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>tcpmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>EstabResets</I>
-(equivalent to SNMP's MIB TCP_MIB_ESTABRESETS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCPMIB\&.INSE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCPMIB\&.INSE</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcpmib.InSegs - Count an incoming tcp segment
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcpmib.InSegs
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sock being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>tcpmib_filter_key</B>
-(or
-<B>ipmib_filter_key</B>
-for tcp v4). If the packet passes the filter is is counted in the global
-<I>InSegs</I>
-(equivalent to SNMP's MIB TCP_MIB_INSEGS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCPMIB\&.OUTR</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCPMIB\&.OUTR</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcpmib.OutRsts - Count the sending of a reset packet
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcpmib.OutRsts
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sock being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>tcpmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>OutRsts</I>
-(equivalent to SNMP's MIB TCP_MIB_OUTRSTS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCPMIB\&.OUTS</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCPMIB\&.OUTS</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcpmib.OutSegs - Count the sending of a TCP segment
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcpmib.OutSegs
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sock being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>tcpmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>OutSegs</I>
-(equivalent to SNMP's MIB TCP_MIB_OUTSEGS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCPMIB\&.PASS</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCPMIB\&.PASS</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcpmib.PassiveOpens - Count the passive creation of a socket
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcpmib.PassiveOpens
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sock being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>tcpmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>PassiveOpens</I>
-(equivalent to SNMP's MIB TCP_MIB_PASSIVEOPENS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TCPMIB\&.RETR</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TCPMIB\&.RETR</H1>
-Section: SNMP Information Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tcpmib.RetransSegs - Count the retransmission of a TCP segment
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tcpmib.RetransSegs
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>sk</I>
-<DL COMPACT><DT><DD>
-pointer to the struct sock being acted on
-</DL>
-
-<P>
-
-<I>op</I>
-<DL COMPACT><DT><DD>
-value to be added to the counter (default value of 1)
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-The packet pointed to by
-<I>skb</I>
-is filtered by the function
-<B>tcpmib_filter_key</B>. If the packet passes the filter is is counted in the global
-<I>RetransSegs</I>
-(equivalent to SNMP's MIB TCP_MIB_RETRANSSEGS)
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TTY\&.INIT</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TTY\&.INIT</H1>
-Section: TTY Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tty.init - Called when a tty is being initalized
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tty.init
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>driver_name</I>
-<DL COMPACT><DT><DD>
-the driver name
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-the driver .dev_name name
-</DL>
-
-<P>
-
-<I>module</I>
-<DL COMPACT><DT><DD>
-the module name
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TTY\&.IOCTL</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TTY\&.IOCTL</H1>
-Section: TTY Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tty.ioctl - called when a ioctl is request to the tty
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tty.ioctl
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>cmd</I>
-<DL COMPACT><DT><DD>
-the ioctl command
-</DL>
-
-<P>
-
-<I>arg</I>
-<DL COMPACT><DT><DD>
-the ioctl argument
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-the file name
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TTY\&.OPEN</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TTY\&.OPEN</H1>
-Section: TTY Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tty.open - Called when a tty is opened
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tty.open
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>inode_state</I>
-<DL COMPACT><DT><DD>
-the inode state
-</DL>
-
-<P>
-
-<I>file_name</I>
-<DL COMPACT><DT><DD>
-the file name
-</DL>
-
-<P>
-
-<I>file_mode</I>
-<DL COMPACT><DT><DD>
-the file mode
-</DL>
-
-<P>
-
-<I>file_flags</I>
-<DL COMPACT><DT><DD>
-the file flags
-</DL>
-
-<P>
-
-<I>inode_number</I>
-<DL COMPACT><DT><DD>
-the inode number
-</DL>
-
-<P>
-
-<I>inode_flags</I>
-<DL COMPACT><DT><DD>
-the inode flags
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TTY\&.POLL</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TTY\&.POLL</H1>
-Section: TTY Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tty.poll - Called when a tty device is being polled
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tty.poll
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>file_name</I>
-<DL COMPACT><DT><DD>
-the tty file name
-</DL>
-
-<P>
-
-<I>wait_key</I>
-<DL COMPACT><DT><DD>
-the wait queue key
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TTY\&.READ</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TTY\&.READ</H1>
-Section: TTY Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tty.read - called when a tty line will be read
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tty.read
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>driver_name</I>
-<DL COMPACT><DT><DD>
-the driver name
-</DL>
-
-<P>
-
-<I>buffer</I>
-<DL COMPACT><DT><DD>
-the buffer that will receive the characters
-</DL>
-
-<P>
-
-<I>file_name</I>
-<DL COMPACT><DT><DD>
-the file name lreated to the tty
-</DL>
-
-<P>
-
-<I>nr</I>
-<DL COMPACT><DT><DD>
-The amount of characters to be read
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TTY\&.RECEIVE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TTY\&.RECEIVE</H1>
-Section: TTY Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tty.receive - called when a tty receives a message
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tty.receive
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>driver_name</I>
-<DL COMPACT><DT><DD>
-the driver name
-</DL>
-
-<P>
-
-<I>count</I>
-<DL COMPACT><DT><DD>
-The amount of characters received
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-the name of the module file
-</DL>
-
-<P>
-
-<I>fp</I>
-<DL COMPACT><DT><DD>
-The flag buffer
-</DL>
-
-<P>
-
-<I>cp</I>
-<DL COMPACT><DT><DD>
-the buffer that was received
-</DL>
-
-<P>
-
-<I>index</I>
-<DL COMPACT><DT><DD>
-The tty Index
-</DL>
-
-<P>
-
-<I>id</I>
-<DL COMPACT><DT><DD>
-the tty id
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TTY\&.REGISTE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TTY\&.REGISTE</H1>
-Section: TTY Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tty.register - Called when a tty device is registred
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tty.register
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>driver_name</I>
-<DL COMPACT><DT><DD>
-the driver name
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-the driver .dev_name name
-</DL>
-
-<P>
-
-<I>index</I>
-<DL COMPACT><DT><DD>
-the tty index requested
-</DL>
-
-<P>
-
-<I>module</I>
-<DL COMPACT><DT><DD>
-the module name
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TTY\&.RELEASE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TTY\&.RELEASE</H1>
-Section: TTY Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tty.release - Called when the tty is closed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tty.release
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>inode_state</I>
-<DL COMPACT><DT><DD>
-the inode state
-</DL>
-
-<P>
-
-<I>file_name</I>
-<DL COMPACT><DT><DD>
-the file name
-</DL>
-
-<P>
-
-<I>file_mode</I>
-<DL COMPACT><DT><DD>
-the file mode
-</DL>
-
-<P>
-
-<I>file_flags</I>
-<DL COMPACT><DT><DD>
-the file flags
-</DL>
-
-<P>
-
-<I>inode_number</I>
-<DL COMPACT><DT><DD>
-the inode number
-</DL>
-
-<P>
-
-<I>inode_flags</I>
-<DL COMPACT><DT><DD>
-the inode flags
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TTY\&.RESIZE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TTY\&.RESIZE</H1>
-Section: TTY Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tty.resize - Called when a terminal resize happens
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tty.resize
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>new_ypixel</I>
-<DL COMPACT><DT><DD>
-the new ypixel value
-</DL>
-
-<P>
-
-<I>old_col</I>
-<DL COMPACT><DT><DD>
-the old col value
-</DL>
-
-<P>
-
-<I>old_xpixel</I>
-<DL COMPACT><DT><DD>
-the old xpixel
-</DL>
-
-<P>
-
-<I>old_ypixel</I>
-<DL COMPACT><DT><DD>
-the old ypixel
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-the tty name
-</DL>
-
-<P>
-
-<I>old_row</I>
-<DL COMPACT><DT><DD>
-the old row value
-</DL>
-
-<P>
-
-<I>new_xpixel</I>
-<DL COMPACT><DT><DD>
-the new xpixel value
-</DL>
-
-<P>
-
-<I>new_row</I>
-<DL COMPACT><DT><DD>
-the new row value
-</DL>
-
-<P>
-
-<I>new_col</I>
-<DL COMPACT><DT><DD>
-the new col value
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TTY\&.UNREGIS</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TTY\&.UNREGIS</H1>
-Section: TTY Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tty.unregister - Called when a tty device is being unregistered
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tty.unregister
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>driver_name</I>
-<DL COMPACT><DT><DD>
-the driver name
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-the driver .dev_name name
-</DL>
-
-<P>
-
-<I>index</I>
-<DL COMPACT><DT><DD>
-the tty index requested
-</DL>
-
-<P>
-
-<I>module</I>
-<DL COMPACT><DT><DD>
-the module name
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::TTY\&.WRITE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::TTY\&.WRITE</H1>
-Section: TTY Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::tty.write - write to the tty line
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-tty.write
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>driver_name</I>
-<DL COMPACT><DT><DD>
-the driver name
-</DL>
-
-<P>
-
-<I>buffer</I>
-<DL COMPACT><DT><DD>
-the buffer that will be written
-</DL>
-
-<P>
-
-<I>file_name</I>
-<DL COMPACT><DT><DD>
-the file name lreated to the tty
-</DL>
-
-<P>
-
-<I>nr</I>
-<DL COMPACT><DT><DD>
-The amount of characters
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::UDP\&.DISCONN</TITLE>
-</HEAD><BODY>
-<H1>PROBE::UDP\&.DISCONN</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::udp.disconnect - Fires when a process requests for a UDP disconnection
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-udp.disconnect
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>flags</I>
-<DL COMPACT><DT><DD>
-Flags (e.g. FIN, etc)
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-The name of this probe
-</DL>
-
-<P>
-
-<I>dport</I>
-<DL COMPACT><DT><DD>
-UDP destination port
-</DL>
-
-<P>
-
-<I>saddr</I>
-<DL COMPACT><DT><DD>
-A string representing the source IP address
-</DL>
-
-<P>
-
-<I>daddr</I>
-<DL COMPACT><DT><DD>
-A string representing the destination IP address
-</DL>
-
-<P>
-
-<I>sport</I>
-<DL COMPACT><DT><DD>
-UDP source port
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-IP address family
-</DL>
-
-<P>
-
-<I>sock</I>
-<DL COMPACT><DT><DD>
-Network socket used by the process
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process which requests a UDP disconnection
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::UDP\&.DISCONN</TITLE>
-</HEAD><BODY>
-<H1>PROBE::UDP\&.DISCONN</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::udp.disconnect.return - UDP has been disconnected successfully
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-udp.disconnect.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>ret</I>
-<DL COMPACT><DT><DD>
-Error code (0: no error)
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-The name of this probe
-</DL>
-
-<P>
-
-<I>dport</I>
-<DL COMPACT><DT><DD>
-UDP destination port
-</DL>
-
-<P>
-
-<I>saddr</I>
-<DL COMPACT><DT><DD>
-A string representing the source IP address
-</DL>
-
-<P>
-
-<I>daddr</I>
-<DL COMPACT><DT><DD>
-A string representing the destination IP address
-</DL>
-
-<P>
-
-<I>sport</I>
-<DL COMPACT><DT><DD>
-UDP source port
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-IP address family
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process which requested a UDP disconnection
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::UDP\&.RECVMSG</TITLE>
-</HEAD><BODY>
-<H1>PROBE::UDP\&.RECVMSG</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::udp.recvmsg - Fires whenever a UDP message is received
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-udp.recvmsg
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-The name of this probe
-</DL>
-
-<P>
-
-<I>dport</I>
-<DL COMPACT><DT><DD>
-UDP destination port
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Number of bytes received by the process
-</DL>
-
-<P>
-
-<I>saddr</I>
-<DL COMPACT><DT><DD>
-A string representing the source IP address
-</DL>
-
-<P>
-
-<I>daddr</I>
-<DL COMPACT><DT><DD>
-A string representing the destination IP address
-</DL>
-
-<P>
-
-<I>sport</I>
-<DL COMPACT><DT><DD>
-UDP source port
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-IP address family
-</DL>
-
-<P>
-
-<I>sock</I>
-<DL COMPACT><DT><DD>
-Network socket used by the process
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process which received a UDP message
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::UDP\&.RECVMSG</TITLE>
-</HEAD><BODY>
-<H1>PROBE::UDP\&.RECVMSG</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::udp.recvmsg.return - Fires whenever an attempt to receive a UDP message received is completed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-udp.recvmsg.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-The name of this probe
-</DL>
-
-<P>
-
-<I>dport</I>
-<DL COMPACT><DT><DD>
-UDP destination port
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Number of bytes received by the process
-</DL>
-
-<P>
-
-<I>saddr</I>
-<DL COMPACT><DT><DD>
-A string representing the source IP address
-</DL>
-
-<P>
-
-<I>daddr</I>
-<DL COMPACT><DT><DD>
-A string representing the destination IP address
-</DL>
-
-<P>
-
-<I>sport</I>
-<DL COMPACT><DT><DD>
-UDP source port
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-IP address family
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process which received a UDP message
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::UDP\&.SENDMSG</TITLE>
-</HEAD><BODY>
-<H1>PROBE::UDP\&.SENDMSG</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::udp.sendmsg - Fires whenever a process sends a UDP message
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-udp.sendmsg
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-The name of this probe
-</DL>
-
-<P>
-
-<I>dport</I>
-<DL COMPACT><DT><DD>
-UDP destination port
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Number of bytes sent by the process
-</DL>
-
-<P>
-
-<I>saddr</I>
-<DL COMPACT><DT><DD>
-A string representing the source IP address
-</DL>
-
-<P>
-
-<I>daddr</I>
-<DL COMPACT><DT><DD>
-A string representing the destination IP address
-</DL>
-
-<P>
-
-<I>sport</I>
-<DL COMPACT><DT><DD>
-UDP source port
-</DL>
-
-<P>
-
-<I>sock</I>
-<DL COMPACT><DT><DD>
-Network socket used by the process
-</DL>
-
-<P>
-
-<I>family</I>
-<DL COMPACT><DT><DD>
-IP address family
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process which sent a UDP message
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::UDP\&.SENDMSG</TITLE>
-</HEAD><BODY>
-<H1>PROBE::UDP\&.SENDMSG</H1>
-Section: Networking Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::udp.sendmsg.return - Fires whenever an attempt to send a UDP message is completed
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-udp.sendmsg.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-The name of this probe
-</DL>
-
-<P>
-
-<I>size</I>
-<DL COMPACT><DT><DD>
-Number of bytes sent by the process
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process which sent a UDP message
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::VM\&.BRK</TITLE>
-</HEAD><BODY>
-<H1>PROBE::VM\&.BRK</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::vm.brk - Fires when a brk is requested (i.e. the heap will be resized)
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-vm.brk
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-the length of the memory segment
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>address</I>
-<DL COMPACT><DT><DD>
-the requested address
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process calling brk.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::VM\&.KFREE</TITLE>
-</HEAD><BODY>
-<H1>PROBE::VM\&.KFREE</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::vm.kfree - Fires when kfree is requested
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-vm.kfree
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>ptr</I>
-<DL COMPACT><DT><DD>
-pointer to the kmemory allocated which is returned by kmalloc
-</DL>
-
-<P>
-
-<I>caller_function</I>
-<DL COMPACT><DT><DD>
-name of the caller function.
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>call_site</I>
-<DL COMPACT><DT><DD>
-address of the function calling this kmemory function
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::VM\&.KMALLOC</TITLE>
-</HEAD><BODY>
-<H1>PROBE::VM\&.KMALLOC</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::vm.kmalloc - Fires when kmalloc is requested
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-vm.kmalloc
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>ptr</I>
-<DL COMPACT><DT><DD>
-pointer to the kmemory allocated
-</DL>
-
-<P>
-
-<I>caller_function</I>
-<DL COMPACT><DT><DD>
-name of the caller function
-</DL>
-
-<P>
-
-<I>gfp_flag_name</I>
-<DL COMPACT><DT><DD>
-type of kmemory to allocate (in String format)
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>gfp_flags</I>
-<DL COMPACT><DT><DD>
-type of kmemory to allocate
-</DL>
-
-<P>
-
-<I>call_site</I>
-<DL COMPACT><DT><DD>
-address of the kmemory function
-</DL>
-
-<P>
-
-<I>bytes_req</I>
-<DL COMPACT><DT><DD>
-requested Bytes
-</DL>
-
-<P>
-
-<I>bytes_alloc</I>
-<DL COMPACT><DT><DD>
-allocated Bytes
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::VM\&.KMALLOC_</TITLE>
-</HEAD><BODY>
-<H1>PROBE::VM\&.KMALLOC_</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::vm.kmalloc_node - Fires when kmalloc_node is requested
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-vm.kmalloc_node
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>ptr</I>
-<DL COMPACT><DT><DD>
-pointer to the kmemory allocated
-</DL>
-
-<P>
-
-<I>caller_function</I>
-<DL COMPACT><DT><DD>
-name of the caller function
-</DL>
-
-<P>
-
-<I>gfp_flag_name</I>
-<DL COMPACT><DT><DD>
-type of kmemory to allocate(in string format)
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>gfp_flags</I>
-<DL COMPACT><DT><DD>
-type of kmemory to allocate
-</DL>
-
-<P>
-
-<I>call_site</I>
-<DL COMPACT><DT><DD>
-address of the function caling this kmemory function
-</DL>
-
-<P>
-
-<I>bytes_req</I>
-<DL COMPACT><DT><DD>
-requested Bytes
-</DL>
-
-<P>
-
-<I>bytes_alloc</I>
-<DL COMPACT><DT><DD>
-allocated Bytes
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::VM\&.KMEM_CAC</TITLE>
-</HEAD><BODY>
-<H1>PROBE::VM\&.KMEM_CAC</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::vm.kmem_cache_alloc - Fires when kmem_cache_alloc is requested
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-vm.kmem_cache_alloc
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>ptr</I>
-<DL COMPACT><DT><DD>
-pointer to the kmemory allocated
-</DL>
-
-<P>
-
-<I>caller_function</I>
-<DL COMPACT><DT><DD>
-name of the caller function.
-</DL>
-
-<P>
-
-<I>gfp_flag_name</I>
-<DL COMPACT><DT><DD>
-type of kmemory to allocate(in string format)
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>gfp_flags</I>
-<DL COMPACT><DT><DD>
-type of kmemory to allocate
-</DL>
-
-<P>
-
-<I>call_site</I>
-<DL COMPACT><DT><DD>
-address of the function calling this kmemory function.
-</DL>
-
-<P>
-
-<I>bytes_req</I>
-<DL COMPACT><DT><DD>
-requested Bytes
-</DL>
-
-<P>
-
-<I>bytes_alloc</I>
-<DL COMPACT><DT><DD>
-allocated Bytes
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::VM\&.KMEM_CAC</TITLE>
-</HEAD><BODY>
-<H1>PROBE::VM\&.KMEM_CAC</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::vm.kmem_cache_alloc_node - Fires when kmem_cache_alloc_node is requested
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-vm.kmem_cache_alloc_node
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>ptr</I>
-<DL COMPACT><DT><DD>
-pointer to the kmemory allocated
-</DL>
-
-<P>
-
-<I>caller_function</I>
-<DL COMPACT><DT><DD>
-name of the caller function
-</DL>
-
-<P>
-
-<I>gfp_flag_name</I>
-<DL COMPACT><DT><DD>
-type of kmemory to allocate(in string format)
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>gfp_flags</I>
-<DL COMPACT><DT><DD>
-type of kmemory to allocate
-</DL>
-
-<P>
-
-<I>call_site</I>
-<DL COMPACT><DT><DD>
-address of the function calling this kmemory function
-</DL>
-
-<P>
-
-<I>bytes_req</I>
-<DL COMPACT><DT><DD>
-requested Bytes
-</DL>
-
-<P>
-
-<I>bytes_alloc</I>
-<DL COMPACT><DT><DD>
-allocated Bytes
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::VM\&.KMEM_CAC</TITLE>
-</HEAD><BODY>
-<H1>PROBE::VM\&.KMEM_CAC</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::vm.kmem_cache_free - Fires when kmem_cache_free is requested
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-vm.kmem_cache_free
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>ptr</I>
-<DL COMPACT><DT><DD>
-Pointer to the kmemory allocated which is returned by kmem_cache
-</DL>
-
-<P>
-
-<I>caller_function</I>
-<DL COMPACT><DT><DD>
-Name of the caller function.
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>call_site</I>
-<DL COMPACT><DT><DD>
-Address of the function calling this kmemory function
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::VM\&.MMAP</TITLE>
-</HEAD><BODY>
-<H1>PROBE::VM\&.MMAP</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::vm.mmap - Fires when an mmap is requested
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-vm.mmap
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-the length of the memory segment
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>address</I>
-<DL COMPACT><DT><DD>
-the requested address
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process calling mmap.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::VM\&.MUNMAP</TITLE>
-</HEAD><BODY>
-<H1>PROBE::VM\&.MUNMAP</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::vm.munmap - Fires when an munmap is requested
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-vm.munmap
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>length</I>
-<DL COMPACT><DT><DD>
-the length of the memory segment
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>address</I>
-<DL COMPACT><DT><DD>
-the requested address
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process calling munmap.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::VM\&.OOM_KILL</TITLE>
-</HEAD><BODY>
-<H1>PROBE::VM\&.OOM_KILL</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::vm.oom_kill - Fires when a thread is selected for termination by the OOM killer
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-vm.oom_kill
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>task</I>
-<DL COMPACT><DT><DD>
-the task being killed
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process that tried to consume excessive memory, and thus triggered the OOM.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::VM\&.PAGEFAUL</TITLE>
-</HEAD><BODY>
-<H1>PROBE::VM\&.PAGEFAUL</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::vm.pagefault - Records that a page fault occurred
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-vm.pagefault
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>write_access</I>
-<DL COMPACT><DT><DD>
-indicates whether this was a write or read access; 1 indicates a write, while 0 indicates a read
-</DL>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>address</I>
-<DL COMPACT><DT><DD>
-the address of the faulting memory access; i.e. the address that caused the page fault
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process which triggered the fault
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::VM\&.PAGEFAUL</TITLE>
-</HEAD><BODY>
-<H1>PROBE::VM\&.PAGEFAUL</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::vm.pagefault.return - Indicates what type of fault occurred
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-vm.pagefault.return
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>fault_type</I>
-<DL COMPACT><DT><DD>
-returns either 0 (VM_FAULT_OOM) for out of memory faults, 2 (VM_FAULT_MINOR) for minor faults, 3 (VM_FAULT_MAJOR) for major faults, or 1 (VM_FAULT_SIGBUS) if the fault was neither OOM, minor fault, nor major fault.
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::VM\&.WRITE_SH</TITLE>
-</HEAD><BODY>
-<H1>PROBE::VM\&.WRITE_SH</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::vm.write_shared - Attempts at writing to a shared page
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-vm.write_shared
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-name of the probe point
-</DL>
-
-<P>
-
-<I>address</I>
-<DL COMPACT><DT><DD>
-the address of the shared write
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The context is the process attempting the write.
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires when a process attempts to write to a shared page. If a copy is necessary, this will be followed by a vm.write_shared_copy.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::VM\&.WRITE_SH</TITLE>
-</HEAD><BODY>
-<H1>PROBE::VM\&.WRITE_SH</H1>
-Section: Memory Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::vm.write_shared_copy - Page copy for shared page write
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-vm.write_shared_copy
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>name</I>
-<DL COMPACT><DT><DD>
-Name of the probe point
-</DL>
-
-<P>
-
-<I>zero</I>
-<DL COMPACT><DT><DD>
-boolean indicating whether it is a zero page (can do a clear instead of a copy)
-</DL>
-
-<P>
-
-<I>address</I>
-<DL COMPACT><DT><DD>
-The address of the shared write
-</DL>
-
-<A NAME="lbAE"> </A>
-<H2>CONTEXT</H2>
-
-<P>
-
-The process attempting the write.
-<A NAME="lbAF"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-
-Fires when a write to a shared page requires a page copy. This is always preceded by a vm.write_shared.
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-<DT><A HREF="#lbAE">CONTEXT</A><DD>
-<DT><A HREF="#lbAF">DESCRIPTION</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::WORKQUEUE\&.C</TITLE>
-</HEAD><BODY>
-<H1>PROBE::WORKQUEUE\&.C</H1>
-Section: Interrupt Request (IRQ) Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::workqueue.create - Creating a new workqueue
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-workqueue.create
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>wq_thread</I>
-<DL COMPACT><DT><DD>
-task_struct of the workqueue thread
-</DL>
-
-<P>
-
-<I>cpu</I>
-<DL COMPACT><DT><DD>
-cpu for which the worker thread is created
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::WORKQUEUE\&.D</TITLE>
-</HEAD><BODY>
-<H1>PROBE::WORKQUEUE\&.D</H1>
-Section: Interrupt Request (IRQ) Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::workqueue.destroy - Destroying workqueue
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-workqueue.destroy
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>wq_thread</I>
-<DL COMPACT><DT><DD>
-task_struct of the workqueue thread
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::WORKQUEUE\&.E</TITLE>
-</HEAD><BODY>
-<H1>PROBE::WORKQUEUE\&.E</H1>
-Section: Interrupt Request (IRQ) Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::workqueue.execute - Executing deferred work
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-workqueue.execute
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>wq_thread</I>
-<DL COMPACT><DT><DD>
-task_struct of the workqueue thread
-</DL>
-
-<P>
-
-<I>work_func</I>
-<DL COMPACT><DT><DD>
-pointer to handler function
-</DL>
-
-<P>
-
-<I>work</I>
-<DL COMPACT><DT><DD>
-work_struct* being executed
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of PROBE::WORKQUEUE\&.I</TITLE>
-</HEAD><BODY>
-<H1>PROBE::WORKQUEUE\&.I</H1>
-Section: Interrupt Request (IRQ) Tapset (3stap)<BR>Updated: March 2014<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-probe::workqueue.insert - Queuing work on a workqueue
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<PRE>
-workqueue.insert
-</PRE>
-
-<A NAME="lbAD"> </A>
-<H2>VALUES</H2>
-
-<P>
-
-<I>wq_thread</I>
-<DL COMPACT><DT><DD>
-task_struct of the workqueue thread
-</DL>
-
-<P>
-
-<I>work_func</I>
-<DL COMPACT><DT><DD>
-pointer to handler function
-</DL>
-
-<P>
-
-<I>work</I>
-<DL COMPACT><DT><DD>
-work_struct* being queued
-</DL>
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">VALUES</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of STAP-MERGE</TITLE>
-</HEAD><BODY>
-<H1>STAP-MERGE</H1>
-Section: User Commands (1)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-stap-merge - systemtap per-cpu binary merger
-<P>
-
-
-
-
-<P>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<BR>
-
-<B>stap-merge</B>
-
-[
-<I>OPTIONS</I>
-
-]
-[
-<I>INPUT FILENAMES</I>
-
-]
-<P>
-<A NAME="lbAD"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-The stap-merge executable applies when the -b option has been used
-while running a
-<I>stap</I>
-
-script. The -b option will generate files
-per-cpu, based on the timestamp field. Then stap-merge will
-merge and sort through the per-cpu files based on the timestamp
-field.
-<P>
-<A NAME="lbAE"> </A>
-<H2>OPTIONS</H2>
-
-<P>
-The systemtap merge executable supports the following options.
-<DL COMPACT>
-<DT><B>-v</B>
-
-<DD>
-Verbose mode, displays three extra fields per set of collected data.
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>[cpu</B>number,<B>sequence</B>number<B>of</B>data,<B>the</B>length<B>of</B>the<B>data</B>set]
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<DT><B>-o</B><I> OUTPUT_FILENAME</I>
-
-<DD>
-<P>
-Specify the name of the file you would like the output to be
-redirected into. If this option is not specified than the
-output will be pushed to standard out.
-<P>
-</DL>
-<A NAME="lbAF"> </A>
-<H2>EXAMPLES</H2>
-
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-$ stap -v -b -e 'probe syscall.open { printf("%s(%d) open\n",
-execname(), pid()) }'
-
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-This should result in several
-<I>stpd_cpu</I>
-
-files (each labled with a number
-representing which cpu the file was produced from).
-<P>
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-$ stap-merge -v stpd_cpu0 stpd_cpu1
-
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-Running the stap-merge program in the same directory as the stap
-script earlier in the example, will produce an ordered sequence of
-packets with the three part label for each set of data. This
-result will be pushed through the standard output. An output file
-could have been specified using the "-o" option.
-<P>
-<A NAME="lbAG"> </A>
-<H2>FILES</H2>
-
-<P>
-<DL COMPACT>
-<DT>Important files and their corresponding paths can be located in the <DD>
-stappaths (7) manual page.
-<P>
-</DL>
-<A NAME="lbAH"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap),
-<I><A HREF="stappaths.7.html">stappaths</A></I>(7),
-<I><A HREF="staprun.8.html">staprun</A></I>(8),
-<I><A HREF="stapvars.3stap.html">stapvars</A></I>(3stap),
-<I><A HREF="stapex.3stap.html">stapex</A></I>(3stap),
-<I><A HREF="stap-server.8.html">stap-server</A></I>(8),
-<I><A HREF="gdb.1.html">gdb</A></I>(1)
-
-</PRE><A NAME="lbAI"> </A>
-<H2>BUGS</H2>
-
-Use the Bugzilla link of the project web page or our mailing list.
-
-<B><A HREF="http://sourceware.org/systemtap/">http://sourceware.org/systemtap/</A></B>,<B><<A HREF="mailto:systemtap@sourceware.org">systemtap@sourceware.org</A>></B>.
-
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAE">OPTIONS</A><DD>
-<DT><A HREF="#lbAF">EXAMPLES</A><DD>
-<DT><A HREF="#lbAG">FILES</A><DD>
-<DT><A HREF="#lbAH">SEE ALSO</A><DD>
-<DT><A HREF="#lbAI">BUGS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of STAP-PREP</TITLE>
-</HEAD><BODY>
-<H1>STAP-PREP</H1>
-Section: User Commands (1)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-stap-prep - prepare system for systemtap use
-<P>
-
-
-
-
-<P>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<BR>
-
-<B>stap-prep</B>
-
-[
-<I>KERNEL_VERSION</I>
-
-]
-<P>
-<A NAME="lbAD"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-The stap-prep executable prepares the system for systemtap use by
-installing kernel headers, debug symbols and build tools that match
-the currently running kernel or optionally the kernel version given by
-the user.
-<P>
-The exact behavior of stap-prep may be customized by the
-distribution maintainers. It might for example only give suggestions
-and not actually install the required packages if that is difficult to
-automate.
-<P>
-<A NAME="lbAE"> </A>
-<H2>EXAMPLES</H2>
-
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-$ stap-prep
-Please install linux-image-3.2.0-2-amd64-dbg
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<A NAME="lbAF"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1)
-
-</PRE><A NAME="lbAG"> </A>
-<H2>BUGS</H2>
-
-Use the Bugzilla link of the project web page or our mailing list.
-
-<B><A HREF="http://sourceware.org/systemtap/">http://sourceware.org/systemtap/</A></B>,<B><<A HREF="mailto:systemtap@sourceware.org">systemtap@sourceware.org</A>></B>.
-
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAE">EXAMPLES</A><DD>
-<DT><A HREF="#lbAF">SEE ALSO</A><DD>
-<DT><A HREF="#lbAG">BUGS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of STAP-REPORT</TITLE>
-</HEAD><BODY>
-<H1>STAP-REPORT</H1>
-Section: User Commands (1)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-stap-report - collect system information that is useful for debugging systemtap bugs
-<P>
-
-
-
-
-<P>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<BR>
-
-<B>stap-report</B>
-
-<P>
-<A NAME="lbAD"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-The stap-report executable collects system information that is useful
-for debugging systemtap bugs. It is a good idea to include such a
-report in bug reports especially if you send them directly to the
-upstream. stap-report can be run either as a normal user or as
-root. The report will be more complete if stap-report is run as root.
-<P>
-<A NAME="lbAE"> </A>
-<H2>EXAMPLES</H2>
-
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-$ stap-report > report.txt
-$ head report.txt
-== id ==
-uid=1000(user) gid=1000(user) groups=122(stapdev),123(stapusr),129(stapsys)
-== stap -V ==
-Systemtap translator/driver (version 2.2.1/0.153, Debian version 2.2.1-1)
-Copyright (C) 2005-2013 Red Hat, Inc. and others
-This is free software; see the source for copying conditions.
-enabled features: AVAHI LIBSQLITE3 NSS TR1_UNORDERED_MAP NLS
-== which stap ==
-/usr/bin/stap
-== locate --regex '/stap(run)?$' | xargs ls -ald ==
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<A NAME="lbAF"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1)
-
-</PRE><A NAME="lbAG"> </A>
-<H2>BUGS</H2>
-
-Use the Bugzilla link of the project web page or our mailing list.
-
-<B><A HREF="http://sourceware.org/systemtap/">http://sourceware.org/systemtap/</A></B>,<B><<A HREF="mailto:systemtap@sourceware.org">systemtap@sourceware.org</A>></B>.
-
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAE">EXAMPLES</A><DD>
-<DT><A HREF="#lbAF">SEE ALSO</A><DD>
-<DT><A HREF="#lbAG">BUGS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of STAP-SERVER</TITLE>
-</HEAD><BODY>
-<H1>STAP-SERVER</H1>
-Section: Maintenance Commands (8)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-stap-server - systemtap compile server management
-<P>
-
-
-
-<P>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<BR>
-
-[
-<B>service</B>
-
-]
-<B>stap-server</B>
-
-{
-<B>start</B>
-
-|
-<B>stop</B>
-
-|
-<B>restart</B>
-
-|
-<B>condrestart</B>
-
-|
-<B>try-restart</B>
-
-|
-<B>force-reload</B>
-
-|
-<B>status</B>
-
-} [
-<I>options</I>
-
-]
-<P>
-<A NAME="lbAD"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-A systemtap compile server listens for connections from stap clients
-on a secure SSL network port and accepts requests to run the
-<I>stap</I>
-
-front end. Each server advertises its presence and configuration on the local
-network using mDNS (<I>avahi</I>) allowing for automatic detection by clients.
-<P>
-<P>
-
-The stap-server script aims to provide:
-<DL COMPACT>
-<DT>•<DD>
-management of systemtap compile servers as a service.
-<DT>•<DD>
-convenient control over configured servers and individual (ad-hoc) servers.
-<P>
-</DL>
-<A NAME="lbAE"> </A>
-<H2>ARGUMENTS</H2>
-
-One of the actions below must be specified:
-<DL COMPACT>
-<DT><B>start</B>
-
-<DD>
-Start servers. The specified servers are started.
-If no server is specified, the configured servers are started. If no servers
-are configured, a server for the kernel release and architecture of the host
-is started.
-If a specified server is
-already started, this action will
-be ignored for that server. If a server fails to start, this action fails.
-<P>
-<DT><B>stop</B>
-
-<DD>
-Stop server(s). The specified servers are stopped.
-If no server is specified, all currently running servers are stopped.
-If a specified server is
-not running, this action
-will be successful for that server. If a server fails to stop, this action
-fails.
-<P>
-<DT><B>restart</B>
-
-<DD>
-Stop and restart servers. The specified servers are stopped and restarted.
-If no server is specified, all currently running servers are stopped and
-restarted. If no servers are running, this action behaves like <I>start</I>.
-<P>
-<DT><B>condrestart</B>
-
-<DD>
-Stop and restart servers. The specified servers are stopped and restarted.
-If a specified server is not running, it is not started. If no server is
-specified, all currently running servers are stopped and restarted. If no
-servers are running, none will be started.
-<P>
-<DT><B>try-restart</B>
-
-<DD>
-This action is identical to <I>condrestart</I>.
-<P>
-<DT><B>force-reload</B>
-
-<DD>
-Stop all running servers, reload config files and restart the service as if
-<I>start</I>
-
-was specified.
-<P>
-<DT><B>status</B>
-
-<DD>
-Print information about running servers. Information about the specified
-server(s) will be printed. If no server is specified, information about all
-running servers will be printed.
-<P>
-</DL>
-<A NAME="lbAF"> </A>
-<H2>OPTIONS</H2>
-
-The following options are used to provide additional configuration and
-to specify servers to be managed:
-<P>
-<DL COMPACT>
-<DT><B>-c</B> <I>configfile</I><DD>
-This option specifies a global configuration file in addition to the default
-global configuration file described
-below. This file will be processed after the default global
-configuration file. If the <B>-c</B> option is specified more than once, the
-last
-configuration file specified will be used.
-<P>
-<DT><B>-a</B> <I>architecture</I><DD>
-This option specifies the target architecture of the server and is
-analogous to the <B>-a</B> option of <I>stap</I>. See the
-<I><A HREF="stap.1.html">stap</A></I>(1)
-
-manual page for more details.
-The default architecture is the architecture of the host.
-<P>
-<DT><B>-r</B> <I>kernel-release</I><DD>
-This option specifies the target kernel release of the server and is
-analogous to the <B>-r</B> option of <I>stap</I>. See the
-<I><A HREF="stap.1.html">stap</A></I>(1)
-
-manual page for more details.
-The default release is that of the currently running kernel.
-<P>
-<DT><B>-I</B> <I>path</I><DD>
-This option specifies an additional path to be searched by the server(s) for
-tapsets and is analogous to the <B>-I</B> option of <I>stap</I>.
-See the
-<I><A HREF="stap.1.html">stap</A></I>(1)
-
-manual page for more details.
-<P>
-<DT><B>-R</B> <I>path</I><DD>
-This option specifies the location of the systemtap runtime to be used by the
-server(s) and is analogous to the <B>-R</B> option of <I>stap</I>.
-See the
-<I><A HREF="stap.1.html">stap</A></I>(1)
-
-manual page for more details.
-<P>
-<DT><B>-B</B> <I>options</I><DD>
-This option specifies options to be passed to <I>make</I> when building systemtap
-modules and is analogous to the <B>-B</B> option of <I>stap</I>.
-See the
-<I><A HREF="stap.1.html">stap</A></I>(1)
-
-manual page for more details.
-<P>
-<DT><B>-i</B><DD>
-This option is a shortcut which specifies one server for each kernel
-release installed in <I>/lib/modules/</I>. Previous
-<B>-I</B>, <B>-R</B>, <B>-B</B> and <B>-u</B> options will be
-applied to each server, however previous <B>-a</B> options will be ignored and
-the default architecture will be used.
-<P>
-<DT><B>-n</B> <I>nickname</I><DD>
-This option allows the specification of a server configuration by nickname.
-When <B>-n</B> is specified, a currently running server with the given nickname
-will be searched for. If no currently running server with the given nickname is
-found, a server configuration with the given nickname will be searched for in
-the configuration files for default servers,
-or the path configured in the global configuration file or
-the configuration file specified by the
-<B>-c</B> option. If a server configuration for the given
-nickname is found, the
-<B>-a</B>, <B>-r</B>, <B>-I</B>, <B>-R</B>, <B>-B</B> and <B>-u</B> options for
-that server will be used as if they were specified on the command line. If no
-configuration with the given nickname is found, and the action is
-<I>start</I>
-
-(or an action behaving like <I>start</I>
-(see <B>ARGUMENTS</B>), the server will be started with the given nickname.
-If no configuration with the given nickname is found, and the action is not
-<I>start</I>
-
-(or an action behaving like <I>start</I>), it is an error. If a nickname is
-not specified for a server which is being started, its nickname will be its
-process id.
-<P>
-<DT><B>-p</B> <I>pid</I><DD>
-This option allows the specification of a server configuration by process id.
-When <B>-p</B> is specified, a currently running server with the given process
-id will be searched for. If no such server is found, it is an error. If a server
-with the given procss id is found, the
-<B>-a</B>, <B>-r</B>, <B>-I</B>, <B>-R</B>, <B>-B</B> and <B>-u</B> options for
-that server will be used as if they were specified on the command line.
-<P>
-<DT><B>-u</B> <I>user-name</I><DD>
-Each systemtap compile server is normally run by the user name
-<I>stap-server</I> (for the initscript) or as the user invoking
-<I>stap-server</I>,
-unless otherwise configured (see <B>FILES</B>). This option
-specifies the user name used to run the server(s). The user name specified
-must be a member of the group <I>stap-server</I>.
-<P>
-<DT><B>--log</B> <I>logfile</I><DD>
-This option allows the specification of a separate log file for each server.
-Each --log option is added to a list which will be applied, in turn, to each
-server specified. If more servers are specified than --log options, the default
-log file (see <B>FILES</B>) will be used for subsequent servers.
-<P>
-<DT><B>--port</B> <I>port-number</I><DD>
-This option allows the specification of a specific network port for each
-server. Each --port option is added to a list which will be applied, in turn,
-to each server specified. If more servers are specified than
---port options, a randomly selected port is used for subsequent servers.
-<P>
-<DT><B>--ssl</B> <I>certificate-db-path</I><DD>
-This option allows the specification of a separate NSS certificate database
-for each server. Each --ssl option is added to a list which will be applied,
-in turn, to each server specified. If more servers are specified than --ssl
-options, the default certificate database
-(see <B>FILES</B>) for subsequent servers.
-<P>
-<DT><B>--max-threads</B> <I>threads</I><DD>
-This option allows the specification of the maximum number of worker threads
-to handle concurrent requests. If <I>threads</I> == 0, each request will be
-handled on the main thread, serially. The default is the number of available
-processor cores.
-<P>
-</DL>
-<A NAME="lbAG"> </A>
-<H2>CONFIGURATION</H2>
-
-<P>
-Configuration files allow us to:
-<DL COMPACT>
-<DT>•<DD>
-specify global configuration of logging, server configuration files, status
-files and other global parameters.
-<DT>•<DD>
-specify which servers are to be started by default.
-<P>
-</DL>
-<A NAME="lbAH"> </A>
-<H2>Global Configuration</H2>
-
-<P>
-The Global Configuration file contains
-variable assignments used to configure the overall operation of the service.
-Each line beginning with a '#' character is ignored. All other lines must be
-of the form <I>VARIABLE=VALUE</I>. This is not a shell script. The entire
-contents of the line after the = will be assigned as-is to the variable.
-<P>
-The following variables may be assigned:
-<P>
-<DL COMPACT>
-<DT><B>CONFIG_PATH</B>
-
-<DD>
-Specifies the absolute path of the directory containing the default server
-configurations.
-<P>
-<DT><B>STAT_PATH</B>
-
-<DD>
-Specifies the absolute path of the running server status directory.
-<P>
-<DT><B>LOG_FILE</B>
-
-<DD>
-Specifies the absolute path of the log file.
-<P>
-<DT><B>STAP_USER</B>
-
-<DD>
-Specifies the userid which will be used to run the server(s)
-(default: for the initscript <I>stap-server</I>, otherwise the user running
-<I>stap-server</I>).
-<P>
-</DL>
-<P>
-
-Here is an example of a Global Configuration file:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-CONFIG_PATH=~<user>/my-stap-server-configs
-LOG_FILE=/tmp/stap-server/log
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<A NAME="lbAI"> </A>
-<H2>Individual Server Configuration</H2>
-
-<P>
-Each server configuration file configures a server to be started when no
-server is specified for the <I>start</I> action, or an action behaving like the
-<I>start</I> action (see <I>ARGUMENTS</I>). Each configuration file contains
-variable assignments used to configure an individual server.
-<P>
-Each line beginning with a '#' character is ignored. All other lines must be
-of the form <I>VARIABLE=VALUE</I>. This is not a shell script. The entire
-contents of the line after the = will be assigned as-is to the variable.
-<P>
-Each configuration file must have a filename suffix of <I>.conf</I>. See
-<I><A HREF="stappaths.7.html">stappaths</A></I>(7) for the default location of these files. This default
-location can be overridden in the global configuration file using the <B>-c</B>
-option (see <I>OPTIONS</I>).
-<P>
-The following variables may be assigned:
-<DL COMPACT>
-<DT><B>ARCH</B>
-
-<DD>
-Specifies the target architecture for this server and corresponds to the
-<B>-a</B> option (see <I>OPTIONS</I>). If <B>ARCH</B> is not set, the
-architecture of the host will be used.
-<P>
-<DT><B>RELEASE</B>
-
-<DD>
-Specifies the kernel release for this server
-and corresponds to the
-<B>-r</B> option (see <I>OPTIONS</I>). If <B>RELEASE</B> is not set, the
-release
-of the kernel running on the host will be used.
-<BR>
-<DT><B>BUILD</B>
-
-<DD>
-Specifies options to be passed to the <I>make</I> process used by
-<I>systemtap</I> to build kernel modules.
-This an array variable with each element corresponding to a
-<B>-B</B> option (see <I>OPTIONS</I>). Using the form <B>BUILD=STRING</B> clears
-the array and sets the first element to <B>STRING</B>. Using the form
-<B>BUILD+=STRING</B> adds <B>STRING</B> as an additional element to the array.
-<BR>
-<DT><B>INCLUDE</B>
-
-<DD>
-Specifies a list of directories to be searched by the server for tapsets.
-This is an array variable with each element corresponding to a
-<B>-I</B> option (see <I>OPTIONS</I>). Using the form <B>INCLUDE=PATH</B> clears
-the array and sets the first element to <B>PATH</B>. Using the form
-<B>INCLUDE+=PATH</B> adds <B>PATH</B> as an additional element to the array.
-<P>
-<DT><B>RUNTIME</B>
-
-<DD>
-Specifies the directory which contains the systemtap runtime code to be used
-by this server
-and corresponds to the
-<B>-R</B> option (see <I>OPTIONS</I>).
-<P>
-<DT><B>USER</B>
-
-<DD>
-Specifies the user name to be used to run this server
-and corresponds to the
-<B>-u</B> option (see <I>OPTIONS</I>).
-<P>
-<DT><B>NICKNAME</B>
-
-<DD>
-Specifies the nickname to be used to refer to this server
-and corresponds to the
-<B>-n</B> option (see <I>OPTIONS</I>).
-<P>
-<DT><B>LOG</B>
-
-<DD>
-Specifies the location of the log file to be used by this server and corresponds to the
-<B>--log</B> option (see <I>OPTIONS</I>).
-<P>
-<DT><B>PORT</B>
-
-<DD>
-Specifies the network port to be used by this server and corresponds to the
-<B>--port</B> option (see <I>OPTIONS</I>).
-<P>
-<DT><B>SSL</B>
-
-<DD>
-Specifies the location of the NSS certificate database to be used by this server and corresponds
-to the
-<B>--ssl</B> option (see <I>OPTIONS</I>).
-<P>
-<DT><B>MAXTHREADS</B>
-
-<DD>
-Specifies the maximum number of worker threads to handle concurrent requests to be used by this server
-and corresponds to the <B>--max-threads</B> option (see <I>OPTIONS</I>).
-<P>
-</DL>
-<P>
-
-Here is an example of a server configuration file:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-ARCH=
-USER=
-RELEASE=
-NICKNAME=native
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-By keeping the ARCH, USER, and RELEASE fields blank, they will default to the
-current arch and release and use the default user.
-<P>
-A more specific example:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-ARCH=i386
-RELEASE=2.6.18-128.el5
-PORT=5001
-LOG=/path/to/log/file
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-And here is a more complicated example:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-USER=serveruser
-RELEASE=/kernels/2.6.18-92.1.18.el5/build
-INCLUDE=/mytapsets
-INCLUDE+=/yourtapsets
-BUILD='VARIABLE1=VALUE1 VARIABLE2=VALUE2'
-DEFINE=STP_MAXMEMORY=1024
-DEFINE+=DEBUG_TRANS
-RUNTIME=/myruntime
-NICKNAME=my-server
-SSL=/path/to/NSS/certificate/database
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<A NAME="lbAJ"> </A>
-<H2>SERVER AUTHENTICAION</H2>
-
-The security of the SSL network connection between the client and server
-depends on the proper
-management of server certificates.
-<P>
-<P>
-
-The trustworthiness of a given systemtap compile server can not be determined
-automatically without a trusted certificate authority issuing systemtap compile server
-certificates. This is
-not practical in everyday use and so, clients must authenticate servers
-against their own database of trusted server certificates. In this context,
-establishing a given server as trusted by a given client means adding
-that server's certificate to the
-client's database of trusted servers.
-<P>
-<P>
-
-For the <I>stap-server</I> initscript, on the local host, this is handled
-automatically.
-When the <I>systemtap-server</I> package is installed, the server's
-certificate for the default user (<I>stap-server</I>) is automatically
-generated and installed. This means that servers started by the
-<I>stap-server</I> initscript,
-with the default user, are automatically trusted by clients on the local
-host, both as an SSL peer and as a systemtap module signer.
-<P>
-
-Furthermore, when stap is invoked by an unprivileged user
-(not root, not a member of the group stapdev, but a member of the group
-stapusr and possibly the group stapsys), the options <I>--use-server</I>
-and <I>--privilege</I>
-are automatically added to the specified options.
-This means that unprivileged users
-on the local host can use a server on the local host
-in unprivileged mode with no further setup or options required. Normal users
-(those in none of the SystemTap groups) can also use compile-servers through the
-<I>--use-server</I> and <I>--privilege</I> options. But they will of course
-be unable to load the module (the <I>-p4</I> option can be used to stop short of
-loading).
-<P>
-<P>
-
-In order to use a server running on another host, that server's certificate
-must be installed on the client's host.
-See the <I>--trust-servers</I> option in the
-<I><A HREF="stap.1.html">stap</A></I>(1)
-
-manual page for more details and README.unprivileged in the systemtap sources
-for more details.
-<P>
-<A NAME="lbAK"> </A>
-<H2>EXAMPLES</H2>
-
-See the
-<I><A HREF="stapex.3stap.html">stapex</A></I>(3stap)
-
-manual page for a collection of sample <I>systemtap</I> scripts.
-<P>
-
-To start the configured servers, or the default server, if none are configured:
-<P>
-
-<B> $ [ service ] stap-server start</B>
-
-<P>
-
-To start a server for each kernel installed in /lib/modules:
-<P>
-
-<B> $ [ service ] stap-server start -i</B>
-
-<P>
-
-To obtain information about the running server(s):
-<P>
-
-<B> $ [ service ] stap-server status</B>
-
-<P>
-
-To start a server like another one, except targeting a different architecture,
-by referencing the first server's nickname:
-<P>
-
-<B> $ [ service ] stap-server start -n </B><I>NICKNAME</I><B> -a </B><I>ARCH</I>
-
-<P>
-
-To start a server for a kernel release not installed (cross-compiling)
-<P>
-
-<B> $ [ service ] stap-server start -a </B><I>ARCH</I><B> -r </B><I>/BUILDDIR</I>
-
-<P>
-
-To stop one of the servers by referencing its process id (obtained by running
-<B>stap-server status</B>):
-<P>
-
-<B> $ [ service ] stap-server stop -p </B><I>PID</I>
-
-<P>
-
-To run a script using a compile server:
-<P>
-
-<B> $ stap SCRIPT --use-server</B>
-
-<P>
-
-To run a script as an unprivileged user using a compile server:
-<P>
-
-<B> $ stap SCRIPT</B>
-
-<P>
-
-To stop all running servers:
-<P>
-
-<B> $ [ service ] stap-server stop</B>
-
-<P>
-
-To restart servers after a global configuration change and/or when default
-servers have been added, changed, or removed:
-<P>
-
-<B> $ [ service ] stap-server force-reload</B>
-
-<P>
-<A NAME="lbAL"> </A>
-<H2>SAFETY AND SECURITY</H2>
-
-Systemtap is an administrative tool. It exposes kernel internal data
-structures and potentially private user information. See the
-<I><A HREF="stap.1.html">stap</A></I>(1)
-
-manual page for additional information on safety and security.
-<P>
-<P>
-
-As a network server, stap-server should be activated with care in
-order to limit the potential effects of bugs or mischevious users.
-Consider the following prophylactic measures.
-<DL COMPACT>
-<DT>1<DD>
-Run stap-server as an unprivileged user, never as root.
-<P>
-When invoked as a
-service (i.e. <B>service stap-server</B> ...), each server is run,
-by default, as the user <I>stap-server</I>.
-When invoked directly (i.e. <B>stap-server</B> ...), each server is run,
-by default, as the invoking user. In each case, another user may be selected by
-using the <I>-u</I> option on invocation, by specifying
-<I>STAP_USER=</I>username in the global configuration file or by specifying
-<I>USER=</I>username in an individual server configuration file. The invoking
-user must have authority to run processes as another user.
-See <I>CONFIGURATION</I>.
-<P>
-The selected user must have write access to the server log file.
-The location of the server log file may
-be changed by setting <I>LOG_FILE=</I>path in the global configuration file.
-See <I>CONFIGURATION</I>.
-<P>
-The selected user must have
-read/write access to the directory containing the server status files.
-The location of the server
-status files may be changed by setting <I>STAT_PATH=</I>path in the global
-configuration file.
-See <I>CONFIGURATION</I>.
-<P>
-The selected user must have
-read/write access to the uprobes.ko build directory and its files.
-<P>
-Neither form of stap-server will run if the selected user is root.
-<P>
-<DT>2<DD>
-Run stap-server requests with resource limits that impose maximum
-cpu time, file size, memory consumption, in order to bound
-the effects of processing excessively large or bogus inputs.
-<P>
-When the user running the server is <I>stap-server</I>,
-each server request is run with limits specified in <I>~stap-server/.systemtap/rc</I>
-otherwise, no limits are imposed.
-<P>
-<DT>3<DD>
-Run stap-server with a TMPDIR environment variable that
-points to a separate and/or quota-enforced directory, in
-order to prevent filling up of important filesystems.
-<P>
-The default TMPDIR is <I>/tmp/</I>.
-<P>
-<DT>4<DD>
-Activate network firewalls to limit stap client connections
-to relatively trustworthy networks.
-<P>
-For automatic selection of servers by clients, <I>avahi</I> must be installed
-on both the server and client hosts and <I>mDNS</I> messages must be allowed through the firewall.
-<P>
-</DL>
-<P>
-
-The systemtap compile server and its related utilities use the Secure Socket Layer
-(SSL) as implemented by Network Security Services (NSS)
-for network security. NSS is also used
-for the generation and management of certificates. The related
-certificate databases must be protected in order to maintain the security of
-the system.
-Use of the utilities provided will help to ensure that the proper protection
-is maintained. The systemtap client will check for proper
-access permissions before making use of any certificate database.
-<P>
-<A NAME="lbAM"> </A>
-<H2>FILES</H2>
-
-<DL COMPACT>
-<DT>Important files and their corresponding paths can be located in the <DD>
-stappaths (7) manual page.
-<P>
-</DL>
-<A NAME="lbAN"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I><A HREF="staprun.8.html">staprun</A></I>(8),
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap),
-<I><A HREF="stappaths.7.html">stappaths</A></I>(7),
-<I><A HREF="stapex.3stap.html">stapex</A></I>(3stap),
-<I>avahi</I>,
-<I><A HREF="ulimit.1.html">ulimit</A></I>(1),
-<I>NSS</I>
-
-</PRE><A NAME="lbAO"> </A>
-<H2>BUGS</H2>
-
-Use the Bugzilla link of the project web page or our mailing list.
-
-<B><A HREF="http://sourceware.org/systemtap/">http://sourceware.org/systemtap/</A></B>, <B><<A HREF="mailto:systemtap@sourceware.org">systemtap@sourceware.org</A>></B>.
-
-
-<P>
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAE">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAF">OPTIONS</A><DD>
-<DT><A HREF="#lbAG">CONFIGURATION</A><DD>
-<DT><A HREF="#lbAH">Global Configuration</A><DD>
-<DT><A HREF="#lbAI">Individual Server Configuration</A><DD>
-<DT><A HREF="#lbAJ">SERVER AUTHENTICAION</A><DD>
-<DT><A HREF="#lbAK">EXAMPLES</A><DD>
-<DT><A HREF="#lbAL">SAFETY AND SECURITY</A><DD>
-<DT><A HREF="#lbAM">FILES</A><DD>
-<DT><A HREF="#lbAN">SEE ALSO</A><DD>
-<DT><A HREF="#lbAO">BUGS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of STAP</TITLE>
-</HEAD><BODY>
-<H1>STAP</H1>
-Section: User Commands (1)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-stap - systemtap script translator/driver
-<P>
-
-
-
-
-<P>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<BR>
-
-<B>stap</B>
-
-[
-<I>OPTIONS</I>
-
-]
-<I>FILENAME</I>
-
-[
-<I>ARGUMENTS</I>
-
-]
-<BR>
-
-<B>stap</B>
-
-[
-<I>OPTIONS</I>
-
-]
-<B>-</B>
-
-[
-<I>ARGUMENTS</I>
-
-]
-<BR>
-
-<B>stap</B>
-
-[
-<I>OPTIONS</I>
-
-]
-<B>-e</B><I> SCRIPT</I>
-
-[
-<I>ARGUMENTS</I>
-
-]
-<BR>
-
-<B>stap</B>
-
-[
-<I>OPTIONS</I>
-
-]
-<B>-l</B><I> PROBE</I>
-
-[
-<I>ARGUMENTS</I>
-
-]
-<BR>
-
-<B>stap</B>
-
-[
-<I>OPTIONS</I>
-
-]
-<B>-L</B><I> PROBE</I>
-
-[
-<I>ARGUMENTS</I>
-
-]
-<P>
-<A NAME="lbAD"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-The
-<I>stap</I>
-
-program is the front-end to the Systemtap tool. It accepts probing
-instructions (written in a simple scripting language), translates
-those instructions into C code, compiles this C code, and loads the
-resulting module into a running Linux kernel or a DynInst user-space
-mutator, to perform the requested system trace/probe functions. You
-can supply the script in a named file (FILENAME), from standard input
-(use - instead of FILENAME), or from the command line (using -e
-SCRIPT). The program runs until it is interrupted by the user, or if
-the script voluntarily invokes the
-<I>exit()</I>
-
-function, or by sufficient number of soft errors.
-<P>
-
-The language, which is described in a later section, is strictly typed,
-declaration free, procedural, and inspired by
-<I>awk</I>.
-
-It allows source code points or events in the kernel to be associated
-with handlers, which are subroutines that are executed synchronously. It is
-somewhat similar conceptually to "breakpoint command lists" in the
-<I>gdb</I>
-
-debugger.
-<P>
-<A NAME="lbAE"> </A>
-<H2>OPTIONS</H2>
-
-The systemtap translator supports the following options. Any other option
-prints a list of supported options. Options may be given on the command line,
-as usual. If the file $SYSTEMTAP_DIR/rc exist, options are also loaded from
-there and interpreted first. ($SYSTEMTAP_DIR defaults to $HOME/.systemtap if unset.)
-<DL COMPACT>
-<DT><B>-</B>
-
-<DD>
-Use standard input instead of a given FILENAME as probe language input,
-unless -e SCRIPT is given.
-<DT><B>-h --help</B>
-
-<DD>
-Show help message.
-<DT><B>-V --version</B>
-
-<DD>
-Show version message.
-<DT><B>-p</B><I> NUM</I>
-
-<DD>
-Stop after pass NUM. The passes are numbered 1-5: parse, elaborate,
-translate, compile, run. See the
-<B>PROCESSING</B>
-
-section for details.
-<DT><B>-v</B>
-
-<DD>
-Increase verbosity for all passes. Produce a larger volume of
-informative (?) output each time option repeated.
-<DT><B>--vp ABCDE</B>
-
-<DD>
-Increase verbosity on a per-pass basis. For example, "--vp 002"
-adds 2 units of verbosity to pass 3 only. The combination "-v --vp 00004"
-adds 1 unit of verbosity for all passes, and 4 more for pass 5.
-<DT><B>-k</B>
-
-<DD>
-Keep the temporary directory after all processing. This may be useful
-in order to examine the generated C code, or to reuse the compiled
-kernel object.
-<DT><B>-g</B>
-
-<DD>
-Guru mode. Enable parsing of unsafe expert-level constructs like
-embedded C.
-<DT><B>-P</B>
-
-<DD>
-Prologue-searching mode. Activate heuristics to work around incorrect
-debugging information for $context variables.
-<DT><B>-u</B>
-
-<DD>
-Unoptimized mode. Disable unused code elision during elaboration.
-<DT><B>-w</B>
-
-<DD>
-Suppressed warnings mode. Disables all warning messages.
-<DT><B>-W</B>
-
-<DD>
-Treat all warnings as errors.
-<DT><B>-b</B>
-
-<DD>
-Use bulk mode (percpu files) for kernel-to-user data transfer.
-<DT><B>-t</B>
-
-<DD>
-Collect timing information on the number of times probe executes
-and average amount of time spent in each probe-point. Also shows
-the derivation for each probe-point.
-<DT><B>-s</B><I>NUM</I>
-
-<DD>
-Use NUM megabyte buffers for kernel-to-user data transfer. On a
-multiprocessor in bulk mode, this is a per-processor amount.
-<DT><B>-I</B><I> DIR</I>
-
-<DD>
-Add the given directory to the tapset search directory. See the
-description of pass 2 for details.
-<DT><B>-D</B><I> NAME=VALUE</I>
-
-<DD>
-Add the given C preprocessor directive to the module Makefile. These can
-be used to override limit parameters described below.
-<DT><B>-B</B><I> NAME=VALUE</I>
-
-<DD>
-Add the given make directive to the kernel module build's make invocation.
-These can be used to add or override kconfig options.
-<DT><B>-a</B><I> ARCH</I>
-
-<DD>
-Use a cross-compilation mode for the given target architecture. This requires
-access to the cross-compiler and the kernel build tree, and goes along
-with the
-<B>-B CROSS_COMPILE=arch-tool-prefix-</B> and <B>-r /build/tree</B>
-
-options.
-<DT><B>--modinfo</B><I> NAME=VALUE</I>
-
-<DD>
-Add the name/value pair as a MODULE_INFO macro call to the generated module.
-This may be useful to inform or override various module-related checks in
-the kernel.
-<DT><B>-G</B><I> NAME=VALUE</I>
-
-<DD>
-Sets the value of global variable NAME to VALUE when staprun is invoked.
-This applies to scalar variables declared global in the script/tapset.
-<DT><B>-R</B><I> DIR</I>
-
-<DD>
-Look for the systemtap runtime sources in the given directory.
-<DT><B>-r</B><I> /DIR</I>
-
-<DD>
-Build for kernel in given build tree. Can also be set with the
-<I>SYSTEMTAP_RELEASE</I>
-
-environment variable.
-<DT><B>-r</B><I> RELEASE</I>
-
-<DD>
-Build for kernel in build tree
-<B>/lib/modules/RELEASE/build</B>.
-
-Can also be set with the
-<I>SYSTEMTAP_RELEASE</I>
-
-environment variable.
-<DT><B>-m</B><I> MODULE</I>
-
-<DD>
-Use the given name for the generated kernel object module, instead
-of a unique randomized name. The generated kernel object module is
-copied to the current directory.
-<DT><B>-d</B><I> MODULE</I>
-
-<DD>
-Add symbol/unwind information for the given module into the kernel object
-module. This may enable symbolic tracebacks from those modules/programs,
-even if they do not have an explicit probe placed into them.
-<DT><B>--ldd</B>
-
-<DD>
-Add symbol/unwind information for all shared libraries suspected by
-ldd to be necessary for user-space binaries being probe or listed with
-the -d option. Caution: this can make the probe modules considerably
-larger.
-<DT><B>--all-modules</B>
-
-<DD>
-Equivalent to specifying "-dkernel" and a "-d" for each kernel module that is
-currently loaded. Caution: this can make the probe modules considerably
-larger.
-<DT><B>-o</B><I> FILE</I>
-
-<DD>
-Send standard output to named file. In bulk mode, percpu files will
-start with FILE_ (FILE_cpu with -F) followed by the cpu number.
-This supports <A HREF="strftime.3.html">strftime</A>(3) formats for FILE.
-<DT><B>-c</B><I> CMD</I>
-
-<DD>
-Start the probes, run CMD, and exit when CMD finishes. This also has the
-effect of setting target() to the pid of the command ran.
-<DT><B>-x</B><I> PID</I>
-
-<DD>
-Sets target() to PID. This allows scripts to be written that filter on
-a specific process.
-<DT><B>-e</B><I> SCRIPT</I>
-
-<DD>
-Run the given SCRIPT specified on the command line.
-<DT><B>-l</B><I> PROBE</I>
-
-<DD>
-Instead of running a probe script, just list all available probe
-points matching the given single probe point. The pattern may include
-wildcards and aliases, but not comma-separated multiple probe points.
-The process result code will indicate failure if there are no matches.
-<DT><B>-L</B><I> PROBE</I>
-
-<DD>
-Similar to "-l", but list probe points and script-level local variables.
-<DT><B>-F</B>
-
-<DD>
-Without -o option, load module and start probes, then detach from the module
-leaving the probes running.
-With -o option, run staprun in background as a daemon and show its pid.
-<DT><B>-S</B><I> size[,N]</I>
-
-<DD>
-Sets the maximum size of output file and the maximum number of output files.
-If the size of output file will exceed
-<B>size</B>
-
-, systemtap switches output file to the next file. And if the number of
-output files exceed
-<B>N</B>
-
-, systemtap removes the oldest output file. You can omit the second argument.
-<DT><B>--skip-badvars</B>
-
-<DD>
-Ignore unresolvable or run-time-inaccessible context variables and
-substitute with 0, without errors.
-<P>
-<DT><B>--suppress-handler-errors</B>
-
-<DD>
-Wrap all probe handlers into something like this
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-try { ... } catch { next }
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-block, which causes any runtime errors to be quietly suppressed.
-Suppressed errors do not count against
-<B>MAXERRORS</B>
-
-limits. In this mode, the
-<B>MAXSKIPPED</B>
-
-limits are also suppressed, so that many errors and skipped probes
-may be accumulated during a script's runtime. Any overall counts will
-still be reported at shutdown.
-<P>
-<DT><B>--compatible</B><I> VERSION</I>
-
-<DD>
-Suppress recent script language or tapset changes which are incompatible
-with given older version of systemtap. This may be useful if a much older
-systemtap script fails to run. See the DEPRECATION section for more
-details.
-<P>
-<DT><B>--check-version</B>
-
-<DD>
-This option is used to check if the active script has any constructors
-that may be systemtap version specific. See the DEPRECATION section
-for more details.
-<P>
-<DT><B>--clean-cache</B>
-
-<DD>
-This option prunes stale entries from the cache directory. This is normally
-done automatically after successful runs, but this option will trigger the
-cleanup manually and then exit. See the CACHING section for more details about
-cache limits.
-<P>
-<DT><B>--color</B>[=<I>WHEN</I>], <B>--colour</B>[=<I>WHEN</I>]<DD>
-This option controls coloring of error messages. WHEN can be either "never",
-"always", or "auto" (i.e. enable only if at a terminal). If WHEN is missing,
-then "always" is assumed. If the option is missing, then "auto" is assumed.
-<P>
-Colors can be modified using the SYSTEMTAP_COLORS environment variable. The
-format must be of the form
-
-<B>key1=val1:key2=val2:key3=val3</B> ...etc.
-
-Valid keys are
-
-"error", "warning", "source", "caret", and "token".
-
-Values constitute Select Graphic Rendition (SGR) parameter(s). Consult the
-documentation of your terminal for the SGRs it supports. As an example, the
-default colors would be expressed as
-
-<B>error=01;31:warning=00;33:source=00;34:caret=01:token=01</B>.
-
-If SYSTEMTAP_COLORS is absent, the default colors will be used. If it is empty
-or invalid, coloring is turned off.
-<P>
-<DT><B>--disable-cache</B>
-
-<DD>
-This option disables all use of the cache directory. No files will be either
-read from or written to the cache.
-<P>
-<DT><B>--poison-cache</B>
-
-<DD>
-This option treats files in the cache directory as invalid. No files will be
-read from the cache, but resulting files from this run will still be written to
-the cache. This is meant as a troubleshooting aid when stap's cached behavior
-seems to be misbehaving.
-<P>
-<DT><B>--privilege</B>[=<I>stapusr</I> | =<I>stapsys</I> | =<I>stapdev</I>]<DD>
-This option instructs <I>stap</I> to examine the script looking for constructs
-which are not allowed for the specified privilege level (see <I>UNPRIVILEGED USERS</I>).
-Compilation fails if any such
-constructs are used.
-If <I>stapusr</I> or <I>stapsys</I> are specified when using a compile server
-(see <I>--use-server</I>),
-the server will examine the script and, if compilation succeeds, the
-server will cryptographically sign the resulting kernel module, certifying
-that is it safe for use by users at the specified privilege level.
-<P>
-If <I>--privilege</I> has not been specified,
-<I>-pN</I> has not been specified with N < 5,
-and the invoking user is not
-<I>root</I>, and is not a member of the group <I>stapdev</I>,
-then <I>stap</I> will automatically
-add the appropriate <I>--privilege</I> option to the options already specified.
-<P>
-<DT><B>--unprivileged</B>
-
-<DD>
-This option is equivalent to <I>--privilege=stapusr</I>.
-<P>
-<DT><B>--use-server</B>[=<I>HOSTNAME</I>[<I>:PORT</I>] | =<I>IP_ADDRESS</I>[<I>:PORT</I>] | =<I>CERT_SERIAL</I>]<DD>
-Specify compile-server(s) to be used for compilation and/or in conjunction
-with
-<I>--list-servers</I>
-
-and
-<I>--trust-servers</I>
-
-(see below). If no argument is
-supplied, then the default in unprivileged mode (see
-<I>--privilege</I>)
-
-is to select compatible servers which are trusted as SSL peers and as
-module signers and currently online. Otherwise the default is to select
-compatible servers which are trusted as SSL peers
-and currently online.
-<I>--use-server</I>
-
-may be
-specified more than once, in which case a list of servers is accumulated
-in the order specified. Servers may be specified by host name, ip address, or
-by certificate serial number (obtained using
-<I>--list-servers</I>).
-
-The latter is most commonly used when adding or revoking
-trust in a server (see
-<I>--trust-servers</I>
-
-below). If a server is specified by host name or ip address, then an optional
-port number may be specified. This is useful for accessing servers which are
-not on the local network or to specify a particular server.
-<P>
-IP addresses may be IPv4 or IPv6 addresses.
-<P>
-If a particular IPv6 address is link local and exists
-on more than one interface, the intended interface may be specified by appending the address with
-a percent sign (%) followed by the intended interface name. For example,
-"fe80::5eff:35ff:fe07:55ca%eth0".
-<P>
-In order to specify a port number with an IPv6 address, it is necessary to enclose the IPv6 address
-in square brackets ([]) in order to separate the port number from the rest of the address. For
-example, "[fe80::5eff:35ff:fe07:55ca]:5000" or "[fe80::5eff:35ff:fe07:55ca%eth0]:5000".
-<P>
-If <I>--use-server</I> has not been specified,
-<I>-pN</I> has not been specified with N < 5,
-and the invoking user not <I>root</I>,
-is not a member of the group <I>stapdev</I>, but is a member of the group
-<I>stapusr</I>, then <I>stap</I> will automatically
-add <I>--use-server</I> to the options already specified.
-<P>
-<DT><B>--use-server-on-error</B>[=<B>yes</B>|=<B>no</B>]<DD>
-Instructs stap to retry compilation of a script using a compile server if
-compilation on the local host fails in a manner which suggests that it might
-succeed using a server.
-If this option is not specified, the default is <I>no</I>.
-If no argument is provided, then the default
-is <I>yes</I>. Compilation will be retried for certain types of errors
-(e.g. insufficient data or resources) which may not occur during
-re-compilation by a compile
-server. Compile servers will be selected automatically for the
-re-compilation attempt as if <I>--use-server</I> was specified with no
-arguments.
-<P>
-<DT><B>--list-servers</B><I>[=SERVERS]</I>
-
-<DD>
-Display the status of the requested
-<I>SERVERS</I>,
-
-where
-<I>SERVERS</I>
-
-is a comma-separated
-list of server attributes. The list of attributes is combined to filter the
-list of servers displayed. Supported attributes are:
-<DL COMPACT><DT><DD>
-<DL COMPACT>
-<DT><B>all</B>
-
-<DD>
-specifies all known servers (trusted SSL peers, trusted module signers, online
-servers).
-<DT><B>specified</B>
-
-<DD>
-specifies servers specified using
-<I>--use-server</I>.
-
-<DT><B>online</B>
-
-<DD>
-filters the output by retaining information about servers which are currently
-online.
-<DT><B>trusted</B>
-
-<DD>
-filters the output by retaining information about servers which are trusted as
-SSL peers.
-<DT><B>signer</B>
-
-<DD>
-filters the output by retaining information about servers which are trusted as
-module signers (see
-<I>--privilege</I>).
-
-<DT><B>compatible</B>
-
-<DD>
-filters the output by retaining information about servers which are compatible
-with the current kernel release and architecture.
-</DL>
-</DL>
-
-<DT><DD>
-If no argument is provided, then the default is
-<B>specified</B>.
-
-If no servers were specified using
-<I>--use-server</I>,
-
-then the default servers for
-<I>--use-server</I>
-
-are listed.
-<P>
-Note that
-<I>--list-servers</I>
-
-uses the
-<I>avahi-daemon</I>
-
-service to detect online servers. If this service is not available, then
-<I>--list-servers</I>
-
-will fail to detect any
-<I>online</I>
-
-servers. In order for
-<I>--list-servers</I>
-
-to detect servers listening on IPv6 addresses, the
-<I>avahi-daemon</I>
-
-configuration file
-<I>/etc/avahi/avahi-daemon.conf</I>
-
-must contain an active "use-ipv6=yes" line. The service must be restarted after adding this line
-in order for IPv6 to be enabled.
-<P>
-<DT><B>--trust-servers</B><I>[=TRUST_SPEC]</I>
-
-<DD>
-Grant or revoke trust in compile-servers, specified using
-<I>--use-server</I>
-
-as specified by TRUST_SPEC,
-where TRUST_SPEC is a comma-separated list specifying the trust which is to
-be granted or revoked. Supported elements are:
-<DL COMPACT><DT><DD>
-<DL COMPACT>
-<DT><B>ssl</B>
-
-<DD>
-trust the specified servers as SSL peers.
-<DT><B>signer</B>
-
-<DD>
-trust the specified servers as module signers (see
-<I>--privilege</I>).
-
-Only root can specify
-<B>signer.</B>
-
-<DT><B>all-users</B>
-
-<DD>
-grant trust as an ssl peer for all users on the local host. The default is
-to grant trust as an ssl peer for the current user only. Trust as a module
-signer is always granted for all users. Only root can specify
-<B>all-users</B>.
-
-<DT><B>revoke</B>
-
-<DD>
-revoke the specified trust. The default is to grant it.
-<DT><B>no-prompt</B>
-
-<DD>
-do not prompt the user for confirmation before carrying out the requested
-action. The default is to prompt the user for confirmation.
-</DL>
-</DL>
-
-<DT><DD>
-If no argument is provided, then the default is
-<B>ssl</B>.
-
-If no servers were specified using
-<I>--use-server</I>,
-
-then no trust will be granted or revoked.
-<DT><DD>
-Unless <B>no-prompt</B> has been specified,
-the user will be prompted to confirm the trust to be granted or revoked before
-the operation is performed.
-<P>
-<DT><B>--dump-probe-types</B>
-
-<DD>
-Dumps a list of supported probe types. If
-<I>--privilege=stapusr</I>
-
-is also specified, the list will be limited to probe types available to unprivileged users.
-<P>
-<DT><B>--remote</B><I> URL</I>
-
-<DD>
-Set the execution target to the given host. This option may be
-repeated to target multiple execution targets. Passes 1-4 are
-completed locally as normal to build the script, and then pass 5 will
-copy the module to the target and run it. Acceptable URL forms include:
-<DL COMPACT><DT><DD>
-<DL COMPACT>
-<DT><B>[USER@]HOSTNAME</B>, <B><A HREF="ssh://[USER@]HOSTNAME">ssh://[USER@]HOSTNAME</A></B><DD>
-This mode uses ssh, optionally using a username not matching your own. If a
-custom ssh_config file is in use, add <B>SendEnv LANG</B> to retain
-internationalization functionality.
-<DT><B>libvirt://DOMAIN</B>, <B>libvirt://DOMAIN/LIBVIRT_URI</B><DD>
-This mode uses <I>stapvirt</I> to execute the script on a domain managed by
-libvirt. Optionally, LIBVIRT_URI may be specified to connect to a specific
-driver and/or a remote host. For example, to connect to the local privileged
-QEMU driver, use:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
---remote libvirt://MyDomain/<A HREF="qemu:///system">qemu:///system</A>
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-See the page at
-
-<<A HREF="http://libvirt.org/uri.html">http://libvirt.org/uri.html</A>>
-
-for supported URIs. Also see <I><A HREF="stapvirt.1.html">stapvirt</A></I>(1) for more information on how to
-prepare the domain for stap probing.
-<DT><B>unix:PATH</B><DD>
-This mode connects to a UNIX socket. This can be used with a QEMU virtio-serial
-port for executing scripts inside a running virtual machine.
-<DT><B>direct://</B><DD>
-Special loopback mode to run on the local host.
-</DL>
-</DL>
-
-<DT><DD>
-<P>
-<DT><B>--remote-prefix</B>
-
-<DD>
-Prefix each line of remote output with "N: ", where N is the index of the remote
-execution target from which the given line originated.
-<P>
-<DT><B>--download-debuginfo</B><I>[=OPTION]</I>
-
-<DD>
-Enable, disable or set a timeout for the automatic debuginfo downloading feature
-offered by abrt as specified by OPTION, where OPTION is one of the following:
-<DL COMPACT><DT><DD>
-<DL COMPACT>
-<DT><B>yes</B>
-
-<DD>
-enable automatic downloading of debuginfo with no timeout. This is the same
-as not providing an OPTION value to
-<I>--download-debuginfo</I>
-
-<DT><B>no</B>
-
-<DD>
-explicitly disable automatic downloading of debuginfo. This is the same as
-not using the option at all.
-<DT><B>ask</B>
-
-<DD>
-show abrt output, and ask before continuing download. No timeout will be set.
-<DT><B><timeout></B>
-
-<DD>
-specify a timeout as a positive number to stop the download if it is taking
-too long.
-</DL>
-</DL>
-
-<DT><DD>
-<P>
-<DT><B>--rlimit-as</B><I>=NUM</I>
-
-<DD>
-Specify the maximum size of the process's virtual memory (address space),
-in bytes. If nothing is specified, no limits are imposed.
-<P>
-<DT><B>--rlimit-cpu</B><I>=NUM</I>
-
-<DD>
-Specify the CPU time limit, in seconds. If nothing is specified, no limits are
-imposed.
-<P>
-<DT><B>--rlimit-nproc</B><I>=NUM</I>
-
-<DD>
-Specify the maximum number of processes that can be created. If nothing is
-specified, no limits are imposed.
-<P>
-<DT><B>--rlimit-stack</B><I>=NUM</I>
-
-<DD>
-Specify the maximum size of the process stack, in bytes. If nothing is specified,
-no limits are imposed.
-<P>
-<DT><B>--rlimit-fsize</B><I>=NUM</I>
-
-<DD>
-Specify the maximum size of files that the process may create, in bytes. If nothing is specified, no limits are
-imposed.
-<P>
-<DT><B>--sysroot</B><I>=DIR</I>
-
-<DD>
-Specify sysroot directory where target files (executables, libraries, etc.)
-are located. With <I>-r RELEASE</I>, the sysroot will be searched for the
-appropriate kernel build directory. With <I>-r /DIR</I>, however, the sysroot
-will not be used to find the kernel build.
-<P>
-<DT><B>--sysenv</B><I>=VAR=VALUE</I>
-
-<DD>
-Provide an alternate value for an environment variable where the value on a
-remote system differs. Path variables (e.g. PATH, LD_LIBRARY_PATH) are assumed
-to be relative to the directory provided by <I>--sysroot</I>, if provided.
-<P>
-<DT><B>--suppress-time-limits</B>
-
-<DD>
-Disable -DSTP_NO_OVERLOAD -MAXACTION -MAXTRYLOCK options. This option
-requires guru mode.
-<P>
-<DT><B>--runtime</B><I>=MODE</I>
-
-<DD>
-Set the pass-5 runtime mode. Valid options are <I>kernel</I> (default)
-and <I>dyninst</I>. See
-<B>ALTERNATE RUNTIMES</B>
-
-below for more information.
-<P>
-<DT><B>--dyninst</B>
-
-<DD>
-Shorthand for <I>--runtime=dyninst</I>.
-<P>
-</DL>
-<A NAME="lbAF"> </A>
-<H2>ARGUMENTS</H2>
-
-<P>
-Any additional arguments on the command line are passed to the script
-parser for substitution. See below.
-<P>
-<A NAME="lbAG"> </A>
-<H2>SCRIPT LANGUAGE</H2>
-
-<P>
-The systemtap script language resembles
-<I>awk</I>.
-
-There are two main outermost constructs: probes and functions. Within
-these, statements and expressions use C-like operator syntax and
-precedence.
-<P>
-<A NAME="lbAH"> </A>
-<H3>GENERAL SYNTAX</H3>
-
-Whitespace is ignored. Three forms of comments are supported:
-<DL COMPACT><DT><DD>
-<BR>
-
-<B>#</B> ... shell style, to the end of line, except for $# and @#
-
-<BR>
-
-<B>//</B> ... C++ style, to the end of line
-
-<BR>
-
-<B>/*</B> ... C style ... <B>*/</B>
-
-</DL>
-
-Literals are either strings enclosed in double-quotes (passing through
-the usual C escape codes with backslashes, and with adjacent string
-literals glued together, also as in C), or integers (in decimal,
-hexadecimal, or octal, using the same notation as in C). All strings
-are limited in length to some reasonable value (a few hundred bytes).
-Integers are 64-bit signed quantities, although the parser also
-accepts (and wraps around) values above positive 2**63.
-<P>
-
-In addition, script arguments given at the end of the command line may
-be inserted. Use
-<B>$1 ... $<NN></B>
-
-for insertion unquoted,
-<B>@1 ... @<NN></B>
-
-for insertion as a string literal. The number of arguments may be accessed
-through
-<B>$#</B>
-
-(as an unquoted number) or through
-<B>@#</B>
-
-(as a quoted number). These may be used at any place a token may begin,
-including within the preprocessing stage. Reference to an argument
-number beyond what was actually given is an error.
-<P>
-<A NAME="lbAI"> </A>
-<H3>PREPROCESSING</H3>
-
-A simple conditional preprocessing stage is run as a part of parsing.
-The general form is similar to the
-cond<B> ? </B>exp1<B> : </B>exp2
-
-ternary operator:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>%(</B> CONDITION <B>%?</B> TRUE-TOKENS <B>%)</B>
-<B>%(</B> CONDITION <B>%?</B> TRUE-TOKENS <B>%:</B> FALSE-TOKENS <B>%)</B>
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-The CONDITION is either an expression whose format is determined by its
-first keyword, or a string literals comparison or a numeric literals
-comparison. It can be also composed of many alternatives and conjunctions
-of CONDITIONs (meant as in previous sentence) using || and && respectively.
-However, parentheses are not supported yet, so remembering that conjunction
-takes precedence over alternative is important.
-<P>
-
-If the first part is the identifier
-<B>kernel_vr</B> or <B>kernel_v</B>
-
-to refer to the kernel version number, with ("2.6.13-1.322FC3smp") or
-without ("2.6.13") the release code suffix, then
-the second part is one of the six standard numeric comparison operators
-<B><</B>, <B><=</B>, <B>==</B>, <B>!=</B>, <B>></B>, and <B>>=</B>,
-
-and the third part is a string literal that contains an RPM-style
-version-release value. The condition is deemed satisfied if the
-version of the target kernel (as optionally overridden by the
-<B>-r</B>
-
-option) compares to the given version string. The comparison is
-performed by the glibc function
-<B>strverscmp</B>.
-
-As a special case, if the operator is for simple equality
-(<B>==</B>),
-
-or inequality
-(<B>!=</B>),
-
-and the third part contains any wildcard characters
-(<B>*</B> or <B>?</B> or <B>[</B>),
-
-then the expression is treated as a wildcard (mis)match as evaluated
-by
-<B>fnmatch</B>.
-
-<P>
-
-If, on the other hand, the first part is the identifier
-<B>arch</B>
-
-to refer to the processor architecture (as named by the kernel
-build system ARCH/SUBARCH), then the second
-part is one of the two string comparison operators
-<B>==</B> or <B>!=</B>,
-
-and the third part is a string literal for matching it. This
-comparison is a wildcard (mis)match.
-<P>
-
-Similarly, if the first part is an identifier like
-<B>CONFIG_something</B>
-
-to refer to a kernel configuration option, then the second part is
-<B>==</B> or <B>!=</B>,
-
-and the third part is a string literal for matching the value
-(commonly "y" or "m"). Nonexistent or unset kernel configuration
-options are represented by the empty string. This comparison is also
-a wildcard (mis)match.
-<P>
-
-If the first part is the identifier
-<B>systemtap_v</B>,
-
-the test refers to the systemtap compatibility version, which may be
-overridden for old scripts with the
-<B>--compatible</B>
-
-flag. The comparison operator is as is for
-<B>kernel_v</B>
-
-and the right operand is a version string. See also the DEPRECATION
-section below.
-<P>
-
-If the first part is the identifier
-<B>systemtap_privilege</B>,
-
-the test refers to the privilege level that the systemtap script is
-compiled with. Here the second part is
-<B>==</B> or <B>!=</B>,
-
-and the third part is a string literal, either "stapusr" or "stapsys"
-or "stapdev".
-<P>
-
-If the first part is the identifier
-<B>guru_mode</B>,
-
-the test refers to if the systemtap script is
-compiled with guru_mode. Here the second part is
-<B>==</B> or <B>!=</B>,
-
-and the third part is a number, either 1 or 0.
-<P>
-
-If the first part is the identifier
-<B>runtime</B>,
-
-the test refers to the systemtap runtime mode. See
-<B>ALTERNATE RUNTIMES</B>
-
-below for more information on runtimes.
-The second
-part is one of the two string comparison operators
-<B>==</B> or <B>!=</B>,
-
-and the third part is a string literal for matching it. This
-comparison is a wildcard (mis)match.
-<P>
-
-Otherwise, the CONDITION is expected to be a comparison between two string
-literals or two numeric literals. In this case, the arguments are the only
-variables usable.
-<P>
-
-The TRUE-TOKENS and FALSE-TOKENS are zero or more general parser
-tokens (possibly including nested preprocessor conditionals), and are
-passed into the input stream if the condition is true or false. For
-example, the following code induces a parse error unless the target
-kernel version is newer than 2.6.5:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-%( kernel_v <= "2.6.5" %? **ERROR** %) # invalid token sequence
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-The following code might adapt to hypothetical kernel version drift:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-probe kernel.function (
- %( kernel_v <= "2.6.12" %? "__mm_do_fault" %:
- %( kernel_vr == "2.6.13*smp" %? "do_page_fault" %:
- UNSUPPORTED %) %)
-) { /* ... */ }
-
-%( arch == "ia64" %?
- probe syscall.vliw = kernel.function("vliw_widget") {}
-%)
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<A NAME="lbAJ"> </A>
-<H3>PREPROCESSOR MACROS</H3>
-
-The preprocessor also supports a simple macro facility, run as a
-separate pass before conditional preprocessing.
-<P>
-
-Macros are defined using the following construct:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-@define NAME %( BODY %)
-@define NAME(PARAM_1, PARAM_2, ...) %( BODY %)
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-Macros, and parameters inside a macro body, are both invoked by
-prefixing the macro name with an @ symbol:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-@define foo %( x %)
-@define add(a,b) %( ((@a)+(@b)) %)
-
- @foo = @add(2,2)
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-
-Macro expansion is currently performed in a separate pass before
-conditional compilation. Therefore, both TRUE- and FALSE-tokens in
-conditional expressions will be macroexpanded regardless of how the
-condition is evaluated. This can sometimes lead to errors:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-// The following results in a conflict:
-%( CONFIG_UTRACE == "y" %?
- @define foo %( process.syscall %)
-%:
- @define foo %( **ERROR** %)
-%)
-
-// The following works properly as expected:
-@define foo %(
- %( CONFIG_UTRACE == "y" %? process.syscall %: **ERROR** %)
-%)
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-The first example is incorrect because both @defines are evaluated in
-a pass prior to the conditional being evaluated.
-<P>
-Normally, a macro definition is local to the file it occurs in. Thus,
-defining a macro in a tapset does not make it available to the user of
-the tapset. Publically available library macros can be defined by
-including .stpm files on the tapset search path. These files may only
-contain @define constructs, which become visible across all tapsets
-and user scripts.
-<P>
-<A NAME="lbAK"> </A>
-<H3>VARIABLES</H3>
-
-Identifiers for variables and functions are an alphanumeric sequence,
-and may include "_" and "$" characters. They may not start with a
-plain digit, as in C. Each variable is by default local to the probe
-or function statement block within which it is mentioned, and therefore
-its scope and lifetime is limited to a particular probe or function
-invocation.
-
-<P>
-
-Scalar variables are implicitly typed as either string or integer.
-Associative arrays also have a string or integer value, and a
-tuple of strings and/or integers serving as a key. Here are a
-few basic expressions.
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-var1 = 5
-var2 = "bar"
-array1 [pid()] = "name" # single numeric key
-array2 ["foo",4,i++] += 5 # vector of string/num/num keys
-if (["hello",5,4] in array2) println ("yes") # membership test
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-
-The translator performs
-<I>type inference</I>
-
-on all identifiers, including array indexes and function parameters.
-Inconsistent type-related use of identifiers signals an error.
-<P>
-
-Variables may be declared global, so that they are shared amongst all
-probes and live as long as the entire systemtap session. There is one
-namespace for all global variables, regardless of which script file
-they are found within. Concurrent access to global variables is
-automatically protected with locks, see the
-<B>SAFETY AND SECURITY</B>
-
-section for more details. A global declaration may be written at the
-outermost level anywhere, not within a block of code. Global
-variables which are written but never read will be displayed
-automatically at session shutdown. The translator will
-infer for each its value type, and if it is used as an array, its key
-types. Optionally, scalar globals may be initialized with a string
-or number literal. The following declaration marks variables as global.
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>global</B> var1<B>,</B> var2<B>,</B> var3=4
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-
-Global variables can also be set as module options. One can do this by either
-using the -G option, or the module must first be compiled using stap -p4.
-Global variables can then be set on the command line when calling staprun on
-the module generated by stap -p4. See
-<I><A HREF="staprun.8.html">staprun</A></I>(8)
-
-for more information.
-<P>
-
-Arrays are limited in size by the MAXMAPENTRIES variable -- see the
-<B>SAFETY AND SECURITY</B>
-
-section for details. Optionally, global arrays may be declared with a
-maximum size in brackets, overriding MAXMAPENTRIES for that array only.
-Note that this doesn't indicate the type of keys for the array, just the
-size.
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>global</B> tiny_array[10]<B>,</B> normal_array<B>,</B> big_array[50000]
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-
-Arrays may be configured for wrapping using the '%' suffix. This
-causes older elements to be overwritten if more elements are inserted
-than the array can hold. This works for both associative and statistics
-typed arrays.
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>global</B> wrapped_array1%[10],<B> wrapped_array2%</B>
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<A NAME="lbAL"> </A>
-<H3>STATEMENTS</H3>
-
-Statements enable procedural control flow. They may occur within
-functions and probe handlers. The total number of statements executed
-in response to any single probe event is limited to some number
-defined by a macro in the translated C code, and is in the
-neighbourhood of 1000.
-<DL COMPACT>
-<DT>EXP<DD>
-Execute the string- or integer-valued expression and throw away
-the value.
-<DT><B>{</B> STMT1 STMT2 ... <B>}</B>
-
-<DD>
-Execute each statement in sequence in this block. Note that
-separators or terminators are generally not necessary between statements.
-<DT><B>;</B>
-
-<DD>
-Null statement, do nothing. It is useful as an optional separator between
-statements to improve syntax-error detection and to handle certain
-grammar ambiguities.
-<DT><B>if</B> (EXP) STMT1 [ <B>else</B> STMT2 ]
-
-<DD>
-Compare integer-valued EXP to zero. Execute the first (non-zero)
-or second STMT (zero).
-<DT><B>while</B> (EXP) STMT
-
-<DD>
-While integer-valued EXP evaluates to non-zero, execute STMT.
-<DT><B>for</B> (EXP1; EXP2; EXP3) STMT
-
-<DD>
-Execute EXP1 as initialization. While EXP2 is non-zero, execute
-STMT, then the iteration expression EXP3.
-<DT><B>foreach</B> (VAR <B>in</B> ARRAY [ limit<B> EXP ]) STMT</B>
-
-<DD>
-Loop over each element of the named global array, assigning current
-key to VAR. The array may not be modified within the statement.
-By adding a single
-<B>+</B> or <B>-</B>
-
-operator after the VAR or the ARRAY identifier, the iteration will
-proceed in a sorted order, by ascending or descending index or value.
-If the array contains statistics aggregates, adding the desired
-<B>@operator</B>
-
-between the ARRAY identifier and the
-<B>+</B> or <B>-</B>
-
-will specify the sorting aggregate function. See the STATISTICS
-section below for the ones available. Default is
-<B>@count</B>.
-
-Using the optional
-<B>limit</B>
-
-keyword limits the number of loop iterations to EXP times. EXP is
-evaluated once at the beginning of the loop.
-<DT><B>foreach</B> ([VAR1, VAR2, ...] <B>in</B> ARRAY [ limit<B> EXP ]) STMT</B>
-
-<DD>
-Same as above, used when the array is indexed with a tuple of keys.
-A sorting suffix may be used on at most one VAR or ARRAY identifier.
-<DT><B>foreach</B> (VALUE = VAR <B>in</B> ARRAY [ limit<B> EXP ]) STMT</B>
-
-<DD>
-This variant of foreach saves current value into VALUE on each
-iteration, so it is the same as ARRAY[VAR]. This also works with a
-tuple of keys. Sorting suffixes on VALUE have the same effect as on ARRAY.
-<DT><B>break</B>, <B>continue</B>
-
-<DD>
-Exit or iterate the innermost nesting loop
-(<B>while</B> or <B>for</B> or <B>foreach</B>)
-
-statement.
-<DT><B>return</B> EXP
-
-<DD>
-Return EXP value from enclosing function. If the function's value is
-not taken anywhere, then a return statement is not needed, and the
-function will have a special "unknown" type with no return value.
-<DT><B>next</B>
-
-<DD>
-Return now from enclosing probe handler. This is especially useful in
-probe aliases that apply event filtering predicates.
-<DT><B>try</B> { STMT1 } <B>catch</B> { STMT2 }
-
-<DD>
-Run the statements in the first block. Upon any run-time errors, abort
-STMT1 and start executing STMT2. Any errors in STMT2 will propagate to
-outer try/catch blocks, if any.
-<DT><B>try</B> { STMT1 } <B>catch</B>(VAR) { STMT2 }
-
-<DD>
-Same as above, plus assign the error message to the string scalar variable VAR.
-<DT><B>delete</B> ARRAY[INDEX1, INDEX2, ...]
-
-<DD>
-Remove from ARRAY the element specified by the index tuple. The value will no
-longer be available, and subsequent iterations will not report the element.
-It is not an error to delete an element that does not exist.
-<DT><B>delete</B> ARRAY
-
-<DD>
-Remove all elements from ARRAY.
-<DT><B>delete</B> SCALAR
-
-<DD>
-Removes the value of SCALAR. Integers and strings are cleared to 0 and ""
-respectively, while statistics are reset to the initial empty state.
-<P>
-</DL>
-<A NAME="lbAM"> </A>
-<H3>EXPRESSIONS</H3>
-
-Systemtap supports a number of operators that have the same general syntax,
-semantics, and precedence as in C and awk. Arithmetic is performed as per
-typical C rules for signed integers. Division by zero or overflow is
-detected and results in an error.
-<DL COMPACT>
-<DT>binary numeric operators<DD>
-<B>* / % + - >> << & ^ | && ||</B>
-
-<DT>binary string operators<DD>
-<B>.</B>
-
-(string concatenation)
-<DT>numeric assignment operators<DD>
-<B>= *= /= %= += -= >>= <<= &= ^= |=</B>
-
-<DT>string assignment operators<DD>
-<B>= .=</B>
-
-<DT>unary numeric operators<DD>
-<B>+ - ! ~ ++ --</B>
-
-<DT>binary numeric, string comparison or regex matching operators<DD>
-<B>< > <= >= == != =~ !~</B>
-
-<DT>ternary operator<DD>
-cond<B> ? </B>exp1<B> : </B>exp2
-
-<DT>grouping operator<DD>
-<B>(</B> exp <B>)</B>
-
-<DT>function call<DD>
-fn <B>(</B>[ arg1, arg2, ... ]<B>)</B>
-
-<DT>array membership check<DD>
-exp<B> in </B>array
-
-<BR>
-
-<B>[</B>exp1<B>, </B>exp2<B>, </B>...<B>] in </B>array
-
-<P>
-</DL>
-<A NAME="lbAN"> </A>
-<H3>REGULAR EXPRESSION MATCHING</H3>
-
-The scripting language supports regular expression matching.
-The basic syntax is as follows:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>exp</B> =~ <B>regex</B>
-<B>exp</B> !~ <B>regex</B>
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-(The first operand must be an expression evaluating to a string; the
-second operand must be a string literal containing a syntactically
-valid regular expression.)
-<P>
-
-The regular expression syntax supports most of the features of POSIX
-Extended Regular Expressions, except for subexpression reuse ("\1")
-functionality. The ability to capture and extract the contents of the
-matched string and subexpressions has not yet been implemented.
-<P>
-<A NAME="lbAO"> </A>
-<H3>PROBES</H3>
-
-The main construct in the scripting language identifies probes.
-Probes associate abstract events with a statement block ("probe
-handler") that is to be executed when any of those events occur. The
-general syntax is as follows:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>probe</B> PROBEPOINT [<B>,</B> PROBEPOINT] <B>{</B> [STMT ...] <B>}</B>
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-
-Events are specified in a special syntax called "probe points". There
-are several varieties of probe points defined by the translator, and
-tapset scripts may define further ones using aliases. Probe points
-may be wildcarded, grouped, or listed in preference sequences, or
-declared optional. More details on probe point syntax and semantics
-are listed on the
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-manual page.
-<P>
-
-The probe handler is interpreted relative to the context of each
-event. For events associated with kernel code, this context may
-include
-<I>variables</I>
-
-defined in the
-<I>source code</I>
-
-at that spot. These "context variables" are presented to the script
-as variables whose names are prefixed with "$". They may be accessed
-only if the kernel's compiler preserved them despite optimization.
-This is the same constraint that a debugger user faces when working
-with optimized code. In addition, the objects must exist in paged-in
-memory at the moment of the systemtap probe handler's execution,
-because systemtap must not cause (suppresses) any additional paging.
-Some probe types have very little context.
-See the
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-man pages to see the kinds of context variables available at each kind
-of probe point.
-<P>
-
-New probe points may be defined using "aliases". Probe point aliases
-look similar to probe definitions, but instead of activating a probe
-at the given point, it just defines a new probe point name as an alias
-to an existing one. There are two types of alias, i.e. the prologue
-style and the epilogue style which are identified by "=" and "+="
-respectively.
-<P>
-
-For prologue style alias, the statement block that follows an alias
-definition is implicitly added as a prologue to any probe that refers
-to the alias. While for the epilogue style alias, the statement block
-that follows an alias definition is implicitly added as an epilogue to
-any probe that refers to the alias. For example:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-probe syscall.read = kernel.function("sys_read") {
- fildes = $fd
- if (execname() == "init") next # skip rest of probe
-}
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-defines a new probe point
-
-<I>syscall.read</I>,
-
-
-which expands to
-
-<I>kernel.function(sys_read)</I>,
-
-
-with the given statement as a prologue, which is useful to predefine
-some variables for the alias user and/or to skip probe processing
-entirely based on some conditions. And
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-probe syscall.read += kernel.function("sys_read") {
- if (tracethis) println ($fd)
-}
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-defines a new probe point with the given statement as an epilogue, which
-is useful to take actions based upon variables set or left over by the
-the alias user. Please note that in each case, the statements in the
-alias handler block are treated ordinarily, so that variables assigned
-there constitute mere initialization, not a macro substitution.
-<P>
-An alias is used just like a built-in probe type.
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-probe syscall.read {
- printf("reading fd=%d, fildes)
- if (fildes > 10) tracethis = 1
-}
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<A NAME="lbAP"> </A>
-<H3>FUNCTIONS</H3>
-
-Systemtap scripts may define subroutines to factor out common work.
-Functions take any number of scalar (integer or string) arguments, and
-must return a single scalar (integer or string). An example function
-declaration looks like this:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-function thisfn (arg1, arg2) {
- return arg1 + arg2
-}
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-Note the general absence of type declarations, which are instead
-inferred by the translator. However, if desired, a function
-definition may include explicit type declarations for its return value
-and/or its arguments. This is especially helpful for embedded-C
-functions. In the following example, the type inference engine need
-only infer type type of arg2 (a string).
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-function thatfn:string (arg1:long, arg2) {
- return sprint(arg1) . arg2
-}
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-Functions may call others or themselves
-recursively, up to a fixed nesting limit. This limit is defined by
-a macro in the translated C code and is in the neighbourhood of 10.
-<P>
-<A NAME="lbAQ"> </A>
-<H3>PRINTING</H3>
-
-There are a set of function names that are specially treated by the
-translator. They format values for printing to the standard systemtap
-output stream in a more convenient way. The
-<I>sprint*</I>
-
-variants return the formatted string instead of printing it.
-<DL COMPACT>
-<DT><B>print</B>, <B>sprint</B>
-
-<DD>
-Print one or more values of any type, concatenated directly together.
-<DT><B>println</B>, <B>sprintln</B>
-
-<DD>
-Print values like
-<I>print</I> and <I>sprint</I>,
-
-but also append a newline.
-<DT><B>printd</B>, <B>sprintd</B>
-
-<DD>
-Take a string delimiter and two or more values of any type, and print the
-values with the delimiter interposed. The delimiter must be a literal
-string constant.
-<DT><B>printdln</B>, <B>sprintdln</B>
-
-<DD>
-Print values with a delimiter like
-<I>printd</I> and <I>sprintd</I>,
-
-but also append a newline.
-<DT><B>printf</B>, <B>sprintf</B>
-
-<DD>
-Take a formatting string and a number of values of corresponding types,
-and print them all. The format must be a literal string constant.
-</DL>
-<P>
-
-The
-<I>printf</I>
-
-formatting directives similar to those of C, except that they are
-fully type-checked by the translator:
-<DL COMPACT><DT><DD>
-<DL COMPACT>
-<DT>%b<DD>
-Writes a binary blob of the value given, instead of ASCII text. The width specifier determines the number of bytes to write; valid specifiers are %b %1b %2b %4b %8b. Default (%b) is 8 bytes.
-<DT>%c<DD>
-Character.
-<DT>%d,%i<DD>
-Signed decimal.
-<DT>%m<DD>
-Safely reads kernel memory at the given address, outputs its content. The optional precision specifier (not field width) determines the number of bytes to read - default is 1 byte. %10.4m prints 4 bytes of the memory in a 10-character-wide field.
-<DT>%M<DD>
-Same as %m, but outputs in hexadecimal. The minimal size of output is double the optional precision specifier - default is 1 byte (2 hex chars). %10.4M prints 4 bytes of the memory as 8 hexadecimal characters in a 10-character-wide field.
-<DT>%o<DD>
-Unsigned octal.
-<DT>%p<DD>
-Unsigned pointer address.
-<DT>%s<DD>
-String.
-<DT>%u<DD>
-Unsigned decimal.
-<DT>%x<DD>
-Unsigned hex value, in all lower-case.
-<DT>%X<DD>
-Unsigned hex value, in all upper-case.
-<DT>%%<DD>
-Writes a %.
-</DL>
-</DL>
-
-<P>
-
-The
-<I>#</I>
-
-flag selects the alternate forms. For octal, this prefixes a 0. For hex, this
-prefixes 0x or 0X, depending on case. For characters, this escapes
-non-printing values with either C-like escapes or raw octal.
-<P>
-
-Examples:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-a = "alice", b = "bob", p = 0x1234abcd, i = 123, j = -1, id[a] = 1234, id[b] = 4567
-print("hello")
- Prints: hello
-println(b)
- Prints: bob\n
-println(a . " is " . sprint(16))
- Prints: alice is 16
-foreach (name in id) printdln("|", strlen(name), name, id[name])
- Prints: 5|alice|1234\n3|bob|4567
-printf("%c is %s; %x or %X or %p; %d or %u\n",97,a,p,p,p,j,j)
- Prints: a is alice; 1234abcd or 1234ABCD or 0x1234abcd; -1 or 18446744073709551615\n
-printf("2 bytes of kernel buffer at address %p: %2m", p, p)
- Prints: 2 byte of kernel buffer at address 0x1234abcd: <binary data>
-printf("%4b", p)
- Prints (these values as binary data): 0x1234abcd
-printf("%#o %#x %#X\n", 1, 2, 3)
- Prints: 01 0x2 0X3
-printf("%#c %#c %#c\n", 0, 9, 42)
- Prints: \000 \t *
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<A NAME="lbAR"> </A>
-<H3>STATISTICS</H3>
-
-It is often desirable to collect statistics in a way that avoids the
-penalties of repeatedly exclusive locking the global variables those
-numbers are being put into. Systemtap provides a solution using a
-special operator to accumulate values, and several pseudo-functions to
-extract the statistical aggregates.
-<P>
-
-The aggregation operator is
-<I><<<</I>,
-
-and resembles an assignment, or a C++ output-streaming operation.
-The left operand specifies a scalar or array-index lvalue, which must
-be declared global. The right operand is a numeric expression. The
-meaning is intuitive: add the given number to the pile of numbers to
-compute statistics of. (The specific list of statistics to gather
-is given separately, by the extraction functions.)
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-foo <<< 1
-stats[pid()] <<< memsize
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-
-The extraction functions are also special. For each appearance of a
-distinct extraction function operating on a given identifier, the
-translator arranges to compute a set of statistics that satisfy it.
-The statistics system is thereby "on-demand". Each execution of
-an extraction function causes the aggregation to be computed for
-that moment across all processors.
-<P>
-
-Here is the set of extractor functions. The first argument of each is
-the same style of lvalue used on the left hand side of the accumulate
-operation. The
-<I>@count(v)</I>, <I>@sum(v)</I>, <I>@min(v)</I>, <I>@max(v)</I>, <I>@avg(v)</I>
-
-extractor functions compute the number/total/minimum/maximum/average
-of all accumulated values. The resulting values are all simple
-integers. Arrays containing aggregates may be sorted and iterated.
-See the
-<B>foreach</B>
-
-construct above.
-<P>
-
-Histograms are also available, but are more complicated because they
-have a vector rather than scalar value.
-<I>@hist_linear(v,start,stop,interval)</I>
-
-represents a linear histogram from "start" to "stop" by increments
-of "interval". The interval must be positive. Similarly,
-<I>@hist_log(v)</I>
-
-represents a base-2 logarithmic histogram. Printing a histogram
-with the
-<I>print</I>
-
-family of functions renders a histogram object as a tabular
-"ASCII art" bar chart.
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-probe timer.profile {
- x[1] <<< pid()
- x[2] <<< uid()
- y <<< tid()
-}
-global x // an array containing aggregates
-global y // a scalar
-probe end {
- foreach ([i] in x @count+) {
- printf ("x[%d]: avg %d = sum %d / count %d\n",
- i, @avg(x[i]), @sum(x[i]), @count(x[i]))
- println (@hist_log(x[i]))
- }
- println ("y:")
- println (@hist_log(y))
-}
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<A NAME="lbAS"> </A>
-<H3>TYPECASTING</H3>
-
-Once a pointer has been saved into a script integer variable, the
-translator loses the type information necessary to access members from
-that pointer. Using the
-<I>@cast()</I>
-
-operator tells the translator how to read a pointer.
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-@cast(p, "type_name"[, "module"])->member
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-
-This will interpret
-<I>p</I>
-
-as a pointer to a struct/union named
-<I>type_name</I>
-
-and dereference the
-<I>member</I>
-
-value. Further
-<I>->subfield</I>
-
-expressions may be appended to dereference more levels.
-
-NOTE:
-the same dereferencing operator
-<I>-></I>
-
-is used to refer to both direct containment or pointer indirection.
-Systemtap automatically determines which. The optional
-<I>module</I>
-
-tells the translator where to look for information about that type.
-Multiple modules may be specified as a list with
-<I>:</I>
-
-separators. If the module is not specified, it will default either to
-the probe module for dwarf probes, or to "kernel" for functions and all
-other probes types.
-<P>
-
-The translator can create its own module with type information from a header
-surrounded by angle brackets, in case normal debuginfo is not available. For
-kernel headers, prefix it with "kernel" to use the appropriate build system.
-All other headers are build with default GCC parameters into a user module.
-Multiple headers may be specified in sequence to resolve a codependency.
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-@cast(tv, "timeval", "<<A HREF="file:///usr/include/sys/time.h">sys/time.h</A>>")->tv_sec
-@cast(task, "task_struct", "kernel<<A HREF="file:///usr/include/linux/sched.h">linux/sched.h</A>>")->tgid
-@cast(task, "task_struct",
- "kernel<<A HREF="file:///usr/include/linux/sched.h">linux/sched.h</A>><<A HREF="file:///usr/include/linux/fs_struct.h">linux/fs_struct.h</A>>")->fs->umask
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-Values acquired by
-<B>@cast</B>
-
-may be pretty-printed by the
-
-$ " and " $$
-suffix operators, the same way as described in the CONTEXT VARIABLES
-section of the
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-manual page.
-<P>
-<P>
-
-When in guru mode, the translator will also allow scripts to assign new
-values to members of typecasted pointers.
-<P>
-
-Typecasting is also useful in the case of
-<I>void*</I>
-
-members whose type may be determinable at runtime.
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-probe foo {
- if ($var->type == 1) {
- value = @cast($var->data, "type1")->bar
- } else {
- value = @cast($var->data, "type2")->baz
- }
- print(value)
-}
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<A NAME="lbAT"> </A>
-<H3>EMBEDDED C</H3>
-
-When in guru mode, the translator accepts embedded code in the
-top level of the script. Such code is enclosed between
-<I>%{</I>
-
-and
-<I>%}</I>
-
-markers, and is transcribed verbatim, without analysis, in some
-sequence, into the top level of the generated C code. At the
-outermost level, this may be useful to add
-<I>#include</I>
-
-instructions, and any auxiliary definitions for use by other embedded
-code.
-<P>
-
-Another place where embedded code is permitted is as a function body.
-In this case, the script language body is replaced entirely by a piece
-of C code enclosed again between
-<I>%{</I> and <I>%}</I>
-
-markers.
-This C code may do anything reasonable and safe. There are a number
-of undocumented but complex safety constraints on atomicity,
-concurrency, resource consumption, and run time limits, so this
-is an advanced technique.
-<P>
-
-The memory locations set aside for input and output values
-are made available to it using macros
-<I>STAP_ARG_*</I>
-
-and
-<I>STAP_RETVALUE</I>.
-
-Errors may be signalled with STAP_ERROR. The function may return
-early with STAP_RETURN. Here are some examples:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-function integer_ops (val) %{
- STAP_RETVALUE = STAP_ARG_val + 1;
- if (STAP_RETVALUE == 4)
- STAP_ERROR("wrong guess: %d", (int) STAP_RETVALUE);
- if (STAP_RETVALUE == 3)
- STAP_RETURN(0);
- STAP_RETVALUE ++;
-%}
-function string_ops (val) %{
- strlcpy (STAP_RETVALUE, STAP_ARG_val, MAXSTRINGLEN);
- strlcat (STAP_RETVALUE, "one", MAXSTRINGLEN);
- if (strcmp (STAP_RETVALUE, "three-two-one"))
- STAP_RETURN("parameter should be three-two-");
-%}
-function no_ops () %{
- STAP_RETURN(); /* function inferred with no return value */
-%}
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-The function argument and return value types have to be inferred by
-the translator from the call sites in order for this to work. The
-user should examine C code generated for ordinary script-language
-functions in order to write compatible embedded-C ones.
-<P>
-
-The last place where embedded code is permitted is as an expression rvalue.
-In this case, the C code enclosed between
-<I>%{</I> and <I>%}</I>
-
-markers is interpreted as an ordinary expression value. It is assumed
-to be a normal 64-bit signed number, unless the marker
-<I>/* string */</I>
-
-is included, in which case it's treated as a string.
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-function add_one (val) {
- return val + %{ 1 %}
-}
-function add_string_two (val) {
- return val . %{ /* string */ "two" %}
-}
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-
-The embedded-C code may contain markers to assert optimization
-and safety properties.
-<DL COMPACT>
-<DT><I>/* pure */</I>
-
-<DD>
-means that the C code has no side effects and may be elided entirely if its
-value is not used by script code.
-<DT><I>/* unprivileged */</I>
-
-<DD>
-means that the C code is so safe that even unprivileged users are permitted
-to use it.
-<DT><I>/* myproc-unprivileged */</I>
-
-<DD>
-means that the C code is so safe that even unprivileged users are permitted
-to use it, provided that the target of the current probe is within the user's
-own process.
-<DT><I>/* guru */</I>
-
-<DD>
-means that the C code is so unsafe that a systemtap user must specify
-<I>-g</I>
-
-(guru mode) to use this.
-<DT><I>/* unmangled */</I>
-
-<DD>
-in an embedded-C function, means that the legacy (pre-1.8) argument
-access syntax should be made available inside the function. Hence, in
-addition to
-<I>STAP_ARG_foo</I>
-
-and
-<I>STAP_RETVALUE</I>
-
-one can use
-<I>THIS->foo</I>
-
-and
-<I>THIS->__retvalue</I>
-
-respectively inside the function. This is useful for quickly migrating code written for SystemTap version 1.7 and earlier.
-<DT><I>/* string */</I>
-
-<DD>
-in embedded-C expressions only, means that the expression has
-<I>const char *</I>
-
-type and should be treated as a string value, instead of
-the default long numeric.
-<P>
-</DL>
-<A NAME="lbAU"> </A>
-<H3>BUILT-INS</H3>
-
-A set of builtin probe point aliases are provided
-by the scripts installed in the directory specified in the
-<I><A HREF="stappaths.7.html">stappaths</A></I>(7)
-
-manual page. The functions are described in the
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-manual page.
-<P>
-<A NAME="lbAV"> </A>
-<H2>PROCESSING</H2>
-
-The translator begins pass 1 by parsing the given input script,
-and all scripts (files named
-<I>*.stp</I>)
-
-found in a tapset directory. The directories listed
-with
-<B>-I</B>
-
-are processed in sequence, each processed in "guru mode". For each
-directory, a number of subdirectories are also searched. These
-subdirectories are derived from the selected kernel version (the
-<B>-R</B>
-
-option),
-in order to allow more kernel-version-specific scripts to override less
-specific ones. For example, for a kernel version
-<I>2.6.12-23.FC3</I>
-
-the following patterns would be searched, in sequence:
-<I>2.6.12-23.FC3/*.stp</I>,
-
-<I>2.6.12/*.stp</I>,
-
-<I>2.6/*.stp</I>,
-
-and finally
-<I>*.stp</I>.
-
-Stopping the translator after pass 1 causes it to print the parse trees.
-<P>
-<P>
-
-In pass 2, the translator analyzes the input script to resolve symbols
-and types. References to variables, functions, and probe aliases that
-are unresolved internally are satisfied by searching through the
-parsed tapset script files. If any tapset script file is selected
-because it defines an unresolved symbol, then the entirety of that
-file is added to the translator's resolution queue. This process
-iterates until all symbols are resolved and a subset of tapset script
-files is selected.
-<P>
-
-Next, all probe point descriptions are validated
-against the wide variety supported by the translator. Probe points that
-refer to code locations ("synchronous probe points") require the
-appropriate kernel debugging information to be installed. In the
-associated probe handlers, target-side variables (whose names begin
-with "$") are found and have their run-time locations decoded.
-<P>
-
-Next, all probes and functions are analyzed for optimization
-opportunities, in order to remove variables, expressions, and
-functions that have no useful value and no side-effect. Embedded-C
-functions are assumed to have side-effects unless they include the
-magic string
-<B>/* pure */</B>.
-
-Since this optimization can hide latent code errors such as type
-mismatches or invalid $context variables, it sometimes may be useful
-to disable the optimizations with the
-<B>-u</B>
-
-option.
-<P>
-
-Finally, all variable, function, parameter, array, and index types are
-inferred from context (literals and operators). Stopping the
-translator after pass 2 causes it to list all the probes, functions,
-and variables, along with all inferred types. Any inconsistent or
-unresolved types cause an error.
-<P>
-<P>
-
-In pass 3, the translator writes C code that represents the actions
-of all selected script files, and creates a
-<I>Makefile</I>
-
-to build that into a kernel object. These files are placed into a
-temporary directory. Stopping the translator at this point causes
-it to print the contents of the C file.
-<P>
-<P>
-
-In pass 4, the translator invokes the Linux kernel build system to
-create the actual kernel object file. This involves running
-<I>make</I>
-
-in the temporary directory, and requires a kernel module build
-system (headers, config and Makefiles) to be installed in the usual
-spot
-<I>/lib/modules/VERSION/build</I>.
-
-Stopping the translator after pass 4 is the last chance before
-running the kernel object. This may be useful if you want to
-archive the file.
-<P>
-<P>
-
-In pass 5, the translator invokes the systemtap auxiliary program
-<I>staprun</I>
-
-program for the given kernel object. This program arranges to load
-the module then communicates with it, copying trace data from the
-kernel into temporary files, until the user sends an interrupt signal.
-Any run-time error encountered by the probe handlers, such as running
-out of memory, division by zero, exceeding nesting or runtime limits,
-results in a soft error indication. Soft errors in excess of
-MAXERRORS block of all subsequent probes (except error-handling
-probes), and terminate the session. Finally,
-<I>staprun</I>
-
-unloads the module, and cleans up.
-<P>
-<A NAME="lbAW"> </A>
-<H3>ABNORMAL TERMINATION</H3>
-
-<P>
-One should avoid killing the stap process forcibly, for example with
-SIGKILL, because the stapio process (a child process of the stap
-process) and the loaded module may be left running on the system. If
-this happens, send SIGTERM or SIGINT to any remaining stapio
-processes, then use rmmod to unload the systemtap module.
-<P>
-<P>
-<A NAME="lbAX"> </A>
-<H2>EXAMPLES</H2>
-
-See the
-<I><A HREF="stapex.3stap.html">stapex</A></I>(3stap)
-
-manual page for a collection of samples.
-<P>
-<A NAME="lbAY"> </A>
-<H2>CACHING</H2>
-
-The systemtap translator caches the pass 3 output (the generated C
-code) and the pass 4 output (the compiled kernel module) if pass 4
-completes successfully. This cached output is reused if the same
-script is translated again assuming the same conditions exist (same kernel
-version, same systemtap version, etc.). Cached files are stored in
-the
-<I>$SYSTEMTAP_DIR/cache</I>
-
-directory. The cache can be limited by having the file
-<I>cache_mb_limit</I>
-
-placed in the cache directory (shown above) containing only an ASCII
-integer representing how many MiB the cache should not exceed. In the
-absence of this file, a default will be created with the limit set to 256MiB.
-This is a 'soft' limit in that the cache will be cleaned after a new entry
-is added if the cache clean interval is exceeded, so the total cache size may
-temporarily exceed this limit. This interval can be specified by having the
-file
-<I>cache_clean_interval_s</I>
-
-placed in the cache directory (shown above) containing only an ASCII integer
-representing the interval in seconds. In the absence of this file, a default
-will be created with the interval set to 30 s.
-<P>
-<A NAME="lbAZ"> </A>
-<H2>SAFETY AND SECURITY</H2>
-
-Systemtap is an administrative tool. It exposes kernel internal data
-structures and potentially private user information.
-<P>
-To actually run the kernel objects it builds, a user must be one of
-the following:
-<DL COMPACT>
-<DT>•<DD>
-the root user;
-<DT>•<DD>
-a member of the
-<I>stapdev</I>
-
-and
-<I>stapusr</I>
-
-groups;
-<DT>•<DD>
-a member of the
-<I>stapsys</I>
-
-and
-<I>stapusr</I>
-
-groups; or
-<DT>•<DD>
-a member of the
-<I>stapusr</I>
-
-group.
-</DL>
-<P>
-
-The root user or a user who is a member of both the
-<I>stapdev</I>
-
-and
-<I>stapusr</I>
-
-groups can build and run any systemtap script.
-<P>
-
-A user who is a member of both the
-<I>stapsys</I>
-
-and
-<I>stapusr</I>
-
-groups can only use pre-built modules under the following conditions:
-<DL COMPACT>
-<DT>•<DD>
-The module has been signed by a trusted signer. Trusted signers are normally
-systemtap compile-servers which sign modules when the <I>--privilege</I> option is
-specified by the client. See the
-<I><A HREF="stap-server.8.html">stap-server</A></I>(8)
-
-manual page for more information.
-<DT>•<DD>
-The module was built using the <I>--privilege=stapsys</I> or the <I>--privilege=stapusr</I>
-options.
-</DL>
-<P>
-
-Members of only the
-<I>stapusr</I>
-
-group can only use pre-built modules under the following conditions:
-<DL COMPACT>
-<DT>•<DD>
-The module is located in
-the /lib/modules/VERSION/systemtap directory. This directory
-must be owned by root and not be world writable.
-</DL>
-<P>
-
-or
-<DL COMPACT>
-<DT>•<DD>
-The module has been signed by a trusted signer. Trusted signers are normally
-systemtap compile-servers which sign modules when the <I>--privilege</I> option is
-specified by the client. See the
-<I><A HREF="stap-server.8.html">stap-server</A></I>(8)
-
-manual page for more information.
-<DT>•<DD>
-The module was built using the FI--privilege=stapusr option.
-</DL>
-<P>
-
-The kernel modules generated by
-<I>stap</I>
-
-program are run by the
-<I>staprun</I>
-
-program. The latter is a part of the Systemtap package, dedicated to
-module loading and unloading (but only in the white zone), and
-kernel-to-user data transfer. Since
-<I>staprun</I>
-
-does not perform any additional security checks on the kernel objects
-it is given, it would be unwise for a system administrator to add
-untrusted users to the
-<I>stapdev</I>
-
-or
-<I>stapusr</I>
-
-groups.
-<P>
-
-The translator asserts certain safety constraints. It aims to ensure
-that no handler routine can run for very long, allocate memory,
-perform unsafe operations, or in unintentionally interfere with the
-kernel. Uses of script global variables are automatically read/write
-locked as appropriate, to protect against manipulation by concurrent probe
-handlers. (Deadlocks are detected with timeouts. Use the
-<B>-t</B>
-
-flag to receive reports of excessive lock contention.) Use of guru mode
-constructs such as embedded C can violate these constraints, leading
-to kernel crash or data corruption.
-<P>
-
-The resource use limits are set by macros in the generated C code.
-These may be overridden with the
-<B>-D</B>
-
-flag. A selection of these is as follows:
-<DL COMPACT>
-<DT>MAXNESTING<DD>
-Maximum number of nested function calls. Default determined by
-script analysis, with a bonus 10 slots added for recursive
-scripts.
-<DT>MAXSTRINGLEN<DD>
-Maximum length of strings, default 128.
-<DT>MAXTRYLOCK<DD>
-Maximum number of iterations to wait for locks on global variables
-before declaring possible deadlock and skipping the probe, default 1000.
-<DT>MAXACTION<DD>
-Maximum number of statements to execute during any single probe hit
-(with interrupts disabled),
-default 1000.
-<DT>MAXACTION_INTERRUPTIBLE<DD>
-Maximum number of statements to execute during any single probe hit
-which is executed with interrupts enabled (such as begin/end probes),
-default (MAXACTION * 10).
-<DT>MAXBACKTRACE<DD>
-Maximum number of stack frames that will be be processed by the stap
-runtime unwinder as produced by the backtrace functions in the
-[u]context-unwind.stp tapsets, default 20.
-<DT>MAXMAPENTRIES<DD>
-Default maximum number of rows in any single global array, default 2048.
-Individual arrays may be declared with a larger or smaller limit instead:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-global big[10000],little[5]
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-or denoted with
-<I>%</I>
-
-to make them wrap-around automatically.
-<DT>MAXERRORS<DD>
-Maximum number of soft errors before an exit is triggered, default 0, which
-means that the first error will exit the script. Note that with the
-<B>--suppress-handler-errors</B>
-
-option, this limit is not enforced.
-<DT>MAXSKIPPED<DD>
-Maximum number of skipped probes before an exit is triggered, default 100.
-Running systemtap with -t (timing) mode gives more details about skipped
-probes. With the default -DINTERRUPTIBLE=1 setting, probes skipped due to
-reentrancy are not accumulated against this limit. Note that with the
-<B>--suppress-handler-errors</B>
-
-option, this limit is not enforced.
-<DT>MINSTACKSPACE<DD>
-Minimum number of free kernel stack bytes required in order to
-run a probe handler, default 1024. This number should be large enough
-for the probe handler's own needs, plus a safety margin.
-<DT>MAXUPROBES<DD>
-Maximum number of concurrently armed user-space probes (uprobes), default
-somewhat larger than the number of user-space probe points named in the script.
-This pool needs to be potentialy large because individual uprobe objects (about
-64 bytes each) are allocated for each process for each matching script-level probe.
-<DT>STP_MAXMEMORY<DD>
-Maximum amount of memory (in kilobytes) that the systemtap module
-should use, default unlimited. The memory size includes the size of
-the module itself, plus any additional allocations. This only tracks
-direct allocations by the systemtap runtime. This does not track
-indirect allocations (as done by kprobes/uprobes/etc. internals).
-<DT>STP_PROCFS_BUFSIZE<DD>
-Size of procfs probe read buffers (in bytes). Defaults to
-<I>MAXSTRINGLEN</I>.
-
-This value can be overridden on a per-procfs file basis using the
-procfs read probe
-<I>.maxsize(MAXSIZE)</I>
-
-parameter.
-</DL>
-<P>
-
-With scripts that contain probes on any interrupt path, it is possible that
-those interrupts may occur in the middle of another probe handler. The probe
-in the interrupt handler would be skipped in this case to avoid reentrance.
-To work around this issue, execute stap with the option
-<B>-DINTERRUPTIBLE=0</B>
-
-to mask interrupts throughout the probe handler. This does add some extra
-overhead to the probes, but it may prevent reentrance for common problem
-cases. However, probes in NMI handlers and in the callpath of the stap
-runtime may still be skipped due to reentrance.
-<P>
-<P>
-
-Multiple scripts can write data into a relay buffer concurrently. A host
-script provides an interface for accessing its relay buffer to guest scripts.
-Then, the output of the guests are merged into the output of the host.
-To run a script as a host, execute stap with
-<B>-DRELAYHOST[=name]</B>
-
-option. The
-<B>name</B>
-
-identifies your host script among several hosts.
-While running the host, execute stap with
-<B>-DRELAYGUEST[=name]</B>
-
-to add a guest script to the host.
-Note that you must unload guests before unloading a host. If there are some
-guests connected to the host, unloading the host will be failed.
-<P>
-<P>
-
-In case something goes wrong with
-<I>stap</I> or <I>staprun</I>
-
-after a probe has already started running, one may safely kill both
-user processes, and remove the active probe kernel module with
-<I>rmmod</I>.
-
-Any pending trace messages may be lost.
-<P>
-<P>
-
-In addition to the methods outlined above, the generated kernel module
-also uses overload processing to make sure that probes can't run for
-too long. If more than STP_OVERLOAD_THRESHOLD cycles (default
-500000000) have been spent in all the probes on a single cpu during
-the last STP_OVERLOAD_INTERVAL cycles (default 1000000000), the probes
-have overloaded the system and an exit is triggered.
-<P>
-
-By default, overload processing is turned on for all modules. If you
-would like to disable overload processing, define STP_NO_OVERLOAD (or
-its alias STAP_NO_OVERLOAD).
-<P>
-<A NAME="lbBA"> </A>
-<H2>UNPRIVILEGED USERS</H2>
-
-<P>
-Systemtap exposes kernel internal data
-structures and potentially private user information. Because of this, use of
-systemtap's full capabilities are restricted to root and to users who are
-members of the groups stapdev and stapusr.
-<P>
-However, a restricted set of systemtap's features can be made available to
-trusted, unprivileged users. These users are members of the group stapusr
-only, or members of the groups stapusr and stapsys.
-These users can load systemtap modules which have been compiled and
-certified by a trusted systemtap compile-server. See the descriptions of the
-options <I>--privilege</I> and <I>--use-server</I>. See
-<I>README.unprivileged</I> in the systemtap source code for information about
-setting up a trusted compile server.
-<P>
-The restrictions enforced when <I>--privilege=stapsys</I> is specified are designed
-to prevent unprivileged users from:
-<DL COMPACT><DT><DD>
-<DL COMPACT>
-<DT>•<DD>
-harming the system maliciously.
-</DL>
-</DL>
-
-<P>
-The restrictions enforced when <I>--privilege=stapusr</I> is specified are designed
-to prevent unprivileged users from:
-<DL COMPACT><DT><DD>
-<DL COMPACT>
-<DT>•<DD>
-harming the system maliciously.
-<DT>•<DD>
-gaining access to information which would not normally be available to an
-unprivileged user.
-<DT>•<DD>
-disrupting the performance of processes owned by other users of the system.
-Some overhead to the system in general is unavoidable since the
-unprivileged user's probes
-will be triggered at the appropriate times. What we would like to avoid is
-targeted interruption of another user's processes which would not normally be
-possible by an unprivileged user.
-</DL>
-</DL>
-
-<P>
-<A NAME="lbBB"> </A>
-<H3>PROBE RESTRICTIONS</H3>
-
-A member of the groups stapusr and stapsys may use all probe points.
-<P>
-
-A member of only the group stapusr may use only the following probes:
-<DL COMPACT><DT><DD>
-<DL COMPACT>
-<DT>•<DD>
-begin, <A HREF="../mann/begin.n.html">begin</A>(n)
-<DT>•<DD>
-end, <A HREF="../mann/end.n.html">end</A>(n)
-<DT>•<DD>
-<A HREF="../mann/error.n.html">error</A>(n)
-<DT>•<DD>
-never
-<DT>•<DD>
-process.*, where the target process is owned by the user.
-<DT>•<DD>
-timer.{jiffies,s,sec,ms,msec,us,usec,ns,nsec}(n)*
-<DT>•<DD>
-<A HREF="../mann/timer.hz.n.html">timer.hz</A>(n)
-</DL>
-</DL>
-
-<P>
-<A NAME="lbBC"> </A>
-<H3>SCRIPTING LANGUAGE RESTRICTIONS</H3>
-
-The following scripting language features are unavailable to all unprivileged users:
-<P>
-<DL COMPACT><DT><DD>
-<DL COMPACT>
-<DT>•<DD>
-any feature enabled by the Guru Mode (-g) option.
-<DT>•<DD>
-embedded C code.
-</DL>
-</DL>
-
-<P>
-<A NAME="lbBD"> </A>
-<H3>RUNTIME RESTRICTIONS</H3>
-
-The following runtime restrictions are placed upon all unprivileged users:
-<DL COMPACT><DT><DD>
-<DL COMPACT>
-<DT>•<DD>
-Only the default runtime code (see <I>-R</I>) may be used.
-</DL>
-</DL>
-
-<P>
-Additional restrictions are placed on members of only the group stapusr:
-<DL COMPACT><DT><DD>
-<DL COMPACT>
-<DT>•<DD>
-Probing of processes owned by other users is not permitted.
-<DT>•<DD>
-Access of kernel memory (read and write) is not permitted.
-</DL>
-</DL>
-
-<P>
-<A NAME="lbBE"> </A>
-<H3>COMMAND LINE OPTION RESTRICTIONS</H3>
-
-Some command line options provide access to features which must not be available
-to all unprivileged users:
-<P>
-<DL COMPACT><DT><DD>
-<DL COMPACT>
-<DT>•<DD>
--g may not be specified.
-<DT>•<DD>
-The following options may not be used by the compile-server client:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
- -a, -B, -D, -I, -r, -R
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-</DL>
-</DL>
-
-<P>
-<A NAME="lbBF"> </A>
-<H3>ENVIRONMENT RESTRICTIONS</H3>
-
-The following environment variables must not be set for all unprivileged users:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-SYSTEMTAP_RUNTIME
-SYSTEMTAP_TAPSET
-SYSTEMTAP_DEBUGINFO_PATH
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<A NAME="lbBG"> </A>
-<H3>TAPSET RESTRICTIONS</H3>
-
-In general, tapset functions are only available for members of the
-group stapusr when they do not gather information that an ordinary
-program running with that user's privileges would be denied access to.
-<P>
-There are two categories of unprivileged tapset functions. The first
-category consists of utility functions that are unconditionally
-available to all users; these include such things as:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-cpu:long ()
-exit ()
-str_replace:string (prnt_str:string, srch_str:string, rplc_str:string)
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-The second category consists of so-called
-<I>myproc-unprivileged</I>
-
-functions that can only gather information within their own
-processes. Scripts that wish to use these functions must test the
-result of the tapset function <I>is_myproc</I> and only call these
-functions if the result is 1. The script will exit immediately if any
-of these functions are called by an unprivileged user within a probe
-within a process which is not owned by that user. Examples of
-<I>myproc-unprivileged</I>
-
-functions include:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-print_usyms (stk:string)
-user_int:long (addr:long)
-usymname:string (addr:long)
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-A compile error is triggered when any function not in either of the
-above categories is used by members of only the group stapusr.
-<P>
-No other built-in tapset functions may be used by members of only the
-group stapusr.
-<P>
-<A NAME="lbBH"> </A>
-<H2>ALTERNATE RUNTIMES</H2>
-
-<P>
-As described above, systemtap's default runtime mode involves building and
-loading kernel modules, with various security tradeoffs presented. Systemtap
-now includes a new prototype backend, selected with <I>--runtime=dyninst</I>,
-which uses Dyninst to instrument a user's own processes at runtime. This
-backend does not use kernel modules, and does not require root privileges, but
-is restricted with respect to the kinds of probes and other constructs that a
-script may use.
-<P>
-The <I>dyninst</I> runtime operates in target-attach mode, so it does require
-a <I>-c COMMAND</I> or <I>-x PID</I> process. For example:
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-stap --runtime=dyninst -c 'stap -V' \
- -e 'probe process.function("main")
- { println("hi from dyninst!") }'
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-It may be necessary to disable a conflicting selinux check with
-
-<BR>
-
-<P>
-
-<DL COMPACT><DT><DD>
-<PRE>
-# setsebool allow_execstack 1
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<A NAME="lbBI"> </A>
-<H2>EXIT STATUS</H2>
-
-<P>
-The systemtap translator generally returns with a success code of 0 if
-the requested script was processed and executed successfully through
-the requested pass. Otherwise, errors may be printed to stderr and
-a failure code is returned. Use
-<I>-v</I>
-
-or
-<I>-vp N</I>
-
-to increase (global or per-pass) verbosity to identify the source of the
-trouble.
-<P>
-In listings mode
-(<I>-l</I> and <I>-L</I>),
-
-error messages are normally suppressed. A success code of 0 is returned
-if at least one matching probe was found.
-<P>
-A script executing in pass 5 that is interrupted with ^C / SIGINT is
-considered to be successful.
-<P>
-<A NAME="lbBJ"> </A>
-<H2>DEPRECATION</H2>
-
-<P>
-Over time, some features of the script language and the tapset library
-may undergo incompatible changes, so that a script written against
-an old version of systemtap may no longer run. In these cases, it may
-help to run systemtap with the
-<I>--compatible VERSION</I>
-
-flag, specifying the last known working version. Running
-systemtap with the
-<I>--check-version</I>
-
-flag will output a warning if any possible incompatible elements have
-been parsed. Deprecation historical details may be found in the NEWS file.
-<P>
-<A NAME="lbBK"> </A>
-<H2>FILES</H2>
-
-<DL COMPACT>
-<DT>Important files and their corresponding paths can be located in the <DD>
-stappaths (7) manual page.
-<P>
-</DL>
-<A NAME="lbBL"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap),
-<I>function::*</I>(3stap),
-<I>probe::*</I>(3stap),
-<I>tapset::*</I>(3stap),
-<I><A HREF="./error::reporting.7stap.html">error::reporting</A></I>(7stap),
-<I><A HREF="stappaths.7.html">stappaths</A></I>(7),
-<I><A HREF="staprun.8.html">staprun</A></I>(8),
-<I><A HREF="stapdyn.8.html">stapdyn</A></I>(8),
-<I><A HREF="stapvars.3stap.html">stapvars</A></I>(3stap),
-<I><A HREF="stapex.3stap.html">stapex</A></I>(3stap),
-<I><A HREF="stap-server.8.html">stap-server</A></I>(8),
-<I><A HREF="stap-prep.1.html">stap-prep</A></I>(1),
-<I><A HREF="awk.1.html">awk</A></I>(1),
-<I><A HREF="gdb.1.html">gdb</A></I>(1)
-
-</PRE><A NAME="lbBM"> </A>
-<H2>BUGS</H2>
-
-Use the Bugzilla link of the project web page or our mailing list.
-
-<B><A HREF="http://sourceware.org/systemtap/">http://sourceware.org/systemtap/</A></B>,<B><<A HREF="mailto:systemtap@sourceware.org">systemtap@sourceware.org</A>></B>.
-
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAE">OPTIONS</A><DD>
-<DT><A HREF="#lbAF">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAG">SCRIPT LANGUAGE</A><DD>
-<DL>
-<DT><A HREF="#lbAH">GENERAL SYNTAX</A><DD>
-<DT><A HREF="#lbAI">PREPROCESSING</A><DD>
-<DT><A HREF="#lbAJ">PREPROCESSOR MACROS</A><DD>
-<DT><A HREF="#lbAK">VARIABLES</A><DD>
-<DT><A HREF="#lbAL">STATEMENTS</A><DD>
-<DT><A HREF="#lbAM">EXPRESSIONS</A><DD>
-<DT><A HREF="#lbAN">REGULAR EXPRESSION MATCHING</A><DD>
-<DT><A HREF="#lbAO">PROBES</A><DD>
-<DT><A HREF="#lbAP">FUNCTIONS</A><DD>
-<DT><A HREF="#lbAQ">PRINTING</A><DD>
-<DT><A HREF="#lbAR">STATISTICS</A><DD>
-<DT><A HREF="#lbAS">TYPECASTING</A><DD>
-<DT><A HREF="#lbAT">EMBEDDED C</A><DD>
-<DT><A HREF="#lbAU">BUILT-INS</A><DD>
-</DL>
-<DT><A HREF="#lbAV">PROCESSING</A><DD>
-<DL>
-<DT><A HREF="#lbAW">ABNORMAL TERMINATION</A><DD>
-</DL>
-<DT><A HREF="#lbAX">EXAMPLES</A><DD>
-<DT><A HREF="#lbAY">CACHING</A><DD>
-<DT><A HREF="#lbAZ">SAFETY AND SECURITY</A><DD>
-<DT><A HREF="#lbBA">UNPRIVILEGED USERS</A><DD>
-<DL>
-<DT><A HREF="#lbBB">PROBE RESTRICTIONS</A><DD>
-<DT><A HREF="#lbBC">SCRIPTING LANGUAGE RESTRICTIONS</A><DD>
-<DT><A HREF="#lbBD">RUNTIME RESTRICTIONS</A><DD>
-<DT><A HREF="#lbBE">COMMAND LINE OPTION RESTRICTIONS</A><DD>
-<DT><A HREF="#lbBF">ENVIRONMENT RESTRICTIONS</A><DD>
-<DT><A HREF="#lbBG">TAPSET RESTRICTIONS</A><DD>
-</DL>
-<DT><A HREF="#lbBH">ALTERNATE RUNTIMES</A><DD>
-<DT><A HREF="#lbBI">EXIT STATUS</A><DD>
-<DT><A HREF="#lbBJ">DEPRECATION</A><DD>
-<DT><A HREF="#lbBK">FILES</A><DD>
-<DT><A HREF="#lbBL">SEE ALSO</A><DD>
-<DT><A HREF="#lbBM">BUGS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:25 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of STAPDYN</TITLE>
-</HEAD><BODY>
-<H1>STAPDYN</H1>
-Section: Maintenance Commands (8)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-stapdyn - systemtap dyninst runtime
-<P>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<BR>
-
-<B>stapdyn</B>
-
-[
-<I>OPTIONS</I>
-
-]
-<I>MODULE</I>
-
-[
-<I>MODULE-OPTIONS</I>
-
-]
-<P>
-<A NAME="lbAD"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-The
-<I>stapdyn</I>
-
-program is the dyninst back-end of the Systemtap tool. It expects a
-shared library produced by the front-end
-<I>stap</I>
-
-tool, when run with
-<I>--dyninst</I>.
-
-<P>
-<P>
-
-Splitting the systemtap tool into a front-end and a back-end allows a
-user to compile a systemtap script on a development machine that has
-the debugging information (need to compile the script) and then
-transfer the resulting shared objevct to a production machine that
-doesn't have any development tools or debugging information installed.
-<P>
-
-Please refer to stappaths (7) for the version number, or run
-rpm -q systemtap (fedora/red hat)
-apt-get -v systemtap (ubuntu)
-<P>
-<A NAME="lbAE"> </A>
-<H2>OPTIONS</H2>
-
-The
-<I>stapdyn</I>
-
-program supports the following options. Any other option
-prints a list of supported options.
-<DL COMPACT>
-<DT><B>-v</B>
-
-<DD>
-Verbose mode.
-<DT><B>-V</B>
-
-<DD>
-Print version number and exit.
-<DT><B>-w</B>
-
-<DD>
-Suppress warnings from the script.
-<DT><B>-c CMD</B>
-
-<DD>
-Command CMD will be run and the
-<I>stapdyn</I>
-
-program will exit when CMD
-does. The '_stp_target' variable will contain the pid for CMD.
-<DT><B>-x PID</B>
-
-<DD>
-The '_stp_target' variable will be set to PID.
-<DT><B>-o FILE</B>
-
-<DD>
-Send output to FILE. If the module uses bulk mode, the output will
-be in percpu files FILE_x(FILE_cpux in background and bulk mode)
-where 'x' is the cpu number. This supports <A HREF="strftime.3.html">strftime</A>(3) formats
-for FILE.
-<DT><B>-C WHEN</B>
-
-<DD>
-Control coloring of error messages. WHEN must be either
-
-"never", "always", or "auto"
-
-(i.e. enable only if at a terminal). If the option is missing, then "auto"
-is assumed. Colors can be modified using the SYSTEMTAP_COLORS environment
-variable. See the
-<I><A HREF="stap.1.html">stap</A></I>(1)
-
-manual page for more information on syntax and behaviour.
-<DT><B>var1=val</B>
-
-<DD>
-Sets the value of global variable var1 to val. Global variables contained
-within a script are treated as options and can be set from the
-stapdyn command line.
-<P>
-</DL>
-<A NAME="lbAF"> </A>
-<H2>ARGUMENTS</H2>
-
-<B>MODULE</B>
-
-is either a module path or a module name. If it is a module name,
-the module will be looked for in the following directory
-(where 'VERSION' is the output of "uname -r"):
-<DL COMPACT>
-<DT><DD>
-/lib/modules/VERSION/systemtap
-</DL>
-<P>
-
-<P>
- $ stap --dyninst -p4 -m mod1 -e 'global var1="foo"; probe begin{printf("%s\n", var1); exit()}'
-<BR>
-
-<P>
-
-Running this with an additional module argument:
-<P>
-
-<P>
- $ stapdyn mod1.so var1="HelloWorld"
-<BR>
-
- HelloWorld
-<P>
-
-Spaces and exclamation marks currently cannot be passed into global variables
-this way.
-<P>
-<A NAME="lbAG"> </A>
-<H2>EXAMPLES</H2>
-
-See the
-<I><A HREF="stapex.3stap.html">stapex</A></I>(3stap)
-
-manual page for a collection of sample scripts.
-<P>
-
-Here is a very basic example of how to use
-<I>stapdyn.</I>
-
-First, use
-<I>stap</I>
-
-to compile a script. The
-<I>stap</I>
-
-program will report the pathname to the resulting module.
-<P>
-
- $ stap --dyninst -p4 -e 'probe begin { printf("Hello World!\n"); exit() }'
-<BR>
-
- /home/user/.systemtap/cache/85/stap_8553d83f78c_265.so
-<P>
-
-Run
-<I>stapdyn</I>
-
-with the pathname to the module as an argument.
-<P>
-
- $ stapdyn /home/user/.systemtap/cache/85/stap_8553d83f78c_265.so
-<BR>
-
- Hello World!
-<P>
-<A NAME="lbAH"> </A>
-<H2>SAFETY AND SECURITY</H2>
-
-Systemtap, in DynInst mode, is a developer tool, and runs completely
-unprivileged. The Linux kernel will only permit one's own processes
-to be accessed, which is enforced by the
-<I><A HREF="ptrace.2.html">ptrace</A></I>(2)
-
-system call.
-See the
-<I><A HREF="stap.1.html">stap</A></I>(1)
-
-manual page for additional information on safety and security.
-<P>
-<A NAME="lbAI"> </A>
-<H2>SEE ALSO</H2>
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap),
-
-<I><A HREF="stap-server.8.html">stap-server</A></I>(8),
-
-<I><A HREF="staprun.8.html">staprun</A></I>(8),
-
-<I><A HREF="stapex.3stap.html">stapex</A></I>(3stap)
-
-<P>
-<A NAME="lbAJ"> </A>
-<H2>BUGS</H2>
-
-Use the Bugzilla link of the project web page or our mailing list.
-
-<B><A HREF="http://sourceware.org/systemtap/">http://sourceware.org/systemtap/</A></B>, <B><<A HREF="mailto:systemtap@sourceware.org">systemtap@sourceware.org</A>></B>.
-
-
-<P>
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAE">OPTIONS</A><DD>
-<DT><A HREF="#lbAF">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAG">EXAMPLES</A><DD>
-<DT><A HREF="#lbAH">SAFETY AND SECURITY</A><DD>
-<DT><A HREF="#lbAI">SEE ALSO</A><DD>
-<DT><A HREF="#lbAJ">BUGS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of STAPEX</TITLE>
-</HEAD><BODY>
-<H1>STAPEX</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-stapex - systemtap examples
-<P>
-
-
-
-<P>
-<A NAME="lbAC"> </A>
-<H2>LANGUAGE BASICS</H2>
-
-These examples give a feel for basic systemtap syntax and
-control structures.
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-global odds, evens
-
-probe begin {
- # "no" and "ne" are local integers
- for (i=0; i<10; i++) {
- if (i % 2) odds [no++] = i
- else evens [ne++] = i
- }
- delete odds[2]
- delete evens[3]
- exit ()
-}
-
-probe end {
- foreach (x+ in odds) {
- printf ("odds[%d] = %d, x, odds[x])
- }
- foreach (x in evens-) {
- printf ("evens[%d] = %d, x, evens[x])
- }
-}
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-This prints:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-odds[1] = 1
-odds[3] = 5
-odds[4] = 7
-odds[5] = 9
-evens[5] = 8
-evens[4] = 6
-evens[2] = 2
-evens[1] = 0
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-Note that all variables types are inferred, and that all locals
-and globals are automatically initialized.
-<P>
-<P>
-
-This script prints the primes between 0 and 49.
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-function isprime (x) {
- if (x < 2) return 0
- for (i=2; i<x; i++) {
- if (x % i == 0) return 0
- if (i * i > x) break
- }
- return 1
-}
-probe begin {
- for (i=0; i<50; i++)
- if (isprime (i)) printf("%d, i)
- exit()
-}
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<P>
-
-This script demonstrates recursive functions.
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-function fibonacci(i) {
- if (i < 1) error ("bad number")
- if (i == 1) return 1
- if (i == 2) return 2
- return fibonacci (i-1) + fibonacci (i-2)
-}
-probe begin {
- printf ("11th fibonacci number: %d, fibonacci (11))
- exit ()
-}
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-Any larger number may exceed the MAXACTION or MAXNESTING
-limits, and result in an error.
-<P>
-<P>
-<A NAME="lbAD"> </A>
-<H2>PROBING</H2>
-
-<P>
-To trace entry and exit from a function, use a pair of probes:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-probe kernel.function("sys_mkdir") { println ("enter") }
-probe kernel.function("sys_mkdir").return { println ("exit") }
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-To list the probeable functions in the kernel, use the listings mode.
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-% stap -l 'kernel.function("*")'
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-To list the probeable functions and local variables in the kernel, use another listings mode.
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-% stap -L 'kernel.function("*")'
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<A NAME="lbAE"> </A>
-<H2>MORE EXAMPLES</H2>
-
-<P>
-The directory to find more examples can be found in the stappaths (7) manual page,
-and online at
-
-<B><A HREF="http://sourceware.org/systemtap/examples/">http://sourceware.org/systemtap/examples/</A></B>
-
-
-<P>
-<A NAME="lbAF"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1)
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-<I><A HREF="stappaths.7.html">stappaths</A></I>(7)
-
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">LANGUAGE BASICS</A><DD>
-<DT><A HREF="#lbAD">PROBING</A><DD>
-<DT><A HREF="#lbAE">MORE EXAMPLES</A><DD>
-<DT><A HREF="#lbAF">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of STAPFUNCS</TITLE>
-</HEAD><BODY>
-<H1>STAPFUNCS</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-stapfuncs - systemtap functions
-<P>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-Functions in the standard systemtap tapset are individually documented
-in the
-<I>3stap</I>
-
-manual section, with the
-<I>function::</I>
-
-prefix. Some built-in functions such as
-<I>printf</I>
-
-are documented on the
-<I><A HREF="stap.1.html">stap</A></I>(1)
-
-man page.
-<P>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I>function::*</I>(3stap),
-<I>tapset::*</I>(3stap)
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of STAP</TITLE>
-</HEAD><BODY>
-<H1>STAP</H1>
-Section: Environments, Tables, and Troff Macros (7)<BR>Updated: Systemtap Team<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-<P>
-stappaths - systemtap configurable file paths
-<P>
-<P>
-
-
-
-<P>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-This manual page was generated on 2014-02-17 for systemtap 2.5.
-The following section will list the main paths in systemtap that are
-important to know and may be required to reference.
-<DL COMPACT>
-<DT>/home/fche/Private/DEVEL/DEVEL-systemtap/git/BUILD2/../INST2/share/systemtap/tapset/<DD>
-The directory for the standard probe-alias / function tapset library,
-unless overridden by the
-<I>SYSTEMTAP_TAPSET</I>
-
-environment variable or the
-<I>XDG_DATA_DIRS</I>
-
-environment variable.
-These are described in the
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap),
-
-<I>probe::*</I>(3stap),
-
-and
-<I>function::*</I>(3stap)
-
-manual pages.
-<DT>/home/fche/Private/DEVEL/DEVEL-systemtap/git/BUILD2/../INST2/share/systemtap/runtime/<DD>
-The runtime sources, unless overridden by the
-<I>SYSTEMTAP_RUNTIME</I>
-
-environment variable.
-<DT>/home/fche/Private/DEVEL/DEVEL-systemtap/git/BUILD2/../INST2/bin/staprun<DD>
-The auxiliary program supervising module loading, interaction, and
-unloading.
-<DT>${exec_prefix}/libexec/systemtap/stapio<DD>
-The auxiliary program for module input and output handling.
-<DT>/usr/include/sys/sdt.h<DD>
-Location of the <<A HREF="file:///usr/include/sys/sdt.h">sys/sdt.h</A>> headers.
-<DT>Kernel debuginfo Path: /usr/lib/debug/lib/modules/$(uname -r)/<DD>
-The location of kernel debugging information when packaged into the
-<I>kernel-debuginfo</I>
-
-RPM, unless overridden by the
-<I>SYSTEMTAP_DEBUGINFO_PATH</I>
-
-environment variable. The default value for this variable is
-<I>+:.debug:/usr/lib/debug:build</I>.
-
-elfutils searches vmlinux in this path and it interprets the path as a base
-directory of which various subdirectories will be searched for finding debuginfo
-for the kernel, kernel modules, and user-space binaries.
-By default, systemtap will also look for vmlinux in these locations:
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-/boot/vmlinux-`uname -r`
-/lib/modules/`uname -r`/vmlinux
-/lib/modules/`uname -r`/vmlinux.debug
-/lib/modules/`uname -r`/build/vmlinux
-/lib/modules/`uname -r`/.debug/vmlinux.debug
-/usr/lib/debug/lib/modules/`uname -r`/vmlinux.debug
-/var/cache/abrt-di/usr/debug/lib/modules/`uname -r`/
-/var/cache/abrt-di/usr/lib/debug/lib/modules/`uname -r`/vmlinux.debug
-
-
-</PRE>
-
-</DL>
-
-
-<DT><DD>
-<BR>
-Corresponding source files are usually located under /usr/src/debug/.
-Further file information on user-space applications can be determined per-basis using
-rpm -ql <package>-debuginfo. For supported user-space applications information please
-visit the systemtap wiki.
-<DT>$HOME/.systemtap<DD>
-Systemtap data directory for cached systemtap files, unless overridden
-by the
-<I>SYSTEMTAP_DIR</I>
-
-environment variable.
-<DT>/tmp/stapXXXXXX<DD>
-Temporary directory for systemtap files, including translated C code
-and kernel object.
-<DT>/lib/modules/VERSION/build<DD>
-The location of kernel module building infrastructure.
-<DT>/home/fche/Private/DEVEL/DEVEL-systemtap/git/BUILD2/../INST2/share/doc/systemtap*/examples<DD>
-Examples with greater detail can be found here. Each example comes with a .txt
-or .meta file explaining what the example, sample or demo does and how it is
-ordinarily run.
-<DT>$SYSTEMTAP_DIR/ssl/server<DD>
-User's server-side SSL certificate database. If SYSTEMTAP_DIR is not
-set, the default is $HOME/.systemtap.
-<DT>$SYSTEMTAP_DIR/ssl/client<DD>
-User's private client-side SSL certificate database. If SYSTEMTAP_DIR is not
-set, the default is $HOME/.systemtap.
-<DT>${prefix}/etc/systemtap/ssl/client<DD>
-Global client-side SSL certificate database.
-<DT>${prefix}/etc/systemtap/staprun/<DD>
-<I>staprun</I>'s trusted signer certificate database.
-<DT>${prefix}/etc/sysconfig/stap-server/<DD>
-stap-server service global configuration file.
-<DT>${prefix}/etc/stap-server/conf.d/*.conf<DD>
-stap-server service configuration files for default servers.
-<DT>/var/run/stap-server/<DD>
-stap-server service default location of status files for running servers.
-<DT>/var/log/stap-server/log<DD>
-stap-server service default log file.
-<P>
-<P>
-</DL>
-<P>
-
-<A NAME="lbAD"> </A>
-<H2>FILES</H2>
-
-
-<I>/home/fche/Private/DEVEL/DEVEL-systemtap/git/BUILD2/../INST2/share/systemtap/tapset</I>
-
-
-<P>
-<A NAME="lbAE"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap),
-<I><A HREF="staprun.8.html">staprun</A></I>(8),
-<I><A HREF="stapvars.3stap.html">stapvars</A></I>(3stap),
-<I><A HREF="stapex.3stap.html">stapex</A></I>(3stap),
-<I><A HREF="stap-server.8.html">stap-server</A></I>(8),
-<I><A HREF="awk.1.html">awk</A></I>(1),
-<I><A HREF="gdb.1.html">gdb</A></I>(1)
-
-
-</PRE><A NAME="lbAF"> </A>
-<H2>BUGS</H2>
-
-Use the Bugzilla link of the project web page or our mailing list.
-
-<B><A HREF="http://sourceware.org/systemtap/">http://sourceware.org/systemtap/</A></B>,<B><<A HREF="mailto:systemtap@sourceware.org">systemtap@sourceware.org</A>></B>.
-
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">FILES</A><DD>
-<DT><A HREF="#lbAE">SEE ALSO</A><DD>
-<DT><A HREF="#lbAF">BUGS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of STAPPROBES</TITLE>
-</HEAD><BODY>
-<H1>STAPPROBES</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-stapprobes - systemtap probe points
-<P>
-
-
-
-<P>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-The following sections enumerate the variety of probe points supported
-by the systemtap translator, and some of the additional aliases defined by
-standard tapset scripts. Many are individually documented in the
-<I>3stap</I>
-
-manual section, with the
-<I>probe::</I>
-
-prefix.
-<P>
-<A NAME="lbAD"> </A>
-<H2>SYNTAX</H2>
-
-<P>
-<P>
-
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>probe</B> PROBEPOINT [<B>,</B> PROBEPOINT] <B>{</B> [STMT ...] <B>}</B>
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-
-A probe declaration may list multiple comma-separated probe points in
-order to attach a handler to all of the named events. Normally, the
-handler statements are run whenever any of events occur.
-<P>
-
-The syntax of a single probe point is a general dotted-symbol
-sequence. This allows a breakdown of the event namespace into parts,
-somewhat like the Domain Name System does on the Internet. Each
-component identifier may be parametrized by a string or number
-literal, with a syntax like a function call. A component may include
-a "*" character, to expand to a set of matching probe points. It may
-also include "**" to match multiple sequential components at once.
-Probe aliases likewise expand to other probe points.
-<P>
-
-Probe aliases can be given on their own, or with a suffix. The suffix
-attaches to the underlying probe point that the alias is expanded
-to. For example,
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-syscall.read.return.maxactive(10)
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-expands to
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-kernel.function("sys_read").return.maxactive(10)
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-with the component
-<I>maxactive(10)</I>
-
-being recognized as a suffix.
-<P>
-
-Normally, each and every probe point resulting from wildcard- and
-alias-expansion must be resolved to some low-level system
-instrumentation facility (e.g., a kprobe address, marker, or a timer
-configuration), otherwise the elaboration phase will fail.
-<P>
-
-However, a probe point may be followed by a "?" character, to indicate
-that it is optional, and that no error should result if it fails to
-resolve. Optionalness passes down through all levels of
-alias/wildcard expansion. Alternately, a probe point may be followed
-by a "!" character, to indicate that it is both optional and
-sufficient. (Think vaguely of the Prolog cut operator.) If it does
-resolve, then no further probe points in the same comma-separated list
-will be resolved. Therefore, the "!" sufficiency mark only makes
-sense in a list of probe point alternatives.
-<P>
-
-Additionally, a probe point may be followed by a "if (expr)" statement, in
-order to enable/disable the probe point on-the-fly. With the "if" statement,
-if the "expr" is false when the probe point is hit, the whole probe body
-including alias's body is skipped. The condition is stacked up through
-all levels of alias/wildcard expansion. So the final condition becomes
-the logical-and of conditions of all expanded alias/wildcard. The expressions
-are necessarily restricted to global variables.
-<P>
-
-These are all
-<B>syntactically</B>
-
-valid probe points. (They are generally
-<B>semantically</B>
-
-invalid, depending on the contents of the tapsets, and the versions of
-kernel/user software installed.)
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-kernel.function("foo").return
-process("/bin/vi").statement(0x2222)
-end
-syscall.*
-syscall.*.return.maxactive(10)
-sys**open
-kernel.function("no_such_function") ?
-module("awol").function("no_such_function") !
-signal.*? if (switch)
-kprobe.function("foo")
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-Probes may be broadly classified into "synchronous" and
-"asynchronous". A "synchronous" event is deemed to occur when any
-processor executes an instruction matched by the specification. This
-gives these probes a reference point (instruction address) from which
-more contextual data may be available. Other families of probe points
-refer to "asynchronous" events such as timers/counters rolling over,
-where there is no fixed reference point that is related. Each probe
-point specification may match multiple locations (for example, using
-wildcards or aliases), and all them are then probed. A probe
-declaration may also contain several comma-separated specifications,
-all of which are probed.
-<P>
-<A NAME="lbAE"> </A>
-<H2>DWARF DEBUGINFO</H2>
-
-<P>
-Resolving some probe points requires DWARF debuginfo or "debug
-symbols" for the specific part being instrumented. For some others,
-DWARF is automatically synthesized on the fly from source code header
-files. For others, it is not needed at all. Since a systemtap script
-may use any mixture of probe points together, the union of their DWARF
-requirements has to be met on the computer where script compilation
-occurs. (See the <I>--use-server</I> option and the <B><A HREF="stap-server.8.html">stap-server</A>(8)</B> man page for information about the remote compilation facility,
-which allows these requirements to be met on a different machine.)
-<P>
-
-The following point lists many of the available probe point families,
-to classify them with respect to their need for DWARF debuginfo.
-<P>
-<TABLE>
-<TR VALIGN=top><TD><B>DWARF</B></TD><TD>NON-DWARF</TD><TD><BR></TD></TR>
-<TR VALIGN=top><TD></TD><TD></TD><TD><BR></TD></TR>
-<TR VALIGN=top><TD>kernel.function, .statement</TD><TD>kernel.mark</TD><TD><BR></TD></TR>
-<TR VALIGN=top><TD>module.function, .statement</TD><TD>process.mark, process.plt</TD><TD><BR></TD></TR>
-<TR VALIGN=top><TD>process.function, .statement</TD><TD>begin, end, error, never</TD><TD><BR></TD></TR>
-<TR VALIGN=top><TD>process.mark <I>(backup)</I></TD><TD>timer</TD><TD><BR></TD></TR>
-<TR VALIGN=top><TD></TD><TD>perf</TD><TD><BR></TD></TR>
-<TR VALIGN=top><TD></TD><TD>procfs</TD><TD><BR></TD></TR>
-<TR VALIGN=top><TD><B>AUTO-DWARF</B></TD><TD>kernel.statement.absolute</TD><TD><BR></TD></TR>
-<TR VALIGN=top><TD></TD><TD>kernel.data</TD><TD><BR></TD></TR>
-<TR VALIGN=top><TD>kernel.trace</TD><TD>kprobe.function</TD><TD><BR></TD></TR>
-<TR VALIGN=top><TD></TD><TD>process.statement.absolute</TD><TD><BR></TD></TR>
-<TR VALIGN=top><TD></TD><TD>process.begin, .end, .error</TD><TD><BR></TD></TR>
-</TABLE>
-
-<P>
-<A NAME="lbAF"> </A>
-<H2>PROBE POINT FAMILIES</H2>
-
-<P>
-<A NAME="lbAG"> </A>
-<H3>BEGIN/END/ERROR</H3>
-
-<P>
-The probe points
-<I>begin</I> and <I>end</I>
-
-are defined by the translator to refer to the time of session startup
-and shutdown. All "begin" probe handlers are run, in some sequence,
-during the startup of the session. All global variables will have
-been initialized prior to this point. All "end" probes are run, in
-some sequence, during the
-<I>normal</I>
-
-shutdown of a session, such as in the aftermath of an
-<I>exit ()</I>
-
-function call, or an interruption from the user. In the case of an
-error-triggered shutdown, "end" probes are not run. There are no
-target variables available in either context.
-<P>
-
-If the order of execution among "begin" or "end" probes is significant,
-then an optional sequence number may be provided:
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-begin(N)
-end(N)
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-The number N may be positive or negative. The probe handlers are run in
-increasing order, and the order between handlers with the same sequence
-number is unspecified. When "begin" or "end" are given without a
-sequence, they are effectively sequence zero.
-<P>
-The
-<I>error</I>
-
-probe point is similar to the
-<I>end</I>
-
-probe, except that each such probe handler run when the session ends
-after errors have occurred. In such cases, "end" probes are skipped,
-but each "error" probe is still attempted. This kind of probe can be
-used to clean up or emit a "final gasp". It may also be numerically
-parametrized to set a sequence.
-<P>
-<A NAME="lbAH"> </A>
-<H3>NEVER</H3>
-
-The probe point
-<I>never</I>
-
-is specially defined by the translator to mean "never". Its probe
-handler is never run, though its statements are analyzed for symbol /
-type correctness as usual. This probe point may be useful in
-conjunction with optional probes.
-<P>
-<A NAME="lbAI"> </A>
-<H3>SYSCALL and ND_SYSCALL</H3>
-
-<P>
-The
-<I>syscall.*</I> and <I>nd_syscall.*</I>
-
-aliases define several hundred probes, too many to
-detail here. They are of the general form:
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-syscall.NAME
-<BR>
-nd_syscall.NAME
-<BR>
-syscall.NAME.return
-<BR>
-nd_syscall.NAME.return
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-Generally, a pair of probes are defined for each normal system call as listed in the
-<I><A HREF="syscalls.2.html">syscalls</A>(2)</I>
-
-manual page, one for entry and one for return. Those system calls that never
-return do not have a corresponding
-<I>.return</I>
-
-probe. The nd_* family of probes are about the same, except it uses
-<B>non-DWARF</B>
-
-based searching mechanisms, which may result in a lower quality of symbolic
-context data (parameters), and may miss some system calls. You may want to
-try them first, in case kernel debugging information is not immediately available.
-<P>
-
-Each probe alias provides a variety of variables. Looking at the tapset source
-code is the most reliable way. Generally, each variable listed in the standard
-manual page is made available as a script-level variable, so
-<I>syscall.open</I>
-
-exposes
-<I>filename</I>, <I>flags</I>, and <I>mode</I>.
-
-In addition, a standard suite of variables is available at most aliases:
-<DL COMPACT>
-<DT><I>argstr</I>
-
-<DD>
-A pretty-printed form of the entire argument list, without parentheses.
-<DT><I>name</I>
-
-<DD>
-The name of the system call.
-<DT><I>retstr</I>
-
-<DD>
-For return probes, a pretty-printed form of the system-call result.
-</DL>
-<P>
-
-As usual for probe aliases, these variables are all simply initialized
-once from the underlying $context variables, so that later changes to
-$context variables are not automatically reflected. Not all probe
-aliases obey all of these general guidelines. Please report any
-bothersome ones you encounter as a bug.
-<P>
-
-If debuginfo availability is a problem, you may try using the
-non-DWARF syscall probe aliases instead. Use the
-<I>nd_syscall.</I>
-
-prefix instead of
-<I>syscall.</I>
-
-The same context variables are available, as far as possible.
-<P>
-<A NAME="lbAJ"> </A>
-<H3>TIMERS</H3>
-
-<P>
-Intervals defined by the standard kernel "jiffies" timer may be used
-to trigger probe handlers asynchronously. Two probe point variants
-are supported by the translator:
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-timer.jiffies(N)
-timer.jiffies(N).randomize(M)
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-The probe handler is run every N jiffies (a kernel-defined unit of
-time, typically between 1 and 60 ms). If the "randomize" component is
-given, a linearly distributed random value in the range [-M..+M] is
-added to N every time the handler is run. N is restricted to a
-reasonable range (1 to around a million), and M is restricted to be
-smaller than N. There are no target variables provided in either
-context. It is possible for such probes to be run concurrently on
-a multi-processor computer.
-<P>
-
-Alternatively, intervals may be specified in units of time.
-There are two probe point variants similar to the jiffies timer:
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-timer.ms(N)
-timer.ms(N).randomize(M)
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-Here, N and M are specified in milliseconds, but the full options for units
-are seconds (s/sec), milliseconds (ms/msec), microseconds (us/usec),
-nanoseconds (ns/nsec), and hertz (hz). Randomization is not supported for
-hertz timers.
-<P>
-The actual resolution of the timers depends on the target kernel. For
-kernels prior to 2.6.17, timers are limited to jiffies resolution, so
-intervals are rounded up to the nearest jiffies interval. After 2.6.17,
-the implementation uses hrtimers for tighter precision, though the actual
-resolution will be arch-dependent. In either case, if the "randomize"
-component is given, then the random value will be added to the interval
-before any rounding occurs.
-<P>
-
-Profiling timers are also available to provide probes that execute on
-all CPUs at the rate of the system tick (CONFIG_HZ). This probe takes
-no parameters. On some kernels, this is a one-concurrent-user-only or
-disabled facility, resulting in error -16 (EBUSY) during probe
-registration.
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-timer.profile.tick
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-Full context information of the interrupted process is available, making
-this probe suitable for a time-based sampling profiler.
-<P>
-
-It is recommended to use the tapset probe
-<I>timer.profile</I>
-
-rather than timer.profile.tick. This probe point behaves identically
-to timer.profile.tick when the underlying functionality is available,
-and falls back to using perf.sw.cpu_clock on some recent kernels which
-lack the corresponding profile timer facility.
-<P>
-<A NAME="lbAK"> </A>
-<H3>DWARF</H3>
-
-<P>
-This family of probe points uses symbolic debugging information for
-the target kernel/module/program, as may be found in unstripped
-executables, or the separate
-<I>debuginfo</I>
-
-packages. They allow placement of probes logically into the execution
-path of the target program, by specifying a set of points in the
-source or object code. When a matching statement executes on any
-processor, the probe handler is run in that context.
-<P>
-
-Probe points in the DWARF family can be identified by the target kernel
-module (or user process), source file, line number, function name, or
-some combination of these.
-<P>
-
-Here is a list of DWARF probe points currently supported:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-kernel.function(PATTERN)
-kernel.function(PATTERN).call
-kernel.function(PATTERN).callee(PATTERN)
-kernel.function(PATTERN).callees(DEPTH)
-kernel.function(PATTERN).return
-kernel.function(PATTERN).inline
-kernel.function(PATTERN).label(LPATTERN)
-module(MPATTERN).function(PATTERN)
-module(MPATTERN).function(PATTERN).call
-module(MPATTERN).function(PATTERN).callee(PATTERN)
-module(MPATTERN).function(PATTERN).callees(DEPTH)
-module(MPATTERN).function(PATTERN).return
-module(MPATTERN).function(PATTERN).inline
-module(MPATTERN).function(PATTERN).label(LPATTERN)
-kernel.statement(PATTERN)
-kernel.statement(ADDRESS).absolute
-module(MPATTERN).statement(PATTERN)
-process("PATH").function("NAME")
-process("PATH").statement("*@FILE.c:123")
-process("PATH").library("PATH").function("NAME")
-process("PATH").library("PATH").statement("*@FILE.c:123")
-process("PATH").function("*").return
-process("PATH").function("myfun").label("foo")
-process("PATH").function("foo").callee("bar")
-process("PATH").function("foo").callees(DEPTH)
-process(PID).statement(ADDRESS).absolute
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-(See the USER-SPACE section below for more information on the process
-probes.)
-<P>
-
-The list above includes multiple variants and modifiers which provide
-additional functionality or filters. They are:
-<DL COMPACT><DT><DD>
-<DL COMPACT>
-<DT><B>.function</B><DD>
-Places a probe near the beginning of the named function, so that
-parameters are available as context variables.
-<DT><B>.return</B><DD>
-Places a probe at the moment <B>after</B> the return from the named
-function, so the return value is available as the "$return" context
-variable.
-<DT><B>.inline</B><DD>
-Filters the results to include only instances of inlined functions. Note
-that inlined functions do not have an identifiable return point, so
-<B>.return</B> is not supported on <B>.inline</B> probes.
-<DT><B>.call</B><DD>
-Filters the results to include only non-inlined functions (the opposite
-set of <B>.inline</B>)
-<DT><B>.exported</B><DD>
-Filters the results to include only exported functions.
-<DT><B>.statement</B><DD>
-Places a probe at the exact spot, exposing those local variables that
-are visible there.
-<DT><B>.callee</B><DD>
-Places a probe on the callee function given in the <B>.callee</B>
-modifier, where the callee must be a function called by the target
-function given in <B>.function</B>. The advantage of doing this over
-directly probing the callee function is that this probe point is run
-only when the callee is called from the target function (add the
--DSTAP_CALLEE_MATCHALL directive to override this when calling
-<B><A HREF="stap.1.html">stap</A></B>(1)).
-<P>
-Note that only callees that can be statically determined are available.
-For example, calls through function pointers are not available.
-Additionally, calls to functions located in other objects (e.g.
-libraries) are not available (instead use another probe point). This
-feature will only work for code compiled with GCC 4.7+.
-<DT><B>.callees</B><DD>
-Shortcut for <B>.callee("*")</B>, which places a probe on all callees of
-the function.
-<DT><B>.callees</B>(DEPTH)<DD>
-Recursively places probes on callees. For example, <B><A HREF=".callees.2.html">.callees</A>(2)</B>
-will probe both callees of the target function, as well as callees of
-those callees. And <B><A HREF=".callees.3.html">.callees</A>(3)</B> goes one level deeper, etc...
-A callee probe at depth N is only triggered when the N callers in the
-callstack match those that were statically determined during analysis
-(this also may be overriden using -DSTAP_CALLEE_MATCHALL).
-</DL>
-</DL>
-
-<P>
-
-In the above list of probe points, MPATTERN stands for a string literal
-that aims to identify the loaded kernel module of interest and LPATTERN
-stands for a source program label. Both MPATTERN and LPATTERN may
-include the "*" "[]", and "?" wildcards.
-PATTERN stands for a string literal that
-aims to identify a point in the program. It is made up of three
-parts:
-<DL COMPACT>
-<DT>•<DD>
-The first part is the name of a function, as would appear in the
-<I>nm</I>
-
-program's output. This part may use the "*" and "?" wildcarding
-operators to match multiple names.
-<DT>•<DD>
-The second part is optional and begins with the "@" character.
-It is followed by the path to the source file containing the function,
-which may include a wildcard pattern, such as mm/slab*.
-If it does not match as is, an implicit "*/" is optionally added
-<I>before</I>
-
-the pattern, so that a script need only name the last few components
-of a possibly long source directory path.
-<DT>•<DD>
-Finally, the third part is optional if the file name part was given,
-and identifies the line number in the source file preceded by a ":"
-or a "+". The line number is assumed to be an
-absolute line number if preceded by a ":", or relative to the entry of
-the function if preceded by a "+".
-All the lines in the function can be matched with ":*".
-A range of lines x through y can be matched with ":x-y".
-</DL>
-<P>
-
-As an alternative, PATTERN may be a numeric constant, indicating an
-address. Such an address may be found from symbol tables of the
-appropriate kernel / module object file. It is verified against
-known statement code boundaries, and will be relocated for use at
-run time.
-<P>
-
-In guru mode only, absolute kernel-space addresses may be specified with
-the ".absolute" suffix. Such an address is considered already relocated,
-as if it came from
-<B>/proc/kallsyms</B>,
-
-so it cannot be checked against statement/instruction boundaries.
-<A NAME="lbAL"> </A>
-<H3>CONTEXT VARIABLES</H3>
-
-<P>
-<P>
-
-Many of the source-level context variables, such as function parameters,
-locals, globals visible in the compilation unit, may be visible to
-probe handlers. They may refer to these variables by prefixing their
-name with "$" within the scripts. In addition, a special syntax
-allows limited traversal of structures, pointers, and arrays. More
-syntax allows pretty-printing of individual variables or their groups.
-See also
-<B>@cast</B>.
-
-Note that variables may be inaccessible due to them being paged out,
-or for a few other reasons. See also man
-<I><A HREF="./error::fault.7stap.html">error::fault</A></I>(7stap).
-
-<P>
-<DL COMPACT>
-<DT>$var<DD>
-refers to an in-scope variable "var". If it's an integer-like type,
-it will be cast to a 64-bit int for systemtap script use. String-like
-pointers (char *) may be copied to systemtap string values using the
-<I>kernel_string</I> or <I>user_string</I>
-
-functions.
-<DT>@var("varname")<DD>
-an alternative syntax for
-<I>$varname</I>
-
-<DT>@var("varname@src/file.c")<DD>
-refers to the global (either file local or external) variable
-<I>varname</I>
-
-defined when the file
-<I>src/file.c</I>
-
-was compiled. The CU in which the variable is resolved is the first CU
-in the module of the probe point which matches the given file name at
-the end and has the shortest file name path (e.g. given
-<I>@var(foo@bar/baz.c)</I>
-
-and CUs with file name paths
-<I>src/sub/module/bar/baz.c</I>
-
-and
-<I>src/bar/baz.c</I>
-
-the second CU will be chosen to resolve the (file) global variable
-<I>foo</I>
-
-<DT>$var->field traversal via a structure's or a pointer's field. This<DD>
-generalized indirection operator may be repeated to follow more
-levels. Note that the
-<I>.</I>
-
-operator is not used for plain structure
-members, only
-<I>-></I>
-
-for both purposes. (This is because "." is reserved for string
-concatenation.)
-<DT>$return<DD>
-is available in return probes only for functions that are declared
-with a return value.
-<DT>$var[N]<DD>
-indexes into an array. The index given with a literal number or even
-an arbitrary numeric expression.
-</DL>
-<P>
-
-A number of operators exist for such basic context variable expressions:
-<DL COMPACT>
-<DT>$$vars<DD>
-expands to a character string that is equivalent to
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-sprintf("parm1=%x ... parmN=%x var1=%x ... varN=%x",
- parm1, ..., parmN, var1, ..., varN)
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-for each variable in scope at the probe point. Some values may be
-printed as
-<I>=?</I>
-
-if their run-time location cannot be found.
-<DT>$$locals<DD>
-expands to a subset of $$vars for only local variables.
-<DT>$$parms<DD>
-expands to a subset of $$vars for only function parameters.
-<DT>$$return<DD>
-is available in return probes only. It expands to a string that
-is equivalent to sprintf("return=%x", $return)
-if the probed function has a return value, or else an empty string.
-<DT>& $EXPR<DD>
-expands to the address of the given context variable expression, if it
-is addressable.
-<DT>@defined($EXPR)<DD>
-expands to 1 or 0 iff the given context variable expression is resolvable,
-for use in conditionals such as
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-@defined($foo->bar) ? $foo->bar : 0
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<DT>$EXPR$<DD>
-expands to a string with all of $EXPR's members, equivalent to
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-sprintf("{.a=%i, .b=%u, .c={...}, .d=[...]}",
- $EXPR->a, $EXPR->b)
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<DT>$EXPR$$<DD>
-expands to a string with all of $var's members and submembers, equivalent to
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-sprintf("{.a=%i, .b=%u, .c={.x=%p, .y=%c}, .d=[%i, ...]}",
- $EXPR->a, $EXPR->b, $EXPR->c->x, $EXPR->c->y, $EXPR->d[0])
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-</DL>
-<A NAME="lbAM"> </A>
-<H3>MORE ON RETURN PROBES</H3>
-
-<P>
-<P>
-
-For the kernel ".return" probes, only a certain fixed number of
-returns may be outstanding. The default is a relatively small number,
-on the order of a few times the number of physical CPUs. If many
-different threads concurrently call the same blocking function, such
-as <A HREF="futex.2.html">futex</A>(2) or <A HREF="read.2.html">read</A>(2), this limit could be exceeded, and skipped
-"kretprobes" would be reported by "stap -t". To work around this,
-specify a
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-probe FOO.return.maxactive(NNN)
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-suffix, with a large enough NNN to cover all expected concurrently blocked
-threads. Alternately, use the
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-stap -DKRETACTIVE=NNNN
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-stap command line macro setting to override the default for all
-".return" probes.
-<P>
-<P>
-
-For ".return" probes, context variables other than the "$return" may
-be accessible, as a convenience for a script programmer wishing to
-access function parameters. These values are <B>snapshots</B>
-taken at the time of function entry. Local variables within the
-function are <B>not</B> generally accessible, since those variables did
-not exist in allocated/initialized form at the snapshot moment.
-<P>
-
-In addition, arbitrary entry-time expressions can also be saved for
-".return" probes using the
-<I>@entry(expr)</I>
-
-operator. For example, one can compute the elapsed time of a function:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-probe kernel.function("do_filp_open").return {
- println( get_timeofday_us() - @entry(get_timeofday_us()) )
-}
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<P>
-
-The following table summarizes how values related to a function
-parameter context variable, a pointer named <B>addr</B>, may be
-accessed from a
-<I>.return</I>
-
-probe.
-
-<TABLE>
-<TR VALIGN=top><TD><B>at-entry value</B></TD><TD>past-exit value</TD><TD><BR></TD></TR>
-<TR VALIGN=top><TD></TD><TD></TD><TD><BR></TD></TR>
-<TR VALIGN=top><TD>$addr</TD><TD><I>not available</I></TD><TD><BR></TD></TR>
-<TR VALIGN=top><TD>$addr->x->y</TD><TD>@cast(@entry($addr),"struct zz")->x->y</TD><TD><BR></TD></TR>
-<TR VALIGN=top><TD>$addr[0]</TD><TD>{kernel,user}_{char,int,...}(& $addr[0])</TD><TD><BR></TD></TR>
-</TABLE>
-
-<P>
-<P>
-<A NAME="lbAN"> </A>
-<H3>DWARFLESS</H3>
-
-In absence of debugging information, entry & exit points of kernel & module
-functions can be probed using the "kprobe" family of probes.
-However, these do not permit looking up the arguments / local variables
-of the function.
-Following constructs are supported :
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-kprobe.function(FUNCTION)
-kprobe.function(FUNCTION).call
-kprobe.function(FUNCTION).return
-kprobe.module(NAME).function(FUNCTION)
-kprobe.module(NAME).function(FUNCTION).call
-kprobe.module(NAME).function(FUNCTION).return
-kprobe.statement.(ADDRESS).absolute
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-
-Probes of type
-<B>function</B>
-
-are recommended for kernel functions, whereas probes of type
-<B>module</B>
-
-are recommended for probing functions of the specified module.
-In case the absolute address of a kernel or module function is known,
-<B>statement</B>
-
-probes can be utilized.
-<P>
-
-Note that
-<I>FUNCTION</I>
-
-and
-<I>MODULE</I>
-
-names
-<B>must not</B>
-
-contain wildcards, or the probe will not be registered.
-Also, statement probes must be run under guru-mode only.
-<P>
-<P>
-<A NAME="lbAO"> </A>
-<H3>USER-SPACE</H3>
-
-Support for user-space probing is available for kernels that are
-configured with the utrace extensions, or have the uprobes facility in
-linux 3.5. (Various kernel build configuration options need to be
-enabled; systemtap will advise if these are missing.)
-<P>
-<P>
-
-There are several forms. First, a non-symbolic probe point:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-process(PID).statement(ADDRESS).absolute
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-is analogous to
-
-kernel.statement(ADDRESS).absolute
-in that both use raw (unverified) virtual addresses and provide
-no $variables. The target PID parameter must identify a running
-process, and ADDRESS should identify a valid instruction address.
-All threads of that process will be probed.
-<P>
-
-Second, non-symbolic user-kernel interface events handled by
-utrace may be probed:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-process(PID).begin
-process("FULLPATH").begin
-process.begin
-process(PID).thread.begin
-process("FULLPATH").thread.begin
-process.thread.begin
-process(PID).end
-process("FULLPATH").end
-process.end
-process(PID).thread.end
-process("FULLPATH").thread.end
-process.thread.end
-process(PID).syscall
-process("FULLPATH").syscall
-process.syscall
-process(PID).syscall.return
-process("FULLPATH").syscall.return
-process.syscall.return
-process(PID).insn
-process("FULLPATH").insn
-process(PID).insn.block
-process("FULLPATH").insn.block
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-
-A
-<B>.begin</B>
-
-probe gets called when new process described by PID or FULLPATH gets created.
-A
-<B>.thread.begin</B>
-
-probe gets called when a new thread described by PID or FULLPATH gets created.
-A
-<B>.end</B>
-
-probe gets called when process described by PID or FULLPATH dies.
-A
-<B>.thread.end</B>
-
-probe gets called when a thread described by PID or FULLPATH dies.
-A
-<B>.syscall</B>
-
-probe gets called when a thread described by PID or FULLPATH makes a
-system call. The system call number is available in the
-<B>$syscall</B>
-
-context variable, and the first 6 arguments of the system call
-are available in the
-<B>$argN</B>
-
-(ex. $arg1, $arg2, ...) context variable.
-A
-<B>.syscall.return</B>
-
-probe gets called when a thread described by PID or FULLPATH returns from a
-system call. The system call number is available in the
-<B>$syscall</B>
-
-context variable, and the return value of the system call is available
-in the
-<B>$return</B>
-
-context variable.
-A
-<B>.insn</B>
-
-probe gets called for every single-stepped instruction of the process described by PID or FULLPATH.
-A
-<B>.insn.block</B>
-
-probe gets called for every block-stepped instruction of the process described by PID or FULLPATH.
-<P>
-
-If a process probe is specified without a PID or FULLPATH, all user
-threads will be probed. However, if systemtap was invoked with the
-<I>-c</I> or <I>-x</I>
-
-options, then process probes are restricted to the process
-hierarchy associated with the target process. If a process probe is
-specified without a PID or FULLPATH, but with the
-<I>-c</I>
-
-option, the PATH of the
-<I>-c</I>
-
-cmd will be heuristically filled into the process PATH.
-<P>
-<P>
-
-Third, symbolic static instrumentation compiled into programs and
-shared libraries may be
-probed:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-process("PATH").mark("LABEL")
-process("PATH").provider("PROVIDER").mark("LABEL")
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-
-A
-<B>.mark</B>
-
-probe gets called via a static probe which is defined in the
-application by STAP_PROBE1(PROVIDER,LABEL,arg1), which are macros defined in
-<B>sys/sdt.h</B>.
-
-The PROVIDER is an arbitrary application identifier, LABEL is the
-marker site identifier, and arg1 is the integer-typed argument.
-STAP_PROBE1 is used for probes with 1 argument, STAP_PROBE2 is used
-for probes with 2 arguments, and so on. The arguments of the probe
-are available in the context variables $arg1, $arg2, ... An
-alternative to using the STAP_PROBE macros is to use the dtrace script
-to create custom macros. Additionally, the variables $$name and
-$$provider are available as parts of the probe point name. The
-<B>sys/sdt.h </B>
-
-macro names DTRACE_PROBE* are available as aliases for STAP_PROBE*.
-<P>
-<P>
-
-Finally, full symbolic source-level probes in user-space programs and
-shared libraries are supported. These are exactly analogous to the
-symbolic DWARF-based kernel/module probes described above. They
-expose the same sorts of context $variables for function parameters,
-local variables, and so on.
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-process("PATH").function("NAME")
-process("PATH").statement("*@FILE.c:123")
-process("PATH").plt("NAME")
-process("PATH").library("PATH").plt("NAME")
-process("PATH").library("PATH").function("NAME")
-process("PATH").library("PATH").statement("*@FILE.c:123")
-process("PATH").function("*").return
-process("PATH").function("myfun").label("foo")
-process("PATH").function("foo").callee("bar")
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<P>
-
-Note that for all process probes,
-<I>PATH</I>
-
-names refer to executables that are searched the same way shells do: relative
-to the working directory if they contain a "/" character, otherwise in
-<B>$PATH</B>.
-
-If PATH names refer to scripts, the actual interpreters (specified in the
-script in the first line after the #! characters) are probed.
-If PATH is a process component parameter referring to shared libraries
-then all processes that map it at runtime would be selected for
-probing. If PATH is a library component parameter referring to shared
-libraries then the process specified by the process component would be
-selected.
-<P>
-<P>
-
-A .plt probe will probe functions in the program linkage table
-corresponding to the rest of the probe point. .plt can be specified
-as a shorthand for .plt("*"). The symbol name is available as a
-$$name context variable; function arguments are not available, since
-PLTs are processed without debuginfo.
-<P>
-<P>
-
-If the PATH string contains wildcards as in the MPATTERN case, then
-standard globbing is performed to find all matching paths. In this
-case, the
-<B>$PATH</B>
-
-environment variable is not used.
-<P>
-<P>
-
-If systemtap was invoked with the
-<I>-c</I> or <I>-x</I>
-
-options, then process probes are restricted to the process
-hierarchy associated with the target process.
-<P>
-<A NAME="lbAP"> </A>
-<H3>JAVA</H3>
-
-Support for probing Java methods is available using Byteman as a
-backend. Byteman is an instrumentation tool from the JBoss project
-which systemtap can use to monitor invocations for a specific method
-or line in a Java program.
-<P>
-
-Systemtap does so by generating a Byteman script listing the probes to
-instrument and then invoking the Byteman
-<I>bminstall</I>
-
-utility.
-<P>
-
-This Java instrumentation support is currently a prototype feature
-with major limitations. Moreover, Java probing currently does not
-work across users; the stap script must run (with appropriate
-permissions) under the same user that the Java process being
-probed. (Thus a stap script under root currently cannot probe Java
-methods in a non-root-user Java process.)
-<P>
-<P>
-
-The first probe type refers to Java processes by the name of the Java process:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-java("PNAME").class("CLASSNAME").method("PATTERN")
-java("PNAME").class("CLASSNAME").method("PATTERN").return
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-The PNAME argument must be a pre-existing jvm pid, and be identifiable
-via a jps listing.
-<P>
-
-The PATTERN parameter specifies the signature of the Java method to
-probe. The signature must consist of the exact name of the method,
-followed by a bracketed list of the types of the arguments, for
-instance "myMethod(int,double,Foo)". Wildcards are not supported.
-<P>
-
-The probe can be set to trigger at a specific line within the method
-by appending a line number with colon, just as in other types of
-probes: "myMethod(int,double,Foo):245".
-<P>
-
-The CLASSNAME parameter identifies the Java class the method belongs
-to, either with or without the package qualification. By default, the
-probe only triggers on descendants of the class that do not override
-the method definition of the original class. However, CLASSNAME can
-take an optional caret prefix, as in
-<I>^org.my.MyClass,</I>
-
-which specifies that the probe should also trigger on all descendants
-of MyClass that override the original method. For instance, every method
-with signature foo(int) in program org.my.MyApp can be probed at once using
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-java("org.my.MyApp").class("^java.lang.Object").method("foo(int)")
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-
-The second probe type works analogously, but refers to Java processes by PID:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-java(PID).class("CLASSNAME").method("PATTERN")
-java(PID).class("CLASSNAME").method("PATTERN").return
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-(PIDs for an already running process can be obtained using the
-<I><A HREF="jps.1.html">jps</A></I>(1)
-
-utility.)
-<P>
-
-Context variables defined within java probes include
-<I>$arg1</I>
-
-through
-<I>$arg10</I>
-
-(for up to the first 10 arguments of a method), represented as integers or strings.
-<P>
-<A NAME="lbAQ"> </A>
-<H3>PROCFS</H3>
-
-<P>
-These probe points allow procfs "files" in
-/proc/systemtap/MODNAME to be created, read and written using a
-permission that may be modified using the proper umask value. Default permissions are 0400 for read
-probes, and 0200 for write probes. If both a read and write probe are being
-used on the same file, a default permission of 0600 will be used.
-Using procfs.umask(0040).read would
-result in a 0404 permission set for the file.
-(<I>MODNAME</I>
-
-is the name of the systemtap module). The
-<I>proc</I>
-
-filesystem is a pseudo-filesystem which is used an an interface to
-kernel data structures. There are several probe point variants supported
-by the translator:
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-procfs("PATH").read
-procfs("PATH").umask(UMASK).read
-procfs("PATH").read.maxsize(MAXSIZE)
-procfs("PATH").umask(UMASK).maxsize(MAXSIZE)
-procfs("PATH").write
-procfs("PATH").umask(UMASK).write
-procfs.read
-procfs.umask(UMASK).read
-procfs.read.maxsize(MAXSIZE)
-procfs.umask(UMASK).read.maxsize(MAXSIZE)
-procfs.write
-procfs.umask(UMASK).write
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<I>PATH</I>
-
-is the file name (relative to /proc/systemtap/MODNAME) to be created.
-If no
-<I>PATH</I>
-
-is specified (as in the last two variants above),
-<I>PATH</I>
-
-defaults to "command".
-<P>
-
-When a user reads /proc/systemtap/MODNAME/PATH, the corresponding
-procfs
-<I>read</I>
-
-probe is triggered. The string data to be read should be assigned to
-a variable named
-<I>$value</I>,
-
-like this:
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-procfs("PATH").read { $value = "100\n" }
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-
-When a user writes into /proc/systemtap/MODNAME/PATH, the
-corresponding procfs
-<I>write</I>
-
-probe is triggered. The data the user wrote is available in the
-string variable named
-<I>$value</I>,
-
-like this:
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-procfs("PATH").write { printf("user wrote: %s", $value) }
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-
-<I>MAXSIZE</I>
-
-is the size of the procfs read buffer. Specifying
-<I>MAXSIZE</I>
-
-allows larger procfs output. If no
-<I>MAXSIZE</I>
-
-is specified, the procfs read buffer defaults to
-<I>STP_PROCFS_BUFSIZE</I>
-
-(which defaults to
-<I>MAXSTRINGLEN</I>,
-
-the maximum length of a string).
-If setting the procfs read buffers for more than one file is needed,
-it may be easiest to override the
-<I>STP_PROCFS_BUFSIZE</I>
-
-definition.
-Here's an example of using
-<I>MAXSIZE</I>:
-
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-procfs.read.maxsize(1024) {
- $value = "long string..."
- $value .= "another long string..."
- $value .= "another long string..."
- $value .= "another long string..."
-}
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<A NAME="lbAR"> </A>
-<H3>NETFILTER HOOKS</H3>
-
-<P>
-These probe points allow observation of network packets using the
-netfilter mechanism. A netfilter probe in systemtap corresponds to a
-netfilter hook function in the original netfilter probes API. It is
-probably more convenient to use
-<I><A HREF="./tapset::netfilter.3stap.html">tapset::netfilter</A></I>(3stap),
-
-which wraps the primitive netfilter hooks and does the work of
-extracting useful information from the context variables.
-<P>
-<P>
-
-There are several probe point variants supported by the translator:
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-netfilter.hook("HOOKNAME").pf("PROTOCOL_F")
-netfilter.pf("PROTOCOL_F").hook("HOOKNAME")
-netfilter.hook("HOOKNAME").pf("PROTOCOL_F").priority("PRIORITY")
-netfilter.pf("PROTOCOL_F").hook("HOOKNAME").priority("PRIORITY")
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<P>
-
-<I>PROTOCOL_F</I>
-
-is the protocol family to listen for, currently one of
-<I>NFPROTO_IPV4,</I>
-
-<I>NFPROTO_IPV6,</I>
-
-<I>NFPROTO_ARP,</I>
-
-or
-<I>NFPROTO_BRIDGE.</I>
-
-<P>
-<P>
-
-<I>HOOKNAME</I>
-
-is the point, or 'hook', in the protocol stack at which to intercept
-the packet. The available hook names for each protocol family are
-taken from the kernel header files <<A HREF="file:///usr/include/linux/netfilter_ipv4.h">linux/netfilter_ipv4.h</A>>,
-<<A HREF="file:///usr/include/linux/netfilter_ipv6.h">linux/netfilter_ipv6.h</A>>, <<A HREF="file:///usr/include/linux/netfilter_arp.h">linux/netfilter_arp.h</A>> and
-<<A HREF="file:///usr/include/linux/netfilter_bridge.h">linux/netfilter_bridge.h</A>>. For instance, allowable hook names for
-<I>NFPROTO_IPV4</I>
-
-are
-<I>NF_INET_PRE_ROUTING,</I>
-
-<I>NF_INET_LOCAL_IN,</I>
-
-<I>NF_INET_FORWARD,</I>
-
-<I>NF_INET_LOCAL_OUT,</I>
-
-and
-<I>NF_INET_POST_ROUTING.</I>
-
-<P>
-<P>
-
-<I>PRIORITY</I>
-
-is an integer priority giving the order in which the probe point
-should be triggered relative to any other netfilter hook functions
-which trigger on the same packet. Hook functions execute on each
-packet in order from smallest priority number to largest priority number. If no
-<I>PRIORITY</I>
-
-is specified (as in the first two probe point variants above),
-<I>PRIORITY</I>
-
-defaults to "0".
-<P>
-There are a number of predefined priority names of the form
-<I>NF_IP_PRI_*</I>
-
-and
-<I>NF_IP6_PRI_*</I>
-
-which are defined in the kernel header files <<A HREF="file:///usr/include/linux/netfilter_ipv4.h">linux/netfilter_ipv4.h</A>> and <<A HREF="file:///usr/include/linux/netfilter_ipv6.h">linux/netfilter_ipv6.h</A>> respectively. The script is permitted to use these
-instead of specifying an integer priority. (The probe points for
-<I>NFPROTO_ARP</I>
-
-and
-<I>NFPROTO_BRIDGE</I>
-
-currently do not expose any named hook priorities to the script writer.)
-Thus, allowable ways to specify the priority include:
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-priority("255")
-priority("NF_IP_PRI_SELINUX_LAST")
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-A script using guru mode is permitted to specify any identifier or
-number as the parameter for hook, pf, and priority. This feature
-should be used with caution, as the parameter is inserted verbatim into
-the C code generated by systemtap.
-<P>
-The netfilter probe points define the following context variables:
-<DL COMPACT>
-<DT><I>$hooknum</I>
-
-<DD>
-The hook number.
-<DT><I>$skb</I>
-
-<DD>
-The address of the sk_buff struct representing the packet. See
-<<A HREF="file:///usr/include/linux/skbuff.h">linux/skbuff.h</A>> for details on how to use this struct, or
-alternatively use the tapset
-<I><A HREF="./tapset::netfilter.3stap.html">tapset::netfilter</A></I>(3stap)
-
-for easy access to key information.
-<P>
-<DT><I>$in</I>
-
-<DD>
-The address of the net_device struct representing the network device
-on which the packet was received (if any). May be 0 if the device is
-unknown or undefined at that stage in the protocol stack.
-<P>
-<DT><I>$out</I>
-
-<DD>
-The address of the net_device struct representing the network device
-on which the packet will be sent (if any). May be 0 if the device is
-unknown or undefined at that stage in the protocol stack.
-<P>
-<DT><I>$verdict</I>
-
-<DD>
-(Guru mode only.) Assigning one of the verdict values defined in
-<<A HREF="file:///usr/include/linux/netfilter.h">linux/netfilter.h</A>> to this variable alters the further progress of
-the packet through the protocol stack. For instance, the following
-guru mode script forces all ipv6 network packets to be dropped:
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-probe netfilter.pf("NFPROTO_IPV6").hook("NF_IP6_PRE_ROUTING") {
- $verdict = 0 /* nf_drop */
-}
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-For convenience, unlike the primitive probe points discussed here, the
-probes defined in
-<I><A HREF="./tapset::netfilter.3stap.html">tapset::netfilter</A></I>(3stap)
-
-export the lowercase names of the verdict constants (e.g. NF_DROP
-becomes nf_drop) as local variables.
-<P>
-</DL>
-<A NAME="lbAS"> </A>
-<H3>MARKERS</H3>
-
-<P>
-This family of probe points hooks up to static probing markers
-inserted into the kernel or modules. These markers are special macro
-calls inserted by kernel developers to make probing faster and more
-reliable than with DWARF-based probes. Further, DWARF debugging
-information is
-<I>not</I>
-
-required to probe markers.
-<P>
-Marker probe points begin with
-<B>kernel</B>.
-
-The next part names the marker itself:
-<B>mark(name)</B>.
-
-The marker name string, which may contain the usual wildcard characters,
-is matched against the names given to the marker macros when the kernel
-and/or module was compiled. Optionally, you can specify
-<B>format(format)</B>.
-
-Specifying the marker format string allows differentiation between two
-markers with the same name but different marker format strings.
-<P>
-The handler associated with a marker-based probe may read the
-optional parameters specified at the macro call site. These are
-named
-<B>$arg1</B> through <B>$argNN</B>,
-
-where NN is the number of parameters supplied by the macro. Number
-and string parameters are passed in a type-safe manner.
-<P>
-The marker format string associated with a marker is available in
-<B>$format</B>.
-
-And also the marker name string is available in
-<B>$name</B>.
-
-<P>
-<A NAME="lbAT"> </A>
-<H3>TRACEPOINTS</H3>
-
-<P>
-This family of probe points hooks up to static probing tracepoints
-inserted into the kernel or modules. As with markers, these
-tracepoints are special macro calls inserted by kernel developers to
-make probing faster and more reliable than with DWARF-based probes,
-and DWARF debugging information is not required to probe tracepoints.
-Tracepoints have an extra advantage of more strongly-typed parameters
-than markers.
-<P>
-Tracepoint probes begin with
-<B>kernel</B>.
-
-The next part names the tracepoint itself:
-<B>trace(name)</B>.
-
-The tracepoint name string, which may contain the usual wildcard
-characters, is matched against the names defined by the kernel
-developers in the tracepoint header files.
-<P>
-The handler associated with a tracepoint-based probe may read the
-optional parameters specified at the macro call site. These are
-named according to the declaration by the tracepoint author. For
-example, the tracepoint probe
-<B>kernel.trace(sched_switch)</B>
-
-provides the parameters
-<B>$rq</B>, <B>$prev</B>, and <B>$next</B>.
-
-If the parameter is a complex type, as in a struct pointer, then a
-script can access fields with the same syntax as DWARF $target
-variables. Also, tracepoint parameters cannot be modified, but in
-guru-mode a script may modify fields of parameters.
-<P>
-The name of the tracepoint is available in
-<B>$$name</B>,
-
-and a string of name=value pairs for all parameters of the tracepoint
-is available in
-<B>$$vars</B> or <B>$$parms</B>.
-
-<P>
-<A NAME="lbAU"> </A>
-<H3>HARDWARE BREAKPOINTS</H3>
-
-This family of probes is used to set hardware watchpoints for a given
-<BR> (global) kernel symbol. The probes take three components as inputs :
-<P>
-1. The
-<B>virtual</B>address<B>/</B>name
-
-of the kernel symbol to be traced is supplied as argument to this class
-of probes. ( Probes for only data segment variables are supported. Probing
-local variables of a function cannot be done.)
-<P>
-2. Nature of access to be probed :
-a.
-<I>.write</I>
-
-probe gets triggered when a write happens at the specified address/symbol
-name.
-b.
-<I>rw</I>
-
-probe is triggered when either a read or write happens.
-<P>
-3.
-<B>.length</B>
-
-(optional)
-Users have the option of specifying the address interval to be probed
-using "length" constructs. The user-specified length gets approximated
-to the closest possible address length that the architecture can
-support. If the specified length exceeds the limits imposed by
-architecture, an error message is flagged and probe registration fails.
-Wherever 'length' is not specified, the translator requests a hardware
-breakpoint probe of length 1. It should be noted that the "length"
-construct is not valid with symbol names.
-<P>
-Following constructs are supported :
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-probe kernel.data(ADDRESS).write
-probe kernel.data(ADDRESS).rw
-probe kernel.data(ADDRESS).length(LEN).write
-probe kernel.data(ADDRESS).length(LEN).rw
-probe kernel.data("SYMBOL_NAME").write
-probe kernel.data("SYMBOL_NAME").rw
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-This set of probes make use of the debug registers of the processor,
-which is a scarce resource. (4 on x86 , 1 on powerpc ) The script
-translation flags a warning if a user requests more hardware breakpoint probes
-than the limits set by architecture. For example,a pass-2 warning is flashed
-when an input script requests 5 hardware breakpoint probes on an x86
-system while x86 architecture supports a maximum of 4 breakpoints.
-Users are cautioned to set probes judiciously.
-<P>
-<A NAME="lbAV"> </A>
-<H3>PERF</H3>
-
-<P>
-This family of probe points interfaces to the kernel "perf event"
-infrastructure for controlling hardware performance counters.
-The events being attached to are described by the "type",
-"config" fields of the
-<I>perf_event_attr</I>
-
-structure, and are sampled at an interval governed by the
-"sample_period" field.
-<P>
-These fields are made available to systemtap scripts using
-the following syntax:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-probe perf.type(NN).config(MM).sample(XX)
-probe perf.type(NN).config(MM)
-probe perf.type(NN).config(MM).process("PROC")
-probe perf.type(NN).config(MM).counter("COUNTER")
-probe perf.type(NN).config(MM).process("PROC").counter("COUNTER")
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-The systemtap probe handler is called once per XX increments
-of the underlying performance counter. The default sampling
-count is 1000000.
-The range of valid type/config is described by the
-<I><A HREF="perf_event_open.2.html">perf_event_open</A></I>(2)
-
-system call, and/or the
-<I>linux/perf_event.h</I>
-
-file. Invalid combinations or exhausted hardware counter resources
-result in errors during systemtap script startup. Systemtap does
-not sanity-check the values: it merely passes them through to
-the kernel for error- and safety-checking. By default the perf event
-probe is systemwide unless .process is specified, which will bind the
-probe to a specific task. If the name is omitted then it
-is inferred from the stap -c argument. A perf event can be read on
-demand using .counter. The body of the perf probe handler will not be
-invoked for a .counter probe; instead, the counter is read in a user
-space probe via:
-<DL COMPACT>
-<DT><BR> process("PROCESS").statement("<A HREF="mailto:func@file">func@file</A>") {stat <<< @perf("NAME")} <DD>
-<P>
-<P>
-</DL>
-<A NAME="lbAW"> </A>
-<H2>EXAMPLES</H2>
-
-<P>
-
-Here are some example probe points, defining the associated events.
-<DL COMPACT>
-<DT>begin, end, end<DD>
-refers to the startup and normal shutdown of the session. In this
-case, the handler would run once during startup and twice during
-shutdown.
-<DT>timer.jiffies(1000).randomize(200)<DD>
-refers to a periodic interrupt, every 1000 +/- 200 jiffies.
-<DT>kernel.function("*init*"), kernel.function("*exit*")<DD>
-refers to all kernel functions with "init" or "exit" in the name.
-<DT>kernel.function("*@kernel/time.c:240")<DD>
-refers to any functions within the "kernel/time.c" file that span
-line 240.
-
-Note
-that this is
-<B>not</B>
-
-a probe at the statement at that line number. Use the
-
-kernel.statement
-probe instead.
-<DT>kernel.mark("getuid")<DD>
-refers to an STAP_MARK(getuid, ...) macro call in the kernel.
-<DT>module("usb*").function("*sync*").return<DD>
-refers to the moment of return from all functions with "sync" in the
-name in any of the USB drivers.
-<DT>kernel.statement(0xc0044852)<DD>
-refers to the first byte of the statement whose compiled instructions
-include the given address in the kernel.
-<DT>kernel.statement("*@kernel/time.c:296")<DD>
-refers to the statement of line 296 within "kernel/time.c".
-<DT>kernel.statement("bio_init@fs/bio.c+3")<DD>
-refers to the statement at line bio_init+3 within "fs/bio.c".
-<DT>kernel.data("pid_max").write<DD>
-refers to a hardware breakpoint of type "write" set on pid_max
-<DT>syscall.*.return<DD>
-refers to the group of probe aliases with any name in the third position
-<P>
-</DL>
-<A NAME="lbAX"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I>probe::*</I>(3stap),
-<I>tapset::*</I>(3stap)
-
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SYNTAX</A><DD>
-<DT><A HREF="#lbAE">DWARF DEBUGINFO</A><DD>
-<DT><A HREF="#lbAF">PROBE POINT FAMILIES</A><DD>
-<DL>
-<DT><A HREF="#lbAG">BEGIN/END/ERROR</A><DD>
-<DT><A HREF="#lbAH">NEVER</A><DD>
-<DT><A HREF="#lbAI">SYSCALL and ND_SYSCALL</A><DD>
-<DT><A HREF="#lbAJ">TIMERS</A><DD>
-<DT><A HREF="#lbAK">DWARF</A><DD>
-<DT><A HREF="#lbAL">CONTEXT VARIABLES</A><DD>
-<DT><A HREF="#lbAM">MORE ON RETURN PROBES</A><DD>
-<DT><A HREF="#lbAN">DWARFLESS</A><DD>
-<DT><A HREF="#lbAO">USER-SPACE</A><DD>
-<DT><A HREF="#lbAP">JAVA</A><DD>
-<DT><A HREF="#lbAQ">PROCFS</A><DD>
-<DT><A HREF="#lbAR">NETFILTER HOOKS</A><DD>
-<DT><A HREF="#lbAS">MARKERS</A><DD>
-<DT><A HREF="#lbAT">TRACEPOINTS</A><DD>
-<DT><A HREF="#lbAU">HARDWARE BREAKPOINTS</A><DD>
-<DT><A HREF="#lbAV">PERF</A><DD>
-</DL>
-<DT><A HREF="#lbAW">EXAMPLES</A><DD>
-<DT><A HREF="#lbAX">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of STAPRUN</TITLE>
-</HEAD><BODY>
-<H1>STAPRUN</H1>
-Section: Maintenance Commands (8)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-staprun - systemtap runtime
-<P>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<BR>
-
-<B>staprun</B>
-
-[
-<I>OPTIONS</I>
-
-]
-<I>MODULE</I>
-
-[
-<I>MODULE-OPTIONS</I>
-
-]
-<P>
-<A NAME="lbAD"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-The
-<I>staprun</I>
-
-program is the back-end of the Systemtap tool. It expects a kernel
-module produced by the front-end
-<I>stap</I>
-
-tool.
-<P>
-
-Splitting the systemtap tool into a front-end and a back-end allows a
-user to compile a systemtap script on a development machine that has
-the kernel development tools (needed to compile the script) and then
-transfer the resulting kernel module to a production machine that
-doesn't have any development tools installed.
-<P>
-
-Please refer to stappaths (7) for the version number, or run
-rpm -q systemtap (fedora/red hat)
-apt-get -v systemtap (ubuntu)
-<P>
-<A NAME="lbAE"> </A>
-<H2>OPTIONS</H2>
-
-The
-<I>staprun</I>
-
-program supports the following options. Any other option
-prints a list of supported options.
-<DL COMPACT>
-<DT><B>-v</B>
-
-<DD>
-Verbose mode.
-<DT><B>-V</B>
-
-<DD>
-Print version number and exit.
-<DT><B>-w</B>
-
-<DD>
-Suppress warnings from the script.
-<DT><B>-u</B>
-
-<DD>
-Load the uprobes.ko module.
-<DT><B>-c CMD</B>
-
-<DD>
-Command CMD will be run and the
-<I>staprun</I>
-
-program will exit when CMD
-does. The '_stp_target' variable will contain the pid for CMD.
-<DT><B>-x PID</B>
-
-<DD>
-The '_stp_target' variable will be set to PID.
-<DT><B>-o FILE</B>
-
-<DD>
-Send output to FILE. If the module uses bulk mode, the output will
-be in percpu files FILE_x(FILE_cpux in background and bulk mode)
-where 'x' is the cpu number. This supports <A HREF="strftime.3.html">strftime</A>(3) formats
-for FILE.
-<DT><B>-b BUFFER_SIZE</B>
-
-<DD>
-The systemtap module will specify a buffer size.
-Setting one here will override that value. The value should be
-an integer between 1 and 4095 which be assumed to be the
-buffer size in MB. That value will be per-cpu if bulk mode is used.
-<DT><B>-L</B>
-
-<DD>
-Load module and start probes, then detach from the module leaving the
-probes running. The module can be attached to later by using the
-<B>-A</B>
-
-option.
-<DT><B>-A</B>
-
-<DD>
-Attach to loaded systemtap module.
-<DT><B>-C WHEN</B>
-
-<DD>
-Control coloring of error messages. WHEN must be either
-
-"never", "always", or "auto"
-
-(i.e. enable only if at a terminal). If the option is missing, then "auto"
-is assumed. Colors can be modified using the SYSTEMTAP_COLORS environment
-variable. See the
-<I><A HREF="stap.1.html">stap</A></I>(1)
-
-manual page for more information on syntax and behaviour.
-<DT><B>-d</B>
-
-<DD>
-Delete a module. Only detached or unused modules
-the user has permission to access will be deleted. Use "*"
-(quoted) to delete all unused modules.
-<DT><B>-D</B>
-
-<DD>
-Run staprun in background as a daemon and show it's pid.
-<DT><B>-R</B>
-
-<DD>
-Rename the module to a unique name before inserting it.
-<DT><B>-r N:URI</B>
-
-<DD>
-Pass the given number and URI data to the tapset functions
-remote_id() and remote_uri().
-<DT><B>-S</B><I> size[,N]</I>
-
-<DD>
-Sets the maximum size of output file and the maximum number of output files.
-If the size of output file will exceed
-<B>size</B>
-
-, systemtap switches output file to the next file. And if the number of
-output files exceed
-<B>N</B>
-
-, systemtap removes the oldest output file. You can omit the second argument.
-<DT><B>-T timeout</B>
-
-<DD>
-Sets maximum time reader thread will wait before dumping trace buffer. Value is
-in ms, default is 200ms. Setting this to a high value decreases number of stapio
-wake-ups, allowing deeper sleep for embedded platforms. But it impacts interactivity
-on terminal as traces are dumped less often in case of low throughput.
-There is no interactivity or performance impact for high throughput as trace is
-dumped when buffer is full, before this timeout expires.
-<DT><B>var1=val</B>
-
-<DD>
-Sets the value of global variable var1 to val. Global variables contained
-within a module are treated as module options and can be set from the
-staprun command line.
-<P>
-</DL>
-<A NAME="lbAF"> </A>
-<H2>ARGUMENTS</H2>
-
-<B>MODULE</B>
-
-is either a module path or a module name. If it is a module name,
-the module will be looked for in the following directory
-(where 'VERSION' is the output of "uname -r"):
-<DL COMPACT>
-<DT><DD>
-/lib/modules/VERSION/systemtap
-</DL>
-<P>
-
-
-Any additional arguments on the command line are passed to the
-module. One use of these additional module arguments is to set the value
-of global variables declared within the module.
-<P>
-
-<P>
- $ stap -p4 -m mod1 -e 'global var1="foo"; probe begin{printf("%s\n", var1); exit()}'
-<BR>
-
-<P>
-
-Running this with an additional module argument:
-<P>
-
-<P>
- $ staprun mod1.ko var1="HelloWorld"
-<BR>
-
- HelloWorld
-<P>
-
-Spaces and exclamation marks currently cannot be passed into global variables
-this way.
-<P>
-<A NAME="lbAG"> </A>
-<H2>EXAMPLES</H2>
-
-See the
-<I><A HREF="stapex.3stap.html">stapex</A></I>(3stap)
-
-manual page for a collection of sample scripts.
-<P>
-
-Here is a very basic example of how to use
-<I>staprun.</I>
-
-First, use
-<I>stap</I>
-
-to compile a script. The
-<I>stap</I>
-
-program will report the pathname to the resulting module.
-<P>
-
- $ stap -p4 -e 'probe begin { printf("Hello World!\n"); exit() }'
-<BR>
-
- /home/user/.systemtap/cache/85/stap_8553d83f78c_265.ko
-<P>
-
-Run
-<I>staprun</I>
-
-with the pathname to the module as an argument.
-<P>
-
- $ staprun /home/user/.systemtap/cache/85/stap_8553d83f78c_265.ko
-<BR>
-
- Hello World!
-<A NAME="lbAH"> </A>
-<H2>MODULE DETACHING AND ATTACHING</H2>
-
-After the
-<I>staprun</I>
-
-program installs a Systemtap kernel module, users can detach from the
-kernel module and reattach to it later. The
-<B>-L</B>
-
-option loads the module and automatically detaches. Users can also
-detach from the kernel module interactively by sending the SIGQUIT
-signal from the keyboard (typically by typing Ctrl-\).
-<P>
-
-To reattach to a kernel module, the
-<I>staprun</I>
-
-<B>-A</B>
-
-option would be used.
-<P>
-<A NAME="lbAI"> </A>
-<H2>FILE SWITCHING BY SIGNAL</H2>
-
-After
-<I>staprun</I>
-
-launched the
-<I>stapio</I>
-
-program, users can command it to switch output file to next file when it
-outputs to file(s) (running staprun with
-<B>-o</B>
-
-option) by sending a
-<B>SIGUSR2</B>
-
-signal to the
-<I>stapio</I>
-
-process. When it receives SIGUSR2, it will switch output file to
-new file with suffix
-<I>.N</I>
-
-where N is the sequential number.
-For example,
-<P>
-
- $ staprun -o foo ...
-<P>
-
-outputs trace logs to
-<I>foo</I>
-
-and if it receives
-<B>SIGUSR2</B>
-
-signal, it switches output to
-<I>foo.1</I>
-
-file. And receiving
-<B>SIGUSR2</B>
-
-again, it switches to
-<I>foo.2</I>
-
-file.
-<P>
-<A NAME="lbAJ"> </A>
-<H2>SAFETY AND SECURITY</H2>
-
-Systemtap, in the default kernel-module runtime mode, is an
-administrative tool. It exposes kernel internal data structures and
-potentially private user information. See the
-<I><A HREF="stap.1.html">stap</A></I>(1)
-
-manual page for additional information on safety and security.
-<P>
-
-To increase system security, users of systemtap must be root, or in the
-<I>staprun</I>
-
-group in order to execute this setuid
-<I>staprun</I>
-
-program.
-A user may select a particular privilege level with the stap
-<I>--privilege=</I>
-
-option, which
-<I>staprun</I>
-
-will later enforce.
-<DL COMPACT>
-<DT>stapdev<DD>
-Members of the
-<I>stapdev</I>
-
-group can write and load script modules with root-equivalent
-privileges, without particular security constraints. (Many safety
-constraints remain.)
-<DT>stapsys<DD>
-Members of the
-<I>stapsys</I>
-
-group have almost all the privileges of
-<I>stapdev</I>,
-
-except for guru mode constructs.
-<DT>staprun<DD>
-Members only of the
-<I>stapusr</I>
-
-group may any-privileged modules placed into the /lib/modules/VERSION/systemtap
-by the system administrator.
-<DT>staprun<DD>
-Members only of the
-<I>stapusr</I>
-
-group may also write and load low-privilege script modules, which are normally
-limited to manipulating their own processes (and not the kernel nor other users'
-processes).
-</DL>
-<P>
-
-Part of the privilege enforcement mechanism may require using a
-stap-server and administrative trust in its cryptographic signer; see the
-<I><A HREF="stap-server.8.html">stap-server</A></I>(8)
-
-manual page for a for more information.
-<A NAME="lbAK"> </A>
-<H2>FILES</H2>
-
-<DL COMPACT>
-<DT>/lib/modules/VERSION/systemtap<DD>
-If MODULE is a module name, the module will be looked for in this directory.
-Users who are only in the
-<I>'stapusr'</I>
-
-group can install modules
-located in this directory. This directory must be owned by the root
-user and not be world writable.
-</DL>
-<A NAME="lbAL"> </A>
-<H2>SEE ALSO</H2>
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap),
-
-<I><A HREF="stap-server.8.html">stap-server</A></I>(8),
-
-<I><A HREF="stapdyn.8.html">stapdyn</A></I>(8),
-
-<I><A HREF="stapex.3stap.html">stapex</A></I>(3stap)
-
-<P>
-<A NAME="lbAM"> </A>
-<H2>BUGS</H2>
-
-Use the Bugzilla link of the project web page or our mailing list.
-
-<B><A HREF="http://sourceware.org/systemtap/">http://sourceware.org/systemtap/</A></B>, <B><<A HREF="mailto:systemtap@sourceware.org">systemtap@sourceware.org</A>></B>.
-
-
-<P>
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAE">OPTIONS</A><DD>
-<DT><A HREF="#lbAF">ARGUMENTS</A><DD>
-<DT><A HREF="#lbAG">EXAMPLES</A><DD>
-<DT><A HREF="#lbAH">MODULE DETACHING AND ATTACHING</A><DD>
-<DT><A HREF="#lbAI">FILE SWITCHING BY SIGNAL</A><DD>
-<DT><A HREF="#lbAJ">SAFETY AND SECURITY</A><DD>
-<DT><A HREF="#lbAK">FILES</A><DD>
-<DT><A HREF="#lbAL">SEE ALSO</A><DD>
-<DT><A HREF="#lbAM">BUGS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of STAPSH</TITLE>
-</HEAD><BODY>
-<H1>STAPSH</H1>
-Section: Maintenance Commands (8)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-stapsh
-<P>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<P>
-<BR>
-
-<B>stapsh</B>
-
-<P>
-<A NAME="lbAD"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-The stapsh executable is used by the stap
-<I>--remote</I>
-
-functionality, as a wrapper shell on the remote machines.
-It is not intended to be run directly by users.
-<P>
-<A NAME="lbAE"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1)
-
-</PRE><A NAME="lbAF"> </A>
-<H2>BUGS</H2>
-
-Use the Bugzilla link of the project web page or our mailing list.
-
-<B><A HREF="http://sourceware.org/systemtap/">http://sourceware.org/systemtap/</A></B>,<B><<A HREF="mailto:systemtap@sourceware.org">systemtap@sourceware.org</A>></B>.
-
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAE">SEE ALSO</A><DD>
-<DT><A HREF="#lbAF">BUGS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of STAPVARS</TITLE>
-</HEAD><BODY>
-<H1>STAPVARS</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-stapvars - systemtap variables
-<P>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-The following sections enumerate the public variables provided by
-standard tapsets installed, (the installation path is show in the
-stappaths (7) manual page). Each variable is described with a
-type, and its behavior/restrictions.
-The syntax is the same as printed with the
-<I>stap</I> option <I>-p2</I>.
-
-Examples:
-<P>
-<DL COMPACT>
-<DT>example1:long<DD>
-Variable "example1" contains an integer.
-<P>
-<DT>example2:string [long]<DD>
-Variable "example2" is an array of strings, indexed by integers.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H3>ARGV</H3>
-
-<P>
-<DL COMPACT>
-<DT>argc:long<DD>
-Contains the value of the
-
-$#
-value: the number of command line arguments passed to the systemtap script.
-It is initialized with an implicit begin(-1) probe.
-<P>
-<DT>argv:string [long]<DD>
-Contains each command line argument as a string. argv[1] will equal @1 if
-there was at least one command line argument. Arguments beyond #32 are not
-transcribed, and produce a warning message within the begin(-1) probe that
-initializes this array.
-<P>
-</DL>
-<A NAME="lbAE"> </A>
-<H3>NULL</H3>
-
-<P>
-<DL COMPACT>
-<DT>NULL:long<DD>
-Simply defined as the number 0.
-<P>
-</DL>
-<A NAME="lbAF"> </A>
-<H2>FILES</H2>
-
-<DL COMPACT>
-<DT>More files and their corresponding paths can be found in the stappaths (7) manual page.<DD>
-<P>
-</DL>
-<A NAME="lbAG"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1)
-<I><A HREF="stappaths.7.html">stappaths</A></I>(7)
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DL>
-<DT><A HREF="#lbAD">ARGV</A><DD>
-<DT><A HREF="#lbAE">NULL</A><DD>
-</DL>
-<DT><A HREF="#lbAF">FILES</A><DD>
-<DT><A HREF="#lbAG">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of STAPVIRT</TITLE>
-</HEAD><BODY>
-<H1>STAPVIRT</H1>
-Section: User Commands (1)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-stapvirt - prepare libvirt domains for systemtap probing
-<P>
-
-
-
-<P>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<B>stapvirt</B>
-[<B>-c</B> <I>URI</I>]
-[<B>-d</B> <I>PATH</I>]
-[<B>-v</B>]
-<I>COMMAND</I>
-<I>ARGUMENTS</I>
-<P>
-<A NAME="lbAD"> </A>
-<H2>DESCRIPTION</H2>
-
-The <I>stapvirt</I> program can be used to add ports to domains managed by
-libvirt (see
-
-<<A HREF="http://libvirt.org/">http://libvirt.org/</A>>).
-
-These ports can then be used by <I>stap</I> to
-run scripts inside the domains (see the '--remote' option in <I><A HREF="stap.1.html">stap</A></I>(1) for
-more information).
-<P>
-
-Ports are added to the definition of the domain using the <B>port-add</B>
-command. These ports can later be removed using the <B>port-remove</B> command.
-Note that there can only be as many simultaneous <I>stap</I> sessions as there
-are ports.
-<P>
-
-Starting from libvirt v1.1.1 and QEMU v0.10.0, SystemTap ports can be hotplugged
-and thus do not need to be added first using the <B>port-add</B> command.
-However, you need to ensure that there is a virtio-serial controller in place so
-that hotplugged ports can be connected. If creating a domain using virt-install,
-you can do this by adding this option:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>$</B> virt-install [...] --controller=virtio-serial
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-If the domain has already been created, you can simply do <B>port-add</B>
-followed immediately by <B>port-remove</B>. The port will be removed, but the
-controller will remain.
-<P>
-<A NAME="lbAE"> </A>
-<H2>OPTIONS</H2>
-
-The following options are supported. Any other option prints a short help
-message.
-<P>
-<DL COMPACT>
-<DT><B>-c</B> <I>URI</I><DD>
-Specify the libvirt driver URI to which to connect (e.g. '<A HREF="qemu:///system').">qemu:///system').</A> The
-default value is NULL, which indicates to libvirt to connect to the default
-driver. See the page at <<A HREF="http://libvirt.org/uri.html">http://libvirt.org/uri.html</A>> for supported values.
-<P>
-<DT><B>-d</B> <I>PATH</I><DD>
-Specify the directory in which UNIX sockets should be created when SystemTap
-ports are added. The default directory is '/var/lib/libvirt/qemu'.
-<P>
-<DT><B>-v</B><DD>
-Increase verbosity. This option may be repeated for more verbosity.
-<P>
-</DL>
-<A NAME="lbAF"> </A>
-<H2>COMMANDS</H2>
-
-The following commands are recognized by stapvirt. Any other command prints a
-short help message.
-<P>
-<DL COMPACT>
-<DT><B>help</B><DD>
-Display the help message.
-<P>
-<DT><B>list</B><DD>
-List available domains.
-<P>
-<DT><B>port-add</B> <I>DOMAIN</I><DD>
-Add a permanent SystemTap port to the domain's definition. If the domain is
-currently running, it must be powered off before changes take effect.
-<P>
-<DT><B>port-list</B> <I>DOMAIN</I><DD>
-List the UNIX socket paths of the permanent SystemTap ports in the domain's
-definition.
-<P>
-<DT><B>port-remove</B> <I>DOMAIN</I><DD>
-Remove a permanent SystemTap port from the domain's definition. If the domain is
-currently running, it must be powered off before changes take effect.
-<P>
-<DT><B>query</B> <I>DOMAIN</I><DD>
-Display the following information about the domain: its name, its UUID, its
-state, the number of permanent SystemTap ports installed, and whether
-hotplugging is supported.
-<P>
-</DL>
-<A NAME="lbAG"> </A>
-<H2>TUTORIAL</H2>
-
-This tutorial will help you get started with stapvirt. Let's start by listing
-all the privileged domains on the machine with the <B>list</B> command:
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>$</B> stapvirt -c '<A HREF="qemu:///system'">qemu:///system'</A> list
-Available domains on URI '<A HREF="qemu:///system':">qemu:///system':</A>
-ID State Type Name
-2 running persistent TestVM
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-Note that we specified the libvirt URI using the -c switch. Otherwise libvirt
-might have defaulted to e.g. '<A HREF="qemu:///session'.">qemu:///session'.</A>
-<P>
-
-Rather than typing the URI everytime, it might be easier to instead set the
-
-LIBVIRT_DEFAULT_URI
-
-environment variable and omit the -c switch. Note that this is a libvirt
-functionality (see
-
-<libvirt.org/uri.html>
-
-for more details).
-<P>
-
-The <B>list</B> command indicates that we have a running domain named 'TestVM'
-with ID 2. Let's use the <B>query</B> command to retrieve more information:
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>$</B> stapvirt query TestVM # by name
-<B>$</B> stapvirt query 2 # by ID
-
- Name: TestVM
- UUID: 905951c0-fa4f-409b-079c-c91ddda27028
- State: running
- ID: 2
- Type: persistent
- Permanent Ports: 0
- Hotplugging: not supported
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-The <B>query</B> command gives us some basic information about the domain, such
-as its name, UUID, and state. More importantly, it gives us two pieces of
-information: the number of permanent ports installed, and whether hotplugging is
-supported. Technically, hotplugging support depends on libvirt and qemu, and is
-not related to the domain in itself.
-<P>
-
-If hotplugging were supported, we could stop here and run <I>stap</I> directly
-(assuming we have a virtio-serial controller already in place, see
-<B>DESCRIPTION</B>). Since in our case hotplugging is not supported, we need to
-add SystemTap ports. To do this, we use the <B>port-add</B> command:
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>$</B> stapvirt port-add TestVM
-Added new port org.systemtap.stapsh.0
-The domain must be restarted before changes take effect.
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-We can confirm that a port was added by running the <B>query</B> command again:
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>$</B> stapvirt query TestVM
-<B>...</B>
- Permanent Ports: 1
- Hotplugging: not supported
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-It now indicates that there is 1 permanent port. We can also use the
-<B>port-list</B> command to know exactly where the port will be created:
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>$</B> stapvirt port-list TestVM
-/var/lib/libvirt/qemu/TestVM.org.systemtap.stapsh.0.sock
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-After powering off and restarting the domain, we are now ready to use the port
-with <I>stap</I>:
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>$</B> stap -e 'probe begin { printf("Hello from TestVM!\n"); exit() }' \
- --remote=libvirt://TestVM
-Hello from TestVM!
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-Finally, if we'd like to remove the port, we can use the <B>port-remove</B>
-command:
-<P>
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>$</B> stapvirt port-remove TestVM
-Removed port org.systemtap.stapsh.0
-The domain must be powered off before changes take effect.
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-And that's all there is to it!
-<P>
-<A NAME="lbAH"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I><A HREF="virt-install.1.html">virt-install</A></I>(1)
-
-</PRE><A NAME="lbAI"> </A>
-<H2>BUGS</H2>
-
-Use the Bugzilla link of the project web page or our mailing list.
-
-<B><A HREF="http://sourceware.org/systemtap/">http://sourceware.org/systemtap/</A></B>,<B><<A HREF="mailto:systemtap@sourceware.org">systemtap@sourceware.org</A>></B>.
-
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAE">OPTIONS</A><DD>
-<DT><A HREF="#lbAF">COMMANDS</A><DD>
-<DT><A HREF="#lbAG">TUTORIAL</A><DD>
-<DT><A HREF="#lbAH">SEE ALSO</A><DD>
-<DT><A HREF="#lbAI">BUGS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:26 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of SYSTEMTAP</TITLE>
-</HEAD><BODY>
-<H1>SYSTEMTAP</H1>
-Section: Maintenance Commands (8)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-systemtap - SystemTap initscript service
-<P>
-
-
-
-<P>
-<A NAME="lbAC"> </A>
-<H2>SYNOPSIS</H2>
-
-<B>service systemtap</B>
-
-<I>COMMAND</I> [<I>OPTIONS</I>] [<I>SCRIPT</I>...]
-
-<P>
-<A NAME="lbAD"> </A>
-<H2>DESCRIPTION</H2>
-
-The SystemTap initscript aims to provide a way to run scripts as a service and
-easily control them individually. Scripts can be configured to start upon manual
-request, or during system startup. On dracut-based systems, it is also possible
-to integrate scripts in the initramfs and have them start during early-boot.
-<P>
-There are various parameters and options available to modify global behaviour,
-as well as script behaviour. Dependencies between scripts can be established so
-that starting one starts others (especially convenient when using the
--DRELAY_HOST and -DRELAY_GUEST options of <I><A HREF="stap.1.html">stap</A></I>(1)).
-<P>
-The configuration file of the initscript is located at
-<B>${prefix}/etc/systemtap/config</B>. Acceptable parameters are detailed in the
-GLOBAL PARAMETERS section.
-<P>
-Scripts must be placed in the <B>${prefix}/etc/systemtap/script.d</B> directory
-and must have a <B>.stp</B> extension. When referring to them on the command-line
-however, there in no need to include the <B>.stp</B> extension. The scripts
-directory may be changed by setting the SCRIPT_PATH parameter in the
-configuration file.
-<P>
-<A NAME="lbAE"> </A>
-<H2>COMMANDS</H2>
-
-One of the commands below must be specified:
-<P>
-<DL COMPACT>
-<DT><B>start</B>
-
-<DD>
-Start <I>SCRIPT</I>s. If no scripts are specified, start the scripts specified by
-the DEFAULT_START configuration. If DEFAULT_START is not set, start all scripts
-in the script directory. For scripts already started, the command is ignored.
-The command will fail if the scripts fail to start (see also the PASSALL
-configuration).
-<P>
-If the AUTOCOMPILE configuration is on, the command will try to compile or
-update the specified scripts when one of the below conditions is true:
-<DL COMPACT><DT><DD>
-<DL COMPACT>
-<DT>-<DD>
-The compiled cache file does not exist.
-<DT>-<DD>
-The mtime (modified timestamp) of the original script file is newer than the
-time of the compiled script cache.
-<DT>-<DD>
-The specified stap options used to compile the script has been changed (see
-also the SCRIPT PARAMETERS section).
-<DT>-<DD>
-The result of `uname -a` has been changed.
-</DL>
-</DL>
-
-<P>
-<DT><B>stop</B>
-
-<DD>
-Stop <I>SCRIPT</I>s. If no scripts are specified, stop all running scripts. For
-scripts already stopped, the command is ignored. The command will fail if the
-scripts fail to stop (see also the PASSALL configuration).
-<P>
-<DT><B>restart</B>
-
-<DD>
-Stop and start <I>SCRIPT</I>s.
-<P>
-<DT><B>status</B>
-
-<DD>
-Show the state of <I>SCRIPT</I>s and their dependencies.
-<P>
-<DT><B>compile</B>
-
-<DD>
-Compile <I>SCRIPT</I>s but do not start them. If the scripts have already been
-compiled, prompt for confirmation before overwriting cache. Compile for the
-current kernel, or the kernel release specified by the <B>-r</B> option.
-<P>
-<DT><B>onboot</B>
-
-<DD>
-Make <I>SCRIPT</I>s part of the initramfs so that they are started earlier during
-the boot process. This command is only available on dracut-based systems. If no
-scripts are specified, create a normal initramfs devoid of any SystemTap files.
-<P>
-The initramfs is created for the current kernel, or the kernel release specified
-by the <B>-r</B> option. The path of the created initramfs defaults
-to <B>/boot/initramfs-KVER.img</B>, where KVER is the output of `uname -r`. Use
-the <B>-o</B> option to specify a different path.
-<P>
-If the output file already exists, it is overwritten, unless the <B>-b</B> switch
-is given, in which case the file is appended <B>.bak</B> rather than overwritten.
-However, if there is already a <B>.bak</B> version of the file, the backup will
-not be overwritten.
-<P>
-WARNING: do not use the <B>-o</B> option of <I><A HREF="stap.1.html">stap</A></I>(1) with onboot scripts
-because the script is started before the root filesystem is even mounted.
-Increase the buffer size if more space is needed.
-<P>
-<DT><B>cleanup</B>
-
-<DD>
-Delete the compiled <I>SCRIPT</I>s from cache. If no scripts are specified, then
-all compiled scripts are deleted. Only the cache for the current kernel is
-deleted, or the kernel release specified by the <B>-r</B> option. Prompt for
-confirmation before deleting.
-<P>
-</DL>
-<A NAME="lbAF"> </A>
-<H2>OPTIONS</H2>
-
-Many of the commands can also take options. However, since users can't pass
-these options on boot, they are only meant for managing scripts after boot and
-for testing. Available options are:
-<P>
-<DL COMPACT>
-<DT><B>-c </B><I>CONFIG_FILE</I>
-
-<DD>
-Specify a different configuration file in place of the default one.
-<P>
-<DT><B>-R</B>
-
-<DD>
-When using the <B>start</B> and <B>stop</B> commands, also include the scripts'
-dependencies (recursively).
-<P>
-<DT><B>-r </B><I>KERNEL_RELEASE</I>
-
-<DD>
-When using the <B>compile</B>, <B>onboot</B>, and <B>cleanup</B> commands, specify
-the target kernel version rather than using the current one. Must be in the same
-format as `uname -r`.
-<P>
-<DT><B>-y</B>
-
-<DD>
-Answer yes for all prompts.
-<P>
-<DT><B>-o </B><I>PATH.IMG</I>
-
-<DD>
-When using the <B>onboot</B> command, specify the output path of the created
-initramfs.
-<P>
-<DT><B>-b</B>
-
-<DD>
-When using the <B>onboot</B> command, backup an existing initramfs image by
-adding a <B>.bak</B> extension rather than overwriting it. Without this option,
-the initramfs is overwritten.
-<P>
-</DL>
-<A NAME="lbAG"> </A>
-<H2>GLOBAL PARAMETERS</H2>
-
-These parameters affect the general behaviour of the SystemTap initscript
-service. They can be specified in the configuration file.
-<P>
-<DL COMPACT>
-<DT><B>SCRIPT_PATH</B>
-
-<DD>
-Specify the absolute path of the script directory. These are the scripts on
-which the initscript can operate. Scripts must have the <B>.stp</B> extension.
-The default path is <B>${prefix}/etc/systemtap/script.d</B>.
-<P>
-<DT><B>CONFIG_PATH</B>
-
-<DD>
-Specify the absolute path of the script configuration directory. These
-configuration files contain options for specific scripts. They must have the
-<B>.conf</B> extension. The default path is <B>${prefix}/etc/systemtap/conf.d</B>.
-<P>
-<DT><B>CACHE_PATH</B>
-
-<DD>
-Specify the absolute path of the cache directory. The default path is
-<B>${prefix}/var/cache/systemtap</B>.
-<P>
-<DT><B>TEMP_PATH</B>
-
-<DD>
-Specify the absolute path of the temporary directory in which SystemTap
-makes temporary directories to compile scripts. The default path is <B>/tmp</B>.
-<P>
-<DT><B>STAT_PATH</B>
-
-<DD>
-Specify the absolute path of the directory containing PID files used to track
-the status of SystemTap scripts. The default path is
-<B>${prefix}/var/run/systemtap</B>.
-<P>
-<DT><B>LOG_FILE</B>
-
-<DD>
-Specify the absolute path of the log file. All messages are sent to this file,
-including compilation and runtime errors. The default path is
-<B>${prefix}/var/log/systemtap.log</B>.
-<P>
-<DT><B>PASSALL</B>
-
-<DD>
-If this is set <B>yes</B>, initscript commands that operate on multiple scripts
-will report as failed when the action could not be performed on at least one
-script. If set to <B>no</B>, only a warning is emitted. The default is <B>yes</B>.
-<P>
-<DT><B>RECURSIVE</B>
-
-<DD>
-If this is set <B>yes</B>, the initscript will always follow script dependencies
-recursively. This means that there is no need to specify the <B>-R</B> option.
-This flag is effective only if you specify script(s) from the command-line. The
-default is <B>no</B>.
-<P>
-<DT><B>AUTOCOMPILE</B>
-
-<DD>
-If this is set <B>yes</B>, the initscript automatically tries to compile
-specified scripts when needed if there is no valid cache. Otherwise, the related
-command simply fails. The default is <B>yes</B>.
-<P>
-<DT><B>DEFAULT_START</B>
-
-<DD>
-Specify scripts which will be started by default. If omitted (or empty), all
-scripts in the script directory will be started. The default is <B>""</B>.
-<P>
-<DT><B>ALLOW_CACHEONLY</B>
-
-<DD>
-If this is set <B>yes</B>, the initscript will also allow operating on scripts
-that are located in the cache directory, but not in the script directory. The
-default is <B>no</B>.
-<P>
-WARNING: the initscript may load unexpected obsolete caches with this option.
-The cache directory should be checked before enabling this option.
-<P>
-<DT><B>LOG_BOOT_ERR</B>
-
-<DD>
-Because boot-time scripts are run before the root filesystem is mounted,
-staprun's stderr cannot be logged to the LOG_FILE as usual. However, the log
-can instead be output to /var/run/systemtap/$script.log by setting LOG_BOOT_ERR
-to <B>yes</B>. If STAT_PATH is different from the default, the log files will be
-moved there upon executing any of the initscript commands. The default is
-<B>no</B>.
-<P>
-</DL>
-<P>
-
-Here is a global configuration file example:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-SCRIPT_PATH=/var/systemtap/script.d/
-PASSALL=yes
-RECURSIVE=no
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<A NAME="lbAH"> </A>
-<H2>SCRIPT PARAMETERS</H2>
-
-These parameters affect the compilation or runtime behaviour of specific
-SystemTap scripts. They must be placed in config files located in the
-CONFIG_PATH directory.
-<P>
-<DL COMPACT>
-<DT><B><SCRIPT>_OPT</B>
-
-<DD>
-Specify options passed to the <I><A HREF="stap.1.html">stap</A></I>(1) command for the SCRIPT. Here, SCRIPT
-is the name of the script file without the <B>.stp</B> extension. Note that the
-<B>-F</B> option is always added.
-<P>
-The following options are ignored when compiling scripts: -p, -m, -r, -c, -x,
--e, -s, -o, -h, -V, -k.
-<P>
-The following options are ignored when running starting scripts: -h, -V, -v, -t,
--p, -I, -e, -R, -r, -m, -k, -g, -P, -D, -b, -u, -q, -w, -l, -d, -L, -F, and all
-long options.
-<P>
-<DT><B><SCRIPT>_REQ</B>
-
-<DD>
-Specify script dependencies (i.e. which script this script requires). For
-example, if foo.stp requires (or needs to run after) bar.stp, set
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-foo_REQ="bar"
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-Specify multiple scripts by separating their names by spaces.
-<P>
-</DL>
-<P>
-
-Here is a script configuration file example:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-script1_OPT="-o /var/log/script1.out -DRELAY_HOST=group1"
-script2_OPT="-DRELAY_GUEST=group1"
-script2_REQ="script1"
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<A NAME="lbAI"> </A>
-<H2>EXAMPLES</H2>
-
-<P>
-<DL COMPACT>
-<DT><B>INSTALLING SCRIPTS</B>
-
-<DD>
-We first copy a SystemTap script (e.g. "script1.stp") into the script directory:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>#</B> cp script1.stp /etc/systemtap/script.d/
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-We can then set any script options, for example:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>#</B> vi /etc/systemtap/conf.d/group1
-script1_OPT="-o /var/log/group1.out -DRELAY_HOST=group1"
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-If we then install a script (e.g. "script2.stp") which shares a buffer with
-script1, there is a dependency. In this case, we can do the following:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>#</B> cp script2.stp /etc/systemtap/script.d/
-<B>#</B> vi /etc/systemtap/conf.d/group1
-script2_OPT="-DRELAY_GUEST=group1"
-script2_REQ="script1"
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-This way, if <I><A HREF="stap.1.html">stap</A></I>(1) fails to run script1, the initscript will not even
-try to run script2.
-<P>
-<DT><B>TESTING</B>
-
-<DD>
-After installing scripts, we can test that they work by simply doing:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>#</B> service systemtap start
-<B>#</B> service systemtap stop
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-We could be more specific as well, for example:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>#</B> service systemtap start script1
-<B>#</B> service systemtap stop script1
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-If there were no errors, we are ready to use it.
-<P>
-<DT><B>ENABLING SERVICE</B>
-
-<DD>
-After we're satisfied with the scripts and their tests, we can enable the
-SystemTap initscript service:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>#</B> chkconfig systemtap on
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<DT><B>DELETING SCRIPTS</B>
-
-<DD>
-Scripts are deleted by simply removing them from the script directory and
-removing any configuration lines specific to them:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>#</B> rm /etc/systemtap/script.d/script2.stp
-<B>#</B> vi /etc/systemtap/conf.d/group1
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-If the script is still running, we also need to stop it:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>#</B> service systemtap stop script2
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-We can then also remove the cache associated with the script:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>#</B> service systemtap cleanup script2
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<DT><B>PREPARING FOR KERNEL UPDATES</B>
-
-<DD>
-Usually, there is nothing to do when booting into a new kernel. The initscript
-will see that the kernel version is different and will compile the scripts. The
-compilation can be done beforehand as well to avoid having to compile during
-boot by using the <B>-r</B> option:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>#</B> service systemtap compile myscript -r <NEW_KERNEL_VERSION>
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<DT><B>IMPORTING COMPILED SCRIPTS</B>
-
-<DD>
-For environments which lack compilation infrastructure (e.g. no compilers or
-debuginfo), such as a production system, the scripts can be compiled on another
-(development) machine and then transferred over to the production system:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>#</B> service systemtap compile myscript -r \
-<BR>
-> <KERNEL_VERSION_OF_TARGET_MACHINE>
-<B>#</B> tar czf stap-scripts-<kernel-version>.tar.gz \
-<BR>
-> /var/cache/systemtap/<kernel-version> \
-<BR>
-> /etc/systemtap/conf.d/<configfile>
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-And then copy this package to the target machine and extract it.
-<P>
-<DT><B>STARTING SCRIPTS DURING EARLY-BOOT</B>
-
-<DD>
-The initscript also allows us to start scripts earlier during the boot process
-by creating an initramfs containing the script's module. The system must be
-dracut-based for this to work. Starting a script at this stage gives access to
-information otherwise very hard to obtain.
-<P>
-We first install the script by copying it into the script directory as usual and
-setting whatever options we'd like:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>#</B> cp myscript.stp /etc/systemtap/script.d
-<B>#</B> vi /etc/systemtap/conf.d/myscript.conf
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-To add the script to the initramfs, we use the <B>onboot</B> command:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>#</B> service systemtap onboot myscript
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-If the script is not already compiled and cached, it will be done at this point.
-A new initramfs will then be created at the default location. We can use the
-<B>-b</B> option to ensure that the existing initramfs is backed up. We can then
-restart the system.
-<P>
-<DT><B>USING A DIFFERENT INITRAMFS</B>
-
-<DD>
-If we would prefer to only start the script for one boot and not others, it
-might be easier to instead use the <B>-o</B> option to specify a different
-initramfs output file:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>#</B> service systemtap onboot myscript \
-> -o /boot/special_initramfs.img
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-Once the initramfs is created, it's simply a matter of changing the command-line
-options at boot-time so that the new image is used rather than the usual one.
-<P>
-<DT><B>CREATING AN INITRAMFS FOR A DIFFERENT KERNEL</B>
-
-<DD>
-Just like the compile command, we can use the <B>-r</B> option to specify the
-kernel for which we want to create the initramfs. This is useful when we are
-about to upgrade and would like to prepare in advance. For example:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>#</B> service systemtap onboot myscript \
-> -r 3.12.6-200.fc19.x86_64
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-<P>
-<DT><B>REMOVING SCRIPTS FROM THE INITRAMFS</B>
-
-<DD>
-Finally, to remove all script from the initramfs, we simple run the <B>onboot</B>
-command without specifying any scripts:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-<B>#</B> service systemtap onboot
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-This will simply create a standard initramfs without any SystemTap modules
-inserted.
-<P>
-<DT><B>TROUBLESHOOTING EARLY-BOOT ISSUES</B>
-
-<DD>
-There can be many reasons for which the module didn't insert or did not work as
-expected. It may be useful to turn on dracut debugging by adding 'rdinitdebug'
-to the kernel command-line and checking dmesg/journalctl -ae. Also, the stderr
-output of staprun can be captured by setting the LOG_BOOT_ERR option to
-<B>yes</B>.
-<P>
-</DL>
-<A NAME="lbAJ"> </A>
-<H2>SEE ALSO</H2>
-
-<I><A HREF="stap.1.html">stap</A></I>(1)
-
-<P>
-<A NAME="lbAK"> </A>
-<H2>BUGS</H2>
-
-Use the Bugzilla link of the project web page or our mailing list.
-
-<B><A HREF="http://sourceware.org/systemtap/">http://sourceware.org/systemtap/</A></B>, <B><<A HREF="mailto:systemtap@sourceware.org">systemtap@sourceware.org</A>></B>.
-
-
-<P>
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
-<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAE">COMMANDS</A><DD>
-<DT><A HREF="#lbAF">OPTIONS</A><DD>
-<DT><A HREF="#lbAG">GLOBAL PARAMETERS</A><DD>
-<DT><A HREF="#lbAH">SCRIPT PARAMETERS</A><DD>
-<DT><A HREF="#lbAI">EXAMPLES</A><DD>
-<DT><A HREF="#lbAJ">SEE ALSO</A><DD>
-<DT><A HREF="#lbAK">BUGS</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::ansi</TITLE>
-</HEAD><BODY>
-<H1>tapset::ansi</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::ansi - systemtap ansi tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>ansi_clear_screen </B>
-
-<DD>
-Move cursor to top left and clear screen.
-<DT><DD>
-See
-<I><A HREF="./function::ansi_clear_screen.3stap.html">function::ansi_clear_screen</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ansi_set_color </B>
-
-<DD>
-Set the ansi Select Graphic Rendition mode.
-<DT><DD>
-See
-<I><A HREF="./function::ansi_set_color.3stap.html">function::ansi_set_color</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ansi_set_color2 </B>
-
-<DD>
-Set the ansi Select Graphic Rendition mode.
-<DT><DD>
-See
-<I><A HREF="./function::ansi_set_color2.3stap.html">function::ansi_set_color2</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ansi_set_color3 </B>
-
-<DD>
-Set the ansi Select Graphic Rendition mode.
-<DT><DD>
-See
-<I><A HREF="./function::ansi_set_color3.3stap.html">function::ansi_set_color3</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ansi_reset_color </B>
-
-<DD>
-Resets Select Graphic Rendition mode.
-<DT><DD>
-See
-<I><A HREF="./function::ansi_reset_color.3stap.html">function::ansi_reset_color</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ansi_new_line </B>
-
-<DD>
-Move cursor to new line.
-<DT><DD>
-See
-<I><A HREF="./function::ansi_new_line.3stap.html">function::ansi_new_line</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ansi_cursor_move </B>
-
-<DD>
-Move cursor to new coordinates.
-<DT><DD>
-See
-<I><A HREF="./function::ansi_cursor_move.3stap.html">function::ansi_cursor_move</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ansi_cursor_hide </B>
-
-<DD>
-Hides the cursor.
-<DT><DD>
-See
-<I><A HREF="./function::ansi_cursor_hide.3stap.html">function::ansi_cursor_hide</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ansi_cursor_save </B>
-
-<DD>
-Saves the cursor position.
-<DT><DD>
-See
-<I><A HREF="./function::ansi_cursor_save.3stap.html">function::ansi_cursor_save</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ansi_cursor_restore </B>
-
-<DD>
-Restores a previously saved cursor position.
-<DT><DD>
-See
-<I><A HREF="./function::ansi_cursor_restore.3stap.html">function::ansi_cursor_restore</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ansi_cursor_show </B>
-
-<DD>
-Shows the cursor.
-<DT><DD>
-See
-<I><A HREF="./function::ansi_cursor_show.3stap.html">function::ansi_cursor_show</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::ansi_clear_screen.3stap.html">function::ansi_clear_screen</A></I>(3stap),
-
-
-<I><A HREF="./function::ansi_set_color.3stap.html">function::ansi_set_color</A></I>(3stap),
-
-
-<I><A HREF="./function::ansi_set_color2.3stap.html">function::ansi_set_color2</A></I>(3stap),
-
-
-<I><A HREF="./function::ansi_set_color3.3stap.html">function::ansi_set_color3</A></I>(3stap),
-
-
-<I><A HREF="./function::ansi_reset_color.3stap.html">function::ansi_reset_color</A></I>(3stap),
-
-
-<I><A HREF="./function::ansi_new_line.3stap.html">function::ansi_new_line</A></I>(3stap),
-
-
-<I><A HREF="./function::ansi_cursor_move.3stap.html">function::ansi_cursor_move</A></I>(3stap),
-
-
-<I><A HREF="./function::ansi_cursor_hide.3stap.html">function::ansi_cursor_hide</A></I>(3stap),
-
-
-<I><A HREF="./function::ansi_cursor_save.3stap.html">function::ansi_cursor_save</A></I>(3stap),
-
-
-<I><A HREF="./function::ansi_cursor_restore.3stap.html">function::ansi_cursor_restore</A></I>(3stap),
-
-
-<I><A HREF="./function::ansi_cursor_show.3stap.html">function::ansi_cursor_show</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::atomic</TITLE>
-</HEAD><BODY>
-<H1>tapset::atomic</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::atomic - systemtap atomic tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>atomic_read </B>
-
-<DD>
-Retrieves an atomic variable from kernel memory
-<DT><DD>
-See
-<I><A HREF="./function::atomic_read.3stap.html">function::atomic_read</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>atomic_long_read </B>
-
-<DD>
-Retrieves an atomic long variable from kernel memory
-<DT><DD>
-See
-<I><A HREF="./function::atomic_long_read.3stap.html">function::atomic_long_read</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::atomic_read.3stap.html">function::atomic_read</A></I>(3stap),
-
-
-<I><A HREF="./function::atomic_long_read.3stap.html">function::atomic_long_read</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::context-caller</TITLE>
-</HEAD><BODY>
-<H1>tapset::context-caller</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::context-caller - systemtap context-caller tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> Provides caller and caller_addr function for context for kernel and user
-<BR> space.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>callers </B>
-
-<DD>
-Return first n elements of kernel stack backtrace
-<DT><DD>
-See
-<I><A HREF="./function::callers.3stap.html">function::callers</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>caller </B>
-
-<DD>
-Return name and address of calling function
-<DT><DD>
-See
-<I><A HREF="./function::caller.3stap.html">function::caller</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>caller_addr </B>
-
-<DD>
-Return caller address
-<DT><DD>
-See
-<I><A HREF="./function::caller_addr.3stap.html">function::caller_addr</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::callers.3stap.html">function::callers</A></I>(3stap),
-
-
-<I><A HREF="./function::caller.3stap.html">function::caller</A></I>(3stap),
-
-
-<I><A HREF="./function::caller_addr.3stap.html">function::caller_addr</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::context-envvar</TITLE>
-</HEAD><BODY>
-<H1>tapset::context-envvar</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::context-envvar - systemtap context-envvar tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> Context functions provide additional information about where an event occurred. These functions can
-provide information such as a backtrace to where the event occurred and the current register values for the
-processor.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>env_var </B>
-
-<DD>
-Fetch environment variable from current process
-<DT><DD>
-See
-<I><A HREF="./function::env_var.3stap.html">function::env_var</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::env_var.3stap.html">function::env_var</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::context-symbols</TITLE>
-</HEAD><BODY>
-<H1>tapset::context-symbols</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::context-symbols - systemtap context-symbols tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> Context functions provide additional information about where an event occurred. These functions can
-provide information such as a backtrace to where the event occurred and the current register values for the
-processor.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>stack </B>
-
-<DD>
-Return address at given depth of kernel stack backtrace
-<DT><DD>
-See
-<I><A HREF="./function::stack.3stap.html">function::stack</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>print_stack </B>
-
-<DD>
-Print out kernel stack from string
-<DT><DD>
-See
-<I><A HREF="./function::print_stack.3stap.html">function::print_stack</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sprint_stack </B>
-
-<DD>
-Return stack for kernel addresses from string
-<DT><DD>
-See
-<I><A HREF="./function::sprint_stack.3stap.html">function::sprint_stack</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>probefunc </B>
-
-<DD>
-Return the probe point's function name, if known
-<DT><DD>
-See
-<I><A HREF="./function::probefunc.3stap.html">function::probefunc</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>probemod </B>
-
-<DD>
-Return the probe point's kernel module name
-<DT><DD>
-See
-<I><A HREF="./function::probemod.3stap.html">function::probemod</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>modname </B>
-
-<DD>
-Return the kernel module name loaded at the address
-<DT><DD>
-See
-<I><A HREF="./function::modname.3stap.html">function::modname</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>symname </B>
-
-<DD>
-Return the kernel symbol associated with the given address
-<DT><DD>
-See
-<I><A HREF="./function::symname.3stap.html">function::symname</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>symdata </B>
-
-<DD>
-Return the kernel symbol and module offset for the address
-<DT><DD>
-See
-<I><A HREF="./function::symdata.3stap.html">function::symdata</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>print_syms </B>
-
-<DD>
-Print out kernel stack from string
-<DT><DD>
-See
-<I><A HREF="./function::print_syms.3stap.html">function::print_syms</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sprint_syms </B>
-
-<DD>
-Return stack for kernel addresses from string
-<DT><DD>
-See
-<I><A HREF="./function::sprint_syms.3stap.html">function::sprint_syms</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::stack.3stap.html">function::stack</A></I>(3stap),
-
-
-<I><A HREF="./function::print_stack.3stap.html">function::print_stack</A></I>(3stap),
-
-
-<I><A HREF="./function::sprint_stack.3stap.html">function::sprint_stack</A></I>(3stap),
-
-
-<I><A HREF="./function::probefunc.3stap.html">function::probefunc</A></I>(3stap),
-
-
-<I><A HREF="./function::probemod.3stap.html">function::probemod</A></I>(3stap),
-
-
-<I><A HREF="./function::modname.3stap.html">function::modname</A></I>(3stap),
-
-
-<I><A HREF="./function::symname.3stap.html">function::symname</A></I>(3stap),
-
-
-<I><A HREF="./function::symdata.3stap.html">function::symdata</A></I>(3stap),
-
-
-<I><A HREF="./function::print_syms.3stap.html">function::print_syms</A></I>(3stap),
-
-
-<I><A HREF="./function::sprint_syms.3stap.html">function::sprint_syms</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::context-unwind</TITLE>
-</HEAD><BODY>
-<H1>tapset::context-unwind</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::context-unwind - systemtap context-unwind tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> Context functions provide additional information about where an event occurred. These functions can
-provide information such as a backtrace to where the event occurred and the current register values for the
-processor.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>print_backtrace </B>
-
-<DD>
-Print kernel stack back trace
-<DT><DD>
-See
-<I><A HREF="./function::print_backtrace.3stap.html">function::print_backtrace</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sprint_backtrace </B>
-
-<DD>
-Return stack back trace as string
-<DT><DD>
-See
-<I><A HREF="./function::sprint_backtrace.3stap.html">function::sprint_backtrace</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>backtrace </B>
-
-<DD>
-Hex backtrace of current kernel stack
-<DT><DD>
-See
-<I><A HREF="./function::backtrace.3stap.html">function::backtrace</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_backtrace </B>
-
-<DD>
-Hex backtrace of an arbitrary task
-<DT><DD>
-See
-<I><A HREF="./function::task_backtrace.3stap.html">function::task_backtrace</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::print_backtrace.3stap.html">function::print_backtrace</A></I>(3stap),
-
-
-<I><A HREF="./function::sprint_backtrace.3stap.html">function::sprint_backtrace</A></I>(3stap),
-
-
-<I><A HREF="./function::backtrace.3stap.html">function::backtrace</A></I>(3stap),
-
-
-<I><A HREF="./function::task_backtrace.3stap.html">function::task_backtrace</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::context</TITLE>
-</HEAD><BODY>
-<H1>tapset::context</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::context - systemtap context tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> Context functions provide additional information about where an event occurred. These functions can
-provide information such as a backtrace to where the event occurred and the current register values for the
-processor.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>print_regs </B>
-
-<DD>
-Print a register dump
-<DT><DD>
-See
-<I><A HREF="./function::print_regs.3stap.html">function::print_regs</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>pp </B>
-
-<DD>
-Returns the active probe point
-<DT><DD>
-See
-<I><A HREF="./function::pp.3stap.html">function::pp</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ppfunc </B>
-
-<DD>
-Returns the function name parsed from pp()
-<DT><DD>
-See
-<I><A HREF="./function::ppfunc.3stap.html">function::ppfunc</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>probe_type </B>
-
-<DD>
-The low level probe handler type of the current probe.
-<DT><DD>
-See
-<I><A HREF="./function::probe_type.3stap.html">function::probe_type</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>execname </B>
-
-<DD>
-Returns the execname of a target process (or group of processes)
-<DT><DD>
-See
-<I><A HREF="./function::execname.3stap.html">function::execname</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>pid </B>
-
-<DD>
-Returns the ID of a target process
-<DT><DD>
-See
-<I><A HREF="./function::pid.3stap.html">function::pid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tid </B>
-
-<DD>
-Returns the thread ID of a target process
-<DT><DD>
-See
-<I><A HREF="./function::tid.3stap.html">function::tid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ppid </B>
-
-<DD>
-Returns the process ID of a target process's parent process
-<DT><DD>
-See
-<I><A HREF="./function::ppid.3stap.html">function::ppid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>pgrp </B>
-
-<DD>
-Returns the process group ID of the current process
-<DT><DD>
-See
-<I><A HREF="./function::pgrp.3stap.html">function::pgrp</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sid </B>
-
-<DD>
-Returns the session ID of the current process
-<DT><DD>
-See
-<I><A HREF="./function::sid.3stap.html">function::sid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>pexecname </B>
-
-<DD>
-Returns the execname of a target process's parent process
-<DT><DD>
-See
-<I><A HREF="./function::pexecname.3stap.html">function::pexecname</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>gid </B>
-
-<DD>
-Returns the group ID of a target process
-<DT><DD>
-See
-<I><A HREF="./function::gid.3stap.html">function::gid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>egid </B>
-
-<DD>
-Returns the effective gid of a target process
-<DT><DD>
-See
-<I><A HREF="./function::egid.3stap.html">function::egid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>uid </B>
-
-<DD>
-Returns the user ID of a target process
-<DT><DD>
-See
-<I><A HREF="./function::uid.3stap.html">function::uid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>euid </B>
-
-<DD>
-Return the effective uid of a target process
-<DT><DD>
-See
-<I><A HREF="./function::euid.3stap.html">function::euid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>is_myproc </B>
-
-<DD>
-Determines if the current probe point has occurred in the user's own process
-<DT><DD>
-See
-<I><A HREF="./function::is_myproc.3stap.html">function::is_myproc</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>cpuid </B>
-
-<DD>
-Returns the current cpu number
-<DT><DD>
-See
-<I><A HREF="./function::cpuid.3stap.html">function::cpuid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>cpu </B>
-
-<DD>
-Returns the current cpu number
-<DT><DD>
-See
-<I><A HREF="./function::cpu.3stap.html">function::cpu</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>registers_valid </B>
-
-<DD>
-Determines validity of register() and u_register() in current context
-<DT><DD>
-See
-<I><A HREF="./function::registers_valid.3stap.html">function::registers_valid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_mode </B>
-
-<DD>
-Determines if probe point occurs in user-mode
-<DT><DD>
-See
-<I><A HREF="./function::user_mode.3stap.html">function::user_mode</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>is_return </B>
-
-<DD>
-Whether the current probe context is a return probe
-<DT><DD>
-See
-<I><A HREF="./function::is_return.3stap.html">function::is_return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>target </B>
-
-<DD>
-Return the process ID of the target process
-<DT><DD>
-See
-<I><A HREF="./function::target.3stap.html">function::target</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>module_name </B>
-
-<DD>
-The module name of the current script
-<DT><DD>
-See
-<I><A HREF="./function::module_name.3stap.html">function::module_name</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stp_pid </B>
-
-<DD>
-The process id of the stapio process
-<DT><DD>
-See
-<I><A HREF="./function::stp_pid.3stap.html">function::stp_pid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>remote_id </B>
-
-<DD>
-The index of this instance in a remote execution.
-<DT><DD>
-See
-<I><A HREF="./function::remote_id.3stap.html">function::remote_id</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>remote_uri </B>
-
-<DD>
-The name of this instance in a remote execution.
-<DT><DD>
-See
-<I><A HREF="./function::remote_uri.3stap.html">function::remote_uri</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stack_size </B>
-
-<DD>
-Return the size of the kernel stack
-<DT><DD>
-See
-<I><A HREF="./function::stack_size.3stap.html">function::stack_size</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stack_used </B>
-
-<DD>
-Returns the amount of kernel stack used
-<DT><DD>
-See
-<I><A HREF="./function::stack_used.3stap.html">function::stack_used</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stack_unused </B>
-
-<DD>
-Returns the amount of kernel stack currently available
-<DT><DD>
-See
-<I><A HREF="./function::stack_unused.3stap.html">function::stack_unused</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>addr </B>
-
-<DD>
-Address of the current probe point.
-<DT><DD>
-See
-<I><A HREF="./function::addr.3stap.html">function::addr</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>uaddr </B>
-
-<DD>
-User space address of current running task
-<DT><DD>
-See
-<I><A HREF="./function::uaddr.3stap.html">function::uaddr</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>cmdline_args </B>
-
-<DD>
-Fetch command line arguments from current process
-<DT><DD>
-See
-<I><A HREF="./function::cmdline_args.3stap.html">function::cmdline_args</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>cmdline_arg </B>
-
-<DD>
-Fetch a command line argument
-<DT><DD>
-See
-<I><A HREF="./function::cmdline_arg.3stap.html">function::cmdline_arg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>cmdline_str </B>
-
-<DD>
-Fetch all command line arguments from current process
-<DT><DD>
-See
-<I><A HREF="./function::cmdline_str.3stap.html">function::cmdline_str</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::print_regs.3stap.html">function::print_regs</A></I>(3stap),
-
-
-<I><A HREF="./function::pp.3stap.html">function::pp</A></I>(3stap),
-
-
-<I><A HREF="./function::ppfunc.3stap.html">function::ppfunc</A></I>(3stap),
-
-
-<I><A HREF="./function::probe_type.3stap.html">function::probe_type</A></I>(3stap),
-
-
-<I><A HREF="./function::execname.3stap.html">function::execname</A></I>(3stap),
-
-
-<I><A HREF="./function::pid.3stap.html">function::pid</A></I>(3stap),
-
-
-<I><A HREF="./function::tid.3stap.html">function::tid</A></I>(3stap),
-
-
-<I><A HREF="./function::ppid.3stap.html">function::ppid</A></I>(3stap),
-
-
-<I><A HREF="./function::pgrp.3stap.html">function::pgrp</A></I>(3stap),
-
-
-<I><A HREF="./function::sid.3stap.html">function::sid</A></I>(3stap),
-
-
-<I><A HREF="./function::pexecname.3stap.html">function::pexecname</A></I>(3stap),
-
-
-<I><A HREF="./function::gid.3stap.html">function::gid</A></I>(3stap),
-
-
-<I><A HREF="./function::egid.3stap.html">function::egid</A></I>(3stap),
-
-
-<I><A HREF="./function::uid.3stap.html">function::uid</A></I>(3stap),
-
-
-<I><A HREF="./function::euid.3stap.html">function::euid</A></I>(3stap),
-
-
-<I><A HREF="./function::is_myproc.3stap.html">function::is_myproc</A></I>(3stap),
-
-
-<I><A HREF="./function::cpuid.3stap.html">function::cpuid</A></I>(3stap),
-
-
-<I><A HREF="./function::cpu.3stap.html">function::cpu</A></I>(3stap),
-
-
-<I><A HREF="./function::registers_valid.3stap.html">function::registers_valid</A></I>(3stap),
-
-
-<I><A HREF="./function::user_mode.3stap.html">function::user_mode</A></I>(3stap),
-
-
-<I><A HREF="./function::is_return.3stap.html">function::is_return</A></I>(3stap),
-
-
-<I><A HREF="./function::target.3stap.html">function::target</A></I>(3stap),
-
-
-<I><A HREF="./function::module_name.3stap.html">function::module_name</A></I>(3stap),
-
-
-<I><A HREF="./function::stp_pid.3stap.html">function::stp_pid</A></I>(3stap),
-
-
-<I><A HREF="./function::remote_id.3stap.html">function::remote_id</A></I>(3stap),
-
-
-<I><A HREF="./function::remote_uri.3stap.html">function::remote_uri</A></I>(3stap),
-
-
-<I><A HREF="./function::stack_size.3stap.html">function::stack_size</A></I>(3stap),
-
-
-<I><A HREF="./function::stack_used.3stap.html">function::stack_used</A></I>(3stap),
-
-
-<I><A HREF="./function::stack_unused.3stap.html">function::stack_unused</A></I>(3stap),
-
-
-<I><A HREF="./function::addr.3stap.html">function::addr</A></I>(3stap),
-
-
-<I><A HREF="./function::uaddr.3stap.html">function::uaddr</A></I>(3stap),
-
-
-<I><A HREF="./function::cmdline_args.3stap.html">function::cmdline_args</A></I>(3stap),
-
-
-<I><A HREF="./function::cmdline_arg.3stap.html">function::cmdline_arg</A></I>(3stap),
-
-
-<I><A HREF="./function::cmdline_str.3stap.html">function::cmdline_str</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:29 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::conversions-guru</TITLE>
-</HEAD><BODY>
-<H1>tapset::conversions-guru</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::conversions-guru - systemtap conversions-guru tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>set_kernel_string </B>
-
-<DD>
-Writes a string to kernel memory
-<DT><DD>
-See
-<I><A HREF="./function::set_kernel_string.3stap.html">function::set_kernel_string</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>set_kernel_string_n </B>
-
-<DD>
-Writes a string of given length to kernel memory
-<DT><DD>
-See
-<I><A HREF="./function::set_kernel_string_n.3stap.html">function::set_kernel_string_n</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>set_kernel_long </B>
-
-<DD>
-Writes a long value to kernel memory
-<DT><DD>
-See
-<I><A HREF="./function::set_kernel_long.3stap.html">function::set_kernel_long</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>set_kernel_int </B>
-
-<DD>
-Writes an int value to kernel memory
-<DT><DD>
-See
-<I><A HREF="./function::set_kernel_int.3stap.html">function::set_kernel_int</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>set_kernel_short </B>
-
-<DD>
-Writes a short value to kernel memory
-<DT><DD>
-See
-<I><A HREF="./function::set_kernel_short.3stap.html">function::set_kernel_short</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>set_kernel_char </B>
-
-<DD>
-Writes a char value to kernel memory
-<DT><DD>
-See
-<I><A HREF="./function::set_kernel_char.3stap.html">function::set_kernel_char</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>set_kernel_pointer </B>
-
-<DD>
-Writes a pointer value to kernel memory.
-<DT><DD>
-See
-<I><A HREF="./function::set_kernel_pointer.3stap.html">function::set_kernel_pointer</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::set_kernel_string.3stap.html">function::set_kernel_string</A></I>(3stap),
-
-
-<I><A HREF="./function::set_kernel_string_n.3stap.html">function::set_kernel_string_n</A></I>(3stap),
-
-
-<I><A HREF="./function::set_kernel_long.3stap.html">function::set_kernel_long</A></I>(3stap),
-
-
-<I><A HREF="./function::set_kernel_int.3stap.html">function::set_kernel_int</A></I>(3stap),
-
-
-<I><A HREF="./function::set_kernel_short.3stap.html">function::set_kernel_short</A></I>(3stap),
-
-
-<I><A HREF="./function::set_kernel_char.3stap.html">function::set_kernel_char</A></I>(3stap),
-
-
-<I><A HREF="./function::set_kernel_pointer.3stap.html">function::set_kernel_pointer</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::conversions</TITLE>
-</HEAD><BODY>
-<H1>tapset::conversions</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::conversions - systemtap conversions tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>kernel_string </B>
-
-<DD>
-Retrieves string from kernel memory
-<DT><DD>
-See
-<I><A HREF="./function::kernel_string.3stap.html">function::kernel_string</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>kernel_string2 </B>
-
-<DD>
-Retrieves string from kernel memory with alternative error string
-<DT><DD>
-See
-<I><A HREF="./function::kernel_string2.3stap.html">function::kernel_string2</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>kernel_string_n </B>
-
-<DD>
-Retrieves string of given length from kernel memory
-<DT><DD>
-See
-<I><A HREF="./function::kernel_string_n.3stap.html">function::kernel_string_n</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>kernel_string_utf32 </B>
-
-<DD>
-Retrieves UTF-32 string from kernel memory
-<DT><DD>
-See
-<I><A HREF="./function::kernel_string_utf32.3stap.html">function::kernel_string_utf32</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>kernel_string2_utf32 </B>
-
-<DD>
-Retrieves UTF-32 string from kernel memory with alternative error string
-<DT><DD>
-See
-<I><A HREF="./function::kernel_string2_utf32.3stap.html">function::kernel_string2_utf32</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>kernel_string_utf16 </B>
-
-<DD>
-Retrieves UTF-16 string from kernel memory
-<DT><DD>
-See
-<I><A HREF="./function::kernel_string_utf16.3stap.html">function::kernel_string_utf16</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>kernel_string2_utf16 </B>
-
-<DD>
-Retrieves UTF-16 string from kernel memory with alternative error string
-<DT><DD>
-See
-<I><A HREF="./function::kernel_string2_utf16.3stap.html">function::kernel_string2_utf16</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>kernel_long </B>
-
-<DD>
-Retrieves a long value stored in kernel memory
-<DT><DD>
-See
-<I><A HREF="./function::kernel_long.3stap.html">function::kernel_long</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>kernel_int </B>
-
-<DD>
-Retrieves an int value stored in kernel memory
-<DT><DD>
-See
-<I><A HREF="./function::kernel_int.3stap.html">function::kernel_int</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>kernel_short </B>
-
-<DD>
-Retrieves a short value stored in kernel memory
-<DT><DD>
-See
-<I><A HREF="./function::kernel_short.3stap.html">function::kernel_short</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>kernel_char </B>
-
-<DD>
-Retrieves a char value stored in kernel memory
-<DT><DD>
-See
-<I><A HREF="./function::kernel_char.3stap.html">function::kernel_char</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>kernel_pointer </B>
-
-<DD>
-Retrieves a pointer value stored in kernel memory
-<DT><DD>
-See
-<I><A HREF="./function::kernel_pointer.3stap.html">function::kernel_pointer</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::kernel_string.3stap.html">function::kernel_string</A></I>(3stap),
-
-
-<I><A HREF="./function::kernel_string2.3stap.html">function::kernel_string2</A></I>(3stap),
-
-
-<I><A HREF="./function::kernel_string_n.3stap.html">function::kernel_string_n</A></I>(3stap),
-
-
-<I><A HREF="./function::kernel_string_utf32.3stap.html">function::kernel_string_utf32</A></I>(3stap),
-
-
-<I><A HREF="./function::kernel_string2_utf32.3stap.html">function::kernel_string2_utf32</A></I>(3stap),
-
-
-<I><A HREF="./function::kernel_string_utf16.3stap.html">function::kernel_string_utf16</A></I>(3stap),
-
-
-<I><A HREF="./function::kernel_string2_utf16.3stap.html">function::kernel_string2_utf16</A></I>(3stap),
-
-
-<I><A HREF="./function::kernel_long.3stap.html">function::kernel_long</A></I>(3stap),
-
-
-<I><A HREF="./function::kernel_int.3stap.html">function::kernel_int</A></I>(3stap),
-
-
-<I><A HREF="./function::kernel_short.3stap.html">function::kernel_short</A></I>(3stap),
-
-
-<I><A HREF="./function::kernel_char.3stap.html">function::kernel_char</A></I>(3stap),
-
-
-<I><A HREF="./function::kernel_pointer.3stap.html">function::kernel_pointer</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::ctime</TITLE>
-</HEAD><BODY>
-<H1>tapset::ctime</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::ctime - systemtap ctime tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>ctime </B>
-
-<DD>
-Convert seconds since epoch into human readable date/time string
-<DT><DD>
-See
-<I><A HREF="./function::ctime.3stap.html">function::ctime</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::ctime.3stap.html">function::ctime</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::dentry</TITLE>
-</HEAD><BODY>
-<H1>tapset::dentry</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::dentry - systemtap dentry tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT><DD>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::dev</TITLE>
-</HEAD><BODY>
-<H1>tapset::dev</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::dev - systemtap dev tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>MAJOR </B>
-
-<DD>
-Extract major device number from a kernel device number (kdev_t)
-<DT><DD>
-See
-<I><A HREF="./function::MAJOR.3stap.html">function::MAJOR</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>MINOR </B>
-
-<DD>
-Extract minor device number from a kernel device number (kdev_t)
-<DT><DD>
-See
-<I><A HREF="./function::MINOR.3stap.html">function::MINOR</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>MKDEF </B>
-
-<DD>
-Creates a value that can be compared to a kernel device number (kdev_t)
-<DT><DD>
-See
-<I><A HREF="./function::MKDEF.3stap.html">function::MKDEF</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>usrdev2kerndev </B>
-
-<DD>
-Converts a user-space device number into the format used in the kernel
-<DT><DD>
-See
-<I><A HREF="./function::usrdev2kerndev.3stap.html">function::usrdev2kerndev</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::MAJOR.3stap.html">function::MAJOR</A></I>(3stap),
-
-
-<I><A HREF="./function::MINOR.3stap.html">function::MINOR</A></I>(3stap),
-
-
-<I><A HREF="./function::MKDEF.3stap.html">function::MKDEF</A></I>(3stap),
-
-
-<I><A HREF="./function::usrdev2kerndev.3stap.html">function::usrdev2kerndev</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::errno</TITLE>
-</HEAD><BODY>
-<H1>tapset::errno</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::errno - systemtap errno tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>errno_str </B>
-
-<DD>
-Symbolic string associated with error code
-<DT><DD>
-See
-<I><A HREF="./function::errno_str.3stap.html">function::errno_str</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>returnval </B>
-
-<DD>
-Possible return value of probed function
-<DT><DD>
-See
-<I><A HREF="./function::returnval.3stap.html">function::returnval</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>returnstr </B>
-
-<DD>
-Formats the return value as a string
-<DT><DD>
-See
-<I><A HREF="./function::returnstr.3stap.html">function::returnstr</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>return_str </B>
-
-<DD>
-Formats the return value as a string
-<DT><DD>
-See
-<I><A HREF="./function::return_str.3stap.html">function::return_str</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::errno_str.3stap.html">function::errno_str</A></I>(3stap),
-
-
-<I><A HREF="./function::returnval.3stap.html">function::returnval</A></I>(3stap),
-
-
-<I><A HREF="./function::returnstr.3stap.html">function::returnstr</A></I>(3stap),
-
-
-<I><A HREF="./function::return_str.3stap.html">function::return_str</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::guru-delay</TITLE>
-</HEAD><BODY>
-<H1>tapset::guru-delay</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::guru-delay - systemtap guru-delay tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> Functions in the guru-delay tapset allow a probe handler to insert
-<BR> deliberate delays. This is sometimes useful as a fault-injection
-<BR> aid. Due to its likelihood of interference with the kernel, guru
-<BR> mode is required, and overload-prevention is suppressed.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>mdelay </B>
-
-<DD>
-millisecond delay
-<DT><DD>
-See
-<I><A HREF="./function::mdelay.3stap.html">function::mdelay</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>udelay </B>
-
-<DD>
-microsecond delay
-<DT><DD>
-See
-<I><A HREF="./function::udelay.3stap.html">function::udelay</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::mdelay.3stap.html">function::mdelay</A></I>(3stap),
-
-
-<I><A HREF="./function::udelay.3stap.html">function::udelay</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::guru-signal</TITLE>
-</HEAD><BODY>
-<H1>tapset::guru-signal</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::guru-signal - systemtap guru-signal tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> Functions in the guru-signal tapset allow a probe handler to queue
-<BR> a user-space signals. Such operations may only be safe from some
-<BR> kinds of probe points, therefore are guru-mode only.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>raise </B>
-
-<DD>
-raise a signal in the current thread
-<DT><DD>
-See
-<I><A HREF="./function::raise.3stap.html">function::raise</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::raise.3stap.html">function::raise</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::indent</TITLE>
-</HEAD><BODY>
-<H1>tapset::indent</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::indent - systemtap indent tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>thread_indent </B>
-
-<DD>
-returns an amount of space with the current task information
-<DT><DD>
-See
-<I><A HREF="./function::thread_indent.3stap.html">function::thread_indent</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>thread_indent_depth </B>
-
-<DD>
-returns the nested-depth of the current task
-<DT><DD>
-See
-<I><A HREF="./function::thread_indent_depth.3stap.html">function::thread_indent_depth</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>indent </B>
-
-<DD>
-returns an amount of space to indent
-<DT><DD>
-See
-<I><A HREF="./function::indent.3stap.html">function::indent</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>indent_depth </B>
-
-<DD>
-returns the global nested-depth
-<DT><DD>
-See
-<I><A HREF="./function::indent_depth.3stap.html">function::indent_depth</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::thread_indent.3stap.html">function::thread_indent</A></I>(3stap),
-
-
-<I><A HREF="./function::thread_indent_depth.3stap.html">function::thread_indent_depth</A></I>(3stap),
-
-
-<I><A HREF="./function::indent.3stap.html">function::indent</A></I>(3stap),
-
-
-<I><A HREF="./function::indent_depth.3stap.html">function::indent_depth</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::inet</TITLE>
-</HEAD><BODY>
-<H1>tapset::inet</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::inet - systemtap inet tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>htonll </B>
-
-<DD>
-Convert 64-bit long long from host to network order
-<DT><DD>
-See
-<I><A HREF="./function::htonll.3stap.html">function::htonll</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>htonl </B>
-
-<DD>
-Convert 32-bit long from host to network order
-<DT><DD>
-See
-<I><A HREF="./function::htonl.3stap.html">function::htonl</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>htons </B>
-
-<DD>
-Convert 16-bit short from host to network order
-<DT><DD>
-See
-<I><A HREF="./function::htons.3stap.html">function::htons</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ntohll </B>
-
-<DD>
-Convert 64-bit long long from network to host order
-<DT><DD>
-See
-<I><A HREF="./function::ntohll.3stap.html">function::ntohll</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ntohl </B>
-
-<DD>
-Convert 32-bit long from network to host order
-<DT><DD>
-See
-<I><A HREF="./function::ntohl.3stap.html">function::ntohl</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ntohs </B>
-
-<DD>
-Convert 16-bit short from network to host order
-<DT><DD>
-See
-<I><A HREF="./function::ntohs.3stap.html">function::ntohs</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::htonll.3stap.html">function::htonll</A></I>(3stap),
-
-
-<I><A HREF="./function::htonl.3stap.html">function::htonl</A></I>(3stap),
-
-
-<I><A HREF="./function::htons.3stap.html">function::htons</A></I>(3stap),
-
-
-<I><A HREF="./function::ntohll.3stap.html">function::ntohll</A></I>(3stap),
-
-
-<I><A HREF="./function::ntohl.3stap.html">function::ntohl</A></I>(3stap),
-
-
-<I><A HREF="./function::ntohs.3stap.html">function::ntohs</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::inet_sock</TITLE>
-</HEAD><BODY>
-<H1>tapset::inet_sock</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::inet_sock - systemtap inet_sock tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>inet_get_local_port </B>
-
-<DD>
-Provide local port number for a kernel socket
-<DT><DD>
-See
-<I><A HREF="./function::inet_get_local_port.3stap.html">function::inet_get_local_port</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>inet_get_ip_source </B>
-
-<DD>
-Provide IP source address string for a kernel socket
-<DT><DD>
-See
-<I><A HREF="./function::inet_get_ip_source.3stap.html">function::inet_get_ip_source</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::inet_get_local_port.3stap.html">function::inet_get_local_port</A></I>(3stap),
-
-
-<I><A HREF="./function::inet_get_ip_source.3stap.html">function::inet_get_ip_source</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::ioblock</TITLE>
-</HEAD><BODY>
-<H1>tapset::ioblock</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::ioblock - systemtap ioblock tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>ioblock.request </B>
-
-<DD>
-Fires whenever making a generic block I/O request.
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioblock.request.3stap.html">probe::ioblock.request</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ioblock.end </B>
-
-<DD>
-Fires whenever a block I/O transfer is complete.
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioblock.end.3stap.html">probe::ioblock.end</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ioblock_trace.bounce </B>
-
-<DD>
-Fires whenever a buffer bounce is needed for at least one page of a block IO request.
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioblock_trace.bounce.3stap.html">probe::ioblock_trace.bounce</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ioblock_trace.request </B>
-
-<DD>
-Fires just as a generic block I/O request is created for a bio.
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioblock_trace.request.3stap.html">probe::ioblock_trace.request</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ioblock_trace.end </B>
-
-<DD>
-Fires whenever a block I/O transfer is complete.
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioblock_trace.end.3stap.html">probe::ioblock_trace.end</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./probe::ioblock.request.3stap.html">probe::ioblock.request</A></I>(3stap),
-
-
-<I><A HREF="./probe::ioblock.end.3stap.html">probe::ioblock.end</A></I>(3stap),
-
-
-<I><A HREF="./probe::ioblock_trace.bounce.3stap.html">probe::ioblock_trace.bounce</A></I>(3stap),
-
-
-<I><A HREF="./probe::ioblock_trace.request.3stap.html">probe::ioblock_trace.request</A></I>(3stap),
-
-
-<I><A HREF="./probe::ioblock_trace.end.3stap.html">probe::ioblock_trace.end</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::ioscheduler</TITLE>
-</HEAD><BODY>
-<H1>tapset::ioscheduler</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::ioscheduler - systemtap ioscheduler tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> This family of probe points is used to probe IO scheduler activities.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>ioscheduler.elv_next_request </B>
-
-<DD>
-Fires when a request is retrieved from the request queue
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioscheduler.elv_next_request.3stap.html">probe::ioscheduler.elv_next_request</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ioscheduler.elv_next_request.return </B>
-
-<DD>
-Fires when a request retrieval issues a return signal
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioscheduler.elv_next_request.return.3stap.html">probe::ioscheduler.elv_next_request.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ioscheduler.elv_completed_request </B>
-
-<DD>
-Fires when a request is completed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioscheduler.elv_completed_request.3stap.html">probe::ioscheduler.elv_completed_request</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ioscheduler.elv_add_request.kp </B>
-
-<DD>
-kprobe based probe to indicate that a request was added to the request queue
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioscheduler.elv_add_request.kp.3stap.html">probe::ioscheduler.elv_add_request.kp</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ioscheduler.elv_add_request.tp </B>
-
-<DD>
-tracepoint based probe to indicate a request is added to the request queue.
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioscheduler.elv_add_request.tp.3stap.html">probe::ioscheduler.elv_add_request.tp</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ioscheduler.elv_add_request </B>
-
-<DD>
-probe to indicate request is added to the request queue.
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioscheduler.elv_add_request.3stap.html">probe::ioscheduler.elv_add_request</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ioscheduler_trace.elv_completed_request </B>
-
-<DD>
-Fires when a request is
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioscheduler_trace.elv_completed_request.3stap.html">probe::ioscheduler_trace.elv_completed_request</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ioscheduler_trace.elv_issue_request </B>
-
-<DD>
-Fires when a request is
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioscheduler_trace.elv_issue_request.3stap.html">probe::ioscheduler_trace.elv_issue_request</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ioscheduler_trace.elv_requeue_request </B>
-
-<DD>
-Fires when a request is
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioscheduler_trace.elv_requeue_request.3stap.html">probe::ioscheduler_trace.elv_requeue_request</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ioscheduler_trace.elv_abort_request </B>
-
-<DD>
-Fires when a request is aborted.
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioscheduler_trace.elv_abort_request.3stap.html">probe::ioscheduler_trace.elv_abort_request</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ioscheduler_trace.plug </B>
-
-<DD>
-Fires when a request queue is plugged;
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioscheduler_trace.plug.3stap.html">probe::ioscheduler_trace.plug</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ioscheduler_trace.unplug_io </B>
-
-<DD>
-Fires when a request queue is unplugged;
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioscheduler_trace.unplug_io.3stap.html">probe::ioscheduler_trace.unplug_io</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ioscheduler_trace.unplug_timer </B>
-
-<DD>
-Fires when unplug timer associated
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ioscheduler_trace.unplug_timer.3stap.html">probe::ioscheduler_trace.unplug_timer</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./probe::ioscheduler.elv_next_request.3stap.html">probe::ioscheduler.elv_next_request</A></I>(3stap),
-
-
-<I><A HREF="./probe::ioscheduler.elv_next_request.return.3stap.html">probe::ioscheduler.elv_next_request.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::ioscheduler.elv_completed_request.3stap.html">probe::ioscheduler.elv_completed_request</A></I>(3stap),
-
-
-<I><A HREF="./probe::ioscheduler.elv_add_request.kp.3stap.html">probe::ioscheduler.elv_add_request.kp</A></I>(3stap),
-
-
-<I><A HREF="./probe::ioscheduler.elv_add_request.tp.3stap.html">probe::ioscheduler.elv_add_request.tp</A></I>(3stap),
-
-
-<I><A HREF="./probe::ioscheduler.elv_add_request.3stap.html">probe::ioscheduler.elv_add_request</A></I>(3stap),
-
-
-<I><A HREF="./probe::ioscheduler_trace.elv_completed_request.3stap.html">probe::ioscheduler_trace.elv_completed_request</A></I>(3stap),
-
-
-<I><A HREF="./probe::ioscheduler_trace.elv_issue_request.3stap.html">probe::ioscheduler_trace.elv_issue_request</A></I>(3stap),
-
-
-<I><A HREF="./probe::ioscheduler_trace.elv_requeue_request.3stap.html">probe::ioscheduler_trace.elv_requeue_request</A></I>(3stap),
-
-
-<I><A HREF="./probe::ioscheduler_trace.elv_abort_request.3stap.html">probe::ioscheduler_trace.elv_abort_request</A></I>(3stap),
-
-
-<I><A HREF="./probe::ioscheduler_trace.plug.3stap.html">probe::ioscheduler_trace.plug</A></I>(3stap),
-
-
-<I><A HREF="./probe::ioscheduler_trace.unplug_io.3stap.html">probe::ioscheduler_trace.unplug_io</A></I>(3stap),
-
-
-<I><A HREF="./probe::ioscheduler_trace.unplug_timer.3stap.html">probe::ioscheduler_trace.unplug_timer</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::ip</TITLE>
-</HEAD><BODY>
-<H1>tapset::ip</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::ip - systemtap ip tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>format_ipaddr </B>
-
-<DD>
-Returns a string representation for an IP address
-<DT><DD>
-See
-<I><A HREF="./function::format_ipaddr.3stap.html">function::format_ipaddr</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ip_ntop </B>
-
-<DD>
-Returns a string representation for an IPv4 address
-<DT><DD>
-See
-<I><A HREF="./function::ip_ntop.3stap.html">function::ip_ntop</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::format_ipaddr.3stap.html">function::format_ipaddr</A></I>(3stap),
-
-
-<I><A HREF="./function::ip_ntop.3stap.html">function::ip_ntop</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::ipmib-filter-default</TITLE>
-</HEAD><BODY>
-<H1>tapset::ipmib-filter-default</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::ipmib-filter-default - systemtap ipmib-filter-default tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>ipmib_filter_key </B>
-
-<DD>
-Default filter function for ipmib.* probes
-<DT><DD>
-See
-<I><A HREF="./function::ipmib_filter_key.3stap.html">function::ipmib_filter_key</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::ipmib_filter_key.3stap.html">function::ipmib_filter_key</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::ipmib</TITLE>
-</HEAD><BODY>
-<H1>tapset::ipmib</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::ipmib - systemtap ipmib tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>ipmib_remote_addr </B>
-
-<DD>
-Get the remote ip address
-<DT><DD>
-See
-<I><A HREF="./function::ipmib_remote_addr.3stap.html">function::ipmib_remote_addr</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ipmib_local_addr </B>
-
-<DD>
-Get the local ip address
-<DT><DD>
-See
-<I><A HREF="./function::ipmib_local_addr.3stap.html">function::ipmib_local_addr</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ipmib_tcp_remote_port </B>
-
-<DD>
-Get the remote tcp port
-<DT><DD>
-See
-<I><A HREF="./function::ipmib_tcp_remote_port.3stap.html">function::ipmib_tcp_remote_port</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ipmib_tcp_local_port </B>
-
-<DD>
-Get the local tcp port
-<DT><DD>
-See
-<I><A HREF="./function::ipmib_tcp_local_port.3stap.html">function::ipmib_tcp_local_port</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ipmib_get_proto </B>
-
-<DD>
-Get the protocol value
-<DT><DD>
-See
-<I><A HREF="./function::ipmib_get_proto.3stap.html">function::ipmib_get_proto</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ipmib.InReceives </B>
-
-<DD>
-Count an arriving packet
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ipmib.InReceives.3stap.html">probe::ipmib.InReceives</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ipmib.InNoRoutes </B>
-
-<DD>
-Count an arriving packet with no matching socket
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ipmib.InNoRoutes.3stap.html">probe::ipmib.InNoRoutes</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ipmib.InAddrErrors </B>
-
-<DD>
-Count arriving packets with an incorrect address
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ipmib.InAddrErrors.3stap.html">probe::ipmib.InAddrErrors</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ipmib.InUnknownProtos </B>
-
-<DD>
-Count arriving packets with an unbound proto
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ipmib.InUnknownProtos.3stap.html">probe::ipmib.InUnknownProtos</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ipmib.InDiscards </B>
-
-<DD>
-Count discarded inbound packets
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ipmib.InDiscards.3stap.html">probe::ipmib.InDiscards</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ipmib.ForwDatagrams </B>
-
-<DD>
-Count forwarded packet
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ipmib.ForwDatagrams.3stap.html">probe::ipmib.ForwDatagrams</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ipmib.OutRequests </B>
-
-<DD>
-Count a request to send a packet
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ipmib.OutRequests.3stap.html">probe::ipmib.OutRequests</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ipmib.ReasmTimeout </B>
-
-<DD>
-Count Reassembly Timeouts
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ipmib.ReasmTimeout.3stap.html">probe::ipmib.ReasmTimeout</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ipmib.ReasmReqds </B>
-
-<DD>
-Count number of packet fragments reassembly requests
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ipmib.ReasmReqds.3stap.html">probe::ipmib.ReasmReqds</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ipmib.FragOKs </B>
-
-<DD>
-Count datagram fragmented successfully
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ipmib.FragOKs.3stap.html">probe::ipmib.FragOKs</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ipmib.FragFails </B>
-
-<DD>
-Count datagram fragmented unsuccessfully
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::ipmib.FragFails.3stap.html">probe::ipmib.FragFails</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::ipmib_remote_addr.3stap.html">function::ipmib_remote_addr</A></I>(3stap),
-
-
-<I><A HREF="./function::ipmib_local_addr.3stap.html">function::ipmib_local_addr</A></I>(3stap),
-
-
-<I><A HREF="./function::ipmib_tcp_remote_port.3stap.html">function::ipmib_tcp_remote_port</A></I>(3stap),
-
-
-<I><A HREF="./function::ipmib_tcp_local_port.3stap.html">function::ipmib_tcp_local_port</A></I>(3stap),
-
-
-<I><A HREF="./function::ipmib_get_proto.3stap.html">function::ipmib_get_proto</A></I>(3stap),
-
-
-<I><A HREF="./probe::ipmib.InReceives.3stap.html">probe::ipmib.InReceives</A></I>(3stap),
-
-
-<I><A HREF="./probe::ipmib.InNoRoutes.3stap.html">probe::ipmib.InNoRoutes</A></I>(3stap),
-
-
-<I><A HREF="./probe::ipmib.InAddrErrors.3stap.html">probe::ipmib.InAddrErrors</A></I>(3stap),
-
-
-<I><A HREF="./probe::ipmib.InUnknownProtos.3stap.html">probe::ipmib.InUnknownProtos</A></I>(3stap),
-
-
-<I><A HREF="./probe::ipmib.InDiscards.3stap.html">probe::ipmib.InDiscards</A></I>(3stap),
-
-
-<I><A HREF="./probe::ipmib.ForwDatagrams.3stap.html">probe::ipmib.ForwDatagrams</A></I>(3stap),
-
-
-<I><A HREF="./probe::ipmib.OutRequests.3stap.html">probe::ipmib.OutRequests</A></I>(3stap),
-
-
-<I><A HREF="./probe::ipmib.ReasmTimeout.3stap.html">probe::ipmib.ReasmTimeout</A></I>(3stap),
-
-
-<I><A HREF="./probe::ipmib.ReasmReqds.3stap.html">probe::ipmib.ReasmReqds</A></I>(3stap),
-
-
-<I><A HREF="./probe::ipmib.FragOKs.3stap.html">probe::ipmib.FragOKs</A></I>(3stap),
-
-
-<I><A HREF="./probe::ipmib.FragFails.3stap.html">probe::ipmib.FragFails</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::irq</TITLE>
-</HEAD><BODY>
-<H1>tapset::irq</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::irq - systemtap irq tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>workqueue.create </B>
-
-<DD>
-Creating a new workqueue
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::workqueue.create.3stap.html">probe::workqueue.create</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>workqueue.insert </B>
-
-<DD>
-Queuing work on a workqueue
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::workqueue.insert.3stap.html">probe::workqueue.insert</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>workqueue.execute </B>
-
-<DD>
-Executing deferred work
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::workqueue.execute.3stap.html">probe::workqueue.execute</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>workqueue.destroy </B>
-
-<DD>
-Destroying workqueue
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::workqueue.destroy.3stap.html">probe::workqueue.destroy</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>irq_handler.entry </B>
-
-<DD>
-Execution of interrupt handler starting
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::irq_handler.entry.3stap.html">probe::irq_handler.entry</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>irq_handler.exit </B>
-
-<DD>
-Execution of interrupt handler completed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::irq_handler.exit.3stap.html">probe::irq_handler.exit</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>softirq.entry </B>
-
-<DD>
-Execution of handler for a pending softirq starting
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::softirq.entry.3stap.html">probe::softirq.entry</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>softirq.exit </B>
-
-<DD>
-Execution of handler for a pending softirq completed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::softirq.exit.3stap.html">probe::softirq.exit</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./probe::workqueue.create.3stap.html">probe::workqueue.create</A></I>(3stap),
-
-
-<I><A HREF="./probe::workqueue.insert.3stap.html">probe::workqueue.insert</A></I>(3stap),
-
-
-<I><A HREF="./probe::workqueue.execute.3stap.html">probe::workqueue.execute</A></I>(3stap),
-
-
-<I><A HREF="./probe::workqueue.destroy.3stap.html">probe::workqueue.destroy</A></I>(3stap),
-
-
-<I><A HREF="./probe::irq_handler.entry.3stap.html">probe::irq_handler.entry</A></I>(3stap),
-
-
-<I><A HREF="./probe::irq_handler.exit.3stap.html">probe::irq_handler.exit</A></I>(3stap),
-
-
-<I><A HREF="./probe::softirq.entry.3stap.html">probe::softirq.entry</A></I>(3stap),
-
-
-<I><A HREF="./probe::softirq.exit.3stap.html">probe::softirq.exit</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::kprocess</TITLE>
-</HEAD><BODY>
-<H1>tapset::kprocess</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::kprocess - systemtap kprocess tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> This family of probe points is used to probe process-related activities.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>kprocess.create </B>
-
-<DD>
-Fires whenever a new process or thread is successfully created
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::kprocess.create.3stap.html">probe::kprocess.create</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>kprocess.start </B>
-
-<DD>
-Starting new process
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::kprocess.start.3stap.html">probe::kprocess.start</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>kprocess.exec </B>
-
-<DD>
-Attempt to exec to a new program
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::kprocess.exec.3stap.html">probe::kprocess.exec</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>kprocess.exec_complete </B>
-
-<DD>
-Return from exec to a new program
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::kprocess.exec_complete.3stap.html">probe::kprocess.exec_complete</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>kprocess.exit </B>
-
-<DD>
-Exit from process
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::kprocess.exit.3stap.html">probe::kprocess.exit</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>kprocess.release </B>
-
-<DD>
-Process released
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::kprocess.release.3stap.html">probe::kprocess.release</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./probe::kprocess.create.3stap.html">probe::kprocess.create</A></I>(3stap),
-
-
-<I><A HREF="./probe::kprocess.start.3stap.html">probe::kprocess.start</A></I>(3stap),
-
-
-<I><A HREF="./probe::kprocess.exec.3stap.html">probe::kprocess.exec</A></I>(3stap),
-
-
-<I><A HREF="./probe::kprocess.exec_complete.3stap.html">probe::kprocess.exec_complete</A></I>(3stap),
-
-
-<I><A HREF="./probe::kprocess.exit.3stap.html">probe::kprocess.exit</A></I>(3stap),
-
-
-<I><A HREF="./probe::kprocess.release.3stap.html">probe::kprocess.release</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::linuxmib-filter-default</TITLE>
-</HEAD><BODY>
-<H1>tapset::linuxmib-filter-default</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::linuxmib-filter-default - systemtap linuxmib-filter-default tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>linuxmib_filter_key </B>
-
-<DD>
-Default filter function for linuxmib.* probes
-<DT><DD>
-See
-<I><A HREF="./function::linuxmib_filter_key.3stap.html">function::linuxmib_filter_key</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::linuxmib_filter_key.3stap.html">function::linuxmib_filter_key</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::linuxmib</TITLE>
-</HEAD><BODY>
-<H1>tapset::linuxmib</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::linuxmib - systemtap linuxmib tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>linuxmib.DelayedACKs </B>
-
-<DD>
-Count of delayed acks
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::linuxmib.DelayedACKs.3stap.html">probe::linuxmib.DelayedACKs</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>linuxmib.ListenOverflows </B>
-
-<DD>
-Count of times a listen queue overflowed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::linuxmib.ListenOverflows.3stap.html">probe::linuxmib.ListenOverflows</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>linuxmib.ListenDrops </B>
-
-<DD>
-Count of times conn request that were dropped
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::linuxmib.ListenDrops.3stap.html">probe::linuxmib.ListenDrops</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>linuxmib.TCPMemoryPressures </B>
-
-<DD>
-Count of times memory pressure was used
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::linuxmib.TCPMemoryPressures.3stap.html">probe::linuxmib.TCPMemoryPressures</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./probe::linuxmib.DelayedACKs.3stap.html">probe::linuxmib.DelayedACKs</A></I>(3stap),
-
-
-<I><A HREF="./probe::linuxmib.ListenOverflows.3stap.html">probe::linuxmib.ListenOverflows</A></I>(3stap),
-
-
-<I><A HREF="./probe::linuxmib.ListenDrops.3stap.html">probe::linuxmib.ListenDrops</A></I>(3stap),
-
-
-<I><A HREF="./probe::linuxmib.TCPMemoryPressures.3stap.html">probe::linuxmib.TCPMemoryPressures</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::loadavg</TITLE>
-</HEAD><BODY>
-<H1>tapset::loadavg</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::loadavg - systemtap loadavg tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> Functions in the loadavg tapset allow a probe handler to capture
-<BR> the load average.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>get_loadavg_index </B>
-
-<DD>
-Get the load average for a specified interval
-<DT><DD>
-See
-<I><A HREF="./function::get_loadavg_index.3stap.html">function::get_loadavg_index</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sprint_loadavg </B>
-
-<DD>
-Report a pretty-printed load average
-<DT><DD>
-See
-<I><A HREF="./function::sprint_loadavg.3stap.html">function::sprint_loadavg</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::get_loadavg_index.3stap.html">function::get_loadavg_index</A></I>(3stap),
-
-
-<I><A HREF="./function::sprint_loadavg.3stap.html">function::sprint_loadavg</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::logging</TITLE>
-</HEAD><BODY>
-<H1>tapset::logging</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::logging - systemtap logging tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>log </B>
-
-<DD>
-Send a line to the common trace buffer
-<DT><DD>
-See
-<I><A HREF="./function::log.3stap.html">function::log</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>warn </B>
-
-<DD>
-Send a line to the warning stream
-<DT><DD>
-See
-<I><A HREF="./function::warn.3stap.html">function::warn</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>exit </B>
-
-<DD>
-Start shutting down probing script.
-<DT><DD>
-See
-<I><A HREF="./function::exit.3stap.html">function::exit</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>error </B>
-
-<DD>
-Send an error message
-<DT><DD>
-See
-<I><A HREF="./function::error.3stap.html">function::error</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ftrace </B>
-
-<DD>
-Send a message to the ftrace ring-buffer
-<DT><DD>
-See
-<I><A HREF="./function::ftrace.3stap.html">function::ftrace</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>printk </B>
-
-<DD>
-Send a message to the kernel trace buffer
-<DT><DD>
-See
-<I><A HREF="./function::printk.3stap.html">function::printk</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::log.3stap.html">function::log</A></I>(3stap),
-
-
-<I><A HREF="./function::warn.3stap.html">function::warn</A></I>(3stap),
-
-
-<I><A HREF="./function::exit.3stap.html">function::exit</A></I>(3stap),
-
-
-<I><A HREF="./function::error.3stap.html">function::error</A></I>(3stap),
-
-
-<I><A HREF="./function::ftrace.3stap.html">function::ftrace</A></I>(3stap),
-
-
-<I><A HREF="./function::printk.3stap.html">function::printk</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::memory</TITLE>
-</HEAD><BODY>
-<H1>tapset::memory</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::memory - systemtap memory tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> This family of probe points is used to probe memory-related events.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>vm_fault_contains </B>
-
-<DD>
-Test return value for page fault reason
-<DT><DD>
-See
-<I><A HREF="./function::vm_fault_contains.3stap.html">function::vm_fault_contains</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>vm.pagefault </B>
-
-<DD>
-Records that a page fault occurred
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::vm.pagefault.3stap.html">probe::vm.pagefault</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>vm.pagefault.return </B>
-
-<DD>
-Indicates what type of fault occurred
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::vm.pagefault.return.3stap.html">probe::vm.pagefault.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>addr_to_node </B>
-
-<DD>
-Returns which node a given address belongs to within a NUMA system
-<DT><DD>
-See
-<I><A HREF="./function::addr_to_node.3stap.html">function::addr_to_node</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>vm.write_shared </B>
-
-<DD>
-Attempts at writing to a shared page
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::vm.write_shared.3stap.html">probe::vm.write_shared</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>vm.write_shared_copy </B>
-
-<DD>
-Page copy for shared page write
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::vm.write_shared_copy.3stap.html">probe::vm.write_shared_copy</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>vm.mmap </B>
-
-<DD>
-Fires when an mmap is requested
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::vm.mmap.3stap.html">probe::vm.mmap</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>vm.munmap </B>
-
-<DD>
-Fires when an munmap is requested
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::vm.munmap.3stap.html">probe::vm.munmap</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>vm.brk </B>
-
-<DD>
-Fires when a brk is requested (i.e. the heap will be resized)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::vm.brk.3stap.html">probe::vm.brk</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>vm.oom_kill </B>
-
-<DD>
-Fires when a thread is selected for termination by the OOM killer
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::vm.oom_kill.3stap.html">probe::vm.oom_kill</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>vm.kmalloc </B>
-
-<DD>
-Fires when kmalloc is requested
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::vm.kmalloc.3stap.html">probe::vm.kmalloc</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>vm.kmem_cache_alloc </B>
-
-<DD>
-Fires when kmem_cache_alloc is requested
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::vm.kmem_cache_alloc.3stap.html">probe::vm.kmem_cache_alloc</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>vm.kmalloc_node </B>
-
-<DD>
-Fires when kmalloc_node is requested
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::vm.kmalloc_node.3stap.html">probe::vm.kmalloc_node</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>vm.kmem_cache_alloc_node </B>
-
-<DD>
-Fires when kmem_cache_alloc_node is requested
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::vm.kmem_cache_alloc_node.3stap.html">probe::vm.kmem_cache_alloc_node</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>vm.kfree </B>
-
-<DD>
-Fires when kfree is requested
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::vm.kfree.3stap.html">probe::vm.kfree</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>vm.kmem_cache_free </B>
-
-<DD>
-Fires when kmem_cache_free is requested
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::vm.kmem_cache_free.3stap.html">probe::vm.kmem_cache_free</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::vm_fault_contains.3stap.html">function::vm_fault_contains</A></I>(3stap),
-
-
-<I><A HREF="./function::addr_to_node.3stap.html">function::addr_to_node</A></I>(3stap),
-
-
-<I><A HREF="./probe::vm.pagefault.3stap.html">probe::vm.pagefault</A></I>(3stap),
-
-
-<I><A HREF="./probe::vm.pagefault.return.3stap.html">probe::vm.pagefault.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::vm.write_shared.3stap.html">probe::vm.write_shared</A></I>(3stap),
-
-
-<I><A HREF="./probe::vm.write_shared_copy.3stap.html">probe::vm.write_shared_copy</A></I>(3stap),
-
-
-<I><A HREF="./probe::vm.mmap.3stap.html">probe::vm.mmap</A></I>(3stap),
-
-
-<I><A HREF="./probe::vm.munmap.3stap.html">probe::vm.munmap</A></I>(3stap),
-
-
-<I><A HREF="./probe::vm.brk.3stap.html">probe::vm.brk</A></I>(3stap),
-
-
-<I><A HREF="./probe::vm.oom_kill.3stap.html">probe::vm.oom_kill</A></I>(3stap),
-
-
-<I><A HREF="./probe::vm.kmalloc.3stap.html">probe::vm.kmalloc</A></I>(3stap),
-
-
-<I><A HREF="./probe::vm.kmem_cache_alloc.3stap.html">probe::vm.kmem_cache_alloc</A></I>(3stap),
-
-
-<I><A HREF="./probe::vm.kmalloc_node.3stap.html">probe::vm.kmalloc_node</A></I>(3stap),
-
-
-<I><A HREF="./probe::vm.kmem_cache_alloc_node.3stap.html">probe::vm.kmem_cache_alloc_node</A></I>(3stap),
-
-
-<I><A HREF="./probe::vm.kfree.3stap.html">probe::vm.kfree</A></I>(3stap),
-
-
-<I><A HREF="./probe::vm.kmem_cache_free.3stap.html">probe::vm.kmem_cache_free</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::netfilter</TITLE>
-</HEAD><BODY>
-<H1>tapset::netfilter</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::netfilter - systemtap netfilter tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>netfilter.ip.pre_routing </B>
-
-<DD>
-Called before an IP packet is routed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netfilter.ip.pre_routing.3stap.html">probe::netfilter.ip.pre_routing</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netfilter.ip.local_in </B>
-
-<DD>
-Called on an incoming IP packet addressed to the local computer
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netfilter.ip.local_in.3stap.html">probe::netfilter.ip.local_in</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netfilter.ip.forward </B>
-
-<DD>
-Called on an incoming IP packet addressed to some other computer
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netfilter.ip.forward.3stap.html">probe::netfilter.ip.forward</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netfilter.ip.local_out </B>
-
-<DD>
-Called on an outgoing IP packet
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netfilter.ip.local_out.3stap.html">probe::netfilter.ip.local_out</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netfilter.ip.post_routing </B>
-
-<DD>
-Called immediately before an outgoing IP packet leaves the computer
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netfilter.ip.post_routing.3stap.html">probe::netfilter.ip.post_routing</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netfilter.bridge.local_in </B>
-
-<DD>
-Called on a bridging packet destined for the local computer
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netfilter.bridge.local_in.3stap.html">probe::netfilter.bridge.local_in</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netfilter.bridge.forward </B>
-
-<DD>
-Called on an incoming bridging packet destined for some other computer
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netfilter.bridge.forward.3stap.html">probe::netfilter.bridge.forward</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netfilter.bridge.local_out </B>
-
-<DD>
-Called on a bridging packet coming from a local process
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netfilter.bridge.local_out.3stap.html">probe::netfilter.bridge.local_out</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./probe::netfilter.ip.pre_routing.3stap.html">probe::netfilter.ip.pre_routing</A></I>(3stap),
-
-
-<I><A HREF="./probe::netfilter.ip.local_in.3stap.html">probe::netfilter.ip.local_in</A></I>(3stap),
-
-
-<I><A HREF="./probe::netfilter.ip.forward.3stap.html">probe::netfilter.ip.forward</A></I>(3stap),
-
-
-<I><A HREF="./probe::netfilter.ip.local_out.3stap.html">probe::netfilter.ip.local_out</A></I>(3stap),
-
-
-<I><A HREF="./probe::netfilter.ip.post_routing.3stap.html">probe::netfilter.ip.post_routing</A></I>(3stap),
-
-
-<I><A HREF="./probe::netfilter.arp.in.3stap.html">probe::netfilter.arp.in</A></I>(3stap),
-
-
-<I><A HREF="./probe::netfilter.arp.out.3stap.html">probe::netfilter.arp.out</A></I>(3stap),
-
-
-<I><A HREF="./probe::netfilter.arp.forward.3stap.html">probe::netfilter.arp.forward</A></I>(3stap),
-
-
-<I><A HREF="./probe::netfilter.bridge.pre_routing.3stap.html">probe::netfilter.bridge.pre_routing</A></I>(3stap),
-
-
-<I><A HREF="./probe::netfilter.bridge.local_in.3stap.html">probe::netfilter.bridge.local_in</A></I>(3stap),
-
-
-<I><A HREF="./probe::netfilter.bridge.forward.3stap.html">probe::netfilter.bridge.forward</A></I>(3stap),
-
-
-<I><A HREF="./probe::netfilter.bridge.local_out.3stap.html">probe::netfilter.bridge.local_out</A></I>(3stap),
-
-
-<I><A HREF="./probe::netfilter.bridge.post_routing.3stap.html">probe::netfilter.bridge.post_routing</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::networking</TITLE>
-</HEAD><BODY>
-<H1>tapset::networking</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::networking - systemtap networking tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> This family of probe points is used to probe the activities of the network device.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>netdev.receive </B>
-
-<DD>
-Data received from network device.
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netdev.receive.3stap.html">probe::netdev.receive</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netdev.transmit </B>
-
-<DD>
-Network device transmitting buffer
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netdev.transmit.3stap.html">probe::netdev.transmit</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netdev.change_mtu </B>
-
-<DD>
-Called when the netdev MTU is changed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netdev.change_mtu.3stap.html">probe::netdev.change_mtu</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netdev.open </B>
-
-<DD>
-Called when the device is opened
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netdev.open.3stap.html">probe::netdev.open</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netdev.close </B>
-
-<DD>
-Called when the device is closed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netdev.close.3stap.html">probe::netdev.close</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netdev.hard_transmit </B>
-
-<DD>
-Called when the devices is going to TX (hard)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netdev.hard_transmit.3stap.html">probe::netdev.hard_transmit</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netdev.rx </B>
-
-<DD>
-Called when the device is going to receive a packet
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netdev.rx.3stap.html">probe::netdev.rx</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netdev.change_rx_flag </B>
-
-<DD>
-Called when the device RX flag will be changed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netdev.change_rx_flag.3stap.html">probe::netdev.change_rx_flag</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netdev.set_promiscuity </B>
-
-<DD>
-Called when the device enters/leaves promiscuity
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netdev.set_promiscuity.3stap.html">probe::netdev.set_promiscuity</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netdev.ioctl </B>
-
-<DD>
-Called when the device suffers an IOCTL
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netdev.ioctl.3stap.html">probe::netdev.ioctl</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netdev.register </B>
-
-<DD>
-Called when the device is registered
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netdev.register.3stap.html">probe::netdev.register</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netdev.unregister </B>
-
-<DD>
-Called when the device is being unregistered
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netdev.unregister.3stap.html">probe::netdev.unregister</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netdev.get_stats </B>
-
-<DD>
-Called when someone asks the device statistics
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netdev.get_stats.3stap.html">probe::netdev.get_stats</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>netdev.change_mac </B>
-
-<DD>
-Called when the netdev_name has the MAC changed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::netdev.change_mac.3stap.html">probe::netdev.change_mac</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./probe::netdev.receive.3stap.html">probe::netdev.receive</A></I>(3stap),
-
-
-<I><A HREF="./probe::netdev.transmit.3stap.html">probe::netdev.transmit</A></I>(3stap),
-
-
-<I><A HREF="./probe::netdev.change_mtu.3stap.html">probe::netdev.change_mtu</A></I>(3stap),
-
-
-<I><A HREF="./probe::netdev.open.3stap.html">probe::netdev.open</A></I>(3stap),
-
-
-<I><A HREF="./probe::netdev.close.3stap.html">probe::netdev.close</A></I>(3stap),
-
-
-<I><A HREF="./probe::netdev.hard_transmit.3stap.html">probe::netdev.hard_transmit</A></I>(3stap),
-
-
-<I><A HREF="./probe::netdev.rx.3stap.html">probe::netdev.rx</A></I>(3stap),
-
-
-<I><A HREF="./probe::netdev.change_rx_flag.3stap.html">probe::netdev.change_rx_flag</A></I>(3stap),
-
-
-<I><A HREF="./probe::netdev.set_promiscuity.3stap.html">probe::netdev.set_promiscuity</A></I>(3stap),
-
-
-<I><A HREF="./probe::netdev.ioctl.3stap.html">probe::netdev.ioctl</A></I>(3stap),
-
-
-<I><A HREF="./probe::netdev.register.3stap.html">probe::netdev.register</A></I>(3stap),
-
-
-<I><A HREF="./probe::netdev.unregister.3stap.html">probe::netdev.unregister</A></I>(3stap),
-
-
-<I><A HREF="./probe::netdev.get_stats.3stap.html">probe::netdev.get_stats</A></I>(3stap),
-
-
-<I><A HREF="./probe::netdev.change_mac.3stap.html">probe::netdev.change_mac</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::nfs</TITLE>
-</HEAD><BODY>
-<H1>tapset::nfs</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::nfs - systemtap nfs tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>nfs.fop.llseek </B>
-
-<DD>
-NFS client llseek operation
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.fop.llseek.3stap.html">probe::nfs.fop.llseek</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.fop.read </B>
-
-<DD>
-NFS client read operation
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.fop.read.3stap.html">probe::nfs.fop.read</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.fop.write </B>
-
-<DD>
-NFS client write operation
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.fop.write.3stap.html">probe::nfs.fop.write</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.fop.aio_read </B>
-
-<DD>
-NFS client aio_read file operation
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.fop.aio_read.3stap.html">probe::nfs.fop.aio_read</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.fop.aio_write </B>
-
-<DD>
-NFS client aio_write file operation
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.fop.aio_write.3stap.html">probe::nfs.fop.aio_write</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.fop.mmap </B>
-
-<DD>
-NFS client mmap operation
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.fop.mmap.3stap.html">probe::nfs.fop.mmap</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.fop.open </B>
-
-<DD>
-NFS client file open operation
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.fop.open.3stap.html">probe::nfs.fop.open</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.fop.flush </B>
-
-<DD>
-NFS client flush file operation
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.fop.flush.3stap.html">probe::nfs.fop.flush</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.fop.release </B>
-
-<DD>
-NFS client release page operation
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.fop.release.3stap.html">probe::nfs.fop.release</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.fop.fsync </B>
-
-<DD>
-NFS client fsync operation
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.fop.fsync.3stap.html">probe::nfs.fop.fsync</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.fop.lock </B>
-
-<DD>
-NFS client file lock operation
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.fop.lock.3stap.html">probe::nfs.fop.lock</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.fop.sendfile </B>
-
-<DD>
-NFS client send file operation
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.fop.sendfile.3stap.html">probe::nfs.fop.sendfile</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.fop.check_flags </B>
-
-<DD>
-NFS client checking flag operation
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.fop.check_flags.3stap.html">probe::nfs.fop.check_flags</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.aop.readpage </B>
-
-<DD>
-NFS client synchronously reading a page
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.aop.readpage.3stap.html">probe::nfs.aop.readpage</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.aop.readpages </B>
-
-<DD>
-NFS client reading multiple pages
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.aop.readpages.3stap.html">probe::nfs.aop.readpages</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.aop.set_page_dirty </B>
-
-<DD>
-NFS client marking page as dirty
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.aop.set_page_dirty.3stap.html">probe::nfs.aop.set_page_dirty</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.aop.writepage </B>
-
-<DD>
-NFS client writing a mapped page to the NFS server
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.aop.writepage.3stap.html">probe::nfs.aop.writepage</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.aop.writepages </B>
-
-<DD>
-NFS client writing several dirty pages to the NFS server
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.aop.writepages.3stap.html">probe::nfs.aop.writepages</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.aop.write_begin </B>
-
-<DD>
-NFS client begin to write data
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.aop.write_begin.3stap.html">probe::nfs.aop.write_begin</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.aop.write_end </B>
-
-<DD>
-NFS client complete writing data
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.aop.write_end.3stap.html">probe::nfs.aop.write_end</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.aop.release_page </B>
-
-<DD>
-NFS client releasing page
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.aop.release_page.3stap.html">probe::nfs.aop.release_page</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./probe::nfs.fop.llseek.3stap.html">probe::nfs.fop.llseek</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.fop.read.3stap.html">probe::nfs.fop.read</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.fop.write.3stap.html">probe::nfs.fop.write</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.fop.aio_read.3stap.html">probe::nfs.fop.aio_read</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.fop.aio_write.3stap.html">probe::nfs.fop.aio_write</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.fop.mmap.3stap.html">probe::nfs.fop.mmap</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.fop.open.3stap.html">probe::nfs.fop.open</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.fop.flush.3stap.html">probe::nfs.fop.flush</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.fop.release.3stap.html">probe::nfs.fop.release</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.fop.fsync.3stap.html">probe::nfs.fop.fsync</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.fop.lock.3stap.html">probe::nfs.fop.lock</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.fop.sendfile.3stap.html">probe::nfs.fop.sendfile</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.fop.check_flags.3stap.html">probe::nfs.fop.check_flags</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.aop.readpage.3stap.html">probe::nfs.aop.readpage</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.aop.readpages.3stap.html">probe::nfs.aop.readpages</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.aop.set_page_dirty.3stap.html">probe::nfs.aop.set_page_dirty</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.aop.writepage.3stap.html">probe::nfs.aop.writepage</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.aop.writepages.3stap.html">probe::nfs.aop.writepages</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.aop.write_begin.3stap.html">probe::nfs.aop.write_begin</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.aop.write_end.3stap.html">probe::nfs.aop.write_end</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.aop.release_page.3stap.html">probe::nfs.aop.release_page</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::nfs_proc</TITLE>
-</HEAD><BODY>
-<H1>tapset::nfs_proc</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::nfs_proc - systemtap nfs_proc tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>nfs.proc.lookup </B>
-
-<DD>
-NFS client opens/searches a file on server
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.proc.lookup.3stap.html">probe::nfs.proc.lookup</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.proc.read </B>
-
-<DD>
-NFS client synchronously reads file from server
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.proc.read.3stap.html">probe::nfs.proc.read</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.proc.write </B>
-
-<DD>
-NFS client synchronously writes file to server
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.proc.write.3stap.html">probe::nfs.proc.write</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.proc.commit </B>
-
-<DD>
-NFS client committing data on server
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.proc.commit.3stap.html">probe::nfs.proc.commit</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.proc.read_setup </B>
-
-<DD>
-NFS client setting up a read RPC task
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.proc.read_setup.3stap.html">probe::nfs.proc.read_setup</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.proc.read_done </B>
-
-<DD>
-NFS client response to a read RPC task
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.proc.read_done.3stap.html">probe::nfs.proc.read_done</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.proc.write_setup </B>
-
-<DD>
-NFS client setting up a write RPC task
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.proc.write_setup.3stap.html">probe::nfs.proc.write_setup</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.proc.write_done </B>
-
-<DD>
-NFS client response to a write RPC task
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.proc.write_done.3stap.html">probe::nfs.proc.write_done</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.proc.commit_setup </B>
-
-<DD>
-NFS client setting up a commit RPC task
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.proc.commit_setup.3stap.html">probe::nfs.proc.commit_setup</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.proc.commit_done </B>
-
-<DD>
-NFS client response to a commit RPC task
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.proc.commit_done.3stap.html">probe::nfs.proc.commit_done</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.proc.open </B>
-
-<DD>
-NFS client allocates file read/write context information
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.proc.open.3stap.html">probe::nfs.proc.open</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.proc.release </B>
-
-<DD>
-<BR> NFS client releases file read/write context information
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.proc.release.3stap.html">probe::nfs.proc.release</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.proc.handle_exception </B>
-
-<DD>
-NFS client handling an NFSv4 exception
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.proc.handle_exception.3stap.html">probe::nfs.proc.handle_exception</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.proc.create </B>
-
-<DD>
-NFS client creating file on server
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.proc.create.3stap.html">probe::nfs.proc.create</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.proc.remove </B>
-
-<DD>
-NFS client removes a file on server
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.proc.remove.3stap.html">probe::nfs.proc.remove</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfs.proc.rename </B>
-
-<DD>
-NFS client renames a file on server
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfs.proc.rename.3stap.html">probe::nfs.proc.rename</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./probe::nfs.proc.lookup.3stap.html">probe::nfs.proc.lookup</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.proc.read.3stap.html">probe::nfs.proc.read</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.proc.write.3stap.html">probe::nfs.proc.write</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.proc.commit.3stap.html">probe::nfs.proc.commit</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.proc.read_setup.3stap.html">probe::nfs.proc.read_setup</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.proc.read_done.3stap.html">probe::nfs.proc.read_done</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.proc.write_setup.3stap.html">probe::nfs.proc.write_setup</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.proc.write_done.3stap.html">probe::nfs.proc.write_done</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.proc.commit_setup.3stap.html">probe::nfs.proc.commit_setup</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.proc.commit_done.3stap.html">probe::nfs.proc.commit_done</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.proc.open.3stap.html">probe::nfs.proc.open</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.proc.release.3stap.html">probe::nfs.proc.release</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.proc.handle_exception.3stap.html">probe::nfs.proc.handle_exception</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.proc.create.3stap.html">probe::nfs.proc.create</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.proc.remove.3stap.html">probe::nfs.proc.remove</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfs.proc.rename.3stap.html">probe::nfs.proc.rename</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::nfsd</TITLE>
-</HEAD><BODY>
-<H1>tapset::nfsd</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::nfsd - systemtap nfsd tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>nfsd.dispatch </B>
-
-<DD>
-NFS server receives an operation from client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfsd.dispatch.3stap.html">probe::nfsd.dispatch</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfsd.proc.lookup </B>
-
-<DD>
-NFS server opening or searching for a file for client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfsd.proc.lookup.3stap.html">probe::nfsd.proc.lookup</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfsd.proc.read </B>
-
-<DD>
-NFS server reading file for client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfsd.proc.read.3stap.html">probe::nfsd.proc.read</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfsd.proc.write </B>
-
-<DD>
-NFS server writing data to file for client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfsd.proc.write.3stap.html">probe::nfsd.proc.write</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfsd.proc.commit </B>
-
-<DD>
-NFS server performing a commit operation for client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfsd.proc.commit.3stap.html">probe::nfsd.proc.commit</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfsd.proc.create </B>
-
-<DD>
-NFS server creating a file for client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfsd.proc.create.3stap.html">probe::nfsd.proc.create</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfsd.proc.remove </B>
-
-<DD>
-NFS server removing a file for client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfsd.proc.remove.3stap.html">probe::nfsd.proc.remove</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfsd.proc.rename </B>
-
-<DD>
-NFS Server renaming a file for client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfsd.proc.rename.3stap.html">probe::nfsd.proc.rename</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfsd.open </B>
-
-<DD>
-NFS server opening a file for client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfsd.open.3stap.html">probe::nfsd.open</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfsd.close </B>
-
-<DD>
-NFS server closing a file for client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfsd.close.3stap.html">probe::nfsd.close</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfsd.read </B>
-
-<DD>
-NFS server reading data from a file for client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfsd.read.3stap.html">probe::nfsd.read</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfsd.write </B>
-
-<DD>
-NFS server writing data to a file for client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfsd.write.3stap.html">probe::nfsd.write</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfsd.commit </B>
-
-<DD>
-NFS server committing all pending writes to stable storage
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfsd.commit.3stap.html">probe::nfsd.commit</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfsd.lookup </B>
-
-<DD>
-NFS server opening or searching file for a file for client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfsd.lookup.3stap.html">probe::nfsd.lookup</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfsd.create </B>
-
-<DD>
-NFS server creating a file(regular,dir,device,fifo) for client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfsd.create.3stap.html">probe::nfsd.create</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfsd.createv3 </B>
-
-<DD>
-NFS server creating a regular file or set file attributes for client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfsd.createv3.3stap.html">probe::nfsd.createv3</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nfsd.unlink </B>
-
-<DD>
-NFS server removing a file or a directory for client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::nfsd.unlink.3stap.html">probe::nfsd.unlink</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./probe::nfsd.dispatch.3stap.html">probe::nfsd.dispatch</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfsd.proc.lookup.3stap.html">probe::nfsd.proc.lookup</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfsd.proc.read.3stap.html">probe::nfsd.proc.read</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfsd.proc.write.3stap.html">probe::nfsd.proc.write</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfsd.proc.commit.3stap.html">probe::nfsd.proc.commit</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfsd.proc.create.3stap.html">probe::nfsd.proc.create</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfsd.proc.remove.3stap.html">probe::nfsd.proc.remove</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfsd.proc.rename.3stap.html">probe::nfsd.proc.rename</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfsd.open.3stap.html">probe::nfsd.open</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfsd.close.3stap.html">probe::nfsd.close</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfsd.read.3stap.html">probe::nfsd.read</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfsd.write.3stap.html">probe::nfsd.write</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfsd.commit.3stap.html">probe::nfsd.commit</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfsd.lookup.3stap.html">probe::nfsd.lookup</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfsd.create.3stap.html">probe::nfsd.create</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfsd.createv3.3stap.html">probe::nfsd.createv3</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfsd.unlink.3stap.html">probe::nfsd.unlink</A></I>(3stap),
-
-
-<I><A HREF="./probe::nfsd.rename.3stap.html">probe::nfsd.rename</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::nfsderrno</TITLE>
-</HEAD><BODY>
-<H1>tapset::nfsderrno</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::nfsderrno - systemtap nfsderrno tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>nfsderror </B>
-
-<DD>
-Convert nfsd error number into string
-<DT><DD>
-See
-<I><A HREF="./function::nfsderror.3stap.html">function::nfsderror</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::nfsderror.3stap.html">function::nfsderror</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::panic</TITLE>
-</HEAD><BODY>
-<H1>tapset::panic</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::panic - systemtap panic tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> Functions in the panic tapset allow a probe handler to invoke
-<BR> the system panic routine with a user-specified message.
-<P>
-<BR> This may be used with a crash dump collection facility such as
-<BR> kexec/kdump in order to capture data for post-mortem debugging.
-<P>
-<BR> Due to the fact that this will bring the system to an immediate
-<BR> halt the functions in this tapset require guru mode.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>panic </B>
-
-<DD>
-trigger a panic
-<DT><DD>
-See
-<I><A HREF="./function::panic.3stap.html">function::panic</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::panic.3stap.html">function::panic</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::pn</TITLE>
-</HEAD><BODY>
-<H1>tapset::pn</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::pn - systemtap pn tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>pn </B>
-
-<DD>
-Returns the active probe name
-<DT><DD>
-See
-<I><A HREF="./function::pn.3stap.html">function::pn</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>pnlabel </B>
-
-<DD>
-Returns the label name parsed from the probe name
-<DT><DD>
-See
-<I><A HREF="./function::pnlabel.3stap.html">function::pnlabel</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::pn.3stap.html">function::pn</A></I>(3stap),
-
-
-<I><A HREF="./function::pnlabel.3stap.html">function::pnlabel</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::proc_mem</TITLE>
-</HEAD><BODY>
-<H1>tapset::proc_mem</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::proc_mem - systemtap proc_mem tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> Process memory query and utility functions provide information about
-<BR> the memory usage of the current application. These functions provide
-<BR> information about the full size, resident, shared, code and data used
-<BR> by the current process. And provide utility functions to query the
-<BR> page size of the current architecture and create human readable string
-<BR> representations of bytes and pages used.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>proc_mem_size </B>
-
-<DD>
-Total program virtual memory size in pages
-<DT><DD>
-See
-<I><A HREF="./function::proc_mem_size.3stap.html">function::proc_mem_size</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>proc_mem_size_pid </B>
-
-<DD>
-Total program virtual memory size in pages
-<DT><DD>
-See
-<I><A HREF="./function::proc_mem_size_pid.3stap.html">function::proc_mem_size_pid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>proc_mem_rss </B>
-
-<DD>
-Program resident set size in pages
-<DT><DD>
-See
-<I><A HREF="./function::proc_mem_rss.3stap.html">function::proc_mem_rss</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>proc_mem_rss_pid </B>
-
-<DD>
-Program resident set size in pages
-<DT><DD>
-See
-<I><A HREF="./function::proc_mem_rss_pid.3stap.html">function::proc_mem_rss_pid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>proc_mem_shr </B>
-
-<DD>
-Program shared pages (from shared mappings)
-<DT><DD>
-See
-<I><A HREF="./function::proc_mem_shr.3stap.html">function::proc_mem_shr</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>proc_mem_shr_pid </B>
-
-<DD>
-Program shared pages (from shared mappings)
-<DT><DD>
-See
-<I><A HREF="./function::proc_mem_shr_pid.3stap.html">function::proc_mem_shr_pid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>proc_mem_txt </B>
-
-<DD>
-Program text (code) size in pages
-<DT><DD>
-See
-<I><A HREF="./function::proc_mem_txt.3stap.html">function::proc_mem_txt</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>proc_mem_txt_pid </B>
-
-<DD>
-Program text (code) size in pages
-<DT><DD>
-See
-<I><A HREF="./function::proc_mem_txt_pid.3stap.html">function::proc_mem_txt_pid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>proc_mem_data </B>
-
-<DD>
-Program data size (data + stack) in pages
-<DT><DD>
-See
-<I><A HREF="./function::proc_mem_data.3stap.html">function::proc_mem_data</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>proc_mem_data_pid </B>
-
-<DD>
-Program data size (data + stack) in pages
-<DT><DD>
-See
-<I><A HREF="./function::proc_mem_data_pid.3stap.html">function::proc_mem_data_pid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>mem_page_size </B>
-
-<DD>
-Number of bytes in a page for this architecture
-<DT><DD>
-See
-<I><A HREF="./function::mem_page_size.3stap.html">function::mem_page_size</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>bytes_to_string </B>
-
-<DD>
-Human readable string for given bytes
-<DT><DD>
-See
-<I><A HREF="./function::bytes_to_string.3stap.html">function::bytes_to_string</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>pages_to_string </B>
-
-<DD>
-Turns pages into a human readable string
-<DT><DD>
-See
-<I><A HREF="./function::pages_to_string.3stap.html">function::pages_to_string</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>proc_mem_string </B>
-
-<DD>
-Human readable string of current proc memory usage
-<DT><DD>
-See
-<I><A HREF="./function::proc_mem_string.3stap.html">function::proc_mem_string</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>proc_mem_string_pid </B>
-
-<DD>
-Human readable string of process memory usage
-<DT><DD>
-See
-<I><A HREF="./function::proc_mem_string_pid.3stap.html">function::proc_mem_string_pid</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::proc_mem_size.3stap.html">function::proc_mem_size</A></I>(3stap),
-
-
-<I><A HREF="./function::proc_mem_size_pid.3stap.html">function::proc_mem_size_pid</A></I>(3stap),
-
-
-<I><A HREF="./function::proc_mem_rss.3stap.html">function::proc_mem_rss</A></I>(3stap),
-
-
-<I><A HREF="./function::proc_mem_rss_pid.3stap.html">function::proc_mem_rss_pid</A></I>(3stap),
-
-
-<I><A HREF="./function::proc_mem_shr.3stap.html">function::proc_mem_shr</A></I>(3stap),
-
-
-<I><A HREF="./function::proc_mem_shr_pid.3stap.html">function::proc_mem_shr_pid</A></I>(3stap),
-
-
-<I><A HREF="./function::proc_mem_txt.3stap.html">function::proc_mem_txt</A></I>(3stap),
-
-
-<I><A HREF="./function::proc_mem_txt_pid.3stap.html">function::proc_mem_txt_pid</A></I>(3stap),
-
-
-<I><A HREF="./function::proc_mem_data.3stap.html">function::proc_mem_data</A></I>(3stap),
-
-
-<I><A HREF="./function::proc_mem_data_pid.3stap.html">function::proc_mem_data_pid</A></I>(3stap),
-
-
-<I><A HREF="./function::mem_page_size.3stap.html">function::mem_page_size</A></I>(3stap),
-
-
-<I><A HREF="./function::bytes_to_string.3stap.html">function::bytes_to_string</A></I>(3stap),
-
-
-<I><A HREF="./function::pages_to_string.3stap.html">function::pages_to_string</A></I>(3stap),
-
-
-<I><A HREF="./function::proc_mem_string.3stap.html">function::proc_mem_string</A></I>(3stap),
-
-
-<I><A HREF="./function::proc_mem_string_pid.3stap.html">function::proc_mem_string_pid</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::pstrace</TITLE>
-</HEAD><BODY>
-<H1>tapset::pstrace</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::pstrace - systemtap pstrace tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>pstrace </B>
-
-<DD>
-Chain of processes and pids back to <A HREF="init.1.html">init</A>(1)
-<DT><DD>
-See
-<I><A HREF="./function::pstrace.3stap.html">function::pstrace</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::pstrace.3stap.html">function::pstrace</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::queue_stats</TITLE>
-</HEAD><BODY>
-<H1>tapset::queue_stats</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::queue_stats - systemtap queue_stats tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>qs_wait </B>
-
-<DD>
-Function to record enqueue requests
-<DT><DD>
-See
-<I><A HREF="./function::qs_wait.3stap.html">function::qs_wait</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>qs_run </B>
-
-<DD>
-Function to record being moved from wait queue to being serviced
-<DT><DD>
-See
-<I><A HREF="./function::qs_run.3stap.html">function::qs_run</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>qs_done </B>
-
-<DD>
-Function to record finishing request
-<DT><DD>
-See
-<I><A HREF="./function::qs_done.3stap.html">function::qs_done</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>qsq_start </B>
-
-<DD>
-Function to reset the stats for a queue
-<DT><DD>
-See
-<I><A HREF="./function::qsq_start.3stap.html">function::qsq_start</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>qsq_utilization </B>
-
-<DD>
-Fraction of time that any request was being serviced
-<DT><DD>
-See
-<I><A HREF="./function::qsq_utilization.3stap.html">function::qsq_utilization</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>qsq_blocked </B>
-
-<DD>
-Returns the time reqest was on the wait queue
-<DT><DD>
-See
-<I><A HREF="./function::qsq_blocked.3stap.html">function::qsq_blocked</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>qsq_wait_queue_length </B>
-
-<DD>
-length of wait queue
-<DT><DD>
-See
-<I><A HREF="./function::qsq_wait_queue_length.3stap.html">function::qsq_wait_queue_length</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>qsq_service_time </B>
-
-<DD>
-Amount of time per request service
-<DT><DD>
-See
-<I><A HREF="./function::qsq_service_time.3stap.html">function::qsq_service_time</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>qsq_wait_time </B>
-
-<DD>
-Amount of time in queue + service per request
-<DT><DD>
-See
-<I><A HREF="./function::qsq_wait_time.3stap.html">function::qsq_wait_time</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>qsq_throughput </B>
-
-<DD>
-Number of requests served per unit time
-<DT><DD>
-See
-<I><A HREF="./function::qsq_throughput.3stap.html">function::qsq_throughput</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>qsq_print </B>
-
-<DD>
-Prints a line of statistics for the given queue
-<DT><DD>
-See
-<I><A HREF="./function::qsq_print.3stap.html">function::qsq_print</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::qs_wait.3stap.html">function::qs_wait</A></I>(3stap),
-
-
-<I><A HREF="./function::qs_run.3stap.html">function::qs_run</A></I>(3stap),
-
-
-<I><A HREF="./function::qs_done.3stap.html">function::qs_done</A></I>(3stap),
-
-
-<I><A HREF="./function::qsq_start.3stap.html">function::qsq_start</A></I>(3stap),
-
-
-<I><A HREF="./function::qsq_utilization.3stap.html">function::qsq_utilization</A></I>(3stap),
-
-
-<I><A HREF="./function::qsq_blocked.3stap.html">function::qsq_blocked</A></I>(3stap),
-
-
-<I><A HREF="./function::qsq_wait_queue_length.3stap.html">function::qsq_wait_queue_length</A></I>(3stap),
-
-
-<I><A HREF="./function::qsq_service_time.3stap.html">function::qsq_service_time</A></I>(3stap),
-
-
-<I><A HREF="./function::qsq_wait_time.3stap.html">function::qsq_wait_time</A></I>(3stap),
-
-
-<I><A HREF="./function::qsq_throughput.3stap.html">function::qsq_throughput</A></I>(3stap),
-
-
-<I><A HREF="./function::qsq_print.3stap.html">function::qsq_print</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::random</TITLE>
-</HEAD><BODY>
-<H1>tapset::random</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::random - systemtap random tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>randint </B>
-
-<DD>
-Return a random number between [0,n)
-<DT><DD>
-See
-<I><A HREF="./function::randint.3stap.html">function::randint</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::randint.3stap.html">function::randint</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::registers</TITLE>
-</HEAD><BODY>
-<H1>tapset::registers</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::registers - systemtap registers tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>register </B>
-
-<DD>
-Return the signed value of the named CPU register
-<DT><DD>
-See
-<I><A HREF="./function::register.3stap.html">function::register</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>u_register </B>
-
-<DD>
-Return the unsigned value of the named CPU register
-<DT><DD>
-See
-<I><A HREF="./function::u_register.3stap.html">function::u_register</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>int_arg </B>
-
-<DD>
-Return function argument as signed int
-<DT><DD>
-See
-<I><A HREF="./function::int_arg.3stap.html">function::int_arg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>uint_arg </B>
-
-<DD>
-Return function argument as unsigned int
-<DT><DD>
-See
-<I><A HREF="./function::uint_arg.3stap.html">function::uint_arg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>long_arg </B>
-
-<DD>
-Return function argument as signed long
-<DT><DD>
-See
-<I><A HREF="./function::long_arg.3stap.html">function::long_arg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ulong_arg </B>
-
-<DD>
-Return function argument as unsigned long
-<DT><DD>
-See
-<I><A HREF="./function::ulong_arg.3stap.html">function::ulong_arg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>longlong_arg </B>
-
-<DD>
-Return function argument as 64-bit value
-<DT><DD>
-See
-<I><A HREF="./function::longlong_arg.3stap.html">function::longlong_arg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ulonglong_arg </B>
-
-<DD>
-Return function argument as 64-bit value
-<DT><DD>
-See
-<I><A HREF="./function::ulonglong_arg.3stap.html">function::ulonglong_arg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>pointer_arg </B>
-
-<DD>
-Return function argument as pointer value
-<DT><DD>
-See
-<I><A HREF="./function::pointer_arg.3stap.html">function::pointer_arg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>s32_arg </B>
-
-<DD>
-Return function argument as signed 32-bit value
-<DT><DD>
-See
-<I><A HREF="./function::s32_arg.3stap.html">function::s32_arg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>u32_arg </B>
-
-<DD>
-Return function argument as unsigned 32-bit value
-<DT><DD>
-See
-<I><A HREF="./function::u32_arg.3stap.html">function::u32_arg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>s64_arg </B>
-
-<DD>
-Return function argument as signed 64-bit value
-<DT><DD>
-See
-<I><A HREF="./function::s64_arg.3stap.html">function::s64_arg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>u64_arg </B>
-
-<DD>
-Return function argument as unsigned 64-bit value
-<DT><DD>
-See
-<I><A HREF="./function::u64_arg.3stap.html">function::u64_arg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>asmlinkage </B>
-
-<DD>
-Mark function as declared asmlinkage
-<DT><DD>
-See
-<I><A HREF="./function::asmlinkage.3stap.html">function::asmlinkage</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>fastcall </B>
-
-<DD>
-Mark function as declared fastcall
-<DT><DD>
-See
-<I><A HREF="./function::fastcall.3stap.html">function::fastcall</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>regparm </B>
-
-<DD>
-Specify regparm value used to compile function
-<DT><DD>
-See
-<I><A HREF="./function::regparm.3stap.html">function::regparm</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::register.3stap.html">function::register</A></I>(3stap),
-
-
-<I><A HREF="./function::u_register.3stap.html">function::u_register</A></I>(3stap),
-
-
-<I><A HREF="./function::int_arg.3stap.html">function::int_arg</A></I>(3stap),
-
-
-<I><A HREF="./function::uint_arg.3stap.html">function::uint_arg</A></I>(3stap),
-
-
-<I><A HREF="./function::long_arg.3stap.html">function::long_arg</A></I>(3stap),
-
-
-<I><A HREF="./function::ulong_arg.3stap.html">function::ulong_arg</A></I>(3stap),
-
-
-<I><A HREF="./function::longlong_arg.3stap.html">function::longlong_arg</A></I>(3stap),
-
-
-<I><A HREF="./function::ulonglong_arg.3stap.html">function::ulonglong_arg</A></I>(3stap),
-
-
-<I><A HREF="./function::pointer_arg.3stap.html">function::pointer_arg</A></I>(3stap),
-
-
-<I><A HREF="./function::s32_arg.3stap.html">function::s32_arg</A></I>(3stap),
-
-
-<I><A HREF="./function::u32_arg.3stap.html">function::u32_arg</A></I>(3stap),
-
-
-<I><A HREF="./function::s64_arg.3stap.html">function::s64_arg</A></I>(3stap),
-
-
-<I><A HREF="./function::u64_arg.3stap.html">function::u64_arg</A></I>(3stap),
-
-
-<I><A HREF="./function::asmlinkage.3stap.html">function::asmlinkage</A></I>(3stap),
-
-
-<I><A HREF="./function::fastcall.3stap.html">function::fastcall</A></I>(3stap),
-
-
-<I><A HREF="./function::regparm.3stap.html">function::regparm</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::rpc</TITLE>
-</HEAD><BODY>
-<H1>tapset::rpc</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::rpc - systemtap rpc tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>sunrpc.clnt.create_client </B>
-
-<DD>
-Create an RPC client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.clnt.create_client.3stap.html">probe::sunrpc.clnt.create_client</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.clnt.clone_client </B>
-
-<DD>
-Clone an RPC client structure
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.clnt.clone_client.3stap.html">probe::sunrpc.clnt.clone_client</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.clnt.shutdown_client </B>
-
-<DD>
-Shutdown an RPC client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.clnt.shutdown_client.3stap.html">probe::sunrpc.clnt.shutdown_client</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.clnt.bind_new_program </B>
-
-<DD>
-Bind a new RPC program to an existing client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.clnt.bind_new_program.3stap.html">probe::sunrpc.clnt.bind_new_program</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.clnt.call_sync </B>
-
-<DD>
-Make a synchronous RPC call
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.clnt.call_sync.3stap.html">probe::sunrpc.clnt.call_sync</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.clnt.call_async </B>
-
-<DD>
-Make an asynchronous RPC call
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.clnt.call_async.3stap.html">probe::sunrpc.clnt.call_async</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.clnt.restart_call </B>
-
-<DD>
-Restart an asynchronous RPC call
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.clnt.restart_call.3stap.html">probe::sunrpc.clnt.restart_call</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.svc.register </B>
-
-<DD>
-Register an RPC service with the local portmapper
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.svc.register.3stap.html">probe::sunrpc.svc.register</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.svc.create </B>
-
-<DD>
-Create an RPC service
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.svc.create.3stap.html">probe::sunrpc.svc.create</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.svc.destroy </B>
-
-<DD>
-Destroy an RPC service
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.svc.destroy.3stap.html">probe::sunrpc.svc.destroy</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.svc.process </B>
-
-<DD>
-Process an RPC request
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.svc.process.3stap.html">probe::sunrpc.svc.process</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.svc.authorise </B>
-
-<DD>
-An RPC request is to be authorised
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.svc.authorise.3stap.html">probe::sunrpc.svc.authorise</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.svc.recv </B>
-
-<DD>
-Listen for the next RPC request on any socket
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.svc.recv.3stap.html">probe::sunrpc.svc.recv</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.svc.send </B>
-
-<DD>
-Return reply to RPC client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.svc.send.3stap.html">probe::sunrpc.svc.send</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.svc.drop </B>
-
-<DD>
-Drop RPC request
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.svc.drop.3stap.html">probe::sunrpc.svc.drop</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.sched.new_task </B>
-
-<DD>
-Create new task for the specified client
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.sched.new_task.3stap.html">probe::sunrpc.sched.new_task</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.sched.release_task </B>
-
-<DD>
-Release all resources associated with a task
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.sched.release_task.3stap.html">probe::sunrpc.sched.release_task</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.sched.execute </B>
-
-<DD>
-Execute the RPC `scheduler'
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.sched.execute.3stap.html">probe::sunrpc.sched.execute</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sunrpc.sched.delay </B>
-
-<DD>
-Delay an RPC task
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::sunrpc.sched.delay.3stap.html">probe::sunrpc.sched.delay</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./probe::sunrpc.clnt.create_client.3stap.html">probe::sunrpc.clnt.create_client</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.clnt.clone_client.3stap.html">probe::sunrpc.clnt.clone_client</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.clnt.shutdown_client.3stap.html">probe::sunrpc.clnt.shutdown_client</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.clnt.bind_new_program.3stap.html">probe::sunrpc.clnt.bind_new_program</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.clnt.call_sync.3stap.html">probe::sunrpc.clnt.call_sync</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.clnt.call_async.3stap.html">probe::sunrpc.clnt.call_async</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.clnt.restart_call.3stap.html">probe::sunrpc.clnt.restart_call</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.svc.register.3stap.html">probe::sunrpc.svc.register</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.svc.create.3stap.html">probe::sunrpc.svc.create</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.svc.destroy.3stap.html">probe::sunrpc.svc.destroy</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.svc.process.3stap.html">probe::sunrpc.svc.process</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.svc.authorise.3stap.html">probe::sunrpc.svc.authorise</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.svc.recv.3stap.html">probe::sunrpc.svc.recv</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.svc.send.3stap.html">probe::sunrpc.svc.send</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.svc.drop.3stap.html">probe::sunrpc.svc.drop</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.sched.new_task.3stap.html">probe::sunrpc.sched.new_task</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.sched.release_task.3stap.html">probe::sunrpc.sched.release_task</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.sched.execute.3stap.html">probe::sunrpc.sched.execute</A></I>(3stap),
-
-
-<I><A HREF="./probe::sunrpc.sched.delay.3stap.html">probe::sunrpc.sched.delay</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::scheduler</TITLE>
-</HEAD><BODY>
-<H1>tapset::scheduler</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::scheduler - systemtap scheduler tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>scheduler.cpu_off </B>
-
-<DD>
-Process is about to stop running on a cpu
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scheduler.cpu_off.3stap.html">probe::scheduler.cpu_off</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scheduler.cpu_on </B>
-
-<DD>
-Process is beginning execution on a cpu
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scheduler.cpu_on.3stap.html">probe::scheduler.cpu_on</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scheduler.tick </B>
-
-<DD>
-Schedulers internal tick, a processes timeslice accounting is updated
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scheduler.tick.3stap.html">probe::scheduler.tick</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scheduler.balance </B>
-
-<DD>
-A cpu attempting to find more work.
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scheduler.balance.3stap.html">probe::scheduler.balance</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scheduler.ctxswitch </B>
-
-<DD>
-A context switch is occuring.
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scheduler.ctxswitch.3stap.html">probe::scheduler.ctxswitch</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scheduler.kthread_stop </B>
-
-<DD>
-A thread created by kthread_create is being stopped
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scheduler.kthread_stop.3stap.html">probe::scheduler.kthread_stop</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scheduler.kthread_stop.return </B>
-
-<DD>
-A kthread is stopped and gets the return value
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scheduler.kthread_stop.return.3stap.html">probe::scheduler.kthread_stop.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scheduler.wait_task </B>
-
-<DD>
-Waiting on a task to unschedule (become inactive)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scheduler.wait_task.3stap.html">probe::scheduler.wait_task</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scheduler.wakeup </B>
-
-<DD>
-Task is woken up
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scheduler.wakeup.3stap.html">probe::scheduler.wakeup</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scheduler.wakeup_new </B>
-
-<DD>
-Newly created task is woken up for the first time
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scheduler.wakeup_new.3stap.html">probe::scheduler.wakeup_new</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scheduler.migrate </B>
-
-<DD>
-Task migrating across cpus
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scheduler.migrate.3stap.html">probe::scheduler.migrate</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scheduler.process_free </B>
-
-<DD>
-Scheduler freeing a data structure for a process
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scheduler.process_free.3stap.html">probe::scheduler.process_free</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scheduler.process_exit </B>
-
-<DD>
-Process exiting
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scheduler.process_exit.3stap.html">probe::scheduler.process_exit</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scheduler.process_wait </B>
-
-<DD>
-Scheduler starting to wait on a process
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scheduler.process_wait.3stap.html">probe::scheduler.process_wait</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scheduler.process_fork </B>
-
-<DD>
-Process forked
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scheduler.process_fork.3stap.html">probe::scheduler.process_fork</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scheduler.signal_send </B>
-
-<DD>
-Sending a signal
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scheduler.signal_send.3stap.html">probe::scheduler.signal_send</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./probe::scheduler.cpu_off.3stap.html">probe::scheduler.cpu_off</A></I>(3stap),
-
-
-<I><A HREF="./probe::scheduler.cpu_on.3stap.html">probe::scheduler.cpu_on</A></I>(3stap),
-
-
-<I><A HREF="./probe::scheduler.tick.3stap.html">probe::scheduler.tick</A></I>(3stap),
-
-
-<I><A HREF="./probe::scheduler.balance.3stap.html">probe::scheduler.balance</A></I>(3stap),
-
-
-<I><A HREF="./probe::scheduler.ctxswitch.3stap.html">probe::scheduler.ctxswitch</A></I>(3stap),
-
-
-<I><A HREF="./probe::scheduler.kthread_stop.3stap.html">probe::scheduler.kthread_stop</A></I>(3stap),
-
-
-<I><A HREF="./probe::scheduler.kthread_stop.return.3stap.html">probe::scheduler.kthread_stop.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::scheduler.wait_task.3stap.html">probe::scheduler.wait_task</A></I>(3stap),
-
-
-<I><A HREF="./probe::scheduler.wakeup.3stap.html">probe::scheduler.wakeup</A></I>(3stap),
-
-
-<I><A HREF="./probe::scheduler.wakeup_new.3stap.html">probe::scheduler.wakeup_new</A></I>(3stap),
-
-
-<I><A HREF="./probe::scheduler.migrate.3stap.html">probe::scheduler.migrate</A></I>(3stap),
-
-
-<I><A HREF="./probe::scheduler.process_free.3stap.html">probe::scheduler.process_free</A></I>(3stap),
-
-
-<I><A HREF="./probe::scheduler.process_exit.3stap.html">probe::scheduler.process_exit</A></I>(3stap),
-
-
-<I><A HREF="./probe::scheduler.process_wait.3stap.html">probe::scheduler.process_wait</A></I>(3stap),
-
-
-<I><A HREF="./probe::scheduler.process_fork.3stap.html">probe::scheduler.process_fork</A></I>(3stap),
-
-
-<I><A HREF="./probe::scheduler.signal_send.3stap.html">probe::scheduler.signal_send</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::scsi</TITLE>
-</HEAD><BODY>
-<H1>tapset::scsi</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::scsi - systemtap scsi tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> This family of probe points is used to probe SCSI activities.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>scsi.ioentry </B>
-
-<DD>
-Prepares a SCSI mid-layer request
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scsi.ioentry.3stap.html">probe::scsi.ioentry</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scsi.iodispatching </B>
-
-<DD>
-SCSI mid-layer dispatched low-level SCSI command
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scsi.iodispatching.3stap.html">probe::scsi.iodispatching</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scsi.iodone </B>
-
-<DD>
-SCSI command completed by low level driver and enqueued into the done queue.
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scsi.iodone.3stap.html">probe::scsi.iodone</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scsi.iocompleted </B>
-
-<DD>
-SCSI mid-layer running the completion processing for block device I/O requests
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scsi.iocompleted.3stap.html">probe::scsi.iocompleted</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scsi.ioexecute </B>
-
-<DD>
-Create mid-layer SCSI request and wait for the result
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scsi.ioexecute.3stap.html">probe::scsi.ioexecute</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>scsi.set_state </B>
-
-<DD>
-Order SCSI device state change
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::scsi.set_state.3stap.html">probe::scsi.set_state</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./probe::scsi.ioentry.3stap.html">probe::scsi.ioentry</A></I>(3stap),
-
-
-<I><A HREF="./probe::scsi.iodispatching.3stap.html">probe::scsi.iodispatching</A></I>(3stap),
-
-
-<I><A HREF="./probe::scsi.iodone.3stap.html">probe::scsi.iodone</A></I>(3stap),
-
-
-<I><A HREF="./probe::scsi.iocompleted.3stap.html">probe::scsi.iocompleted</A></I>(3stap),
-
-
-<I><A HREF="./probe::scsi.ioexecute.3stap.html">probe::scsi.ioexecute</A></I>(3stap),
-
-
-<I><A HREF="./probe::scsi.set_state.3stap.html">probe::scsi.set_state</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::signal</TITLE>
-</HEAD><BODY>
-<H1>tapset::signal</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::signal - systemtap signal tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> This family of probe points is used to probe signal activities.
-<BR> Since there are so many signals sent to processes at any given
-<BR> point, it is advisable to filter the information according to the
-<BR> requirements. For example, filter only for a particular signal
-<BR> (if sig==2) or for a particular process (if pid_name==stap).
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>signal.send </B>
-
-<DD>
-Signal being sent to a process
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.send.3stap.html">probe::signal.send</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.send.return </B>
-
-<DD>
-Signal being sent to a process completed (deprecated in SystemTap 2.1)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.send.return.3stap.html">probe::signal.send.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.checkperm </B>
-
-<DD>
-Check being performed on a sent signal
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.checkperm.3stap.html">probe::signal.checkperm</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.checkperm.return </B>
-
-<DD>
-Check performed on a sent signal completed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.checkperm.return.3stap.html">probe::signal.checkperm.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.wakeup </B>
-
-<DD>
-Sleeping process being wakened for signal
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.wakeup.3stap.html">probe::signal.wakeup</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.check_ignored </B>
-
-<DD>
-Checking to see signal is ignored
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.check_ignored.3stap.html">probe::signal.check_ignored</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.check_ignored.return </B>
-
-<DD>
-Check to see signal is ignored completed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.check_ignored.return.3stap.html">probe::signal.check_ignored.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.force_segv </B>
-
-<DD>
-Forcing send of SIGSEGV
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.force_segv.3stap.html">probe::signal.force_segv</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.force_segv.return </B>
-
-<DD>
-Forcing send of SIGSEGV complete
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.force_segv.return.3stap.html">probe::signal.force_segv.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.syskill </B>
-
-<DD>
-Sending kill signal to a process
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.syskill.3stap.html">probe::signal.syskill</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.syskill.return </B>
-
-<DD>
-Sending kill signal completed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.syskill.return.3stap.html">probe::signal.syskill.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.sys_tkill </B>
-
-<DD>
-Sending a kill signal to a thread
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.sys_tkill.3stap.html">probe::signal.sys_tkill</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.systkill.return </B>
-
-<DD>
-Sending kill signal to a thread completed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.systkill.return.3stap.html">probe::signal.systkill.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.sys_tgkill </B>
-
-<DD>
-Sending kill signal to a thread group
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.sys_tgkill.3stap.html">probe::signal.sys_tgkill</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.sys_tgkill.return </B>
-
-<DD>
-Sending kill signal to a thread group completed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.sys_tgkill.return.3stap.html">probe::signal.sys_tgkill.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.send_sig_queue </B>
-
-<DD>
-Queuing a signal to a process
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.send_sig_queue.3stap.html">probe::signal.send_sig_queue</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.send_sig_queue.return </B>
-
-<DD>
-Queuing a signal to a process completed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.send_sig_queue.return.3stap.html">probe::signal.send_sig_queue.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.pending </B>
-
-<DD>
-Examining pending signal
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.pending.3stap.html">probe::signal.pending</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.pending.return </B>
-
-<DD>
-Examination of pending signal completed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.pending.return.3stap.html">probe::signal.pending.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.handle </B>
-
-<DD>
-Signal handler being invoked
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.handle.3stap.html">probe::signal.handle</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.handle.return </B>
-
-<DD>
-Signal handler invocation completed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.handle.return.3stap.html">probe::signal.handle.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.do_action </B>
-
-<DD>
-Examining or changing a signal action
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.do_action.3stap.html">probe::signal.do_action</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.do_action.return </B>
-
-<DD>
-Examining or changing a signal action completed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.do_action.return.3stap.html">probe::signal.do_action.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.procmask </B>
-
-<DD>
-Examining or changing blocked signals
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.procmask.3stap.html">probe::signal.procmask</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.procmask.return </B>
-
-<DD>
-Examining or changing blocked signals completed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.procmask.return.3stap.html">probe::signal.procmask.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal.flush </B>
-
-<DD>
-Flushing all pending signals for a task
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::signal.flush.3stap.html">probe::signal.flush</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>get_sa_flags </B>
-
-<DD>
-Returns the numeric value of sa_flags
-<DT><DD>
-See
-<I><A HREF="./function::get_sa_flags.3stap.html">function::get_sa_flags</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>get_sa_flags </B>
-
-<DD>
-Returns the numeric value of sa_handler
-<DT><DD>
-See
-<I><A HREF="./function::get_sa_flags.3stap.html">function::get_sa_flags</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>get_sa_flags </B>
-
-<DD>
-Returns the string representation of a sigset
-<DT><DD>
-See
-<I><A HREF="./function::get_sa_flags.3stap.html">function::get_sa_flags</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>is_sig_blocked </B>
-
-<DD>
-Returns 1 if the signal is currently blocked, or 0 if it is not
-<DT><DD>
-See
-<I><A HREF="./function::is_sig_blocked.3stap.html">function::is_sig_blocked</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sa_flags_str </B>
-
-<DD>
-Returns the string representation of sa_flags
-<DT><DD>
-See
-<I><A HREF="./function::sa_flags_str.3stap.html">function::sa_flags_str</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sa_handler </B>
-
-<DD>
-Returns the string representation of an sa_handler
-<DT><DD>
-See
-<I><A HREF="./function::sa_handler.3stap.html">function::sa_handler</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>signal_str </B>
-
-<DD>
-Returns the string representation of a signal number
-<DT><DD>
-See
-<I><A HREF="./function::signal_str.3stap.html">function::signal_str</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::get_sa_flags.3stap.html">function::get_sa_flags</A></I>(3stap),
-
-
-<I><A HREF="./function::get_sa_flags.3stap.html">function::get_sa_flags</A></I>(3stap),
-
-
-<I><A HREF="./function::get_sa_flags.3stap.html">function::get_sa_flags</A></I>(3stap),
-
-
-<I><A HREF="./function::is_sig_blocked.3stap.html">function::is_sig_blocked</A></I>(3stap),
-
-
-<I><A HREF="./function::sa_flags_str.3stap.html">function::sa_flags_str</A></I>(3stap),
-
-
-<I><A HREF="./function::sa_handler.3stap.html">function::sa_handler</A></I>(3stap),
-
-
-<I><A HREF="./function::signal_str.3stap.html">function::signal_str</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.send.3stap.html">probe::signal.send</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.send.return.3stap.html">probe::signal.send.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.checkperm.3stap.html">probe::signal.checkperm</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.checkperm.return.3stap.html">probe::signal.checkperm.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.wakeup.3stap.html">probe::signal.wakeup</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.check_ignored.3stap.html">probe::signal.check_ignored</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.check_ignored.return.3stap.html">probe::signal.check_ignored.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.force_segv.3stap.html">probe::signal.force_segv</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.force_segv.return.3stap.html">probe::signal.force_segv.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.syskill.3stap.html">probe::signal.syskill</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.syskill.return.3stap.html">probe::signal.syskill.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.sys_tkill.3stap.html">probe::signal.sys_tkill</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.systkill.return.3stap.html">probe::signal.systkill.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.sys_tgkill.3stap.html">probe::signal.sys_tgkill</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.sys_tgkill.return.3stap.html">probe::signal.sys_tgkill.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.send_sig_queue.3stap.html">probe::signal.send_sig_queue</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.send_sig_queue.return.3stap.html">probe::signal.send_sig_queue.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.pending.3stap.html">probe::signal.pending</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.pending.return.3stap.html">probe::signal.pending.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.handle.3stap.html">probe::signal.handle</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.handle.return.3stap.html">probe::signal.handle.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.do_action.3stap.html">probe::signal.do_action</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.do_action.return.3stap.html">probe::signal.do_action.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.procmask.3stap.html">probe::signal.procmask</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.procmask.return.3stap.html">probe::signal.procmask.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::signal.flush.3stap.html">probe::signal.flush</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::socket</TITLE>
-</HEAD><BODY>
-<H1>tapset::socket</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::socket - systemtap socket tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> This family of probe points is used to probe socket activities.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>socket.send </B>
-
-<DD>
-Message sent on a socket.
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.send.3stap.html">probe::socket.send</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>socket.receive </B>
-
-<DD>
-Message received on a socket.
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.receive.3stap.html">probe::socket.receive</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>socket.sendmsg </B>
-
-<DD>
-Message is currently being sent on a socket.
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.sendmsg.3stap.html">probe::socket.sendmsg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>socket.sendmsg.return </B>
-
-<DD>
-Return from socket.sendmsg.
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.sendmsg.return.3stap.html">probe::socket.sendmsg.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>socket.recvmsg </B>
-
-<DD>
-Message being received on socket
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.recvmsg.3stap.html">probe::socket.recvmsg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>socket.recvmsg.return </B>
-
-<DD>
-Return from Message being received on socket
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.recvmsg.return.3stap.html">probe::socket.recvmsg.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>socket.aio_write </B>
-
-<DD>
-Message send via sock_aio_write()
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.aio_write.3stap.html">probe::socket.aio_write</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>socket.aio_write.return </B>
-
-<DD>
-Conclusion of message send via sock_aio_write()
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.aio_write.return.3stap.html">probe::socket.aio_write.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>socket.aio_read </B>
-
-<DD>
-Receiving message via sock_aio_read()
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.aio_read.3stap.html">probe::socket.aio_read</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>socket.aio_read.return </B>
-
-<DD>
-Conclusion of message received via sock_aio_read()
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.aio_read.return.3stap.html">probe::socket.aio_read.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>socket.writev </B>
-
-<DD>
-Message sent via socket_writev()
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.writev.3stap.html">probe::socket.writev</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>socket.writev.return </B>
-
-<DD>
-Conclusion of message sent via socket_writev()
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.writev.return.3stap.html">probe::socket.writev.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>socket.readv </B>
-
-<DD>
-Receiving a message via sock_readv()
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.readv.3stap.html">probe::socket.readv</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>socket.readv.return </B>
-
-<DD>
-Conclusion of receiving a message via sock_readv()
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.readv.return.3stap.html">probe::socket.readv.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>socket.create </B>
-
-<DD>
-Creation of a socket
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.create.3stap.html">probe::socket.create</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>socket.create.return </B>
-
-<DD>
-Return from Creation of a socket
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.create.return.3stap.html">probe::socket.create.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>socket.close </B>
-
-<DD>
-Close a socket
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.close.3stap.html">probe::socket.close</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>socket.close.return </B>
-
-<DD>
-Return from closing a socket
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::socket.close.return.3stap.html">probe::socket.close.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sock_prot_num2str </B>
-
-<DD>
-Given a protocol number, return a string representation
-<DT><DD>
-See
-<I><A HREF="./function::sock_prot_num2str.3stap.html">function::sock_prot_num2str</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sock_prot_str2num </B>
-
-<DD>
-Given a protocol name (string), return the corresponding protocol number
-<DT><DD>
-See
-<I><A HREF="./function::sock_prot_str2num.3stap.html">function::sock_prot_str2num</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sock_fam_num2str </B>
-
-<DD>
-Given a protocol family number, return a string representation
-<DT><DD>
-See
-<I><A HREF="./function::sock_fam_num2str.3stap.html">function::sock_fam_num2str</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sock_fam_str2num </B>
-
-<DD>
-Given a protocol family name (string), return the corresponding protocol family number
-<DT><DD>
-See
-<I><A HREF="./function::sock_fam_str2num.3stap.html">function::sock_fam_str2num</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sock_state_num2str </B>
-
-<DD>
-Given a socket state number, return a string representation
-<DT><DD>
-See
-<I><A HREF="./function::sock_state_num2str.3stap.html">function::sock_state_num2str</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sock_state_str2num </B>
-
-<DD>
-Given a socket state string, return the corresponding state number
-<DT><DD>
-See
-<I><A HREF="./function::sock_state_str2num.3stap.html">function::sock_state_str2num</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::sock_prot_num2str.3stap.html">function::sock_prot_num2str</A></I>(3stap),
-
-
-<I><A HREF="./function::sock_prot_str2num.3stap.html">function::sock_prot_str2num</A></I>(3stap),
-
-
-<I><A HREF="./function::sock_fam_num2str.3stap.html">function::sock_fam_num2str</A></I>(3stap),
-
-
-<I><A HREF="./function::sock_fam_str2num.3stap.html">function::sock_fam_str2num</A></I>(3stap),
-
-
-<I><A HREF="./function::sock_state_num2str.3stap.html">function::sock_state_num2str</A></I>(3stap),
-
-
-<I><A HREF="./function::sock_state_str2num.3stap.html">function::sock_state_str2num</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.send.3stap.html">probe::socket.send</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.receive.3stap.html">probe::socket.receive</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.sendmsg.3stap.html">probe::socket.sendmsg</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.sendmsg.return.3stap.html">probe::socket.sendmsg.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.recvmsg.3stap.html">probe::socket.recvmsg</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.recvmsg.return.3stap.html">probe::socket.recvmsg.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.aio_write.3stap.html">probe::socket.aio_write</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.aio_write.return.3stap.html">probe::socket.aio_write.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.aio_read.3stap.html">probe::socket.aio_read</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.aio_read.return.3stap.html">probe::socket.aio_read.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.writev.3stap.html">probe::socket.writev</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.writev.return.3stap.html">probe::socket.writev.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.readv.3stap.html">probe::socket.readv</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.readv.return.3stap.html">probe::socket.readv.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.create.3stap.html">probe::socket.create</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.create.return.3stap.html">probe::socket.create.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.close.3stap.html">probe::socket.close</A></I>(3stap),
-
-
-<I><A HREF="./probe::socket.close.return.3stap.html">probe::socket.close.return</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::speculative</TITLE>
-</HEAD><BODY>
-<H1>tapset::speculative</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::speculative - systemtap speculative tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>speculation </B>
-
-<DD>
-Allocate a new id for speculative output
-<DT><DD>
-See
-<I><A HREF="./function::speculation.3stap.html">function::speculation</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>speculate </B>
-
-<DD>
-Store a string for possible output later
-<DT><DD>
-See
-<I><A HREF="./function::speculate.3stap.html">function::speculate</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>discard </B>
-
-<DD>
-Discard all output related to a speculation buffer
-<DT><DD>
-See
-<I><A HREF="./function::discard.3stap.html">function::discard</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>commit </B>
-
-<DD>
-Write out all output related to a speculation buffer
-<DT><DD>
-See
-<I><A HREF="./function::commit.3stap.html">function::commit</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::speculation.3stap.html">function::speculation</A></I>(3stap),
-
-
-<I><A HREF="./function::speculate.3stap.html">function::speculate</A></I>(3stap),
-
-
-<I><A HREF="./function::discard.3stap.html">function::discard</A></I>(3stap),
-
-
-<I><A HREF="./function::commit.3stap.html">function::commit</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::stap_staticmarkers</TITLE>
-</HEAD><BODY>
-<H1>tapset::stap_staticmarkers</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::stap_staticmarkers - systemtap stap_staticmarkers tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>stap.pass0 </B>
-
-<DD>
-Starting stap pass0 (parsing command line arguments)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.pass0.3stap.html">probe::stap.pass0</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.pass0.end </B>
-
-<DD>
-Finished stap pass0 (parsing command line arguments)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.pass0.end.3stap.html">probe::stap.pass0.end</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.pass1a </B>
-
-<DD>
-Starting stap pass1 (parsing user script)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.pass1a.3stap.html">probe::stap.pass1a</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.pass1b </B>
-
-<DD>
-Starting stap pass1 (parsing library scripts)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.pass1b.3stap.html">probe::stap.pass1b</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.pass1.end </B>
-
-<DD>
-Finished stap pass1 (parsing scripts)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.pass1.end.3stap.html">probe::stap.pass1.end</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.pass2 </B>
-
-<DD>
-Starting stap pass2 (elaboration)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.pass2.3stap.html">probe::stap.pass2</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.pass2.end </B>
-
-<DD>
-Finished stap pass2 (elaboration)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.pass2.end.3stap.html">probe::stap.pass2.end</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.pass3 </B>
-
-<DD>
-Starting stap pass3 (translation to C)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.pass3.3stap.html">probe::stap.pass3</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.pass3.end </B>
-
-<DD>
-Finished stap pass3 (translation to C)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.pass3.end.3stap.html">probe::stap.pass3.end</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.pass4 </B>
-
-<DD>
-Starting stap pass4 (compile C code into kernel module)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.pass4.3stap.html">probe::stap.pass4</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.pass4.end </B>
-
-<DD>
-Finished stap pass4 (compile C code into kernel module)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.pass4.end.3stap.html">probe::stap.pass4.end</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.pass5 </B>
-
-<DD>
-Starting stap pass5 (running the instrumentation)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.pass5.3stap.html">probe::stap.pass5</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.pass5.end </B>
-
-<DD>
-Finished stap pass5 (running the instrumentation)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.pass5.end.3stap.html">probe::stap.pass5.end</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.pass6 </B>
-
-<DD>
-Starting stap pass6 (cleanup)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.pass6.3stap.html">probe::stap.pass6</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.pass6.end </B>
-
-<DD>
-Finished stap pass6 (cleanup)
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.pass6.end.3stap.html">probe::stap.pass6.end</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.cache_clean </B>
-
-<DD>
-Removing file from stap cache
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.cache_clean.3stap.html">probe::stap.cache_clean</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.cache_add_mod </B>
-
-<DD>
-Adding kernel instrumentation module to cache
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.cache_add_mod.3stap.html">probe::stap.cache_add_mod</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.cache_add_src </B>
-
-<DD>
-Adding C code translation to cache
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.cache_add_src.3stap.html">probe::stap.cache_add_src</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.cache_add_nss </B>
-
-<DD>
-Add NSS (Network Security Services) information to cache
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.cache_add_nss.3stap.html">probe::stap.cache_add_nss</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.cache_get </B>
-
-<DD>
-Found item in stap cache
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.cache_get.3stap.html">probe::stap.cache_get</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.system </B>
-
-<DD>
-Starting a command from stap
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.system.3stap.html">probe::stap.system</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.system.spawn </B>
-
-<DD>
-stap spawned new process
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.system.spawn.3stap.html">probe::stap.system.spawn</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stap.system.return </B>
-
-<DD>
-Finished a command from stap
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stap.system.return.3stap.html">probe::stap.system.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>staprun.insert_module </B>
-
-<DD>
-Inserting SystemTap instrumentation module
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::staprun.insert_module.3stap.html">probe::staprun.insert_module</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>staprun.remove_module </B>
-
-<DD>
-Removing SystemTap instrumentation module
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::staprun.remove_module.3stap.html">probe::staprun.remove_module</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>staprun.send_control_message </B>
-
-<DD>
-Sending a control message
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::staprun.send_control_message.3stap.html">probe::staprun.send_control_message</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stapio.receive_control_message </B>
-
-<DD>
-Received a control message
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::stapio.receive_control_message.3stap.html">probe::stapio.receive_control_message</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./probe::stap.pass0.3stap.html">probe::stap.pass0</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.pass0.end.3stap.html">probe::stap.pass0.end</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.pass1a.3stap.html">probe::stap.pass1a</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.pass1b.3stap.html">probe::stap.pass1b</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.pass1.end.3stap.html">probe::stap.pass1.end</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.pass2.3stap.html">probe::stap.pass2</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.pass2.end.3stap.html">probe::stap.pass2.end</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.pass3.3stap.html">probe::stap.pass3</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.pass3.end.3stap.html">probe::stap.pass3.end</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.pass4.3stap.html">probe::stap.pass4</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.pass4.end.3stap.html">probe::stap.pass4.end</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.pass5.3stap.html">probe::stap.pass5</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.pass5.end.3stap.html">probe::stap.pass5.end</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.pass6.3stap.html">probe::stap.pass6</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.pass6.end.3stap.html">probe::stap.pass6.end</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.cache_clean.3stap.html">probe::stap.cache_clean</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.cache_add_mod.3stap.html">probe::stap.cache_add_mod</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.cache_add_src.3stap.html">probe::stap.cache_add_src</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.cache_add_nss.3stap.html">probe::stap.cache_add_nss</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.cache_get.3stap.html">probe::stap.cache_get</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.system.3stap.html">probe::stap.system</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.system.spawn.3stap.html">probe::stap.system.spawn</A></I>(3stap),
-
-
-<I><A HREF="./probe::stap.system.return.3stap.html">probe::stap.system.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::staprun.insert_module.3stap.html">probe::staprun.insert_module</A></I>(3stap),
-
-
-<I><A HREF="./probe::staprun.remove_module.3stap.html">probe::staprun.remove_module</A></I>(3stap),
-
-
-<I><A HREF="./probe::staprun.send_control_message.3stap.html">probe::staprun.send_control_message</A></I>(3stap),
-
-
-<I><A HREF="./probe::stapio.receive_control_message.3stap.html">probe::stapio.receive_control_message</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::stopwatch</TITLE>
-</HEAD><BODY>
-<H1>tapset::stopwatch</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::stopwatch - systemtap stopwatch tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>delete_stopwatch </B>
-
-<DD>
-Remove an existing stopwatch
-<DT><DD>
-See
-<I><A HREF="./function::delete_stopwatch.3stap.html">function::delete_stopwatch</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>start_stopwatch </B>
-
-<DD>
-Start a stopwatch
-<DT><DD>
-See
-<I><A HREF="./function::start_stopwatch.3stap.html">function::start_stopwatch</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stop_stopwatch </B>
-
-<DD>
-Stop a stopwatch
-<DT><DD>
-See
-<I><A HREF="./function::stop_stopwatch.3stap.html">function::stop_stopwatch</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>read_stopwatch_ns </B>
-
-<DD>
-Reads the time in nanoseconds for a stopwatch
-<DT><DD>
-See
-<I><A HREF="./function::read_stopwatch_ns.3stap.html">function::read_stopwatch_ns</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>read_stopwatch_us </B>
-
-<DD>
-Reads the time in microseconds for a stopwatch
-<DT><DD>
-See
-<I><A HREF="./function::read_stopwatch_us.3stap.html">function::read_stopwatch_us</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>read_stopwatch_ms </B>
-
-<DD>
-Reads the time in milliseconds for a stopwatch
-<DT><DD>
-See
-<I><A HREF="./function::read_stopwatch_ms.3stap.html">function::read_stopwatch_ms</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>read_stopwatch_ms </B>
-
-<DD>
-Reads the time in seconds for a stopwatch
-<DT><DD>
-See
-<I><A HREF="./function::read_stopwatch_ms.3stap.html">function::read_stopwatch_ms</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::delete_stopwatch.3stap.html">function::delete_stopwatch</A></I>(3stap),
-
-
-<I><A HREF="./function::start_stopwatch.3stap.html">function::start_stopwatch</A></I>(3stap),
-
-
-<I><A HREF="./function::stop_stopwatch.3stap.html">function::stop_stopwatch</A></I>(3stap),
-
-
-<I><A HREF="./function::read_stopwatch_ns.3stap.html">function::read_stopwatch_ns</A></I>(3stap),
-
-
-<I><A HREF="./function::read_stopwatch_us.3stap.html">function::read_stopwatch_us</A></I>(3stap),
-
-
-<I><A HREF="./function::read_stopwatch_ms.3stap.html">function::read_stopwatch_ms</A></I>(3stap),
-
-
-<I><A HREF="./function::read_stopwatch_ms.3stap.html">function::read_stopwatch_ms</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::string</TITLE>
-</HEAD><BODY>
-<H1>tapset::string</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::string - systemtap string tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>strlen </B>
-
-<DD>
-Returns the length of a string
-<DT><DD>
-See
-<I><A HREF="./function::strlen.3stap.html">function::strlen</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>substr </B>
-
-<DD>
-Returns a substring
-<DT><DD>
-See
-<I><A HREF="./function::substr.3stap.html">function::substr</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>stringat </B>
-
-<DD>
-Returns the char at a given position in the string
-<DT><DD>
-See
-<I><A HREF="./function::stringat.3stap.html">function::stringat</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>isinstr </B>
-
-<DD>
-Returns whether a string is a substring of another string
-<DT><DD>
-See
-<I><A HREF="./function::isinstr.3stap.html">function::isinstr</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>text_str </B>
-
-<DD>
-Escape any non-printable chars in a string
-<DT><DD>
-See
-<I><A HREF="./function::text_str.3stap.html">function::text_str</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>text_strn </B>
-
-<DD>
-Escape any non-printable chars in a string
-<DT><DD>
-See
-<I><A HREF="./function::text_strn.3stap.html">function::text_strn</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>- strtol </B>
-
-<DD>
-Convert a string to a long
-<DT><DD>
-See
-<I>function::-</I><A HREF="strtol.3stap.html">strtol</A><I>(3stap)</I>
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>isdigit </B>
-
-<DD>
-Checks for a digit
-<DT><DD>
-See
-<I><A HREF="./function::isdigit.3stap.html">function::isdigit</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::strlen.3stap.html">function::strlen</A></I>(3stap),
-
-
-<I><A HREF="./function::substr.3stap.html">function::substr</A></I>(3stap),
-
-
-<I><A HREF="./function::stringat.3stap.html">function::stringat</A></I>(3stap),
-
-
-<I><A HREF="./function::isinstr.3stap.html">function::isinstr</A></I>(3stap),
-
-
-<I><A HREF="./function::text_str.3stap.html">function::text_str</A></I>(3stap),
-
-
-<I><A HREF="./function::text_strn.3stap.html">function::text_strn</A></I>(3stap),
-
-
-<I>function::-</I>(3stap),
-
-
-<I><A HREF="./function::strtol.3stap.html">function::strtol</A></I>(3stap),
-
-
-<I><A HREF="./function::isdigit.3stap.html">function::isdigit</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::system</TITLE>
-</HEAD><BODY>
-<H1>tapset::system</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::system - systemtap system tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>system </B>
-
-<DD>
-Issue a command to the system
-<DT><DD>
-See
-<I><A HREF="./function::system.3stap.html">function::system</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::system.3stap.html">function::system</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::target_set</TITLE>
-</HEAD><BODY>
-<H1>tapset::target_set</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::target_set - systemtap target_set tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>target_set_pid </B>
-
-<DD>
-Does pid descend from target process?
-<DT><DD>
-See
-<I><A HREF="./function::target_set_pid.3stap.html">function::target_set_pid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>target_set_report </B>
-
-<DD>
-Print a report about the target set
-<DT><DD>
-See
-<I><A HREF="./function::target_set_report.3stap.html">function::target_set_report</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::target_set_pid.3stap.html">function::target_set_pid</A></I>(3stap),
-
-
-<I><A HREF="./function::target_set_report.3stap.html">function::target_set_report</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::task</TITLE>
-</HEAD><BODY>
-<H1>tapset::task</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::task - systemtap task tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>task_current </B>
-
-<DD>
-The current task_struct of the current task
-<DT><DD>
-See
-<I><A HREF="./function::task_current.3stap.html">function::task_current</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_parent </B>
-
-<DD>
-The task_struct of the parent task
-<DT><DD>
-See
-<I><A HREF="./function::task_parent.3stap.html">function::task_parent</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_state </B>
-
-<DD>
-The state of the task
-<DT><DD>
-See
-<I><A HREF="./function::task_state.3stap.html">function::task_state</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_execname </B>
-
-<DD>
-The name of the task
-<DT><DD>
-See
-<I><A HREF="./function::task_execname.3stap.html">function::task_execname</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_pid </B>
-
-<DD>
-The process identifier of the task
-<DT><DD>
-See
-<I><A HREF="./function::task_pid.3stap.html">function::task_pid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>pid2task </B>
-
-<DD>
-The task_struct of the given process identifier
-<DT><DD>
-See
-<I><A HREF="./function::pid2task.3stap.html">function::pid2task</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>pid2execname </B>
-
-<DD>
-The name of the given process identifier
-<DT><DD>
-See
-<I><A HREF="./function::pid2execname.3stap.html">function::pid2execname</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_tid </B>
-
-<DD>
-The thread identifier of the task
-<DT><DD>
-See
-<I><A HREF="./function::task_tid.3stap.html">function::task_tid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_gid </B>
-
-<DD>
-The group identifier of the task
-<DT><DD>
-See
-<I><A HREF="./function::task_gid.3stap.html">function::task_gid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_egid </B>
-
-<DD>
-The effective group identifier of the task
-<DT><DD>
-See
-<I><A HREF="./function::task_egid.3stap.html">function::task_egid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_uid </B>
-
-<DD>
-The user identifier of the task
-<DT><DD>
-See
-<I><A HREF="./function::task_uid.3stap.html">function::task_uid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_euid </B>
-
-<DD>
-The effective user identifier of the task
-<DT><DD>
-See
-<I><A HREF="./function::task_euid.3stap.html">function::task_euid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_prio </B>
-
-<DD>
-The priority value of the task
-<DT><DD>
-See
-<I><A HREF="./function::task_prio.3stap.html">function::task_prio</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_nice </B>
-
-<DD>
-The nice value of the task
-<DT><DD>
-See
-<I><A HREF="./function::task_nice.3stap.html">function::task_nice</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_cpu </B>
-
-<DD>
-The scheduled cpu of the task
-<DT><DD>
-See
-<I><A HREF="./function::task_cpu.3stap.html">function::task_cpu</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_open_file_handles </B>
-
-<DD>
-The number of open files of the task
-<DT><DD>
-See
-<I><A HREF="./function::task_open_file_handles.3stap.html">function::task_open_file_handles</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_max_file_handles </B>
-
-<DD>
-The max number of open files for the task
-<DT><DD>
-See
-<I><A HREF="./function::task_max_file_handles.3stap.html">function::task_max_file_handles</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::task_current.3stap.html">function::task_current</A></I>(3stap),
-
-
-<I><A HREF="./function::task_parent.3stap.html">function::task_parent</A></I>(3stap),
-
-
-<I><A HREF="./function::task_state.3stap.html">function::task_state</A></I>(3stap),
-
-
-<I><A HREF="./function::task_execname.3stap.html">function::task_execname</A></I>(3stap),
-
-
-<I><A HREF="./function::task_pid.3stap.html">function::task_pid</A></I>(3stap),
-
-
-<I><A HREF="./function::pid2task.3stap.html">function::pid2task</A></I>(3stap),
-
-
-<I><A HREF="./function::pid2execname.3stap.html">function::pid2execname</A></I>(3stap),
-
-
-<I><A HREF="./function::task_tid.3stap.html">function::task_tid</A></I>(3stap),
-
-
-<I><A HREF="./function::task_gid.3stap.html">function::task_gid</A></I>(3stap),
-
-
-<I><A HREF="./function::task_egid.3stap.html">function::task_egid</A></I>(3stap),
-
-
-<I><A HREF="./function::task_uid.3stap.html">function::task_uid</A></I>(3stap),
-
-
-<I><A HREF="./function::task_euid.3stap.html">function::task_euid</A></I>(3stap),
-
-
-<I><A HREF="./function::task_prio.3stap.html">function::task_prio</A></I>(3stap),
-
-
-<I><A HREF="./function::task_nice.3stap.html">function::task_nice</A></I>(3stap),
-
-
-<I><A HREF="./function::task_cpu.3stap.html">function::task_cpu</A></I>(3stap),
-
-
-<I><A HREF="./function::task_open_file_handles.3stap.html">function::task_open_file_handles</A></I>(3stap),
-
-
-<I><A HREF="./function::task_max_file_handles.3stap.html">function::task_max_file_handles</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::task_ancestry</TITLE>
-</HEAD><BODY>
-<H1>tapset::task_ancestry</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::task_ancestry - systemtap task_ancestry tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>task_ancestry </B>
-
-<DD>
-The ancestry of the given task
-<DT><DD>
-See
-<I><A HREF="./function::task_ancestry.3stap.html">function::task_ancestry</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::task_ancestry.3stap.html">function::task_ancestry</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::task_time</TITLE>
-</HEAD><BODY>
-<H1>tapset::task_time</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::task_time - systemtap task_time tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> Task time query and utility functions provide information about
-<BR> the time resource usage of the current task. These functions provide
-<BR> information about the user time and system time of the current
-<BR> task. And provide utility functions to turn the reported times
-<BR> into miliseconds and create human readable string representations
-<BR> of task time used. The reported times are approximates and should
-<BR> be used for "coarse grained" measurements only. The reported user
-<BR> and system time are only for the current task, not for the process
-<BR> as a whole nor of any time spend by children of the current task.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>task_utime </B>
-
-<DD>
-User time of the current task
-<DT><DD>
-See
-<I><A HREF="./function::task_utime.3stap.html">function::task_utime</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_utime_tid </B>
-
-<DD>
-User time of the given task
-<DT><DD>
-See
-<I><A HREF="./function::task_utime_tid.3stap.html">function::task_utime_tid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_stime </B>
-
-<DD>
-System time of the current task
-<DT><DD>
-See
-<I><A HREF="./function::task_stime.3stap.html">function::task_stime</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_stime_tid </B>
-
-<DD>
-System time of the given task
-<DT><DD>
-See
-<I><A HREF="./function::task_stime_tid.3stap.html">function::task_stime_tid</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_start_time </B>
-
-<DD>
-Start time of the given task
-<DT><DD>
-See
-<I><A HREF="./function::task_start_time.3stap.html">function::task_start_time</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>cputime_to_msecs </B>
-
-<DD>
-Translates the given cputime into milliseconds
-<DT><DD>
-See
-<I><A HREF="./function::cputime_to_msecs.3stap.html">function::cputime_to_msecs</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>cputime_to_usecs </B>
-
-<DD>
-Translates the given cputime into microseconds
-<DT><DD>
-See
-<I><A HREF="./function::cputime_to_usecs.3stap.html">function::cputime_to_usecs</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>msecs_to_string </B>
-
-<DD>
-Human readable string for given milliseconds
-<DT><DD>
-See
-<I><A HREF="./function::msecs_to_string.3stap.html">function::msecs_to_string</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>usecs_to_string </B>
-
-<DD>
-Human readable string for given microseconds
-<DT><DD>
-See
-<I><A HREF="./function::usecs_to_string.3stap.html">function::usecs_to_string</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>nsecs_to_string </B>
-
-<DD>
-Human readable string for given nanoseconds
-<DT><DD>
-See
-<I><A HREF="./function::nsecs_to_string.3stap.html">function::nsecs_to_string</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>cputime_to_string </B>
-
-<DD>
-Human readable string for given cputime
-<DT><DD>
-See
-<I><A HREF="./function::cputime_to_string.3stap.html">function::cputime_to_string</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_time_string </B>
-
-<DD>
-Human readable string of task time usage
-<DT><DD>
-See
-<I><A HREF="./function::task_time_string.3stap.html">function::task_time_string</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>task_time_string_tid </B>
-
-<DD>
-Human readable string of task time usage
-<DT><DD>
-See
-<I><A HREF="./function::task_time_string_tid.3stap.html">function::task_time_string_tid</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::task_utime.3stap.html">function::task_utime</A></I>(3stap),
-
-
-<I><A HREF="./function::task_utime_tid.3stap.html">function::task_utime_tid</A></I>(3stap),
-
-
-<I><A HREF="./function::task_stime.3stap.html">function::task_stime</A></I>(3stap),
-
-
-<I><A HREF="./function::task_stime_tid.3stap.html">function::task_stime_tid</A></I>(3stap),
-
-
-<I><A HREF="./function::task_start_time.3stap.html">function::task_start_time</A></I>(3stap),
-
-
-<I><A HREF="./function::cputime_to_msecs.3stap.html">function::cputime_to_msecs</A></I>(3stap),
-
-
-<I><A HREF="./function::cputime_to_usecs.3stap.html">function::cputime_to_usecs</A></I>(3stap),
-
-
-<I><A HREF="./function::msecs_to_string.3stap.html">function::msecs_to_string</A></I>(3stap),
-
-
-<I><A HREF="./function::usecs_to_string.3stap.html">function::usecs_to_string</A></I>(3stap),
-
-
-<I><A HREF="./function::nsecs_to_string.3stap.html">function::nsecs_to_string</A></I>(3stap),
-
-
-<I><A HREF="./function::cputime_to_string.3stap.html">function::cputime_to_string</A></I>(3stap),
-
-
-<I><A HREF="./function::task_time_string.3stap.html">function::task_time_string</A></I>(3stap),
-
-
-<I><A HREF="./function::task_time_string_tid.3stap.html">function::task_time_string_tid</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::tcp</TITLE>
-</HEAD><BODY>
-<H1>tapset::tcp</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::tcp - systemtap tcp tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> This family of probe points is used to probe events that occur in the TCP layer,
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>tcp.sendmsg </B>
-
-<DD>
-Sending a tcp message
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcp.sendmsg.3stap.html">probe::tcp.sendmsg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcp.sendmsg.return </B>
-
-<DD>
-<BR> Sending TCP message is done
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcp.sendmsg.return.3stap.html">probe::tcp.sendmsg.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcp.recvmsg </B>
-
-<DD>
-Receiving TCP message
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcp.recvmsg.3stap.html">probe::tcp.recvmsg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcp.recvmsg.return </B>
-
-<DD>
-Receiving TCP message complete
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcp.recvmsg.return.3stap.html">probe::tcp.recvmsg.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcp.disconnect </B>
-
-<DD>
-TCP socket disconnection
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcp.disconnect.3stap.html">probe::tcp.disconnect</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcp.disconnect.return </B>
-
-<DD>
-TCP socket disconnection complete
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcp.disconnect.return.3stap.html">probe::tcp.disconnect.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcp.setsockopt </B>
-
-<DD>
-Call to setsockopt()
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcp.setsockopt.3stap.html">probe::tcp.setsockopt</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcp.setsockopt.return </B>
-
-<DD>
-<BR> Return from setsockopt()
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcp.setsockopt.return.3stap.html">probe::tcp.setsockopt.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcp.receive </B>
-
-<DD>
-Called when a TCP packet is received
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcp.receive.3stap.html">probe::tcp.receive</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./probe::tcp.sendmsg.3stap.html">probe::tcp.sendmsg</A></I>(3stap),
-
-
-<I><A HREF="./probe::tcp.sendmsg.return.3stap.html">probe::tcp.sendmsg.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::tcp.recvmsg.3stap.html">probe::tcp.recvmsg</A></I>(3stap),
-
-
-<I><A HREF="./probe::tcp.recvmsg.return.3stap.html">probe::tcp.recvmsg.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::tcp.disconnect.3stap.html">probe::tcp.disconnect</A></I>(3stap),
-
-
-<I><A HREF="./probe::tcp.disconnect.return.3stap.html">probe::tcp.disconnect.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::tcp.setsockopt.3stap.html">probe::tcp.setsockopt</A></I>(3stap),
-
-
-<I><A HREF="./probe::tcp.setsockopt.return.3stap.html">probe::tcp.setsockopt.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::tcp.receive.3stap.html">probe::tcp.receive</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::tcpmib-filter-default</TITLE>
-</HEAD><BODY>
-<H1>tapset::tcpmib-filter-default</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::tcpmib-filter-default - systemtap tcpmib-filter-default tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>tcpmib_filter_key </B>
-
-<DD>
-Default filter function for tcpmib.* probes
-<DT><DD>
-See
-<I><A HREF="./function::tcpmib_filter_key.3stap.html">function::tcpmib_filter_key</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::tcpmib_filter_key.3stap.html">function::tcpmib_filter_key</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::tcpmib</TITLE>
-</HEAD><BODY>
-<H1>tapset::tcpmib</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::tcpmib - systemtap tcpmib tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>tcpmib_get_state </B>
-
-<DD>
-Get a socket's state
-<DT><DD>
-See
-<I><A HREF="./function::tcpmib_get_state.3stap.html">function::tcpmib_get_state</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcpmib_local_addr </B>
-
-<DD>
-Get the source address
-<DT><DD>
-See
-<I><A HREF="./function::tcpmib_local_addr.3stap.html">function::tcpmib_local_addr</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcpmib_remote_addr </B>
-
-<DD>
-Get the remote address
-<DT><DD>
-See
-<I><A HREF="./function::tcpmib_remote_addr.3stap.html">function::tcpmib_remote_addr</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcpmib_local_port </B>
-
-<DD>
-Get the local port
-<DT><DD>
-See
-<I><A HREF="./function::tcpmib_local_port.3stap.html">function::tcpmib_local_port</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcpmib_remote_port </B>
-
-<DD>
-Get the remote port
-<DT><DD>
-See
-<I><A HREF="./function::tcpmib_remote_port.3stap.html">function::tcpmib_remote_port</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcpmib.ActiveOpens </B>
-
-<DD>
-Count an active opening of a socket
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcpmib.ActiveOpens.3stap.html">probe::tcpmib.ActiveOpens</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcpmib.AttemptFails </B>
-
-<DD>
-Count a failed attempt to open a socket
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcpmib.AttemptFails.3stap.html">probe::tcpmib.AttemptFails</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcpmib.CurrEstab </B>
-
-<DD>
-Update the count of open sockets
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcpmib.CurrEstab.3stap.html">probe::tcpmib.CurrEstab</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcpmib.EstabResets </B>
-
-<DD>
-Count the reset of a socket
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcpmib.EstabResets.3stap.html">probe::tcpmib.EstabResets</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcpmib.InSegs </B>
-
-<DD>
-Count an incoming tcp segment
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcpmib.InSegs.3stap.html">probe::tcpmib.InSegs</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcpmib.OutRsts </B>
-
-<DD>
-Count the sending of a reset packet
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcpmib.OutRsts.3stap.html">probe::tcpmib.OutRsts</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcpmib.OutSegs </B>
-
-<DD>
-Count the sending of a TCP segment
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcpmib.OutSegs.3stap.html">probe::tcpmib.OutSegs</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcpmib.PassiveOpens </B>
-
-<DD>
-Count the passive creation of a socket
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcpmib.PassiveOpens.3stap.html">probe::tcpmib.PassiveOpens</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tcpmib.RetransSegs </B>
-
-<DD>
-Count the retransmission of a TCP segment
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tcpmib.RetransSegs.3stap.html">probe::tcpmib.RetransSegs</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::tcpmib_get_state.3stap.html">function::tcpmib_get_state</A></I>(3stap),
-
-
-<I><A HREF="./function::tcpmib_local_addr.3stap.html">function::tcpmib_local_addr</A></I>(3stap),
-
-
-<I><A HREF="./function::tcpmib_remote_addr.3stap.html">function::tcpmib_remote_addr</A></I>(3stap),
-
-
-<I><A HREF="./function::tcpmib_local_port.3stap.html">function::tcpmib_local_port</A></I>(3stap),
-
-
-<I><A HREF="./function::tcpmib_remote_port.3stap.html">function::tcpmib_remote_port</A></I>(3stap),
-
-
-<I><A HREF="./probe::tcpmib.ActiveOpens.3stap.html">probe::tcpmib.ActiveOpens</A></I>(3stap),
-
-
-<I><A HREF="./probe::tcpmib.AttemptFails.3stap.html">probe::tcpmib.AttemptFails</A></I>(3stap),
-
-
-<I><A HREF="./probe::tcpmib.CurrEstab.3stap.html">probe::tcpmib.CurrEstab</A></I>(3stap),
-
-
-<I><A HREF="./probe::tcpmib.EstabResets.3stap.html">probe::tcpmib.EstabResets</A></I>(3stap),
-
-
-<I><A HREF="./probe::tcpmib.InSegs.3stap.html">probe::tcpmib.InSegs</A></I>(3stap),
-
-
-<I><A HREF="./probe::tcpmib.OutRsts.3stap.html">probe::tcpmib.OutRsts</A></I>(3stap),
-
-
-<I><A HREF="./probe::tcpmib.OutSegs.3stap.html">probe::tcpmib.OutSegs</A></I>(3stap),
-
-
-<I><A HREF="./probe::tcpmib.PassiveOpens.3stap.html">probe::tcpmib.PassiveOpens</A></I>(3stap),
-
-
-<I><A HREF="./probe::tcpmib.RetransSegs.3stap.html">probe::tcpmib.RetransSegs</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::timestamp</TITLE>
-</HEAD><BODY>
-<H1>tapset::timestamp</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::timestamp - systemtap timestamp tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> Each timestamp function returns a value to indicate when a function is executed. These
-returned values can then be used to indicate when an event occurred, provide an ordering for events,
-or compute the amount of time elapsed between two time stamps.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>get_cycles </B>
-
-<DD>
-Processor cycle count
-<DT><DD>
-See
-<I><A HREF="./function::get_cycles.3stap.html">function::get_cycles</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>jiffies </B>
-
-<DD>
-Kernel jiffies count
-<DT><DD>
-See
-<I><A HREF="./function::jiffies.3stap.html">function::jiffies</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>HZ </B>
-
-<DD>
-Kernel HZ
-<DT><DD>
-See
-<I><A HREF="./function::HZ.3stap.html">function::HZ</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::get_cycles.3stap.html">function::get_cycles</A></I>(3stap),
-
-
-<I><A HREF="./function::jiffies.3stap.html">function::jiffies</A></I>(3stap),
-
-
-<I><A HREF="./function::HZ.3stap.html">function::HZ</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::timestamp_gtod</TITLE>
-</HEAD><BODY>
-<H1>tapset::timestamp_gtod</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::timestamp_gtod - systemtap timestamp_gtod tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>gettimeofday_ns </B>
-
-<DD>
-Number of nanoseconds since UNIX epoch
-<DT><DD>
-See
-<I><A HREF="./function::gettimeofday_ns.3stap.html">function::gettimeofday_ns</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>gettimeofday_us </B>
-
-<DD>
-Number of microseconds since UNIX epoch
-<DT><DD>
-See
-<I><A HREF="./function::gettimeofday_us.3stap.html">function::gettimeofday_us</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>gettimeofday_ms </B>
-
-<DD>
-Number of milliseconds since UNIX epoch
-<DT><DD>
-See
-<I><A HREF="./function::gettimeofday_ms.3stap.html">function::gettimeofday_ms</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>gettimeofday_s </B>
-
-<DD>
-Number of seconds since UNIX epoch
-<DT><DD>
-See
-<I><A HREF="./function::gettimeofday_s.3stap.html">function::gettimeofday_s</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::gettimeofday_ns.3stap.html">function::gettimeofday_ns</A></I>(3stap),
-
-
-<I><A HREF="./function::gettimeofday_us.3stap.html">function::gettimeofday_us</A></I>(3stap),
-
-
-<I><A HREF="./function::gettimeofday_ms.3stap.html">function::gettimeofday_ms</A></I>(3stap),
-
-
-<I><A HREF="./function::gettimeofday_s.3stap.html">function::gettimeofday_s</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::timestamp_monotonic</TITLE>
-</HEAD><BODY>
-<H1>tapset::timestamp_monotonic</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::timestamp_monotonic - systemtap timestamp_monotonic tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>cpu_clock_ns </B>
-
-<DD>
-Number of nanoseconds on the given cpu's clock
-<DT><DD>
-See
-<I><A HREF="./function::cpu_clock_ns.3stap.html">function::cpu_clock_ns</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>cpu_clock_us </B>
-
-<DD>
-Number of microseconds on the given cpu's clock
-<DT><DD>
-See
-<I><A HREF="./function::cpu_clock_us.3stap.html">function::cpu_clock_us</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>cpu_clock_ms </B>
-
-<DD>
-Number of milliseconds on the given cpu's clock
-<DT><DD>
-See
-<I><A HREF="./function::cpu_clock_ms.3stap.html">function::cpu_clock_ms</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>cpu_clock_s </B>
-
-<DD>
-Number of seconds on the given cpu's clock
-<DT><DD>
-See
-<I><A HREF="./function::cpu_clock_s.3stap.html">function::cpu_clock_s</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>local_clock_ns </B>
-
-<DD>
-Number of nanoseconds on the local cpu's clock
-<DT><DD>
-See
-<I><A HREF="./function::local_clock_ns.3stap.html">function::local_clock_ns</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>local_clock_us </B>
-
-<DD>
-Number of microseconds on the local cpu's clock
-<DT><DD>
-See
-<I><A HREF="./function::local_clock_us.3stap.html">function::local_clock_us</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>local_clock_ms </B>
-
-<DD>
-Number of milliseconds on the local cpu's clock
-<DT><DD>
-See
-<I><A HREF="./function::local_clock_ms.3stap.html">function::local_clock_ms</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>local_clock_s </B>
-
-<DD>
-Number of seconds on the local cpu's clock
-<DT><DD>
-See
-<I><A HREF="./function::local_clock_s.3stap.html">function::local_clock_s</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::cpu_clock_ns.3stap.html">function::cpu_clock_ns</A></I>(3stap),
-
-
-<I><A HREF="./function::cpu_clock_us.3stap.html">function::cpu_clock_us</A></I>(3stap),
-
-
-<I><A HREF="./function::cpu_clock_ms.3stap.html">function::cpu_clock_ms</A></I>(3stap),
-
-
-<I><A HREF="./function::cpu_clock_s.3stap.html">function::cpu_clock_s</A></I>(3stap),
-
-
-<I><A HREF="./function::local_clock_ns.3stap.html">function::local_clock_ns</A></I>(3stap),
-
-
-<I><A HREF="./function::local_clock_us.3stap.html">function::local_clock_us</A></I>(3stap),
-
-
-<I><A HREF="./function::local_clock_ms.3stap.html">function::local_clock_ms</A></I>(3stap),
-
-
-<I><A HREF="./function::local_clock_s.3stap.html">function::local_clock_s</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::tokenize</TITLE>
-</HEAD><BODY>
-<H1>tapset::tokenize</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::tokenize - systemtap tokenize tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>tokenize </B>
-
-<DD>
-Return the next non-empty token in a string
-<DT><DD>
-See
-<I><A HREF="./function::tokenize.3stap.html">function::tokenize</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::tokenize.3stap.html">function::tokenize</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::tty</TITLE>
-</HEAD><BODY>
-<H1>tapset::tty</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::tty - systemtap tty tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>tty.open </B>
-
-<DD>
-Called when a tty is opened
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tty.open.3stap.html">probe::tty.open</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tty.release </B>
-
-<DD>
-Called when the tty is closed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tty.release.3stap.html">probe::tty.release</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tty.resize </B>
-
-<DD>
-Called when a terminal resize happens
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tty.resize.3stap.html">probe::tty.resize</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tty.ioctl </B>
-
-<DD>
-called when a ioctl is request to the tty
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tty.ioctl.3stap.html">probe::tty.ioctl</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tty.init </B>
-
-<DD>
-Called when a tty is being initalized
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tty.init.3stap.html">probe::tty.init</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tty.register </B>
-
-<DD>
-Called when a tty device is registred
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tty.register.3stap.html">probe::tty.register</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tty.unregister </B>
-
-<DD>
-Called when a tty device is being unregistered
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tty.unregister.3stap.html">probe::tty.unregister</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tty.poll </B>
-
-<DD>
-Called when a tty device is being polled
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tty.poll.3stap.html">probe::tty.poll</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tty.receive </B>
-
-<DD>
-called when a tty receives a message
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tty.receive.3stap.html">probe::tty.receive</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tty.write </B>
-
-<DD>
-write to the tty line
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tty.write.3stap.html">probe::tty.write</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tty.read </B>
-
-<DD>
-called when a tty line will be read
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::tty.read.3stap.html">probe::tty.read</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./probe::tty.open.3stap.html">probe::tty.open</A></I>(3stap),
-
-
-<I><A HREF="./probe::tty.release.3stap.html">probe::tty.release</A></I>(3stap),
-
-
-<I><A HREF="./probe::tty.resize.3stap.html">probe::tty.resize</A></I>(3stap),
-
-
-<I><A HREF="./probe::tty.ioctl.3stap.html">probe::tty.ioctl</A></I>(3stap),
-
-
-<I><A HREF="./probe::tty.init.3stap.html">probe::tty.init</A></I>(3stap),
-
-
-<I><A HREF="./probe::tty.register.3stap.html">probe::tty.register</A></I>(3stap),
-
-
-<I><A HREF="./probe::tty.unregister.3stap.html">probe::tty.unregister</A></I>(3stap),
-
-
-<I><A HREF="./probe::tty.poll.3stap.html">probe::tty.poll</A></I>(3stap),
-
-
-<I><A HREF="./probe::tty.receive.3stap.html">probe::tty.receive</A></I>(3stap),
-
-
-<I><A HREF="./probe::tty.write.3stap.html">probe::tty.write</A></I>(3stap),
-
-
-<I><A HREF="./probe::tty.read.3stap.html">probe::tty.read</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::tzinfo</TITLE>
-</HEAD><BODY>
-<H1>tapset::tzinfo</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::tzinfo - systemtap tzinfo tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>tz_gmtoff </B>
-
-<DD>
-Return local time zone offset
-<DT><DD>
-See
-<I><A HREF="./function::tz_gmtoff.3stap.html">function::tz_gmtoff</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tz_name </B>
-
-<DD>
-Return local time zone name
-<DT><DD>
-See
-<I><A HREF="./function::tz_name.3stap.html">function::tz_name</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>tz_ctime </B>
-
-<DD>
-Convert seconds since epoch into human readable date/time string, with local time zone
-<DT><DD>
-See
-<I><A HREF="./function::tz_ctime.3stap.html">function::tz_ctime</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::tz_gmtoff.3stap.html">function::tz_gmtoff</A></I>(3stap),
-
-
-<I><A HREF="./function::tz_name.3stap.html">function::tz_name</A></I>(3stap),
-
-
-<I><A HREF="./function::tz_ctime.3stap.html">function::tz_ctime</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::ucontext-symbols</TITLE>
-</HEAD><BODY>
-<H1>tapset::ucontext-symbols</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::ucontext-symbols - systemtap ucontext-symbols tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> User context symbol functions provide additional information about
-<BR> addresses from an application. These functions can provide
-<BR> information about the user space map (library) that the event occurred or
-<BR> the function symbol of an address.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>ustack </B>
-
-<DD>
-Return address at given depth of user stack backtrace
-<DT><DD>
-See
-<I><A HREF="./function::ustack.3stap.html">function::ustack</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>usymname </B>
-
-<DD>
-Return the symbol of an address in the current task.
-<DT><DD>
-See
-<I><A HREF="./function::usymname.3stap.html">function::usymname</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>usymdata </B>
-
-<DD>
-Return the symbol and module offset of an address.
-<DT><DD>
-See
-<I><A HREF="./function::usymdata.3stap.html">function::usymdata</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>print_ustack </B>
-
-<DD>
-Print out stack for the current task from string.
-<DT><DD>
-See
-<I><A HREF="./function::print_ustack.3stap.html">function::print_ustack</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>print_usyms </B>
-
-<DD>
-Print out user stack from string
-<DT><DD>
-See
-<I><A HREF="./function::print_usyms.3stap.html">function::print_usyms</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sprint_ustack </B>
-
-<DD>
-Return stack for the current task from string.
-<DT><DD>
-See
-<I><A HREF="./function::sprint_ustack.3stap.html">function::sprint_ustack</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sprint_usyms </B>
-
-<DD>
-Return stack for user addresses from string
-<DT><DD>
-See
-<I><A HREF="./function::sprint_usyms.3stap.html">function::sprint_usyms</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::ustack.3stap.html">function::ustack</A></I>(3stap),
-
-
-<I><A HREF="./function::usymname.3stap.html">function::usymname</A></I>(3stap),
-
-
-<I><A HREF="./function::usymdata.3stap.html">function::usymdata</A></I>(3stap),
-
-
-<I><A HREF="./function::print_ustack.3stap.html">function::print_ustack</A></I>(3stap),
-
-
-<I><A HREF="./function::print_usyms.3stap.html">function::print_usyms</A></I>(3stap),
-
-
-<I><A HREF="./function::sprint_ustack.3stap.html">function::sprint_ustack</A></I>(3stap),
-
-
-<I><A HREF="./function::sprint_usyms.3stap.html">function::sprint_usyms</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::ucontext-unwind</TITLE>
-</HEAD><BODY>
-<H1>tapset::ucontext-unwind</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::ucontext-unwind - systemtap ucontext-unwind tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>print_ubacktrace </B>
-
-<DD>
-Print stack back trace for current user-space task.
-<DT><DD>
-See
-<I><A HREF="./function::print_ubacktrace.3stap.html">function::print_ubacktrace</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>sprint_ubacktrace </B>
-
-<DD>
-Return stack back trace for current user-space task as string.
-<DT><DD>
-See
-<I><A HREF="./function::sprint_ubacktrace.3stap.html">function::sprint_ubacktrace</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ubacktrace </B>
-
-<DD>
-Hex backtrace of current user-space task stack.
-<DT><DD>
-See
-<I><A HREF="./function::ubacktrace.3stap.html">function::ubacktrace</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::print_ubacktrace.3stap.html">function::print_ubacktrace</A></I>(3stap),
-
-
-<I><A HREF="./function::sprint_ubacktrace.3stap.html">function::sprint_ubacktrace</A></I>(3stap),
-
-
-<I><A HREF="./function::ubacktrace.3stap.html">function::ubacktrace</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::ucontext</TITLE>
-</HEAD><BODY>
-<H1>tapset::ucontext</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::ucontext - systemtap ucontext tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>umodname </B>
-
-<DD>
-Returns the (short) name of the user module.
-<DT><DD>
-See
-<I><A HREF="./function::umodname.3stap.html">function::umodname</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>ucallers </B>
-
-<DD>
-Return first n elements of user stack backtrace
-<DT><DD>
-See
-<I><A HREF="./function::ucallers.3stap.html">function::ucallers</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::umodname.3stap.html">function::umodname</A></I>(3stap),
-
-
-<I><A HREF="./function::ucallers.3stap.html">function::ucallers</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::uconversions</TITLE>
-</HEAD><BODY>
-<H1>tapset::uconversions</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::uconversions - systemtap uconversions tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>user_string </B>
-
-<DD>
-Retrieves string from user space
-<DT><DD>
-See
-<I><A HREF="./function::user_string.3stap.html">function::user_string</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_string2 </B>
-
-<DD>
-Retrieves string from user space with alternative error string
-<DT><DD>
-See
-<I><A HREF="./function::user_string2.3stap.html">function::user_string2</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_string_warn </B>
-
-<DD>
-Retrieves string from user space
-<DT><DD>
-See
-<I><A HREF="./function::user_string_warn.3stap.html">function::user_string_warn</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_string2_warn </B>
-
-<DD>
-Retrieves string from user space with alternative warning string
-<DT><DD>
-See
-<I><A HREF="./function::user_string2_warn.3stap.html">function::user_string2_warn</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_string_quoted </B>
-
-<DD>
-Retrieves and quotes string from user space
-<DT><DD>
-See
-<I><A HREF="./function::user_string_quoted.3stap.html">function::user_string_quoted</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_string_n </B>
-
-<DD>
-Retrieves string of given length from user space
-<DT><DD>
-See
-<I><A HREF="./function::user_string_n.3stap.html">function::user_string_n</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_string_n2 </B>
-
-<DD>
-Retrieves string of given length from user space
-<DT><DD>
-See
-<I><A HREF="./function::user_string_n2.3stap.html">function::user_string_n2</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_string_n_warn </B>
-
-<DD>
-Retrieves string from user space
-<DT><DD>
-See
-<I><A HREF="./function::user_string_n_warn.3stap.html">function::user_string_n_warn</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_string2_n_warn </B>
-
-<DD>
-Retrieves string from user space with alternative warning string
-<DT><DD>
-See
-<I><A HREF="./function::user_string2_n_warn.3stap.html">function::user_string2_n_warn</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_string_n_quoted </B>
-
-<DD>
-Retrieves and quotes string from user space
-<DT><DD>
-See
-<I><A HREF="./function::user_string_n_quoted.3stap.html">function::user_string_n_quoted</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_string_n2_quoted </B>
-
-<DD>
-Retrieves and quotes string from user space
-<DT><DD>
-See
-<I><A HREF="./function::user_string_n2_quoted.3stap.html">function::user_string_n2_quoted</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_string_utf32 </B>
-
-<DD>
-Retrieves UTF-32 string from user memory
-<DT><DD>
-See
-<I><A HREF="./function::user_string_utf32.3stap.html">function::user_string_utf32</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_string2_utf32 </B>
-
-<DD>
-Retrieves UTF-32 string from user memory with alternative error string
-<DT><DD>
-See
-<I><A HREF="./function::user_string2_utf32.3stap.html">function::user_string2_utf32</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_string_utf16 </B>
-
-<DD>
-Retrieves UTF-16 string from user memory
-<DT><DD>
-See
-<I><A HREF="./function::user_string_utf16.3stap.html">function::user_string_utf16</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_string2_utf16 </B>
-
-<DD>
-Retrieves UTF-16 string from user memory with alternative error string
-<DT><DD>
-See
-<I><A HREF="./function::user_string2_utf16.3stap.html">function::user_string2_utf16</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_char </B>
-
-<DD>
-Retrieves a char value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_char.3stap.html">function::user_char</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_char_warn </B>
-
-<DD>
-Retrieves a char value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_char_warn.3stap.html">function::user_char_warn</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_short </B>
-
-<DD>
-Retrieves a short value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_short.3stap.html">function::user_short</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_short_warn </B>
-
-<DD>
-Retrieves a short value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_short_warn.3stap.html">function::user_short_warn</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_ushort </B>
-
-<DD>
-Retrieves an unsigned short value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_ushort.3stap.html">function::user_ushort</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_ushort_warn </B>
-
-<DD>
-Retrieves an unsigned short value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_ushort_warn.3stap.html">function::user_ushort_warn</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_int </B>
-
-<DD>
-Retrieves an int value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_int.3stap.html">function::user_int</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_int_warn </B>
-
-<DD>
-Retrieves an int value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_int_warn.3stap.html">function::user_int_warn</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_long </B>
-
-<DD>
-Retrieves a long value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_long.3stap.html">function::user_long</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_long_warn </B>
-
-<DD>
-Retrieves a long value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_long_warn.3stap.html">function::user_long_warn</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_int8 </B>
-
-<DD>
-Retrieves a 8-bit integer value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_int8.3stap.html">function::user_int8</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_uint8 </B>
-
-<DD>
-Retrieves an unsigned 8-bit integer value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_uint8.3stap.html">function::user_uint8</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_int16 </B>
-
-<DD>
-Retrieves a 16-bit integer value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_int16.3stap.html">function::user_int16</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_uint16 </B>
-
-<DD>
-Retrieves an unsigned 16-bit integer value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_uint16.3stap.html">function::user_uint16</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_int32 </B>
-
-<DD>
-Retrieves a 32-bit integer value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_int32.3stap.html">function::user_int32</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_uint32 </B>
-
-<DD>
-Retrieves an unsigned 32-bit integer value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_uint32.3stap.html">function::user_uint32</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_int64 </B>
-
-<DD>
-Retrieves a 64-bit integer value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_int64.3stap.html">function::user_int64</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>user_uint64 </B>
-
-<DD>
-Retrieves an unsigned 64-bit integer value stored in user space
-<DT><DD>
-See
-<I><A HREF="./function::user_uint64.3stap.html">function::user_uint64</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./function::user_string.3stap.html">function::user_string</A></I>(3stap),
-
-
-<I><A HREF="./function::user_string2.3stap.html">function::user_string2</A></I>(3stap),
-
-
-<I><A HREF="./function::user_string_warn.3stap.html">function::user_string_warn</A></I>(3stap),
-
-
-<I><A HREF="./function::user_string2_warn.3stap.html">function::user_string2_warn</A></I>(3stap),
-
-
-<I><A HREF="./function::user_string_quoted.3stap.html">function::user_string_quoted</A></I>(3stap),
-
-
-<I><A HREF="./function::user_string_n.3stap.html">function::user_string_n</A></I>(3stap),
-
-
-<I><A HREF="./function::user_string_n2.3stap.html">function::user_string_n2</A></I>(3stap),
-
-
-<I><A HREF="./function::user_string_n_warn.3stap.html">function::user_string_n_warn</A></I>(3stap),
-
-
-<I><A HREF="./function::user_string2_n_warn.3stap.html">function::user_string2_n_warn</A></I>(3stap),
-
-
-<I><A HREF="./function::user_string_n_quoted.3stap.html">function::user_string_n_quoted</A></I>(3stap),
-
-
-<I><A HREF="./function::user_string_n2_quoted.3stap.html">function::user_string_n2_quoted</A></I>(3stap),
-
-
-<I><A HREF="./function::user_string_utf32.3stap.html">function::user_string_utf32</A></I>(3stap),
-
-
-<I><A HREF="./function::user_string2_utf32.3stap.html">function::user_string2_utf32</A></I>(3stap),
-
-
-<I><A HREF="./function::user_string_utf16.3stap.html">function::user_string_utf16</A></I>(3stap),
-
-
-<I><A HREF="./function::user_string2_utf16.3stap.html">function::user_string2_utf16</A></I>(3stap),
-
-
-<I><A HREF="./function::user_char.3stap.html">function::user_char</A></I>(3stap),
-
-
-<I><A HREF="./function::user_char_warn.3stap.html">function::user_char_warn</A></I>(3stap),
-
-
-<I><A HREF="./function::user_short.3stap.html">function::user_short</A></I>(3stap),
-
-
-<I><A HREF="./function::user_short_warn.3stap.html">function::user_short_warn</A></I>(3stap),
-
-
-<I><A HREF="./function::user_ushort.3stap.html">function::user_ushort</A></I>(3stap),
-
-
-<I><A HREF="./function::user_ushort_warn.3stap.html">function::user_ushort_warn</A></I>(3stap),
-
-
-<I><A HREF="./function::user_int.3stap.html">function::user_int</A></I>(3stap),
-
-
-<I><A HREF="./function::user_int_warn.3stap.html">function::user_int_warn</A></I>(3stap),
-
-
-<I><A HREF="./function::user_long.3stap.html">function::user_long</A></I>(3stap),
-
-
-<I><A HREF="./function::user_long_warn.3stap.html">function::user_long_warn</A></I>(3stap),
-
-
-<I><A HREF="./function::user_int8.3stap.html">function::user_int8</A></I>(3stap),
-
-
-<I><A HREF="./function::user_uint8.3stap.html">function::user_uint8</A></I>(3stap),
-
-
-<I><A HREF="./function::user_int16.3stap.html">function::user_int16</A></I>(3stap),
-
-
-<I><A HREF="./function::user_uint16.3stap.html">function::user_uint16</A></I>(3stap),
-
-
-<I><A HREF="./function::user_int32.3stap.html">function::user_int32</A></I>(3stap),
-
-
-<I><A HREF="./function::user_uint32.3stap.html">function::user_uint32</A></I>(3stap),
-
-
-<I><A HREF="./function::user_int64.3stap.html">function::user_int64</A></I>(3stap),
-
-
-<I><A HREF="./function::user_uint64.3stap.html">function::user_uint64</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of tapset::udp</TITLE>
-</HEAD><BODY>
-<H1>tapset::udp</H1>
-Section: Misc. Reference Manual Pages (3stap)<BR>Updated: ---<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-tapset::udp - systemtap udp tapset
-<BR>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-<P>
-<BR> This family of probe points is used to probe events that occur in the UDP layer.
-<P>
-<DL COMPACT>
-<DT></DL>
-<P>
-
-<DD>
-<DL COMPACT>
-<DT><B>udp.sendmsg </B>
-
-<DD>
-Fires whenever a process sends a UDP message
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::udp.sendmsg.3stap.html">probe::udp.sendmsg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>udp.sendmsg.return </B>
-
-<DD>
-Fires whenever an attempt to send a UDP message is completed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::udp.sendmsg.return.3stap.html">probe::udp.sendmsg.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>udp.recvmsg </B>
-
-<DD>
-Fires whenever a UDP message is received
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::udp.recvmsg.3stap.html">probe::udp.recvmsg</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>udp.recvmsg.return </B>
-
-<DD>
-Fires whenever an attempt to receive a UDP message received is completed
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::udp.recvmsg.return.3stap.html">probe::udp.recvmsg.return</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>udp.disconnect </B>
-
-<DD>
-Fires when a process requests for a UDP disconnection
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::udp.disconnect.3stap.html">probe::udp.disconnect</A></I>(3stap)
-
-<BR> for details.
-</DL>
-<P>
-
-<DL COMPACT>
-<DT><B>udp.disconnect.return </B>
-
-<DD>
-UDP has been disconnected successfully
-<DT><DD>
-<BR> See
-<I><A HREF="./probe::udp.disconnect.return.3stap.html">probe::udp.disconnect.return</A></I>(3stap)
-
-<BR> for details.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-
-<I><A HREF="./probe::udp.sendmsg.3stap.html">probe::udp.sendmsg</A></I>(3stap),
-
-
-<I><A HREF="./probe::udp.sendmsg.return.3stap.html">probe::udp.sendmsg.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::udp.recvmsg.3stap.html">probe::udp.recvmsg</A></I>(3stap),
-
-
-<I><A HREF="./probe::udp.recvmsg.return.3stap.html">probe::udp.recvmsg.return</A></I>(3stap),
-
-
-<I><A HREF="./probe::udp.disconnect.3stap.html">probe::udp.disconnect</A></I>(3stap),
-
-
-<I><A HREF="./probe::udp.disconnect.return.3stap.html">probe::udp.disconnect.return</A></I>(3stap),
-
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="stapprobes.3stap.html">stapprobes</A></I>(3stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of WARNING::DEBUGINFO</TITLE>
-</HEAD><BODY>
-<H1>WARNING::DEBUGINFO</H1>
-Section: Misc. Reference Manual Pages (7stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-warning::debuginfo - systemtap missing-debuginfo warnings
-<P>
-
-
-
-<P>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-For many symbolic probing operations, systemtap needs DWARF debuginfo for
-the relevant binaries. This often includes resolving function/statement
-probes, or $context variables in related handlers. DWARF debuginfo may
-be found in the original binaries built during compilation, or may have
-been split into separate files. The
-<I>SYSTEMTAP_DEBUGINFO_PATH</I>
-
-environment variable affects where systemtap looks for these files.
-<P>
-
-If your operating system came from a distributor, check with them if
-debuginfo packages or variants are available. If your distributor does
-not have debuginfo-equipped binaries at all, you may need to rebuild it.
-<P>
-
-Systemtap uses the
-<I>elfutils</I>
-
-library to process ELF/DWARF files. The version of elfutils used by systemtap
-is the number after the slash in the
-<I>-V</I>
-
-output:
-
-<P>
-
-<BR>
-
-<DL COMPACT><DT><DD>
-<PRE>
-% stap -V
-Systemtap translator/driver (version 2.3/0.156, rpm 2.3-1.fc19)
-Copyright (C) 2005-2013 Red Hat, Inc. and others
-[...]
-
-</PRE>
-
-</DL>
-
-
-<P>
-
-This indicates systemtap version 2.3 with elfutils version 0.156.
-<P>
-<DL COMPACT>
-<DT>kernel debuginfo<DD>
-For scripts that target the kernel, systemtap may search for the
-<I>vmlinux</I>
-
-file created during its original build. This is distinct from the
-boot-loader's compressed/stripped
-<I>vmlinuz</I>
-
-file, and much larger. If you have a hand-built kernel, make sure
-it was built with the
-<I>CONFIG_DEBUG_INFO=y</I>
-
-option.
-<P>
-<DT>process debuginfo<DD>
-For scripts that target user-space, systemtap may search for debuginfo.
-If you have hand-built binaries, use
-<I>CFLAGS=-g -O2</I>
-
-to compile them.
-<P>
-<DT>minidebuginfo<DD>
-On some systems, binaries may be compiled with a subset of debuginfo
-useful for function tracing and backtraces. This 'Minidebuginfo' is
-a xz compressed section labeled .gnu_debugdata. Support for
-minidebuginfo relies on elfutils version 0.156 or later.
-<P>
-<DT>compressed debuginfo<DD>
-On some systems, debuginfo may be available, but compressed into
-<I>.zdebug_*</I>
-
-sections. Support for compressed debuginfo relies on elfutils
-version 0.153 or later.
-<P>
-<DT>unnecessary debuginfo<DD>
-In some cases, a script may be altered to avoid requiring debuginfo.
-For example, as script that uses
-<I>probe syscall.*</I>
-
-probes could try instead
-<I>probe nd_syscall.*</I>
-
-(for non-DWARF syscall): these work similarly, and use more intricate
-(fragile) tapset functions to extract system call arguments. Another
-option is use of compiled-in instrumentation such as kernel tracepoints
-or user-space
-<I><<A HREF="file:///usr/include/sys/sdt.h">sys/sdt.h</A>></I>
-
-markers in libraries or executables, which do not require debuginfo.
-If debuginfo was required for resolving a complicated
-<I>$var->foo->bar</I>
-
-expression, it may be possible to use
-<I>@cast(var,foo,foo.h)->foo->bar</I>
-
-to synthesize debuginfo for that type from a header file.
-<P>
-</DL>
-<A NAME="lbAD"> </A>
-<H2>AUTOMATION</H2>
-
-<P>
-On some platforms, systemtap may advise what commands to run, in order
-to download needed debuginfo. Another possibility is to invoke systemtap
-with the
-<I>--download-debuginfo</I>
-
-flag.
-The
-<I>stap-prep</I>
-
-script included with systemtap may be able to download the
-appropriate kernel debuginfo. Another possibility is to install and
-use a
-<I>stap-server</I>
-
-remote-compilation instance on a machine on your network, where
-debuginfo and compilation resources can be centralized. Try the
-<I>stap --use-server</I>
-
-option, in case such a server is already running.
-<P>
-<A NAME="lbAE"> </A>
-<H2>SEE ALSO</H2>
-
-
-<PRE>
-<I><A HREF="stap.1.html">stap</A></I>(1),
-<I><A HREF="stappaths.7.html">stappaths</A></I>(7),
-<I><A HREF="stap-server.8.html">stap-server</A></I>(8),
-<I><A HREF="strip.1.html">strip</A></I>(1),
-<I><A HREF="./error::dwarf.7stap.html">error::dwarf</A></I>(7stap),
-<I><A HREF="./error::reporting.7stap.html">error::reporting</A></I>(7stap),
-<I><A HREF="./error::contextvars.7stap.html">error::contextvars</A></I>(7stap),
-<I><A HREF="http://fedorahosted.org/elfutils">http://fedorahosted.org/elfutils</A></I>,
-<I><A HREF="http://fedoraproject.org/wiki/Features/MiniDebugInfo">http://fedoraproject.org/wiki/Features/MiniDebugInfo</A></I>
-
-</PRE>
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">AUTOMATION</A><DD>
-<DT><A HREF="#lbAE">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-
-<HTML><HEAD><TITLE>Manpage of WARNING::PROCESS-TRACKING</TITLE>
-</HEAD><BODY>
-<H1>WARNING::PROCESS-TRACKING</H1>
-Section: Misc. Reference Manual Pages (7stap)<BR><A HREF="#index">Index</A>
-<A HREF="index.html">Return to Main Contents</A><HR>
-
-<A NAME="lbAB"> </A>
-<H2>NAME</H2>
-
-warning::process-tracking - process-tracking facilities are not available
-<P>
-<A NAME="lbAC"> </A>
-<H2>DESCRIPTION</H2>
-
-This warning,
-
-WARNING: process-tracking facilities are not available in this kernel
-
-and the related message,
-
-WARNING: cannot track target in process '...'
-
-both occur at runtime when running on a kernel (generally an older
-version) that has neither utrace functionality nor an acceptable
-substitute.
-<P>
-
-The script should still load and run. However, probes that rely on
-availability of process-tracking facilities will silently fail to
-trigger.
-<P>
-
-If process-tracking functionality is absolutely necessary, either a
-kernel version newer than 3.5 is needed, or an older version must be
-compiled with appropriate utrace patches.
-<P>
-<A NAME="lbAD"> </A>
-<H2>SEE ALSO</H2>
-
-<I><A HREF="stap.1.html">stap</A></I>(1),
-
-<I><A HREF="./error::reporting.7stap.html">error::reporting</A></I>(7stap)
-
-<P>
-
-<HR>
-<A NAME="index"> </A><H2>Index</H2>
-<DL>
-<DT><A HREF="#lbAB">NAME</A><DD>
-<DT><A HREF="#lbAC">DESCRIPTION</A><DD>
-<DT><A HREF="#lbAD">SEE ALSO</A><DD>
-</DL>
-<HR>
-This document was created by
-<A HREFhttp://www.kapiti.co.nz/michael/vhman2html.html">man2html</A>,
-using the manual pages.<BR>
-Time: 10:39:30 GMT, March 18, 2014
-</BODY>
-</HTML>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::HZ</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="next" href="API-cpu-clock-ms.html" title="function::cpu_clock_ms"></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::HZ</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="timestamp_stp.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-cpu-clock-ms.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::HZ"><a name="API-HZ"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::HZ —
- Kernel HZ
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- HZ:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5744544"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5745696"></a><h2>Description</h2><p>
- This function returns the value of the kernel HZ macro,
- which corresponds to the rate of increase of the jiffies value.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="timestamp_stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-cpu-clock-ms.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 3. Timestamp Functions </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::cpu_clock_ms</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::MAJOR</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="dev.stp.html" title="Chapter 19. Device Tapset"><link rel="prev" href="dev.stp.html" title="Chapter 19. Device Tapset"><link rel="next" href="API-MINOR.html" title="function::MINOR"></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::MAJOR</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="dev.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 19. Device Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-MINOR.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::MAJOR"><a name="API-MAJOR"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::MAJOR —
- Extract major device number from a kernel device number (kdev_t)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- MAJOR:long(dev:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp10978096"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- Kernel device number to query.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="dev.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="dev.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-MINOR.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 19. Device Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::MINOR</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::MINOR</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="dev.stp.html" title="Chapter 19. Device Tapset"><link rel="prev" href="API-MAJOR.html" title="function::MAJOR"><link rel="next" href="API-MKDEV.html" title="function::MKDEV"></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::MINOR</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-MAJOR.html">Prev</a> </td><th width="60%" align="center">Chapter 19. Device Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-MKDEV.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::MINOR"><a name="API-MINOR"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::MINOR —
- Extract minor device number from a kernel device number (kdev_t)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- MINOR:long(dev:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp10988000"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- Kernel device number to query.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-MAJOR.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="dev.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-MKDEV.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::MAJOR</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::MKDEV</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::MKDEV</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="dev.stp.html" title="Chapter 19. Device Tapset"><link rel="prev" href="API-MINOR.html" title="function::MINOR"><link rel="next" href="API-usrdev2kerndev.html" title="function::usrdev2kerndev"></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::MKDEV</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-MINOR.html">Prev</a> </td><th width="60%" align="center">Chapter 19. Device Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-usrdev2kerndev.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::MKDEV"><a name="API-MKDEV"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::MKDEV —
- Creates a value that can be compared to a kernel device number (kdev_t)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- MKDEV:long(major:long,minor:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp10997968"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>major</code></em></span></dt><dd><p>
- Intended major device number.
- </p></dd><dt><span class="term"><em class="parameter"><code>minor</code></em></span></dt><dd><p>
- Intended minor device number.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-MINOR.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="dev.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-usrdev2kerndev.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::MINOR</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::usrdev2kerndev</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::addr_to_node</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="next" href="API-bytes-to-string.html" title="function::bytes_to_string"></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::addr_to_node</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="memory_stp.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-bytes-to-string.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::addr_to_node"><a name="API-addr-to-node"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::addr_to_node —
- Returns which node a given address belongs to within a NUMA system
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- addr_to_node:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6022592"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the address of the faulting memory access
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp6025648"></a><h2>Description</h2><p>
- This function accepts an address, and returns the
- node that the given address belongs to in a NUMA system.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="memory_stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-bytes-to-string.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 6. Memory Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::bytes_to_string</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::addr</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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="context_stp.html" title="Chapter 2. Context Functions"><link rel="next" href="API-asmlinkage.html" title="function::asmlinkage"></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::addr</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="context_stp.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-asmlinkage.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::addr"><a name="API-addr"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::addr —
- Address of the current probe point.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- addr:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp3746640"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp3747856"></a><h2>Description</h2><p>
- Returns the instruction pointer from the current probe's
- register state. Not all probe types have registers though, in which case
- zero is returned. The returned address is suitable for use with functions
- like <code class="function">symname</code> and <code class="function">symdata</code>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="context_stp.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-asmlinkage.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 2. Context Functions </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::asmlinkage</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ansi_clear_screen</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ansi.stp.html" title="Chapter 28. Utility functions for using ansi control chars in logs"><link rel="prev" href="ansi.stp.html" title="Chapter 28. Utility functions for using ansi control chars in logs"><link rel="next" href="API-ansi-cursor-hide.html" title="function::ansi_cursor_hide"></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::ansi_clear_screen</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ansi.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 28. Utility functions for using ansi control chars in logs</th><td width="20%" align="right"> <a accesskey="n" href="API-ansi-cursor-hide.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ansi_clear_screen"><a name="API-ansi-clear-screen"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ansi_clear_screen —
- Move cursor to top left and clear screen.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ansi_clear_screen()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12121632"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp12122848"></a><h2>Description</h2><p>
- Sends ansi code for moving cursor to top left and then the
- ansi code for clearing the screen from the cursor position to the end.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ansi.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ansi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ansi-cursor-hide.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 28. Utility functions for using ansi control chars in logs </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::ansi_cursor_hide</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ansi_cursor_hide</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ansi.stp.html" title="Chapter 28. Utility functions for using ansi control chars in logs"><link rel="prev" href="API-ansi-clear-screen.html" title="function::ansi_clear_screen"><link rel="next" href="API-ansi-cursor-move.html" title="function::ansi_cursor_move"></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::ansi_cursor_hide</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ansi-clear-screen.html">Prev</a> </td><th width="60%" align="center">Chapter 28. Utility functions for using ansi control chars in logs</th><td width="20%" align="right"> <a accesskey="n" href="API-ansi-cursor-move.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ansi_cursor_hide"><a name="API-ansi-cursor-hide"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ansi_cursor_hide —
- Hides the cursor.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ansi_cursor_hide()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12130960"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp12132176"></a><h2>Description</h2><p>
- Sends ansi code for hiding the cursor.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ansi-clear-screen.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ansi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ansi-cursor-move.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ansi_clear_screen</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::ansi_cursor_move</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ansi_cursor_move</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ansi.stp.html" title="Chapter 28. Utility functions for using ansi control chars in logs"><link rel="prev" href="API-ansi-cursor-hide.html" title="function::ansi_cursor_hide"><link rel="next" href="API-ansi-cursor-restore.html" title="function::ansi_cursor_restore"></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::ansi_cursor_move</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ansi-cursor-hide.html">Prev</a> </td><th width="60%" align="center">Chapter 28. Utility functions for using ansi control chars in logs</th><td width="20%" align="right"> <a accesskey="n" href="API-ansi-cursor-restore.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ansi_cursor_move"><a name="API-ansi-cursor-move"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ansi_cursor_move —
- Move cursor to new coordinates.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ansi_cursor_move(x:long,y:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12140192"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>x</code></em></span></dt><dd><p>
- Row to move the cursor to.
- </p></dd><dt><span class="term"><em class="parameter"><code>y</code></em></span></dt><dd><p>
- Colomn to move the cursor to.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12145408"></a><h2>Description</h2><p>
- Sends ansi code for positioning the cursor at row x
- and column y. Coordinates start at one, (1,1) is the top-left corner.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ansi-cursor-hide.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ansi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ansi-cursor-restore.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ansi_cursor_hide</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::ansi_cursor_restore</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ansi_cursor_restore</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ansi.stp.html" title="Chapter 28. Utility functions for using ansi control chars in logs"><link rel="prev" href="API-ansi-cursor-move.html" title="function::ansi_cursor_move"><link rel="next" href="API-ansi-cursor-save.html" title="function::ansi_cursor_save"></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::ansi_cursor_restore</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ansi-cursor-move.html">Prev</a> </td><th width="60%" align="center">Chapter 28. Utility functions for using ansi control chars in logs</th><td width="20%" align="right"> <a accesskey="n" href="API-ansi-cursor-save.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ansi_cursor_restore"><a name="API-ansi-cursor-restore"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ansi_cursor_restore —
- Restores a previously saved cursor position.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ansi_cursor_restore()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12153472"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp12154688"></a><h2>Description</h2><p>
- Sends ansi code for restoring the current cursor position
- previously saved with <code class="function">ansi_cursor_save</code>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ansi-cursor-move.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ansi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ansi-cursor-save.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ansi_cursor_move</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::ansi_cursor_save</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ansi_cursor_save</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ansi.stp.html" title="Chapter 28. Utility functions for using ansi control chars in logs"><link rel="prev" href="API-ansi-cursor-restore.html" title="function::ansi_cursor_restore"><link rel="next" href="API-ansi-cursor-show.html" title="function::ansi_cursor_show"></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::ansi_cursor_save</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ansi-cursor-restore.html">Prev</a> </td><th width="60%" align="center">Chapter 28. Utility functions for using ansi control chars in logs</th><td width="20%" align="right"> <a accesskey="n" href="API-ansi-cursor-show.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ansi_cursor_save"><a name="API-ansi-cursor-save"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ansi_cursor_save —
- Saves the cursor position.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ansi_cursor_save()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12163424"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp12164640"></a><h2>Description</h2><p>
- Sends ansi code for saving the current cursor position.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ansi-cursor-restore.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ansi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ansi-cursor-show.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ansi_cursor_restore</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::ansi_cursor_show</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ansi_cursor_show</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ansi.stp.html" title="Chapter 28. Utility functions for using ansi control chars in logs"><link rel="prev" href="API-ansi-cursor-save.html" title="function::ansi_cursor_save"><link rel="next" href="API-ansi-new-line.html" title="function::ansi_new_line"></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::ansi_cursor_show</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ansi-cursor-save.html">Prev</a> </td><th width="60%" align="center">Chapter 28. Utility functions for using ansi control chars in logs</th><td width="20%" align="right"> <a accesskey="n" href="API-ansi-new-line.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ansi_cursor_show"><a name="API-ansi-cursor-show"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ansi_cursor_show —
- Shows the cursor.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ansi_cursor_show()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12172608"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp12173824"></a><h2>Description</h2><p>
- Sends ansi code for showing the cursor.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ansi-cursor-save.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ansi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ansi-new-line.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ansi_cursor_save</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::ansi_new_line</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ansi_new_line</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ansi.stp.html" title="Chapter 28. Utility functions for using ansi control chars in logs"><link rel="prev" href="API-ansi-cursor-show.html" title="function::ansi_cursor_show"><link rel="next" href="API-ansi-reset-color.html" title="function::ansi_reset_color"></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::ansi_new_line</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ansi-cursor-show.html">Prev</a> </td><th width="60%" align="center">Chapter 28. Utility functions for using ansi control chars in logs</th><td width="20%" align="right"> <a accesskey="n" href="API-ansi-reset-color.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ansi_new_line"><a name="API-ansi-new-line"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ansi_new_line —
- Move cursor to new line.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ansi_new_line()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12181792"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp12183008"></a><h2>Description</h2><p>
- Sends ansi code new line.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ansi-cursor-show.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ansi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ansi-reset-color.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ansi_cursor_show</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::ansi_reset_color</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ansi_reset_color</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ansi.stp.html" title="Chapter 28. Utility functions for using ansi control chars in logs"><link rel="prev" href="API-ansi-new-line.html" title="function::ansi_new_line"><link rel="next" href="API-ansi-set-color.html" title="function::ansi_set_color"></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::ansi_reset_color</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ansi-new-line.html">Prev</a> </td><th width="60%" align="center">Chapter 28. Utility functions for using ansi control chars in logs</th><td width="20%" align="right"> <a accesskey="n" href="API-ansi-set-color.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ansi_reset_color"><a name="API-ansi-reset-color"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ansi_reset_color —
- Resets Select Graphic Rendition mode.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ansi_reset_color()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12191024"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp12192240"></a><h2>Description</h2><p>
- Sends ansi code to reset foreground, background and color
- attribute to default values.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ansi-new-line.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ansi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ansi-set-color.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ansi_new_line</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::ansi_set_color</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ansi_set_color</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ansi.stp.html" title="Chapter 28. Utility functions for using ansi control chars in logs"><link rel="prev" href="API-ansi-reset-color.html" title="function::ansi_reset_color"><link rel="next" href="API-ansi-set-color2.html" title="function::ansi_set_color2"></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::ansi_set_color</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ansi-reset-color.html">Prev</a> </td><th width="60%" align="center">Chapter 28. Utility functions for using ansi control chars in logs</th><td width="20%" align="right"> <a accesskey="n" href="API-ansi-set-color2.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ansi_set_color"><a name="API-ansi-set-color"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ansi_set_color —
- Set the ansi Select Graphic Rendition mode.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ansi_set_color(fg:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12200272"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>fg</code></em></span></dt><dd><p>
- Foreground color to set.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12203488"></a><h2>Description</h2><p>
- Sends ansi code for Select Graphic Rendition mode for the
- given forground color. Black (30), Blue (34), Green (32), Cyan (36),
- Red (31), Purple (35), Brown (33), Light Gray (37).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ansi-reset-color.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ansi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ansi-set-color2.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ansi_reset_color</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::ansi_set_color2</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ansi_set_color2</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ansi.stp.html" title="Chapter 28. Utility functions for using ansi control chars in logs"><link rel="prev" href="API-ansi-set-color.html" title="function::ansi_set_color"><link rel="next" href="API-ansi-set-color3.html" title="function::ansi_set_color3"></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::ansi_set_color2</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ansi-set-color.html">Prev</a> </td><th width="60%" align="center">Chapter 28. Utility functions for using ansi control chars in logs</th><td width="20%" align="right"> <a accesskey="n" href="API-ansi-set-color3.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ansi_set_color2"><a name="API-ansi-set-color2"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ansi_set_color2 —
- Set the ansi Select Graphic Rendition mode.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ansi_set_color2(fg:long,bg:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12211552"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>fg</code></em></span></dt><dd><p>
- Foreground color to set.
- </p></dd><dt><span class="term"><em class="parameter"><code>bg</code></em></span></dt><dd><p>
- Background color to set.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12216752"></a><h2>Description</h2><p>
- Sends ansi code for Select Graphic Rendition mode for the
- given forground color, Black (30), Blue (34), Green (32), Cyan (36),
- Red (31), Purple (35), Brown (33), Light Gray (37) and the given
- background color, Black (40), Red (41), Green (42), Yellow (43),
- Blue (44), Magenta (45), Cyan (46), White (47).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ansi-set-color.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ansi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ansi-set-color3.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ansi_set_color</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::ansi_set_color3</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ansi_set_color3</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ansi.stp.html" title="Chapter 28. Utility functions for using ansi control chars in logs"><link rel="prev" href="API-ansi-set-color2.html" title="function::ansi_set_color2"><link rel="next" href="API-indent.html" title="function::indent"></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::ansi_set_color3</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ansi-set-color2.html">Prev</a> </td><th width="60%" align="center">Chapter 28. Utility functions for using ansi control chars in logs</th><td width="20%" align="right"> <a accesskey="n" href="API-indent.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ansi_set_color3"><a name="API-ansi-set-color3"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ansi_set_color3 —
- Set the ansi Select Graphic Rendition mode.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ansi_set_color3(fg:long,bg:long,attr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12225072"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>fg</code></em></span></dt><dd><p>
- Foreground color to set.
- </p></dd><dt><span class="term"><em class="parameter"><code>bg</code></em></span></dt><dd><p>
- Background color to set.
- </p></dd><dt><span class="term"><em class="parameter"><code>attr</code></em></span></dt><dd><p>
- Color attribute to set.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12232240"></a><h2>Description</h2><p>
- Sends ansi code for Select Graphic Rendition mode for the
- given forground color, Black (30), Blue (34), Green (32), Cyan (36),
- Red (31), Purple (35), Brown (33), Light Gray (37), the given
- background color, Black (40), Red (41), Green (42), Yellow (43),
- Blue (44), Magenta (45), Cyan (46), White (47) and the color attribute
- All attributes off (0), Intensity Bold (1), Underline Single (4),
- Blink Slow (5), Blink Rapid (6), Image Negative (7).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ansi-set-color2.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ansi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-indent.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ansi_set_color2</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::indent</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::asmlinkage</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-addr.html" title="function::addr"><link rel="next" href="API-backtrace.html" title="function::backtrace"></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::asmlinkage</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-addr.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-backtrace.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::asmlinkage"><a name="API-asmlinkage"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::asmlinkage —
- Mark function as declared asmlinkage
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- asmlinkage()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp84640"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp85856"></a><h2>Description</h2><p>
- Call this function before accessing arguments
- using the *_arg functions
- if the probed kernel function was declared asmlinkage in the source.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-addr.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-backtrace.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::addr</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::backtrace</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::atomic_long_read</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="next" href="API-atomic-read.html" title="function::atomic_read"></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::atomic_long_read</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="conversions.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-atomic-read.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::atomic_long_read"><a name="API-atomic-long-read"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::atomic_long_read —
- Retrieves an atomic long variable from kernel memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- atomic_long_read:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11318256"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- pointer to atomic long variable
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11321472"></a><h2>Description</h2><p>
- Safely perform the read of an atomic long variable. This will be a
- NOP on kernels that do not have ATOMIC_LONG_INIT set on the kernel config.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="conversions.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-atomic-read.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 24. String and data retrieving functions Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::atomic_read</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::atomic_read</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-atomic-long-read.html" title="function::atomic_long_read"><link rel="next" href="API-kernel-char.html" title="function::kernel_char"></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::atomic_read</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-atomic-long-read.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kernel-char.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::atomic_read"><a name="API-atomic-read"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::atomic_read —
- Retrieves an atomic variable from kernel memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- atomic_read:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11329568"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- pointer to atomic variable
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11332768"></a><h2>Description</h2><p>
- Safely perform the read of an atomic variable.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-atomic-long-read.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kernel-char.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::atomic_long_read</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::kernel_char</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::backtrace</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-asmlinkage.html" title="function::asmlinkage"><link rel="next" href="API-caller.html" title="function::caller"></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::backtrace</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-asmlinkage.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-caller.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::backtrace"><a name="API-backtrace"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::backtrace —
- Hex backtrace of current kernel stack
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- backtrace:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp93760"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp94976"></a><h2>Description</h2><p>
- This function returns a string of hex addresses
- that are a backtrace of the kernel stack. Output may be truncated
- as per maximum string length (MAXSTRINGLEN). See
- <code class="function">ubacktrace</code> for user-space backtrace.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-asmlinkage.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-caller.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::asmlinkage</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::caller</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::bytes_to_string</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-addr-to-node.html" title="function::addr_to_node"><link rel="next" href="API-mem-page-size.html" title="function::mem_page_size"></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::bytes_to_string</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-addr-to-node.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-mem-page-size.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::bytes_to_string"><a name="API-bytes-to-string"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::bytes_to_string —
- Human readable string for given bytes
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- bytes_to_string:string(bytes:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6033024"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>bytes</code></em></span></dt><dd><p>
- Number of bytes to translate.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp6036080"></a><h2>Description</h2><p>
- Returns a string representing the number of bytes (up
- to 1024 bytes), the number of kilobytes (when less than 1024K)
- postfixed by 'K', the number of megabytes (when less than 1024M)
- postfixed by 'M' or the number of gigabytes postfixed by 'G'. If
- representing K, M or G, and the number is amount is less than 100,
- it includes a '.' plus the remainer. The returned string will be 5
- characters wide (padding with whitespace at the front) unless
- negative or representing more than 9999G bytes.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-addr-to-node.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-mem-page-size.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::addr_to_node</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::mem_page_size</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::caller_addr</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-caller.html" title="function::caller"><link rel="next" href="API-callers.html" title="function::callers"></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::caller_addr</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-caller.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-callers.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::caller_addr"><a name="API-caller-addr"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::caller_addr —
- Return caller address
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- caller_addr:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp115312"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp116528"></a><h2>Description</h2><p>
- This function returns the address of the calling function.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-caller.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-callers.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::caller</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::callers</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::caller</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-backtrace.html" title="function::backtrace"><link rel="next" href="API-caller-addr.html" title="function::caller_addr"></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::caller</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-backtrace.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-caller-addr.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::caller"><a name="API-caller"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::caller —
- Return name and address of calling function
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- caller:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp103632"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp104848"></a><h2>Description</h2><p>
- This function returns the address and name of the
- calling function. This is equivalent to calling:
- sprintf(<span class="quote">“<span class="quote"><code class="constant">s</code> 0x<code class="constant">x</code></span>”</span>, symname(<code class="function">caller_addr</code>), <code class="function">caller_addr</code>)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-backtrace.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-caller-addr.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::backtrace</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::caller_addr</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::callers</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-caller-addr.html" title="function::caller_addr"><link rel="next" href="API-cmdline-arg.html" title="function::cmdline_arg"></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::callers</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-caller-addr.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-cmdline-arg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::callers"><a name="API-callers"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::callers —
- Return first n elements of kernel stack backtrace
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- callers:string(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4765056"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- number of levels to descend in the stack (not counting the top
- level). If n is -1, print the entire stack.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp4768256"></a><h2>Description</h2><p>
- This function returns a string of the first n hex
- addresses from the backtrace of the kernel stack. Output may be
- truncated as per maximum string length (MAXSTRINGLEN).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-caller-addr.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-cmdline-arg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::caller_addr</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::cmdline_arg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::cmdline_arg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-callers.html" title="function::callers"><link rel="next" href="API-cmdline-args.html" title="function::cmdline_args"></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::cmdline_arg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-callers.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-cmdline-args.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::cmdline_arg"><a name="API-cmdline-arg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::cmdline_arg —
- Fetch a command line argument
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- cmdline_arg:string(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4775696"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- Argument to get (zero is the command itself)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp4778752"></a><h2>Description</h2><p>
- Returns argument the requested argument from the
- current process or the empty string when there are not that many
- arguments or there is a problem retrieving the argument. Argument
- zero is traditionally the command itself.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-callers.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-cmdline-args.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::callers</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::cmdline_args</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::cmdline_args</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-cmdline-arg.html" title="function::cmdline_arg"><link rel="next" href="API-cmdline-str.html" title="function::cmdline_str"></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::cmdline_args</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-cmdline-arg.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-cmdline-str.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::cmdline_args"><a name="API-cmdline-args"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::cmdline_args —
- Fetch command line arguments from current process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- cmdline_args:string(n:long,m:long,delim:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4786256"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- First argument to get (zero is the command itself)
- </p></dd><dt><span class="term"><em class="parameter"><code>m</code></em></span></dt><dd><p>
- Last argument to get (or minus one for all arguments after n)
- </p></dd><dt><span class="term"><em class="parameter"><code>delim</code></em></span></dt><dd><p>
- String to use to delimit arguments when more than one.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp4793120"></a><h2>Description</h2><p>
- Returns arguments from the current process starting
- with argument number n, up to argument m. If there are less than n
- arguments, or the arguments cannot be retrieved from the current
- process, the empty string is returned. If m is smaller than n then
- all arguments starting from argument n are returned. Argument zero
- is traditionally the command itself.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-cmdline-arg.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-cmdline-str.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::cmdline_arg</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::cmdline_str</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::cmdline_str</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-cmdline-args.html" title="function::cmdline_args"><link rel="next" href="API-cpu.html" title="function::cpu"></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::cmdline_str</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-cmdline-args.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-cpu.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::cmdline_str"><a name="API-cmdline-str"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::cmdline_str —
- Fetch all command line arguments from current process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- cmdline_str:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4800752"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp4801904"></a><h2>Description</h2><p>
- Returns all arguments from the current process
- delimited by spaces. Returns the empty string when the arguments
- cannot be retrieved.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-cmdline-args.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-cpu.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::cmdline_args</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::cpu</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::commit</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="speculation.stp.html" title="Chapter 31. Speculation"><link rel="prev" href="speculation.stp.html" title="Chapter 31. Speculation"><link rel="next" href="API-discard.html" title="function::discard"></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::commit</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="speculation.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 31. Speculation</th><td width="20%" align="right"> <a accesskey="n" href="API-discard.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::commit"><a name="API-commit"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::commit —
- Write out all output related to a speculation buffer
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- commit(id:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp13781728"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>id</code></em></span></dt><dd><p>
- of the buffer to store the information in
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp13784912"></a><h2>Description</h2><p>
- Output all the output for <em class="parameter"><code>id</code></em> in the order that it was entered into
- the speculative buffer by <code class="function">speculative</code>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="speculation.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="speculation.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-discard.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 31. Speculation </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::discard</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::cpu_clock_ms</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-HZ.html" title="function::HZ"><link rel="next" href="API-cpu-clock-ns.html" title="function::cpu_clock_ns"></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::cpu_clock_ms</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-HZ.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-cpu-clock-ns.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::cpu_clock_ms"><a name="API-cpu-clock-ms"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::cpu_clock_ms —
- Number of milliseconds on the given cpu's clock
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- cpu_clock_ms:long(cpu:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5753088"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>cpu</code></em></span></dt><dd><p>
- Which processor's clock to read
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5756144"></a><h2>Description</h2><p>
- This function returns the number of milliseconds on the given
- cpu's clock. This is always monotonic comparing on the same cpu, but may
- have some drift between cpus (within about a jiffy).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-HZ.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-cpu-clock-ns.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::HZ</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::cpu_clock_ns</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::cpu_clock_ns</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-cpu-clock-ms.html" title="function::cpu_clock_ms"><link rel="next" href="API-cpu-clock-s.html" title="function::cpu_clock_s"></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::cpu_clock_ns</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-cpu-clock-ms.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-cpu-clock-s.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::cpu_clock_ns"><a name="API-cpu-clock-ns"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::cpu_clock_ns —
- Number of nanoseconds on the given cpu's clock
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- cpu_clock_ns:long(cpu:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5763600"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>cpu</code></em></span></dt><dd><p>
- Which processor's clock to read
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5766656"></a><h2>Description</h2><p>
- This function returns the number of nanoseconds on the given
- cpu's clock. This is always monotonic comparing on the same cpu, but may
- have some drift between cpus (within about a jiffy).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-cpu-clock-ms.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-cpu-clock-s.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::cpu_clock_ms</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::cpu_clock_s</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::cpu_clock_s</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-cpu-clock-ns.html" title="function::cpu_clock_ns"><link rel="next" href="API-cpu-clock-us.html" title="function::cpu_clock_us"></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::cpu_clock_s</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-cpu-clock-ns.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-cpu-clock-us.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::cpu_clock_s"><a name="API-cpu-clock-s"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::cpu_clock_s —
- Number of seconds on the given cpu's clock
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- cpu_clock_s:long(cpu:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5774112"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>cpu</code></em></span></dt><dd><p>
- Which processor's clock to read
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5777168"></a><h2>Description</h2><p>
- This function returns the number of seconds on the given cpu's
- clock. This is always monotonic comparing on the same cpu, but may have
- some drift between cpus (within about a jiffy).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-cpu-clock-ns.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-cpu-clock-us.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::cpu_clock_ns</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::cpu_clock_us</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::cpu_clock_us</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-cpu-clock-s.html" title="function::cpu_clock_s"><link rel="next" href="API-delete-stopwatch.html" title="function::delete_stopwatch"></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::cpu_clock_us</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-cpu-clock-s.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-delete-stopwatch.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::cpu_clock_us"><a name="API-cpu-clock-us"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::cpu_clock_us —
- Number of microseconds on the given cpu's clock
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- cpu_clock_us:long(cpu:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5784624"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>cpu</code></em></span></dt><dd><p>
- Which processor's clock to read
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5787680"></a><h2>Description</h2><p>
- This function returns the number of microseconds on the given
- cpu's clock. This is always monotonic comparing on the same cpu, but may
- have some drift between cpus (within about a jiffy).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-cpu-clock-s.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-delete-stopwatch.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::cpu_clock_s</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::delete_stopwatch</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::cpu</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-cmdline-str.html" title="function::cmdline_str"><link rel="next" href="API-cpuid.html" title="function::cpuid"></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::cpu</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-cmdline-str.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-cpuid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::cpu"><a name="API-cpu"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::cpu —
- Returns the current cpu number
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- cpu:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4809312"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp4810464"></a><h2>Description</h2><p>
- This function returns the current cpu number.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-cmdline-str.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-cpuid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::cmdline_str</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::cpuid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::cpuid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-cpu.html" title="function::cpu"><link rel="next" href="API-egid.html" title="function::egid"></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::cpuid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-cpu.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-egid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::cpuid"><a name="API-cpuid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::cpuid —
- Returns the current cpu number
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- cpuid:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4817712"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp4818864"></a><h2>Description</h2><p>
- This function returns the current cpu number.
- Deprecated in SystemTap 1.4 and removed in SystemTap 1.5.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-cpu.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-egid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::cpu</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::egid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::cputime_to_msecs</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="task_time_stp.html" title="Chapter 7. Task Time Tapset"><link rel="prev" href="task_time_stp.html" title="Chapter 7. Task Time Tapset"><link rel="next" href="API-cputime-to-string.html" title="function::cputime_to_string"></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::cputime_to_msecs</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="task_time_stp.html">Prev</a> </td><th width="60%" align="center">Chapter 7. Task Time Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-cputime-to-string.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::cputime_to_msecs"><a name="API-cputime-to-msecs"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::cputime_to_msecs —
- Translates the given cputime into milliseconds
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- cputime_to_msecs:long(cputime:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6426560"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>cputime</code></em></span></dt><dd><p>
- Time to convert to milliseconds.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="task_time_stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="task_time_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-cputime-to-string.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 7. Task Time Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::cputime_to_string</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::cputime_to_string</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="task_time_stp.html" title="Chapter 7. Task Time Tapset"><link rel="prev" href="API-cputime-to-msecs.html" title="function::cputime_to_msecs"><link rel="next" href="API-msecs-to-string.html" title="function::msecs_to_string"></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::cputime_to_string</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-cputime-to-msecs.html">Prev</a> </td><th width="60%" align="center">Chapter 7. Task Time Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-msecs-to-string.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::cputime_to_string"><a name="API-cputime-to-string"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::cputime_to_string —
- Human readable string for given cputime
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- cputime_to_string:string(cputime:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6436464"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>cputime</code></em></span></dt><dd><p>
- Time to translate.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp6439664"></a><h2>Description</h2><p>
- Equivalent to calling:
- msec_to_string (cputime_to_msecs (cputime).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-cputime-to-msecs.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="task_time_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-msecs-to-string.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::cputime_to_msecs</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::msecs_to_string</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ctime</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ctime.stp.html" title="Chapter 4. Time utility functions"><link rel="prev" href="ctime.stp.html" title="Chapter 4. Time utility functions"><link rel="next" href="API-tz-ctime.html" title="function::tz_ctime"></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::ctime</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ctime.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 4. Time utility functions</th><td width="20%" align="right"> <a accesskey="n" href="API-tz-ctime.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ctime"><a name="API-ctime"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ctime —
- Convert seconds since epoch into human readable date/time string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ctime:string(epochsecs:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5963024"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>epochsecs</code></em></span></dt><dd><p>
- Number of seconds since epoch (as returned by <code class="function">gettimeofday_s</code>)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5966704"></a><h2>Description</h2><p>
- Takes an argument of seconds since the epoch as returned by
- <code class="function">gettimeofday_s</code>. Returns a string of the form
- </p><p>
-
- <span class="quote">“<span class="quote">Wed Jun 30 21:49:08 1993</span>”</span>
- </p><p>
-
- The string will always be exactly 24 characters. If the time would
- be unreasonable far in the past (before what can be represented
- with a 32 bit offset in seconds from the epoch) an error will occur
- (which can be avoided with try/catch). If the time would be
- unreasonable far in the future, an error will also occur.
- </p><p>
-
- Note that the epoch (zero) corresponds to
- </p><p>
-
- <span class="quote">“<span class="quote">Thu Jan 1 00:00:00 1970</span>”</span>
- </p><p>
-
- The earliest full date given by ctime, corresponding to epochsecs
- -2147483648 is <span class="quote">“<span class="quote">Fri Dec 13 20:45:52 1901</span>”</span>. The latest full date
- given by ctime, corresponding to epochsecs 2147483647 is
- <span class="quote">“<span class="quote">Tue Jan 19 03:14:07 2038</span>”</span>.
- </p><p>
-
- The abbreviations for the days of the week are ‘Sun’, ‘Mon’, ‘Tue’,
- ‘Wed’, ‘Thu’, ‘Fri’, and ‘Sat’. The abbreviations for the months
- are ‘Jan’, ‘Feb’, ‘Mar’, ‘Apr’, ‘May’, ‘Jun’, ‘Jul’, ‘Aug’, ‘Sep’,
- ‘Oct’, ‘Nov’, and ‘Dec’.
- </p><p>
-
- Note that the real C library <code class="function">ctime</code> function puts a newline ('\n')
- character at the end of the string that this function does not.
- Also note that since the kernel has no concept of timezones, the
- returned time is always in GMT.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ctime.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ctime.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tz-ctime.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 4. Time utility functions </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::tz_ctime</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::d_name</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="dentry.stp.html" title="Chapter 20. Directory-entry (dentry) Tapset"><link rel="prev" href="dentry.stp.html" title="Chapter 20. Directory-entry (dentry) Tapset"><link rel="next" href="API-d-path.html" title="function::d_path"></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::d_name</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="dentry.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 20. Directory-entry (dentry) Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-d-path.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::d_name"><a name="API-d-name"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::d_name —
- get the dirent name
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- d_name:string(dentry:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11021344"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dentry</code></em></span></dt><dd><p>
- Pointer to dentry.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11024544"></a><h2>Description</h2><p>
- </p><p>
-
- Returns the dirent name (path basename).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="dentry.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="dentry.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-d-path.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 20. Directory-entry (dentry) Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::d_path</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::d_path</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="dentry.stp.html" title="Chapter 20. Directory-entry (dentry) Tapset"><link rel="prev" href="API-d-name.html" title="function::d_name"><link rel="next" href="API-inode-name.html" title="function::inode_name"></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::d_path</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-d-name.html">Prev</a> </td><th width="60%" align="center">Chapter 20. Directory-entry (dentry) Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-inode-name.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::d_path"><a name="API-d-path"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::d_path —
- get the full nameidata path
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- d_path:string(nd:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11032720"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>nd</code></em></span></dt><dd><p>
- Pointer to nameidata.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11035888"></a><h2>Description</h2><p>
- </p><p>
-
- Returns the full dirent name (full path to the root), like
- the kernel d_path function.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-d-name.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="dentry.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-inode-name.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::d_name</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::inode_name</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::delete_stopwatch</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-cpu-clock-us.html" title="function::cpu_clock_us"><link rel="next" href="API-get-cycles.html" title="function::get_cycles"></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::delete_stopwatch</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-cpu-clock-us.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-get-cycles.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::delete_stopwatch"><a name="API-delete-stopwatch"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::delete_stopwatch —
- Remove an existing stopwatch
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- delete_stopwatch(name:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5795136"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- the stopwatch name
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5798192"></a><h2>Description</h2><p>
- Remove stopwatch <em class="parameter"><code>name</code></em>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-cpu-clock-us.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-get-cycles.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::cpu_clock_us</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::get_cycles</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::discard</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="speculation.stp.html" title="Chapter 31. Speculation"><link rel="prev" href="API-commit.html" title="function::commit"><link rel="next" href="API-speculate.html" title="function::speculate"></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::discard</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-commit.html">Prev</a> </td><th width="60%" align="center">Chapter 31. Speculation</th><td width="20%" align="right"> <a accesskey="n" href="API-speculate.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::discard"><a name="API-discard"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::discard —
- Discard all output related to a speculation buffer
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- discard(id:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp13794272"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>id</code></em></span></dt><dd><p>
- of the buffer to store the information in
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-commit.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="speculation.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-speculate.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::commit</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::speculate</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::egid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-cpuid.html" title="function::cpuid"><link rel="next" href="API-env-var.html" title="function::env_var"></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::egid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-cpuid.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-env-var.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::egid"><a name="API-egid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::egid —
- Returns the effective gid of a target process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- egid:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4826240"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp4827392"></a><h2>Description</h2><p>
- This function returns the effective gid of a target process
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-cpuid.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-env-var.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::cpuid</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::env_var</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::env_var</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-egid.html" title="function::egid"><link rel="next" href="API-euid.html" title="function::euid"></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::env_var</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-egid.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-euid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::env_var"><a name="API-env-var"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::env_var —
- Fetch environment variable from current process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- env_var:string(name:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4834640"></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 environment variable to fetch
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp4837696"></a><h2>Description</h2><p>
- Returns the contents of the specified environment value
- for the current process. If the variable isn't set an empty string
- is returned.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-egid.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-euid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::egid</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::euid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::errno_str</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="errno.stp.html" title="Chapter 18. Errno Tapset"><link rel="prev" href="errno.stp.html" title="Chapter 18. Errno Tapset"><link rel="next" href="API-return-str.html" title="function::return_str"></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::errno_str</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="errno.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 18. Errno Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-return-str.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::errno_str"><a name="API-errno-str"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::errno_str —
- Symbolic string associated with error code
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- errno_str:string(err:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp10928176"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>err</code></em></span></dt><dd><p>
- The error number received
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10931344"></a><h2>Description</h2><p>
- This function returns the symbolic string associated
- with the giver error code, such as ENOENT for the number 2, or
- E#3333 for an out-of-range value such as 3333.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="errno.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="errno.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-return-str.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 18. Errno Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::return_str</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::error</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="logging.stp.html" title="Chapter 21. Logging Tapset"><link rel="prev" href="logging.stp.html" title="Chapter 21. Logging Tapset"><link rel="next" href="API-exit.html" title="function::exit"></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::error</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="logging.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 21. Logging Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-exit.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::error"><a name="API-error"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::error —
- Send an error message
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- error(msg:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11095360"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>msg</code></em></span></dt><dd><p>
- The formatted message string
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11098528"></a><h2>Description</h2><p>
- An implicit end-of-line is added. staprun prepends
- the string <span class="quote">“<span class="quote">ERROR:</span>”</span>. Sending an error message aborts the currently
- running probe. Depending on the MAXERRORS parameter, it may
- trigger an <code class="function">exit</code>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="logging.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="logging.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-exit.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 21. Logging Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::exit</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::euid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-env-var.html" title="function::env_var"><link rel="next" href="API-execname.html" title="function::execname"></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::euid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-env-var.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-execname.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::euid"><a name="API-euid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::euid —
- Return the effective uid of a target process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- euid:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4845104"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp4846256"></a><h2>Description</h2><p>
- Returns the effective user ID of the target process.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-env-var.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-execname.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::env_var</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::execname</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::execname</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-euid.html" title="function::euid"><link rel="next" href="API-fastcall.html" title="function::fastcall"></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::execname</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-euid.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-fastcall.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::execname"><a name="API-execname"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::execname —
- Returns the execname of a target process (or group of processes)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- execname:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4853664"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp4854816"></a><h2>Description</h2><p>
- Returns the execname of a target process (or group of processes).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-euid.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-fastcall.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::euid</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::fastcall</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::exit</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="logging.stp.html" title="Chapter 21. Logging Tapset"><link rel="prev" href="API-error.html" title="function::error"><link rel="next" href="API-ftrace.html" title="function::ftrace"></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::exit</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-error.html">Prev</a> </td><th width="60%" align="center">Chapter 21. Logging Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ftrace.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::exit"><a name="API-exit"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::exit —
- Start shutting down probing script.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- exit()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11107776"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp11108992"></a><h2>Description</h2><p>
- This only enqueues a request to start
- shutting down the script. New probes will not fire
- (except <span class="quote">“<span class="quote">end</span>”</span> probes), but all currently
- running ones may complete their work.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-error.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="logging.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ftrace.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::error</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::ftrace</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::fastcall</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-execname.html" title="function::execname"><link rel="next" href="API-gid.html" title="function::gid"></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::fastcall</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-execname.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-gid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::fastcall"><a name="API-fastcall"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::fastcall —
- Mark function as declared fastcall
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- fastcall()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4862144"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp4863296"></a><h2>Description</h2><p>
- Call this function before accessing arguments
- using the *_arg functions
- if the probed kernel function was declared fastcall in the source.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-execname.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-gid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::execname</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::gid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::format_ipaddr</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="next" href="API-htonl.html" title="function::htonl"></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::format_ipaddr</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="networking.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-htonl.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::format_ipaddr"><a name="API-format-ipaddr"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::format_ipaddr —
- Returns a string representation for an IP address
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- format_ipaddr:string(addr:long,family:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp7632304"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- the IP address family (either AF_INET or AF_INET6)
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="networking.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-htonl.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 13. Networking Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::htonl</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ftrace</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="logging.stp.html" title="Chapter 21. Logging Tapset"><link rel="prev" href="API-exit.html" title="function::exit"><link rel="next" href="API-log.html" title="function::log"></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::ftrace</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-exit.html">Prev</a> </td><th width="60%" align="center">Chapter 21. Logging Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-log.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ftrace"><a name="API-ftrace"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ftrace —
- Send a message to the ftrace ring-buffer
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ftrace(msg:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11117488"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>msg</code></em></span></dt><dd><p>
- The formatted message string
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11120656"></a><h2>Description</h2><p>
- If the ftrace ring-buffer is configured & available,
- see /debugfs/tracing/trace for the message. Otherwise, the
- message may be quietly dropped. An implicit end-of-line is added.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-exit.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="logging.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-log.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::exit</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::log</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::get_cycles</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-delete-stopwatch.html" title="function::delete_stopwatch"><link rel="next" href="API-gettimeofday-ms.html" title="function::gettimeofday_ms"></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::get_cycles</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-delete-stopwatch.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-gettimeofday-ms.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::get_cycles"><a name="API-get-cycles"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::get_cycles —
- Processor cycle count
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- get_cycles:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5806064"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5807216"></a><h2>Description</h2><p>
- This function returns the processor cycle counter value
- if available, else it returns zero. The cycle counter is free running
- and unsynchronized on each processor. Thus, the order of events cannot
- determined by comparing the results of the get_cycles function on
- different processors.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-delete-stopwatch.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-gettimeofday-ms.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::delete_stopwatch</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::gettimeofday_ms</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::get_sa_flags</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="next" href="API-get-sa-handler.html" title="function::get_sa_handler"></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::get_sa_flags</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="signal.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-get-sa-handler.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::get_sa_flags"><a name="API-get-sa-flags"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::get_sa_flags —
- Returns the numeric value of sa_flags
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- get_sa_flags:long(act:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp10421504"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>act</code></em></span></dt><dd><p>
- address of the sigaction to query.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="signal.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-get-sa-handler.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 17. Signal Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::get_sa_handler</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::get_sa_handler</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-get-sa-flags.html" title="function::get_sa_flags"><link rel="next" href="API-is-sig-blocked.html" title="function::is_sig_blocked"></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::get_sa_handler</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-get-sa-flags.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-is-sig-blocked.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::get_sa_handler"><a name="API-get-sa-handler"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::get_sa_handler —
- Returns the numeric value of sa_handler
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- get_sa_handler:long(act:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp10431472"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>act</code></em></span></dt><dd><p>
- address of the sigaction to query.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-get-sa-flags.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-is-sig-blocked.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::get_sa_flags</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::is_sig_blocked</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::gettimeofday_ms</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-get-cycles.html" title="function::get_cycles"><link rel="next" href="API-gettimeofday-ns.html" title="function::gettimeofday_ns"></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::gettimeofday_ms</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-get-cycles.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-gettimeofday-ns.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::gettimeofday_ms"><a name="API-gettimeofday-ms"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::gettimeofday_ms —
- Number of milliseconds since UNIX epoch
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- gettimeofday_ms:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5814784"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5815936"></a><h2>Description</h2><p>
- This function returns the number of milliseconds
- since the UNIX epoch.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-get-cycles.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-gettimeofday-ns.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::get_cycles</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::gettimeofday_ns</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::gettimeofday_ns</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-gettimeofday-ms.html" title="function::gettimeofday_ms"><link rel="next" href="API-gettimeofday-s.html" title="function::gettimeofday_s"></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::gettimeofday_ns</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-gettimeofday-ms.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-gettimeofday-s.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::gettimeofday_ns"><a name="API-gettimeofday-ns"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::gettimeofday_ns —
- Number of nanoseconds since UNIX epoch
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- gettimeofday_ns:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5823280"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5824432"></a><h2>Description</h2><p>
- This function returns the number of nanoseconds
- since the UNIX epoch.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-gettimeofday-ms.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-gettimeofday-s.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::gettimeofday_ms</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::gettimeofday_s</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::gettimeofday_s</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-gettimeofday-ns.html" title="function::gettimeofday_ns"><link rel="next" href="API-gettimeofday-us.html" title="function::gettimeofday_us"></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::gettimeofday_s</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-gettimeofday-ns.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-gettimeofday-us.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::gettimeofday_s"><a name="API-gettimeofday-s"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::gettimeofday_s —
- Number of seconds since UNIX epoch
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- gettimeofday_s:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5831776"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5832928"></a><h2>Description</h2><p>
- This function returns the number of seconds since
- the UNIX epoch.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-gettimeofday-ns.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-gettimeofday-us.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::gettimeofday_ns</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::gettimeofday_us</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::gettimeofday_us</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-gettimeofday-s.html" title="function::gettimeofday_s"><link rel="next" href="API-jiffies.html" title="function::jiffies"></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::gettimeofday_us</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-gettimeofday-s.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-jiffies.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::gettimeofday_us"><a name="API-gettimeofday-us"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::gettimeofday_us —
- Number of microseconds since UNIX epoch
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- gettimeofday_us:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5840272"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5841424"></a><h2>Description</h2><p>
- This function returns the number of microseconds
- since the UNIX epoch.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-gettimeofday-s.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-jiffies.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::gettimeofday_s</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::jiffies</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::gid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-fastcall.html" title="function::fastcall"><link rel="next" href="API-int-arg.html" title="function::int_arg"></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::gid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-fastcall.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-int-arg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::gid"><a name="API-gid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::gid —
- Returns the group ID of a target process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- gid:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4870704"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp4871856"></a><h2>Description</h2><p>
- This function returns the group ID of a target process.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-fastcall.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-int-arg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::fastcall</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::int_arg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::htonl</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-format-ipaddr.html" title="function::format_ipaddr"><link rel="next" href="API-htonll.html" title="function::htonll"></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::htonl</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-format-ipaddr.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-htonll.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::htonl"><a name="API-htonl"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::htonl —
- Convert 32-bit long from host to network order
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- htonl:long(x:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp7644240"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>x</code></em></span></dt><dd><p>
- Value to convert
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-format-ipaddr.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-htonll.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::format_ipaddr</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::htonll</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::htonll</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-htonl.html" title="function::htonl"><link rel="next" href="API-htons.html" title="function::htons"></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::htonll</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-htonl.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-htons.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::htonll"><a name="API-htonll"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::htonll —
- Convert 64-bit long long from host to network order
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- htonll:long(x:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp7654128"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>x</code></em></span></dt><dd><p>
- Value to convert
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-htonl.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-htons.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::htonl</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::htons</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::htons</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-htonll.html" title="function::htonll"><link rel="next" href="API-ip-ntop.html" title="function::ip_ntop"></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::htons</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-htonll.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ip-ntop.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::htons"><a name="API-htons"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::htons —
- Convert 16-bit short from host to network order
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- htons:long(x:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp7663984"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>x</code></em></span></dt><dd><p>
- Value to convert
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-htonll.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ip-ntop.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::htonll</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::ip_ntop</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::indent</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ansi.stp.html" title="Chapter 28. Utility functions for using ansi control chars in logs"><link rel="prev" href="API-ansi-set-color3.html" title="function::ansi_set_color3"><link rel="next" href="API-thread-indent.html" title="function::thread_indent"></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::indent</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ansi-set-color3.html">Prev</a> </td><th width="60%" align="center">Chapter 28. Utility functions for using ansi control chars in logs</th><td width="20%" align="right"> <a accesskey="n" href="API-thread-indent.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::indent"><a name="API-indent"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::indent —
- returns an amount of space to indent
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- indent:string(delta:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12240656"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>delta</code></em></span></dt><dd><p>
- the amount of space added/removed for each call
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12243888"></a><h2>Description</h2><p>
- This function returns a string with appropriate
- indentation. Call it with a small positive or matching negative
- delta. Unlike the thread_indent function, the indent does not
- track individual indent values on a per thread basis.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ansi-set-color3.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ansi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-thread-indent.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ansi_set_color3</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::thread_indent</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::inet_get_ip_source</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="next" href="API-inet-get-local-port.html" title="function::inet_get_local_port"></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::inet_get_ip_source</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="socket.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-inet-get-local-port.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::inet_get_ip_source"><a name="API-inet-get-ip-source"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::inet_get_ip_source —
- Provide IP source address string for a kernel socket
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- inet_get_ip_source:string(sock:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9238512"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sock</code></em></span></dt><dd><p>
- pointer to the kernel socket
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="socket.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-inet-get-local-port.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 14. Socket Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::inet_get_local_port</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::inet_get_local_port</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-inet-get-ip-source.html" title="function::inet_get_ip_source"><link rel="next" href="API-sock-fam-num2str.html" title="function::sock_fam_num2str"></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::inet_get_local_port</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-inet-get-ip-source.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sock-fam-num2str.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::inet_get_local_port"><a name="API-inet-get-local-port"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::inet_get_local_port —
- Provide local port number for a kernel socket
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- inet_get_local_port:long(sock:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9248512"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sock</code></em></span></dt><dd><p>
- pointer to the kernel socket
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-inet-get-ip-source.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sock-fam-num2str.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::inet_get_ip_source</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::sock_fam_num2str</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::inode_name</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="dentry.stp.html" title="Chapter 20. Directory-entry (dentry) Tapset"><link rel="prev" href="API-d-path.html" title="function::d_path"><link rel="next" href="API-real-mount.html" title="function::real_mount"></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::inode_name</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-d-path.html">Prev</a> </td><th width="60%" align="center">Chapter 20. Directory-entry (dentry) Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-real-mount.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::inode_name"><a name="API-inode-name"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::inode_name —
- get the inode name
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- inode_name:string(inode:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11044176"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>inode</code></em></span></dt><dd><p>
- Pointer to inode.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11047376"></a><h2>Description</h2><p>
- </p><p>
-
- Returns the first path basename associated with the given inode.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-d-path.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="dentry.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-real-mount.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::d_path</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::real_mount</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::int_arg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-gid.html" title="function::gid"><link rel="next" href="API-is-myproc.html" title="function::is_myproc"></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::int_arg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-gid.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-is-myproc.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::int_arg"><a name="API-int-arg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::int_arg —
- Return function argument as signed int
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- int_arg:long(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4879184"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- index of argument to return
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp4882240"></a><h2>Description</h2><p>
- Return the value of argument n as a signed int
- (i.e., a 32-bit integer sign-extended to 64 bits).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-gid.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-is-myproc.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::gid</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::is_myproc</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioblock.end</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="next" href="API-ioblock-request.html" title="probe::ioblock.request"></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>probe::ioblock.end</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="iosched.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ioblock-request.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioblock.end"><a name="API-ioblock-end"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioblock.end —
- Fires whenever a block I/O transfer is complete.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioblock.end </pre></div><div class="refsect1" title="Values"><a name="idp6778064"></a><h2>Values</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp6779280"></a><h2>Description</h2><p>
- </p><p>
-
- <em class="parameter"><code>name</code></em> - name of the probe point
- <em class="parameter"><code>devname</code></em> - block device name
- <em class="parameter"><code>ino</code></em> - i-node number of the mapped file
- <em class="parameter"><code>bytes_done</code></em> - number of bytes transferred
- <em class="parameter"><code>sector</code></em> - beginning sector for the entire bio
- <em class="parameter"><code>flags</code></em> - see below
- BIO_UPTODATE 0 ok after I/O completion
- BIO_RW_BLOCK 1 RW_AHEAD set, and read/write would block
- BIO_EOF 2 out-out-bounds error
- BIO_SEG_VALID 3 nr_hw_seg valid
- BIO_CLONED 4 doesn't own data
- BIO_BOUNCED 5 bio is a bounce bio
- BIO_USER_MAPPED 6 contains user pages
- BIO_EOPNOTSUPP 7 not supported
- <em class="parameter"><code>error</code></em> - 0 on success
- <em class="parameter"><code>rw</code></em> - binary trace for read/write request
- <em class="parameter"><code>vcnt</code></em> - bio vector count which represents number of array element (page, offset, length) which makes up this I/O request
- <em class="parameter"><code>idx</code></em> - offset into the bio vector array
- <em class="parameter"><code>phys_segments</code></em> - number of segments in this bio after physical address coalescing is performed.
- <em class="parameter"><code>hw_segments</code></em> - number of segments after physical and DMA remapping hardware coalescing is performed
- <em class="parameter"><code>size</code></em> - total size in bytes
-</p></div><div class="refsect1" title="Context"><a name="idp6790928"></a><h2>Context</h2><p>
- The process signals the transfer is done.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="iosched.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ioblock-request.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 9. IO Scheduler and block IO Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioblock.request</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioblock.request</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="API-ioblock-end.html" title="probe::ioblock.end"><link rel="next" href="API-ioblock-trace-bounce.html" title="probe::ioblock_trace.bounce"></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>probe::ioblock.request</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioblock-end.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ioblock-trace-bounce.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioblock.request"><a name="API-ioblock-request"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioblock.request —
- Fires whenever making a generic block I/O request.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioblock.request </pre></div><div class="refsect1" title="Values"><a name="idp6798864"></a><h2>Values</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp6800080"></a><h2>Description</h2><p>
- </p><p>
-
- <em class="parameter"><code>name</code></em> - name of the probe point
- <em class="parameter"><code>devname</code></em> - block device name
- <em class="parameter"><code>ino</code></em> - i-node number of the mapped file
- <em class="parameter"><code>sector</code></em> - beginning sector for the entire bio
- <em class="parameter"><code>flags</code></em> - see below
- BIO_UPTODATE 0 ok after I/O completion
- BIO_RW_BLOCK 1 RW_AHEAD set, and read/write would block
- BIO_EOF 2 out-out-bounds error
- BIO_SEG_VALID 3 nr_hw_seg valid
- BIO_CLONED 4 doesn't own data
- BIO_BOUNCED 5 bio is a bounce bio
- BIO_USER_MAPPED 6 contains user pages
- BIO_EOPNOTSUPP 7 not supported
- </p><p>
-
- <em class="parameter"><code>rw</code></em> - binary trace for read/write request
- <em class="parameter"><code>vcnt</code></em> - bio vector count which represents number of array element (page, offset, length) which make up this I/O request
- <em class="parameter"><code>idx</code></em> - offset into the bio vector array
- <em class="parameter"><code>phys_segments</code></em> - number of segments in this bio after physical address coalescing is performed
- <em class="parameter"><code>hw_segments</code></em> - number of segments after physical and DMA remapping hardware coalescing is performed
- <em class="parameter"><code>size</code></em> - total size in bytes
- <em class="parameter"><code>bdev</code></em> - target block device
- <em class="parameter"><code>bdev_contains</code></em> - points to the device object which contains the partition (when bio structure represents a partition)
- <em class="parameter"><code>p_start_sect</code></em> - points to the start sector of the partition structure of the device
-</p></div><div class="refsect1" title="Context"><a name="idp6812768"></a><h2>Context</h2><p>
- The process makes block I/O request
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioblock-end.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ioblock-trace-bounce.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioblock.end</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioblock_trace.bounce</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioblock_trace.bounce</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="API-ioblock-request.html" title="probe::ioblock.request"><link rel="next" href="API-ioblock-trace-end.html" title="probe::ioblock_trace.end"></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>probe::ioblock_trace.bounce</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioblock-request.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ioblock-trace-end.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioblock_trace.bounce"><a name="API-ioblock-trace-bounce"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioblock_trace.bounce —
- Fires whenever a buffer bounce is needed for at least one page of a block IO request.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioblock_trace.bounce </pre></div><div class="refsect1" title="Values"><a name="idp6820816"></a><h2>Values</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp6822032"></a><h2>Description</h2><p>
- </p><p>
-
- <em class="parameter"><code>name</code></em> - name of the probe point
- <em class="parameter"><code>q</code></em> - request queue on which this bio was queued.
- <em class="parameter"><code>devname</code></em> - device for which a buffer bounce was needed.
- <em class="parameter"><code>ino</code></em> - i-node number of the mapped file
- <em class="parameter"><code>bytes_done</code></em> - number of bytes transferred
- <em class="parameter"><code>sector</code></em> - beginning sector for the entire bio
- <em class="parameter"><code>flags</code></em> - see below
- BIO_UPTODATE 0 ok after I/O completion
- BIO_RW_BLOCK 1 RW_AHEAD set, and read/write would block
- BIO_EOF 2 out-out-bounds error
- BIO_SEG_VALID 3 nr_hw_seg valid
- BIO_CLONED 4 doesn't own data
- BIO_BOUNCED 5 bio is a bounce bio
- BIO_USER_MAPPED 6 contains user pages
- BIO_EOPNOTSUPP 7 not supported
- <em class="parameter"><code>rw</code></em> - binary trace for read/write request
- <em class="parameter"><code>vcnt</code></em> - bio vector count which represents number of array element (page, offset, length) which makes up this I/O request
- <em class="parameter"><code>idx</code></em> - offset into the bio vector array
- <em class="parameter"><code>phys_segments</code></em> - number of segments in this bio after physical address coalescing is performed.
- <em class="parameter"><code>size</code></em> - total size in bytes
- <em class="parameter"><code>bdev</code></em> - target block device
- <em class="parameter"><code>bdev_contains</code></em> - points to the device object which contains the partition (when bio structure represents a partition)
- <em class="parameter"><code>p_start_sect</code></em> - points to the start sector of the partition structure of the device
-</p></div><div class="refsect1" title="Context"><a name="idp6835152"></a><h2>Context </h2><p>
- The process creating a block IO request.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioblock-request.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ioblock-trace-end.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioblock.request</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioblock_trace.end</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioblock_trace.end</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="API-ioblock-trace-bounce.html" title="probe::ioblock_trace.bounce"><link rel="next" href="API-ioblock-trace-request.html" title="probe::ioblock_trace.request"></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>probe::ioblock_trace.end</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioblock-trace-bounce.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ioblock-trace-request.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioblock_trace.end"><a name="API-ioblock-trace-end"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioblock_trace.end —
- Fires whenever a block I/O transfer is complete.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioblock_trace.end </pre></div><div class="refsect1" title="Values"><a name="idp6843136"></a><h2>Values</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp6844352"></a><h2>Description</h2><p>
- </p><p>
-
- <em class="parameter"><code>name</code></em> - name of the probe point
- <em class="parameter"><code>q</code></em> - request queue on which this bio was queued.
- <em class="parameter"><code>devname</code></em> - block device name
- <em class="parameter"><code>ino</code></em> - i-node number of the mapped file
- <em class="parameter"><code>bytes_done</code></em> - number of bytes transferred
- <em class="parameter"><code>sector</code></em> - beginning sector for the entire bio
- <em class="parameter"><code>flags</code></em> - see below
- BIO_UPTODATE 0 ok after I/O completion
- BIO_RW_BLOCK 1 RW_AHEAD set, and read/write would block
- BIO_EOF 2 out-out-bounds error
- BIO_SEG_VALID 3 nr_hw_seg valid
- BIO_CLONED 4 doesn't own data
- BIO_BOUNCED 5 bio is a bounce bio
- BIO_USER_MAPPED 6 contains user pages
- BIO_EOPNOTSUPP 7 not supported
- </p><p>
-
- <em class="parameter"><code>rw</code></em> - binary trace for read/write request
- <em class="parameter"><code>vcnt</code></em> - bio vector count which represents number of array element (page, offset, length) which makes up this I/O request
- <em class="parameter"><code>idx</code></em> - offset into the bio vector array
- <em class="parameter"><code>phys_segments</code></em> - number of segments in this bio after physical address coalescing is performed.
- <em class="parameter"><code>size</code></em> - total size in bytes
- <em class="parameter"><code>bdev</code></em> - target block device
- <em class="parameter"><code>bdev_contains</code></em> - points to the device object which contains the partition (when bio structure represents a partition)
- <em class="parameter"><code>p_start_sect</code></em> - points to the start sector of the partition structure of the device
-</p></div><div class="refsect1" title="Context"><a name="idp6857712"></a><h2>Context</h2><p>
- The process signals the transfer is done.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioblock-trace-bounce.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ioblock-trace-request.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioblock_trace.bounce</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioblock_trace.request</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioblock_trace.request</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="API-ioblock-trace-end.html" title="probe::ioblock_trace.end"><link rel="next" href="API-ioscheduler-elv-add-request.html" title="probe::ioscheduler.elv_add_request"></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>probe::ioblock_trace.request</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioblock-trace-end.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ioscheduler-elv-add-request.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioblock_trace.request"><a name="API-ioblock-trace-request"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioblock_trace.request —
- Fires just as a generic block I/O request is created for a bio.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioblock_trace.request </pre></div><div class="refsect1" title="Values"><a name="idp6865712"></a><h2>Values</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp6866928"></a><h2>Description</h2><p>
- </p><p>
-
- <em class="parameter"><code>name</code></em> - name of the probe point
- <em class="parameter"><code>q</code></em> - request queue on which this bio was queued.
- <em class="parameter"><code>devname</code></em> - block device name
- <em class="parameter"><code>ino</code></em> - i-node number of the mapped file
- <em class="parameter"><code>bytes_done</code></em> - number of bytes transferred
- <em class="parameter"><code>sector</code></em> - beginning sector for the entire bio
- <em class="parameter"><code>flags</code></em> - see below
- BIO_UPTODATE 0 ok after I/O completion
- BIO_RW_BLOCK 1 RW_AHEAD set, and read/write would block
- BIO_EOF 2 out-out-bounds error
- BIO_SEG_VALID 3 nr_hw_seg valid
- BIO_CLONED 4 doesn't own data
- BIO_BOUNCED 5 bio is a bounce bio
- BIO_USER_MAPPED 6 contains user pages
- BIO_EOPNOTSUPP 7 not supported
- </p><p>
-
- <em class="parameter"><code>rw</code></em> - binary trace for read/write request
- <em class="parameter"><code>vcnt</code></em> - bio vector count which represents number of array element (page, offset, length) which make up this I/O request
- <em class="parameter"><code>idx</code></em> - offset into the bio vector array
- <em class="parameter"><code>phys_segments</code></em> - number of segments in this bio after physical address coalescing is performed.
- <em class="parameter"><code>size</code></em> - total size in bytes
- <em class="parameter"><code>bdev</code></em> - target block device
- <em class="parameter"><code>bdev_contains</code></em> - points to the device object which contains the partition (when bio structure represents a partition)
- <em class="parameter"><code>p_start_sect</code></em> - points to the start sector of the partition structure of the device
-</p></div><div class="refsect1" title="Context"><a name="idp6880288"></a><h2>Context</h2><p>
- The process makes block I/O request
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioblock-trace-end.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ioscheduler-elv-add-request.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioblock_trace.end</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioscheduler.elv_add_request</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioscheduler.elv_add_request.kp</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="API-ioscheduler-elv-add-request.html" title="probe::ioscheduler.elv_add_request"><link rel="next" href="API-ioscheduler-elv-add-request-tp.html" title="probe::ioscheduler.elv_add_request.tp"></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>probe::ioscheduler.elv_add_request.kp</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioscheduler-elv-add-request.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ioscheduler-elv-add-request-tp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioscheduler.elv_add_request.kp"><a name="API-ioscheduler-elv-add-request-kp"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioscheduler.elv_add_request.kp —
- kprobe based probe to indicate that a request was added to the request queue
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioscheduler.elv_add_request.kp </pre></div><div class="refsect1" title="Values"><a name="idp6908416"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>disk_major</code></em></span></dt><dd><p>
- Disk major number of the request
- </p></dd><dt><span class="term"><em class="parameter"><code>rq</code></em></span></dt><dd><p>
- Address of the request
- </p></dd><dt><span class="term"><em class="parameter"><code>q</code></em></span></dt><dd><p>
- pointer to request queue
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>elevator_name</code></em></span></dt><dd><p>
- The type of I/O elevator currently enabled
- </p></dd><dt><span class="term"><em class="parameter"><code>disk_minor</code></em></span></dt><dd><p>
- Disk minor number of the request
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_flags</code></em></span></dt><dd><p>
- Request flags
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioscheduler-elv-add-request.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ioscheduler-elv-add-request-tp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioscheduler.elv_add_request</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioscheduler.elv_add_request.tp</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioscheduler.elv_add_request.tp</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="API-ioscheduler-elv-add-request-kp.html" title="probe::ioscheduler.elv_add_request.kp"><link rel="next" href="API-ioscheduler-elv-completed-request.html" title="probe::ioscheduler.elv_completed_request"></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>probe::ioscheduler.elv_add_request.tp</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioscheduler-elv-add-request-kp.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ioscheduler-elv-completed-request.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioscheduler.elv_add_request.tp"><a name="API-ioscheduler-elv-add-request-tp"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioscheduler.elv_add_request.tp —
- tracepoint based probe to indicate a request is added to the request queue.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioscheduler.elv_add_request.tp </pre></div><div class="refsect1" title="Values"><a name="idp6930496"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>disk_major</code></em></span></dt><dd><p>
- Disk major no of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>rq</code></em></span></dt><dd><p>
- Address of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>q</code></em></span></dt><dd><p>
- Pointer to request queue.
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>elevator_name</code></em></span></dt><dd><p>
- The type of I/O elevator currently enabled.
- </p></dd><dt><span class="term"><em class="parameter"><code>disk_minor</code></em></span></dt><dd><p>
- Disk minor number of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_flags</code></em></span></dt><dd><p>
- Request flags.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioscheduler-elv-add-request-kp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ioscheduler-elv-completed-request.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioscheduler.elv_add_request.kp</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioscheduler.elv_completed_request</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioscheduler.elv_add_request</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="API-ioblock-trace-request.html" title="probe::ioblock_trace.request"><link rel="next" href="API-ioscheduler-elv-add-request-kp.html" title="probe::ioscheduler.elv_add_request.kp"></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>probe::ioscheduler.elv_add_request</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioblock-trace-request.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ioscheduler-elv-add-request-kp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioscheduler.elv_add_request"><a name="API-ioscheduler-elv-add-request"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioscheduler.elv_add_request —
- probe to indicate request is added to the request queue.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioscheduler.elv_add_request </pre></div><div class="refsect1" title="Values"><a name="idp6888320"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>disk_major</code></em></span></dt><dd><p>
- Disk major no of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>rq</code></em></span></dt><dd><p>
- Address of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>q</code></em></span></dt><dd><p>
- Pointer to request queue.
- </p></dd><dt><span class="term"><em class="parameter"><code>elevator_name</code></em></span></dt><dd><p>
- The type of I/O elevator currently enabled.
- </p></dd><dt><span class="term"><em class="parameter"><code>disk_minor</code></em></span></dt><dd><p>
- Disk minor number of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_flags</code></em></span></dt><dd><p>
- Request flags.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioblock-trace-request.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ioscheduler-elv-add-request-kp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioblock_trace.request</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioscheduler.elv_add_request.kp</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioscheduler.elv_completed_request</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="API-ioscheduler-elv-add-request-tp.html" title="probe::ioscheduler.elv_add_request.tp"><link rel="next" href="API-ioscheduler-elv-next-request.html" title="probe::ioscheduler.elv_next_request"></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>probe::ioscheduler.elv_completed_request</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioscheduler-elv-add-request-tp.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ioscheduler-elv-next-request.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioscheduler.elv_completed_request"><a name="API-ioscheduler-elv-completed-request"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioscheduler.elv_completed_request —
- Fires when a request is completed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioscheduler.elv_completed_request </pre></div><div class="refsect1" title="Values"><a name="idp6952544"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>disk_major</code></em></span></dt><dd><p>
- Disk major number of the request
- </p></dd><dt><span class="term"><em class="parameter"><code>rq</code></em></span></dt><dd><p>
- Address of the request
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>elevator_name</code></em></span></dt><dd><p>
- The type of I/O elevator currently enabled
- </p></dd><dt><span class="term"><em class="parameter"><code>disk_minor</code></em></span></dt><dd><p>
- Disk minor number of the request
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_flags</code></em></span></dt><dd><p>
- Request flags
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioscheduler-elv-add-request-tp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ioscheduler-elv-next-request.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioscheduler.elv_add_request.tp</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioscheduler.elv_next_request</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioscheduler.elv_next_request.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="API-ioscheduler-elv-next-request.html" title="probe::ioscheduler.elv_next_request"><link rel="next" href="API-ioscheduler-trace-elv-abort-request.html" title="probe::ioscheduler_trace.elv_abort_request"></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>probe::ioscheduler.elv_next_request.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioscheduler-elv-next-request.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ioscheduler-trace-elv-abort-request.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioscheduler.elv_next_request.return"><a name="API-ioscheduler-elv-next-request-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioscheduler.elv_next_request.return —
- Fires when a request retrieval issues a return signal
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioscheduler.elv_next_request.return </pre></div><div class="refsect1" title="Values"><a name="idp6984720"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>disk_major</code></em></span></dt><dd><p>
- Disk major number of the request
- </p></dd><dt><span class="term"><em class="parameter"><code>rq</code></em></span></dt><dd><p>
- Address of the request
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>disk_minor</code></em></span></dt><dd><p>
- Disk minor number of the request
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_flags</code></em></span></dt><dd><p>
- Request flags
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioscheduler-elv-next-request.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ioscheduler-trace-elv-abort-request.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioscheduler.elv_next_request</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioscheduler_trace.elv_abort_request</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioscheduler.elv_next_request</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="API-ioscheduler-elv-completed-request.html" title="probe::ioscheduler.elv_completed_request"><link rel="next" href="API-ioscheduler-elv-next-request-return.html" title="probe::ioscheduler.elv_next_request.return"></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>probe::ioscheduler.elv_next_request</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioscheduler-elv-completed-request.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ioscheduler-elv-next-request-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioscheduler.elv_next_request"><a name="API-ioscheduler-elv-next-request"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioscheduler.elv_next_request —
- Fires when a request is retrieved from the request queue
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioscheduler.elv_next_request </pre></div><div class="refsect1" title="Values"><a name="idp6972624"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>elevator_name</code></em></span></dt><dd><p>
- The type of I/O elevator currently enabled
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioscheduler-elv-completed-request.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ioscheduler-elv-next-request-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioscheduler.elv_completed_request</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioscheduler.elv_next_request.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioscheduler_trace.elv_abort_request</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="API-ioscheduler-elv-next-request-return.html" title="probe::ioscheduler.elv_next_request.return"><link rel="next" href="API-ioscheduler-trace-elv-completed-request.html" title="probe::ioscheduler_trace.elv_completed_request"></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>probe::ioscheduler_trace.elv_abort_request</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioscheduler-elv-next-request-return.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ioscheduler-trace-elv-completed-request.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioscheduler_trace.elv_abort_request"><a name="API-ioscheduler-trace-elv-abort-request"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioscheduler_trace.elv_abort_request —
- Fires when a request is aborted.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioscheduler_trace.elv_abort_request </pre></div><div class="refsect1" title="Values"><a name="idp7002784"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>disk_major</code></em></span></dt><dd><p>
- Disk major no of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>rq</code></em></span></dt><dd><p>
- Address of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>elevator_name</code></em></span></dt><dd><p>
- The type of I/O elevator currently enabled.
- </p></dd><dt><span class="term"><em class="parameter"><code>disk_minor</code></em></span></dt><dd><p>
- Disk minor number of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_flags</code></em></span></dt><dd><p>
- Request flags.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioscheduler-elv-next-request-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ioscheduler-trace-elv-completed-request.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioscheduler.elv_next_request.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioscheduler_trace.elv_completed_request</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioscheduler_trace.elv_completed_request</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="API-ioscheduler-trace-elv-abort-request.html" title="probe::ioscheduler_trace.elv_abort_request"><link rel="next" href="API-ioscheduler-trace-elv-issue-request.html" title="probe::ioscheduler_trace.elv_issue_request"></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>probe::ioscheduler_trace.elv_completed_request</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioscheduler-trace-elv-abort-request.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ioscheduler-trace-elv-issue-request.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioscheduler_trace.elv_completed_request"><a name="API-ioscheduler-trace-elv-completed-request"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioscheduler_trace.elv_completed_request —
- Fires when a request is
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioscheduler_trace.elv_completed_request </pre></div><div class="refsect1" title="Values"><a name="idp7022944"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>disk_major</code></em></span></dt><dd><p>
- Disk major no of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>rq</code></em></span></dt><dd><p>
- Address of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>elevator_name</code></em></span></dt><dd><p>
- The type of I/O elevator currently enabled.
- </p></dd><dt><span class="term"><em class="parameter"><code>disk_minor</code></em></span></dt><dd><p>
- Disk minor number of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_flags</code></em></span></dt><dd><p>
- Request flags.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp7036224"></a><h2>Description</h2><p>
- completed.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioscheduler-trace-elv-abort-request.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ioscheduler-trace-elv-issue-request.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioscheduler_trace.elv_abort_request</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioscheduler_trace.elv_issue_request</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioscheduler_trace.elv_issue_request</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="API-ioscheduler-trace-elv-completed-request.html" title="probe::ioscheduler_trace.elv_completed_request"><link rel="next" href="API-ioscheduler-trace-elv-requeue-request.html" title="probe::ioscheduler_trace.elv_requeue_request"></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>probe::ioscheduler_trace.elv_issue_request</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioscheduler-trace-elv-completed-request.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ioscheduler-trace-elv-requeue-request.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioscheduler_trace.elv_issue_request"><a name="API-ioscheduler-trace-elv-issue-request"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioscheduler_trace.elv_issue_request —
- Fires when a request is
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioscheduler_trace.elv_issue_request </pre></div><div class="refsect1" title="Values"><a name="idp7044208"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>disk_major</code></em></span></dt><dd><p>
- Disk major no of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>rq</code></em></span></dt><dd><p>
- Address of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>elevator_name</code></em></span></dt><dd><p>
- The type of I/O elevator currently enabled.
- </p></dd><dt><span class="term"><em class="parameter"><code>disk_minor</code></em></span></dt><dd><p>
- Disk minor number of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_flags</code></em></span></dt><dd><p>
- Request flags.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp7057488"></a><h2>Description</h2><p>
- scheduled.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioscheduler-trace-elv-completed-request.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ioscheduler-trace-elv-requeue-request.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioscheduler_trace.elv_completed_request</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioscheduler_trace.elv_requeue_request</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioscheduler_trace.elv_requeue_request</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="API-ioscheduler-trace-elv-issue-request.html" title="probe::ioscheduler_trace.elv_issue_request"><link rel="next" href="API-ioscheduler-trace-plug.html" title="probe::ioscheduler_trace.plug"></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>probe::ioscheduler_trace.elv_requeue_request</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioscheduler-trace-elv-issue-request.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ioscheduler-trace-plug.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioscheduler_trace.elv_requeue_request"><a name="API-ioscheduler-trace-elv-requeue-request"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioscheduler_trace.elv_requeue_request —
- Fires when a request is
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioscheduler_trace.elv_requeue_request </pre></div><div class="refsect1" title="Values"><a name="idp7065568"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>disk_major</code></em></span></dt><dd><p>
- Disk major no of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>rq</code></em></span></dt><dd><p>
- Address of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>elevator_name</code></em></span></dt><dd><p>
- The type of I/O elevator currently enabled.
- </p></dd><dt><span class="term"><em class="parameter"><code>disk_minor</code></em></span></dt><dd><p>
- Disk minor number of request.
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_flags</code></em></span></dt><dd><p>
- Request flags.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp7078848"></a><h2>Description</h2><p>
- put back on the queue, when the hadware cannot accept more requests.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioscheduler-trace-elv-issue-request.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ioscheduler-trace-plug.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioscheduler_trace.elv_issue_request</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioscheduler_trace.plug</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioscheduler_trace.plug</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="API-ioscheduler-trace-elv-requeue-request.html" title="probe::ioscheduler_trace.elv_requeue_request"><link rel="next" href="API-ioscheduler-trace-unplug-io.html" title="probe::ioscheduler_trace.unplug_io"></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>probe::ioscheduler_trace.plug</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioscheduler-trace-elv-requeue-request.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ioscheduler-trace-unplug-io.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioscheduler_trace.plug"><a name="API-ioscheduler-trace-plug"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioscheduler_trace.plug —
- Fires when a request queue is plugged;
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioscheduler_trace.plug </pre></div><div class="refsect1" title="Values"><a name="idp7086928"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_queue</code></em></span></dt><dd><p>
- request queue
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp7092144"></a><h2>Description</h2><p>
- ie, requests in the queue cannot be serviced by block driver.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioscheduler-trace-elv-requeue-request.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ioscheduler-trace-unplug-io.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioscheduler_trace.elv_requeue_request</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioscheduler_trace.unplug_io</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioscheduler_trace.unplug_io</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="API-ioscheduler-trace-plug.html" title="probe::ioscheduler_trace.plug"><link rel="next" href="API-ioscheduler-trace-unplug-timer.html" title="probe::ioscheduler_trace.unplug_timer"></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>probe::ioscheduler_trace.unplug_io</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioscheduler-trace-plug.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ioscheduler-trace-unplug-timer.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioscheduler_trace.unplug_io"><a name="API-ioscheduler-trace-unplug-io"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioscheduler_trace.unplug_io —
- Fires when a request queue is unplugged;
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioscheduler_trace.unplug_io </pre></div><div class="refsect1" title="Values"><a name="idp7100160"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_queue</code></em></span></dt><dd><p>
- request queue
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp7105376"></a><h2>Description</h2><p>
- Either, when number of pending requests in the queue exceeds threshold
- or, upon expiration of timer that was activated when queue was plugged.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioscheduler-trace-plug.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ioscheduler-trace-unplug-timer.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioscheduler_trace.plug</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioscheduler_trace.unplug_timer</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ioscheduler_trace.unplug_timer</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"><link rel="prev" href="API-ioscheduler-trace-unplug-io.html" title="probe::ioscheduler_trace.unplug_io"><link rel="next" href="scsi.stp.html" title="Chapter 10. SCSI Tapset"></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>probe::ioscheduler_trace.unplug_timer</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioscheduler-trace-unplug-io.html">Prev</a> </td><th width="60%" align="center">Chapter 9. IO Scheduler and block IO Tapset</th><td width="20%" align="right"> <a accesskey="n" href="scsi.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ioscheduler_trace.unplug_timer"><a name="API-ioscheduler-trace-unplug-timer"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ioscheduler_trace.unplug_timer —
- Fires when unplug timer associated
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ioscheduler_trace.unplug_timer </pre></div><div class="refsect1" title="Values"><a name="idp7113424"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_queue</code></em></span></dt><dd><p>
- request queue
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp7118640"></a><h2>Description</h2><p>
- with a request queue expires.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioscheduler-trace-unplug-io.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="iosched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="scsi.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioscheduler_trace.unplug_io</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 10. SCSI Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ip_ntop</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-htons.html" title="function::htons"><link rel="next" href="API-ntohl.html" title="function::ntohl"></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::ip_ntop</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-htons.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ntohl.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ip_ntop"><a name="API-ip-ntop"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ip_ntop —
- Returns a string representation for an IPv4 address
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ip_ntop:string(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp7673872"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the IPv4 address represented as an integer
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-htons.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ntohl.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::htons</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::ntohl</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ipmib.ForwDatagrams</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-tcpmib-remote-port.html" title="function::tcpmib_remote_port"><link rel="next" href="API-ipmib-FragFails.html" title="probe::ipmib.FragFails"></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>probe::ipmib.ForwDatagrams</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcpmib-remote-port.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ipmib-FragFails.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ipmib.ForwDatagrams"><a name="API-ipmib-ForwDatagrams"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ipmib.ForwDatagrams —
- Count forwarded packet
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ipmib.ForwDatagrams </pre></div><div class="refsect1" title="Values"><a name="idp9943024"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>skb</code></em></span></dt><dd><p>
- pointer to the struct sk_buff being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp9948224"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">ipmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>ForwDatagrams</code></em> (equivalent to SNMP's MIB
- IPSTATS_MIB_OUTFORWDATAGRAMS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcpmib-remote-port.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ipmib-FragFails.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::tcpmib_remote_port</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ipmib.FragFails</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ipmib.FragFails</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-ipmib-ForwDatagrams.html" title="probe::ipmib.ForwDatagrams"><link rel="next" href="API-ipmib-FragOKs.html" title="probe::ipmib.FragOKs"></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>probe::ipmib.FragFails</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ipmib-ForwDatagrams.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ipmib-FragOKs.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ipmib.FragFails"><a name="API-ipmib-FragFails"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ipmib.FragFails —
- Count datagram fragmented unsuccessfully
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ipmib.FragFails </pre></div><div class="refsect1" title="Values"><a name="idp9958384"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>skb</code></em></span></dt><dd><p>
- pointer to the struct sk_buff being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- Value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp9963584"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">ipmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>FragFails</code></em> (equivalent to SNMP's MIB
- IPSTATS_MIB_FRAGFAILS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ipmib-ForwDatagrams.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ipmib-FragOKs.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ipmib.ForwDatagrams</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ipmib.FragOKs</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ipmib.FragOKs</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-ipmib-FragFails.html" title="probe::ipmib.FragFails"><link rel="next" href="API-ipmib-InAddrErrors.html" title="probe::ipmib.InAddrErrors"></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>probe::ipmib.FragOKs</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ipmib-FragFails.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ipmib-InAddrErrors.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ipmib.FragOKs"><a name="API-ipmib-FragOKs"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ipmib.FragOKs —
- Count datagram fragmented successfully
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ipmib.FragOKs </pre></div><div class="refsect1" title="Values"><a name="idp9973776"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>skb</code></em></span></dt><dd><p>
- pointer to the struct sk_buff being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp9978976"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">ipmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>FragOKs</code></em> (equivalent to SNMP's MIB
- IPSTATS_MIB_FRAGOKS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ipmib-FragFails.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ipmib-InAddrErrors.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ipmib.FragFails</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ipmib.InAddrErrors</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ipmib.InAddrErrors</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-ipmib-FragOKs.html" title="probe::ipmib.FragOKs"><link rel="next" href="API-ipmib-InDiscards.html" title="probe::ipmib.InDiscards"></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>probe::ipmib.InAddrErrors</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ipmib-FragOKs.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ipmib-InDiscards.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ipmib.InAddrErrors"><a name="API-ipmib-InAddrErrors"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ipmib.InAddrErrors —
- Count arriving packets with an incorrect address
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ipmib.InAddrErrors </pre></div><div class="refsect1" title="Values"><a name="idp9989216"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>skb</code></em></span></dt><dd><p>
- pointer to the struct sk_buff being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp9994416"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">ipmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>InAddrErrors</code></em> (equivalent to SNMP's MIB
- IPSTATS_MIB_INADDRERRORS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ipmib-FragOKs.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ipmib-InDiscards.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ipmib.FragOKs</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ipmib.InDiscards</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ipmib.InDiscards</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-ipmib-InAddrErrors.html" title="probe::ipmib.InAddrErrors"><link rel="next" href="API-ipmib-InNoRoutes.html" title="probe::ipmib.InNoRoutes"></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>probe::ipmib.InDiscards</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ipmib-InAddrErrors.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ipmib-InNoRoutes.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ipmib.InDiscards"><a name="API-ipmib-InDiscards"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ipmib.InDiscards —
- Count discarded inbound packets
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ipmib.InDiscards </pre></div><div class="refsect1" title="Values"><a name="idp10004608"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>skb</code></em></span></dt><dd><p>
- pointer to the struct sk_buff being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10009808"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">ipmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>InDiscards</code></em> (equivalent to SNMP's MIB
- STATS_MIB_INDISCARDS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ipmib-InAddrErrors.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ipmib-InNoRoutes.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ipmib.InAddrErrors</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ipmib.InNoRoutes</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ipmib.InNoRoutes</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-ipmib-InDiscards.html" title="probe::ipmib.InDiscards"><link rel="next" href="API-ipmib-InReceives.html" title="probe::ipmib.InReceives"></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>probe::ipmib.InNoRoutes</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ipmib-InDiscards.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ipmib-InReceives.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ipmib.InNoRoutes"><a name="API-ipmib-InNoRoutes"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ipmib.InNoRoutes —
- Count an arriving packet with no matching socket
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ipmib.InNoRoutes </pre></div><div class="refsect1" title="Values"><a name="idp10020016"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>skb</code></em></span></dt><dd><p>
- pointer to the struct sk_buff being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10025216"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">ipmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>InNoRoutes</code></em> (equivalent to SNMP's MIB
- IPSTATS_MIB_INNOROUTES)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ipmib-InDiscards.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ipmib-InReceives.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ipmib.InDiscards</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ipmib.InReceives</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ipmib.InReceives</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-ipmib-InNoRoutes.html" title="probe::ipmib.InNoRoutes"><link rel="next" href="API-ipmib-InUnknownProtos.html" title="probe::ipmib.InUnknownProtos"></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>probe::ipmib.InReceives</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ipmib-InNoRoutes.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ipmib-InUnknownProtos.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ipmib.InReceives"><a name="API-ipmib-InReceives"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ipmib.InReceives —
- Count an arriving packet
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ipmib.InReceives </pre></div><div class="refsect1" title="Values"><a name="idp10035280"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>skb</code></em></span></dt><dd><p>
- pointer to the struct sk_buff being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10040480"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">ipmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>InReceives</code></em> (equivalent to SNMP's MIB
- IPSTATS_MIB_INRECEIVES)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ipmib-InNoRoutes.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ipmib-InUnknownProtos.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ipmib.InNoRoutes</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ipmib.InUnknownProtos</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ipmib.InUnknownProtos</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-ipmib-InReceives.html" title="probe::ipmib.InReceives"><link rel="next" href="API-ipmib-OutRequests.html" title="probe::ipmib.OutRequests"></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>probe::ipmib.InUnknownProtos</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ipmib-InReceives.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ipmib-OutRequests.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ipmib.InUnknownProtos"><a name="API-ipmib-InUnknownProtos"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ipmib.InUnknownProtos —
- Count arriving packets with an unbound proto
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ipmib.InUnknownProtos </pre></div><div class="refsect1" title="Values"><a name="idp10050736"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>skb</code></em></span></dt><dd><p>
- pointer to the struct sk_buff being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10055936"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">ipmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>InUnknownProtos</code></em> (equivalent to SNMP's MIB
- IPSTATS_MIB_INUNKNOWNPROTOS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ipmib-InReceives.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ipmib-OutRequests.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ipmib.InReceives</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ipmib.OutRequests</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ipmib.OutRequests</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-ipmib-InUnknownProtos.html" title="probe::ipmib.InUnknownProtos"><link rel="next" href="API-ipmib-ReasmReqds.html" title="probe::ipmib.ReasmReqds"></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>probe::ipmib.OutRequests</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ipmib-InUnknownProtos.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ipmib-ReasmReqds.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ipmib.OutRequests"><a name="API-ipmib-OutRequests"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ipmib.OutRequests —
- Count a request to send a packet
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ipmib.OutRequests </pre></div><div class="refsect1" title="Values"><a name="idp10066112"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>skb</code></em></span></dt><dd><p>
- pointer to the struct sk_buff being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10071312"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">ipmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>OutRequests</code></em> (equivalent to SNMP's MIB
- IPSTATS_MIB_OUTREQUESTS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ipmib-InUnknownProtos.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ipmib-ReasmReqds.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ipmib.InUnknownProtos</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ipmib.ReasmReqds</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ipmib.ReasmReqds</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-ipmib-OutRequests.html" title="probe::ipmib.OutRequests"><link rel="next" href="API-ipmib-ReasmTimeout.html" title="probe::ipmib.ReasmTimeout"></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>probe::ipmib.ReasmReqds</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ipmib-OutRequests.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ipmib-ReasmTimeout.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ipmib.ReasmReqds"><a name="API-ipmib-ReasmReqds"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ipmib.ReasmReqds —
- Count number of packet fragments reassembly requests
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ipmib.ReasmReqds </pre></div><div class="refsect1" title="Values"><a name="idp10081520"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>skb</code></em></span></dt><dd><p>
- pointer to the struct sk_buff being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10086720"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">ipmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>ReasmReqds</code></em> (equivalent to SNMP's MIB
- IPSTATS_MIB_REASMREQDS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ipmib-OutRequests.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ipmib-ReasmTimeout.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ipmib.OutRequests</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ipmib.ReasmTimeout</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::ipmib.ReasmTimeout</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-ipmib-ReasmReqds.html" title="probe::ipmib.ReasmReqds"><link rel="next" href="API-linuxmib-DelayedACKs.html" title="probe::linuxmib.DelayedACKs"></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>probe::ipmib.ReasmTimeout</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ipmib-ReasmReqds.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-linuxmib-DelayedACKs.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::ipmib.ReasmTimeout"><a name="API-ipmib-ReasmTimeout"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::ipmib.ReasmTimeout —
- Count Reassembly Timeouts
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">ipmib.ReasmTimeout </pre></div><div class="refsect1" title="Values"><a name="idp10096816"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>skb</code></em></span></dt><dd><p>
- pointer to the struct sk_buff being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10102016"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">ipmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>ReasmTimeout</code></em> (equivalent to SNMP's MIB
- IPSTATS_MIB_REASMTIMEOUT)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ipmib-ReasmReqds.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-linuxmib-DelayedACKs.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ipmib.ReasmReqds</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::linuxmib.DelayedACKs</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ipmib_filter_key</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="next" href="API-ipmib-get-proto.html" title="function::ipmib_get_proto"></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::ipmib_filter_key</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="snmp.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ipmib-get-proto.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ipmib_filter_key"><a name="API-ipmib-filter-key"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ipmib_filter_key —
- Default filter function for ipmib.* probes
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ipmib_filter_key:long(skb:long,op:long,SourceIsLocal:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9771296"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>skb</code></em></span></dt><dd><p>
- pointer to the struct sk_buff
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be counted if <em class="parameter"><code>skb</code></em> passes the filter
- </p></dd><dt><span class="term"><em class="parameter"><code>SourceIsLocal</code></em></span></dt><dd><p>
- 1 is local operation and 0 is non-local operation
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp9779248"></a><h2>Description</h2><p>
- This function is a default filter function.
- The user can replace this function with their own.
- The user-supplied filter function returns an index key based on the values
- in <em class="parameter"><code>skb</code></em>.
- A return value of 0 means this particular <em class="parameter"><code>skb</code></em> should be not be counted.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="snmp.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ipmib-get-proto.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 15. SNMP Information Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::ipmib_get_proto</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ipmib_get_proto</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-ipmib-filter-key.html" title="function::ipmib_filter_key"><link rel="next" href="API-ipmib-local-addr.html" title="function::ipmib_local_addr"></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::ipmib_get_proto</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ipmib-filter-key.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ipmib-local-addr.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ipmib_get_proto"><a name="API-ipmib-get-proto"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ipmib_get_proto —
- Get the protocol value
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ipmib_get_proto:long(skb:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9788832"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>skb</code></em></span></dt><dd><p>
- pointer to a struct sk_buff
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp9792000"></a><h2>Description</h2><p>
- Returns the protocol value from <em class="parameter"><code>skb</code></em>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ipmib-filter-key.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ipmib-local-addr.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ipmib_filter_key</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::ipmib_local_addr</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ipmib_local_addr</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-ipmib-get-proto.html" title="function::ipmib_get_proto"><link rel="next" href="API-ipmib-remote-addr.html" title="function::ipmib_remote_addr"></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::ipmib_local_addr</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ipmib-get-proto.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ipmib-remote-addr.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ipmib_local_addr"><a name="API-ipmib-local-addr"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ipmib_local_addr —
- Get the local ip address
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ipmib_local_addr:long(skb:long,SourceIsLocal:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9800688"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>skb</code></em></span></dt><dd><p>
- pointer to a struct sk_buff
- </p></dd><dt><span class="term"><em class="parameter"><code>SourceIsLocal</code></em></span></dt><dd><p>
- flag to indicate whether local operation
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp9805888"></a><h2>Description</h2><p>
- Returns the local ip address <em class="parameter"><code>skb</code></em>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ipmib-get-proto.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ipmib-remote-addr.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ipmib_get_proto</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::ipmib_remote_addr</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ipmib_remote_addr</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-ipmib-local-addr.html" title="function::ipmib_local_addr"><link rel="next" href="API-ipmib-tcp-local-port.html" title="function::ipmib_tcp_local_port"></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::ipmib_remote_addr</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ipmib-local-addr.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ipmib-tcp-local-port.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ipmib_remote_addr"><a name="API-ipmib-remote-addr"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ipmib_remote_addr —
- Get the remote ip address
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ipmib_remote_addr:long(skb:long,SourceIsLocal:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9814528"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>skb</code></em></span></dt><dd><p>
- pointer to a struct sk_buff
- </p></dd><dt><span class="term"><em class="parameter"><code>SourceIsLocal</code></em></span></dt><dd><p>
- flag to indicate whether local operation
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp9819728"></a><h2>Description</h2><p>
- Returns the remote ip address from <em class="parameter"><code>skb</code></em>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ipmib-local-addr.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ipmib-tcp-local-port.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ipmib_local_addr</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::ipmib_tcp_local_port</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ipmib_tcp_local_port</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-ipmib-remote-addr.html" title="function::ipmib_remote_addr"><link rel="next" href="API-ipmib-tcp-remote-port.html" title="function::ipmib_tcp_remote_port"></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::ipmib_tcp_local_port</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ipmib-remote-addr.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ipmib-tcp-remote-port.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ipmib_tcp_local_port"><a name="API-ipmib-tcp-local-port"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ipmib_tcp_local_port —
- Get the local tcp port
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ipmib_tcp_local_port:long(skb:long,SourceIsLocal:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9828448"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>skb</code></em></span></dt><dd><p>
- pointer to a struct sk_buff
- </p></dd><dt><span class="term"><em class="parameter"><code>SourceIsLocal</code></em></span></dt><dd><p>
- flag to indicate whether local operation
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp9833648"></a><h2>Description</h2><p>
- Returns the local tcp port from <em class="parameter"><code>skb</code></em>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ipmib-remote-addr.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ipmib-tcp-remote-port.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ipmib_remote_addr</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::ipmib_tcp_remote_port</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ipmib_tcp_remote_port</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-ipmib-tcp-local-port.html" title="function::ipmib_tcp_local_port"><link rel="next" href="API-linuxmib-filter-key.html" title="function::linuxmib_filter_key"></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::ipmib_tcp_remote_port</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ipmib-tcp-local-port.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-linuxmib-filter-key.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ipmib_tcp_remote_port"><a name="API-ipmib-tcp-remote-port"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ipmib_tcp_remote_port —
- Get the remote tcp port
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ipmib_tcp_remote_port:long(skb:long,SourceIsLocal:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9842368"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>skb</code></em></span></dt><dd><p>
- pointer to a struct sk_buff
- </p></dd><dt><span class="term"><em class="parameter"><code>SourceIsLocal</code></em></span></dt><dd><p>
- flag to indicate whether local operation
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp9847568"></a><h2>Description</h2><p>
- Returns the remote tcp port from <em class="parameter"><code>skb</code></em>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ipmib-tcp-local-port.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-linuxmib-filter-key.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ipmib_tcp_local_port</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::linuxmib_filter_key</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::irq_handler.entry</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="irq.stp.html" title="Chapter 12. Interrupt Request (IRQ) Tapset"><link rel="prev" href="irq.stp.html" title="Chapter 12. Interrupt Request (IRQ) Tapset"><link rel="next" href="API-irq-handler-exit.html" title="probe::irq_handler.exit"></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>probe::irq_handler.entry</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="irq.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 12. Interrupt Request (IRQ) Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-irq-handler-exit.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::irq_handler.entry"><a name="API-irq-handler-entry"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::irq_handler.entry —
- Execution of interrupt handler starting
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">irq_handler.entry </pre></div><div class="refsect1" title="Values"><a name="idp7482928"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev_name</code></em></span></dt><dd><p>
- name of device
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- Flags for IRQ handler
- </p></dd><dt><span class="term"><em class="parameter"><code>dev_id</code></em></span></dt><dd><p>
- Cookie to identify device
- </p></dd><dt><span class="term"><em class="parameter"><code>dir</code></em></span></dt><dd><p>
- pointer to the proc/irq/NN/name entry
- </p></dd><dt><span class="term"><em class="parameter"><code>irq</code></em></span></dt><dd><p>
- irq number
- </p></dd><dt><span class="term"><em class="parameter"><code>next_irqaction</code></em></span></dt><dd><p>
- pointer to next irqaction for shared interrupts
- </p></dd><dt><span class="term"><em class="parameter"><code>thread_flags</code></em></span></dt><dd><p>
- Flags related to thread
- </p></dd><dt><span class="term"><em class="parameter"><code>thread</code></em></span></dt><dd><p>
- thread pointer for threaded interrupts
- </p></dd><dt><span class="term"><em class="parameter"><code>thread_fn</code></em></span></dt><dd><p>
- interrupt handler function for threaded interrupts
- </p></dd><dt><span class="term"><em class="parameter"><code>handler</code></em></span></dt><dd><p>
- interrupt handler function
- </p></dd><dt><span class="term"><em class="parameter"><code>flags_str</code></em></span></dt><dd><p>
- symbolic string representation of IRQ flags
- </p></dd><dt><span class="term"><em class="parameter"><code>action</code></em></span></dt><dd><p>
- struct irqaction* for this interrupt num
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="irq.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="irq.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-irq-handler-exit.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 12. Interrupt Request (IRQ) Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::irq_handler.exit</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::irq_handler.exit</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="irq.stp.html" title="Chapter 12. Interrupt Request (IRQ) Tapset"><link rel="prev" href="API-irq-handler-entry.html" title="probe::irq_handler.entry"><link rel="next" href="API-softirq-entry.html" title="probe::softirq.entry"></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>probe::irq_handler.exit</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-irq-handler-entry.html">Prev</a> </td><th width="60%" align="center">Chapter 12. Interrupt Request (IRQ) Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-softirq-entry.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::irq_handler.exit"><a name="API-irq-handler-exit"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::irq_handler.exit —
- Execution of interrupt handler completed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">irq_handler.exit </pre></div><div class="refsect1" title="Values"><a name="idp7515072"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev_name</code></em></span></dt><dd><p>
- name of device
- </p></dd><dt><span class="term"><em class="parameter"><code>ret</code></em></span></dt><dd><p>
- return value of the handler
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- flags for IRQ handler
- </p></dd><dt><span class="term"><em class="parameter"><code>dev_id</code></em></span></dt><dd><p>
- Cookie to identify device
- </p></dd><dt><span class="term"><em class="parameter"><code>dir</code></em></span></dt><dd><p>
- pointer to the proc/irq/NN/name entry
- </p></dd><dt><span class="term"><em class="parameter"><code>next_irqaction</code></em></span></dt><dd><p>
- pointer to next irqaction for shared interrupts
- </p></dd><dt><span class="term"><em class="parameter"><code>irq</code></em></span></dt><dd><p>
- interrupt number
- </p></dd><dt><span class="term"><em class="parameter"><code>thread_flags</code></em></span></dt><dd><p>
- Flags related to thread
- </p></dd><dt><span class="term"><em class="parameter"><code>thread</code></em></span></dt><dd><p>
- thread pointer for threaded interrupts
- </p></dd><dt><span class="term"><em class="parameter"><code>thread_fn</code></em></span></dt><dd><p>
- interrupt handler function for threaded interrupts
- </p></dd><dt><span class="term"><em class="parameter"><code>flags_str</code></em></span></dt><dd><p>
- symbolic string representation of IRQ flags
- </p></dd><dt><span class="term"><em class="parameter"><code>handler</code></em></span></dt><dd><p>
- interrupt handler function that was executed
- </p></dd><dt><span class="term"><em class="parameter"><code>action</code></em></span></dt><dd><p>
- struct irqaction*
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-irq-handler-entry.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="irq.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-softirq-entry.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::irq_handler.entry</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::softirq.entry</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::is_myproc</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-int-arg.html" title="function::int_arg"><link rel="next" href="API-is-return.html" title="function::is_return"></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::is_myproc</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-int-arg.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-is-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::is_myproc"><a name="API-is-myproc"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::is_myproc —
- Determines if the current probe point has occurred in the user's own process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- is_myproc:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4889712"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp4890864"></a><h2>Description</h2><p>
- This function returns 1 if the current probe
- point has occurred in the user's own process.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-int-arg.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-is-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::int_arg</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::is_return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::is_return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-is-myproc.html" title="function::is_myproc"><link rel="next" href="API-long-arg.html" title="function::long_arg"></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::is_return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-is-myproc.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-long-arg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::is_return"><a name="API-is-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::is_return —
- Whether the current probe context is a return probe
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- is_return:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4898304"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp4899456"></a><h2>Description</h2><p>
- Returns 1 if the current probe context is a return probe,
- returns 0 otherwise.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-is-myproc.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-long-arg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::is_myproc</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::long_arg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::is_sig_blocked</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-get-sa-handler.html" title="function::get_sa_handler"><link rel="next" href="API-sa-flags-str.html" title="function::sa_flags_str"></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::is_sig_blocked</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-get-sa-handler.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sa-flags-str.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::is_sig_blocked"><a name="API-is-sig-blocked"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::is_sig_blocked —
- Returns 1 if the signal is currently blocked, or 0 if it is not
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- is_sig_blocked:long(task:long,sig:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp10441408"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- address of the task_struct to query.
- </p></dd><dt><span class="term"><em class="parameter"><code>sig</code></em></span></dt><dd><p>
- the signal number to test.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-get-sa-handler.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sa-flags-str.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::get_sa_handler</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::sa_flags_str</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::isdigit</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="string.stp.html" title="Chapter 27. A collection of standard string functions"><link rel="prev" href="string.stp.html" title="Chapter 27. A collection of standard string functions"><link rel="next" href="API-isinstr.html" title="function::isinstr"></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::isdigit</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="string.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 27. A collection of standard string functions</th><td width="20%" align="right"> <a accesskey="n" href="API-isinstr.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::isdigit"><a name="API-isdigit"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::isdigit —
- Checks for a digit
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- isdigit:long(str:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11981872"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>str</code></em></span></dt><dd><p>
- string to check
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11985088"></a><h2>Description</h2><p>
- Checks for a digit (0 through 9) as the first
- character of a string. Returns non-zero if true, and a zero if
- false.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="string.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="string.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-isinstr.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 27. A collection of standard string functions </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::isinstr</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::isinstr</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="string.stp.html" title="Chapter 27. A collection of standard string functions"><link rel="prev" href="API-isdigit.html" title="function::isdigit"><link rel="next" href="API-str-replace.html" title="function::str_replace"></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::isinstr</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-isdigit.html">Prev</a> </td><th width="60%" align="center">Chapter 27. A collection of standard string functions</th><td width="20%" align="right"> <a accesskey="n" href="API-str-replace.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::isinstr"><a name="API-isinstr"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::isinstr —
- Returns whether a string is a substring of another string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- isinstr:long(s1:string,s2:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11993136"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>s1</code></em></span></dt><dd><p>
- string to search in
- </p></dd><dt><span class="term"><em class="parameter"><code>s2</code></em></span></dt><dd><p>
- substring to find
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11998336"></a><h2>Description</h2><p>
- This function returns 1 if string <em class="parameter"><code>s1</code></em> contains <em class="parameter"><code>s2</code></em>,
- otherwise zero.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-isdigit.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="string.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-str-replace.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::isdigit</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::str_replace</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::jiffies</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-gettimeofday-us.html" title="function::gettimeofday_us"><link rel="next" href="API-local-clock-ms.html" title="function::local_clock_ms"></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::jiffies</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-gettimeofday-us.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-local-clock-ms.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::jiffies"><a name="API-jiffies"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::jiffies —
- Kernel jiffies count
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- jiffies:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5848768"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5849920"></a><h2>Description</h2><p>
- This function returns the value of the kernel jiffies
- variable. This value is incremented periodically by timer interrupts,
- and may wrap around a 32-bit or 64-bit boundary. See <code class="function">HZ</code>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-gettimeofday-us.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-local-clock-ms.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::gettimeofday_us</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::local_clock_ms</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::kernel_char</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-atomic-read.html" title="function::atomic_read"><link rel="next" href="API-kernel-int.html" title="function::kernel_int"></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::kernel_char</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-atomic-read.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kernel-int.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::kernel_char"><a name="API-kernel-char"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::kernel_char —
- Retrieves a char value stored in kernel memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- kernel_char:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11340768"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to retrieve the char from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11343984"></a><h2>Description</h2><p>
- Returns the char value from a given kernel memory address.
- Reports an error when reading from the given address fails.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-atomic-read.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kernel-int.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::atomic_read</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::kernel_int</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::kernel_int</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-kernel-char.html" title="function::kernel_char"><link rel="next" href="API-kernel-long.html" title="function::kernel_long"></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::kernel_int</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kernel-char.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kernel-long.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::kernel_int"><a name="API-kernel-int"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::kernel_int —
- Retrieves an int value stored in kernel memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- kernel_int:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11351952"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to retrieve the int from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11355168"></a><h2>Description</h2><p>
- Returns the int value from a given kernel memory address.
- Reports an error when reading from the given address fails.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kernel-char.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kernel-long.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::kernel_char</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::kernel_long</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::kernel_long</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-kernel-int.html" title="function::kernel_int"><link rel="next" href="API-kernel-pointer.html" title="function::kernel_pointer"></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::kernel_long</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kernel-int.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kernel-pointer.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::kernel_long"><a name="API-kernel-long"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::kernel_long —
- Retrieves a long value stored in kernel memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- kernel_long:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11363248"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to retrieve the long from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11366464"></a><h2>Description</h2><p>
- Returns the long value from a given kernel memory address.
- Reports an error when reading from the given address fails.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kernel-int.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kernel-pointer.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::kernel_int</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::kernel_pointer</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::kernel_pointer</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-kernel-long.html" title="function::kernel_long"><link rel="next" href="API-kernel-short.html" title="function::kernel_short"></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::kernel_pointer</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kernel-long.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kernel-short.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::kernel_pointer"><a name="API-kernel-pointer"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::kernel_pointer —
- Retrieves a pointer value stored in kernel memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- kernel_pointer:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11374544"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to retrieve the pointer from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11377776"></a><h2>Description</h2><p>
- Returns the pointer value from a given kernel memory
- address. Reports an error when reading from the given address
- fails.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kernel-long.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kernel-short.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::kernel_long</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::kernel_short</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::kernel_short</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-kernel-pointer.html" title="function::kernel_pointer"><link rel="next" href="API-kernel-string.html" title="function::kernel_string"></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::kernel_short</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kernel-pointer.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kernel-string.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::kernel_short"><a name="API-kernel-short"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::kernel_short —
- Retrieves a short value stored in kernel memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- kernel_short:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11385856"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to retrieve the short from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11389088"></a><h2>Description</h2><p>
- Returns the short value from a given kernel memory address.
- Reports an error when reading from the given address fails.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kernel-pointer.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kernel-string.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::kernel_pointer</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::kernel_string</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::kernel_string_n</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-kernel-string2-utf32.html" title="function::kernel_string2_utf32"><link rel="next" href="API-kernel-string-utf16.html" title="function::kernel_string_utf16"></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::kernel_string_n</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kernel-string2-utf32.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kernel-string-utf16.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::kernel_string_n"><a name="API-kernel-string-n"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::kernel_string_n —
- Retrieves string of given length from kernel memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- kernel_string_n:string(addr:long,n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11449056"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to retrieve the string from
- </p></dd><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- The maximum length of the string (if not null terminated)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11454304"></a><h2>Description</h2><p>
- Returns the C string of a maximum given length from a
- given kernel memory address. Reports an error on string copy fault.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kernel-string2-utf32.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kernel-string-utf16.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::kernel_string2_utf32</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::kernel_string_utf16</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::kernel_string_utf16</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-kernel-string-n.html" title="function::kernel_string_n"><link rel="next" href="API-kernel-string-utf32.html" title="function::kernel_string_utf32"></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::kernel_string_utf16</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kernel-string-n.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kernel-string-utf32.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::kernel_string_utf16"><a name="API-kernel-string-utf16"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::kernel_string_utf16 —
- Retrieves UTF-16 string from kernel memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- kernel_string_utf16:string(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11462432"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to retrieve the string from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11465664"></a><h2>Description</h2><p>
- This function returns a null terminated UTF-8 string converted
- from the UTF-16 string at a given kernel memory address. Reports an error on
- string copy fault or conversion error.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kernel-string-n.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kernel-string-utf32.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::kernel_string_n</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::kernel_string_utf32</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::kernel_string_utf32</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-kernel-string-utf16.html" title="function::kernel_string_utf16"><link rel="next" href="API-user-char.html" title="function::user_char"></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::kernel_string_utf32</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kernel-string-utf16.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-char.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::kernel_string_utf32"><a name="API-kernel-string-utf32"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::kernel_string_utf32 —
- Retrieves UTF-32 string from kernel memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- kernel_string_utf32:string(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11473856"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to retrieve the string from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11477088"></a><h2>Description</h2><p>
- This function returns a null terminated UTF-8 string converted
- from the UTF-32 string at a given kernel memory address. Reports an error on
- string copy fault or conversion error.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kernel-string-utf16.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-char.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::kernel_string_utf16</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::user_char</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::kernel_string</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-kernel-short.html" title="function::kernel_short"><link rel="next" href="API-kernel-string2.html" title="function::kernel_string2"></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::kernel_string</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kernel-short.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kernel-string2.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::kernel_string"><a name="API-kernel-string"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::kernel_string —
- Retrieves string from kernel memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- kernel_string:string(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11397120"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to retrieve the string from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11400352"></a><h2>Description</h2><p>
- This function returns the null terminated C string
- from a given kernel memory address. Reports an error on string
- copy fault.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kernel-short.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kernel-string2.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::kernel_short</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::kernel_string2</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::kernel_string2_utf16</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-kernel-string2.html" title="function::kernel_string2"><link rel="next" href="API-kernel-string2-utf32.html" title="function::kernel_string2_utf32"></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::kernel_string2_utf16</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kernel-string2.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kernel-string2-utf32.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::kernel_string2_utf16"><a name="API-kernel-string2-utf16"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::kernel_string2_utf16 —
- Retrieves UTF-16 string from kernel memory with alternative error string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- kernel_string2_utf16:string(addr:long,err_msg:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11421984"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to retrieve the string from
- </p></dd><dt><span class="term"><em class="parameter"><code>err_msg</code></em></span></dt><dd><p>
- The error message to return when data isn't available
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11427264"></a><h2>Description</h2><p>
- This function returns a null terminated UTF-8 string converted
- from the UTF-16 string at a given kernel memory address. Reports the given
- error message on string copy fault or conversion error.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kernel-string2.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kernel-string2-utf32.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::kernel_string2</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::kernel_string2_utf32</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::kernel_string2_utf32</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-kernel-string2-utf16.html" title="function::kernel_string2_utf16"><link rel="next" href="API-kernel-string-n.html" title="function::kernel_string_n"></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::kernel_string2_utf32</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kernel-string2-utf16.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kernel-string-n.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::kernel_string2_utf32"><a name="API-kernel-string2-utf32"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::kernel_string2_utf32 —
- Retrieves UTF-32 string from kernel memory with alternative error string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- kernel_string2_utf32:string(addr:long,err_msg:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11435552"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to retrieve the string from
- </p></dd><dt><span class="term"><em class="parameter"><code>err_msg</code></em></span></dt><dd><p>
- The error message to return when data isn't available
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11440832"></a><h2>Description</h2><p>
- This function returns a null terminated UTF-8 string converted
- from the UTF-32 string at a given kernel memory address. Reports the given
- error message on string copy fault or conversion error.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kernel-string2-utf16.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kernel-string-n.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::kernel_string2_utf16</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::kernel_string_n</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::kernel_string2</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-kernel-string.html" title="function::kernel_string"><link rel="next" href="API-kernel-string2-utf16.html" title="function::kernel_string2_utf16"></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::kernel_string2</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kernel-string.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kernel-string2-utf16.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::kernel_string2"><a name="API-kernel-string2"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::kernel_string2 —
- Retrieves string from kernel memory with alternative error string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- kernel_string2:string(addr:long,err_msg:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11408480"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to retrieve the string from
- </p></dd><dt><span class="term"><em class="parameter"><code>err_msg</code></em></span></dt><dd><p>
- The error message to return when data isn't available
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11413760"></a><h2>Description</h2><p>
- This function returns the null terminated C string
- from a given kernel memory address. Reports the given error message
- on string copy fault.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kernel-string.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kernel-string2-utf16.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::kernel_string</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::kernel_string2_utf16</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::kprocess.create</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="kprocess.stp.html" title="Chapter 16. Kernel Process Tapset"><link rel="prev" href="API-target-set-report.html" title="function::target_set_report"><link rel="next" href="API-kprocess-exec.html" title="probe::kprocess.exec"></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>probe::kprocess.create</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-target-set-report.html">Prev</a> </td><th width="60%" align="center">Chapter 16. Kernel Process Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kprocess-exec.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::kprocess.create"><a name="API-kprocess-create"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::kprocess.create —
- Fires whenever a new process or thread is successfully created
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">kprocess.create </pre></div><div class="refsect1" title="Values"><a name="idp10336160"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>new_tid</code></em></span></dt><dd><p>
- The TID of the newly created task
- </p></dd><dt><span class="term"><em class="parameter"><code>new_pid</code></em></span></dt><dd><p>
- The PID of the newly created process
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp10341408"></a><h2>Context</h2><p>
- Parent of the created process.
-</p></div><div class="refsect1" title="Description"><a name="idp10342640"></a><h2>Description</h2><p>
- Fires whenever a new process is successfully created, either as a result of
- fork (or one of its syscall variants), or a new kernel thread.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-target-set-report.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="kprocess.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kprocess-exec.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::target_set_report</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::kprocess.exec</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::kprocess.exec_complete</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="kprocess.stp.html" title="Chapter 16. Kernel Process Tapset"><link rel="prev" href="API-kprocess-exec.html" title="probe::kprocess.exec"><link rel="next" href="API-kprocess-exit.html" title="probe::kprocess.exit"></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>probe::kprocess.exec_complete</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kprocess-exec.html">Prev</a> </td><th width="60%" align="center">Chapter 16. Kernel Process Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kprocess-exit.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::kprocess.exec_complete"><a name="API-kprocess-exec-complete"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::kprocess.exec_complete —
- Return from exec to a new program
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">kprocess.exec_complete </pre></div><div class="refsect1" title="Values"><a name="idp10363232"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>success</code></em></span></dt><dd><p>
- A boolean indicating whether the exec was successful
- </p></dd><dt><span class="term"><em class="parameter"><code>errno</code></em></span></dt><dd><p>
- The error number resulting from the exec
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp10368496"></a><h2>Context</h2><p>
- On success, the context of the new executable.
- On failure, remains in the context of the caller.
-</p></div><div class="refsect1" title="Description"><a name="idp10369808"></a><h2>Description</h2><p>
- Fires at the completion of an exec call.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kprocess-exec.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="kprocess.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kprocess-exit.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::kprocess.exec</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::kprocess.exit</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::kprocess.exec</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="kprocess.stp.html" title="Chapter 16. Kernel Process Tapset"><link rel="prev" href="API-kprocess-create.html" title="probe::kprocess.create"><link rel="next" href="API-kprocess-exec-complete.html" title="probe::kprocess.exec_complete"></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>probe::kprocess.exec</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kprocess-create.html">Prev</a> </td><th width="60%" align="center">Chapter 16. Kernel Process Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kprocess-exec-complete.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::kprocess.exec"><a name="API-kprocess-exec"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::kprocess.exec —
- Attempt to exec to a new program
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">kprocess.exec </pre></div><div class="refsect1" title="Values"><a name="idp10350720"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>filename</code></em></span></dt><dd><p>
- The path to the new executable
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp10353936"></a><h2>Context</h2><p>
- The caller of exec.
-</p></div><div class="refsect1" title="Description"><a name="idp10355168"></a><h2>Description</h2><p>
- Fires whenever a process attempts to exec to a new program.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kprocess-create.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="kprocess.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kprocess-exec-complete.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::kprocess.create</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::kprocess.exec_complete</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::kprocess.exit</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="kprocess.stp.html" title="Chapter 16. Kernel Process Tapset"><link rel="prev" href="API-kprocess-exec-complete.html" title="probe::kprocess.exec_complete"><link rel="next" href="API-kprocess-release.html" title="probe::kprocess.release"></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>probe::kprocess.exit</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kprocess-exec-complete.html">Prev</a> </td><th width="60%" align="center">Chapter 16. Kernel Process Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kprocess-release.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::kprocess.exit"><a name="API-kprocess-exit"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::kprocess.exit —
- Exit from process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">kprocess.exit </pre></div><div class="refsect1" title="Values"><a name="idp10377776"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>code</code></em></span></dt><dd><p>
- The exit code of the process
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp10380976"></a><h2>Context</h2><p>
- The process which is terminating.
-</p></div><div class="refsect1" title="Description"><a name="idp10382208"></a><h2>Description</h2><p>
- Fires when a process terminates. This will always be followed by a
- kprocess.release, though the latter may be delayed if the process waits in a
- zombie state.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kprocess-exec-complete.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="kprocess.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kprocess-release.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::kprocess.exec_complete</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::kprocess.release</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::kprocess.release</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="kprocess.stp.html" title="Chapter 16. Kernel Process Tapset"><link rel="prev" href="API-kprocess-exit.html" title="probe::kprocess.exit"><link rel="next" href="API-kprocess-start.html" title="probe::kprocess.start"></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>probe::kprocess.release</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kprocess-exit.html">Prev</a> </td><th width="60%" align="center">Chapter 16. Kernel Process Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kprocess-start.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::kprocess.release"><a name="API-kprocess-release"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::kprocess.release —
- Process released
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">kprocess.release </pre></div><div class="refsect1" title="Values"><a name="idp10390304"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>pid</code></em></span></dt><dd><p>
- Same as <em class="parameter"><code>released_pid</code></em> for compatibility (deprecated)
- </p></dd><dt><span class="term"><em class="parameter"><code>released_pid</code></em></span></dt><dd><p>
- PID of the process being released
- </p></dd><dt><span class="term"><em class="parameter"><code>released_tid</code></em></span></dt><dd><p>
- TID of the task being released
- </p></dd><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- A task handle to the process being released
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp10400288"></a><h2>Context</h2><p>
- The context of the parent, if it wanted notification of this process'
- termination, else the context of the process itself.
-</p></div><div class="refsect1" title="Description"><a name="idp10401616"></a><h2>Description</h2><p>
- Fires when a process is released from the kernel. This always follows a
- kprocess.exit, though it may be delayed somewhat if the process waits in a
- zombie state.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kprocess-exit.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="kprocess.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kprocess-start.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::kprocess.exit</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::kprocess.start</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::kprocess.start</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="kprocess.stp.html" title="Chapter 16. Kernel Process Tapset"><link rel="prev" href="API-kprocess-release.html" title="probe::kprocess.release"><link rel="next" href="signal.stp.html" title="Chapter 17. Signal Tapset"></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>probe::kprocess.start</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kprocess-release.html">Prev</a> </td><th width="60%" align="center">Chapter 16. Kernel Process Tapset</th><td width="20%" align="right"> <a accesskey="n" href="signal.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::kprocess.start"><a name="API-kprocess-start"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::kprocess.start —
- Starting new process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">kprocess.start </pre></div><div class="refsect1" title="Values"><a name="idp10409712"></a><h2>Values</h2><p>
- None
- </p></div><div class="refsect1" title="Context"><a name="idp10410928"></a><h2>Context</h2><p>
- Newly created process.
-</p></div><div class="refsect1" title="Description"><a name="idp10412160"></a><h2>Description</h2><p>
- Fires immediately before a new process begins execution.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kprocess-release.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="kprocess.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="signal.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::kprocess.release</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 17. Signal Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::linuxmib.DelayedACKs</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-ipmib-ReasmTimeout.html" title="probe::ipmib.ReasmTimeout"><link rel="next" href="API-linuxmib-ListenDrops.html" title="probe::linuxmib.ListenDrops"></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>probe::linuxmib.DelayedACKs</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ipmib-ReasmTimeout.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-linuxmib-ListenDrops.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::linuxmib.DelayedACKs"><a name="API-linuxmib-DelayedACKs"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::linuxmib.DelayedACKs —
- Count of delayed acks
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">linuxmib.DelayedACKs </pre></div><div class="refsect1" title="Values"><a name="idp10112272"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- Pointer to the struct sock being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- Value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10117472"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">linuxmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>DelayedACKs</code></em> (equivalent to SNMP's MIB
- LINUX_MIB_DELAYEDACKS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ipmib-ReasmTimeout.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-linuxmib-ListenDrops.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ipmib.ReasmTimeout</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::linuxmib.ListenDrops</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::linuxmib.ListenDrops</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-linuxmib-DelayedACKs.html" title="probe::linuxmib.DelayedACKs"><link rel="next" href="API-linuxmib-ListenOverflows.html" title="probe::linuxmib.ListenOverflows"></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>probe::linuxmib.ListenDrops</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-linuxmib-DelayedACKs.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-linuxmib-ListenOverflows.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::linuxmib.ListenDrops"><a name="API-linuxmib-ListenDrops"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::linuxmib.ListenDrops —
- Count of times conn request that were dropped
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">linuxmib.ListenDrops </pre></div><div class="refsect1" title="Values"><a name="idp10127728"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- Pointer to the struct sock being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- Value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10132928"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">linuxmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>ListenDrops</code></em> (equivalent to SNMP's MIB
- LINUX_MIB_LISTENDROPS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-linuxmib-DelayedACKs.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-linuxmib-ListenOverflows.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::linuxmib.DelayedACKs</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::linuxmib.ListenOverflows</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::linuxmib.ListenOverflows</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-linuxmib-ListenDrops.html" title="probe::linuxmib.ListenDrops"><link rel="next" href="API-linuxmib-TCPMemoryPressures.html" title="probe::linuxmib.TCPMemoryPressures"></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>probe::linuxmib.ListenOverflows</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-linuxmib-ListenDrops.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-linuxmib-TCPMemoryPressures.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::linuxmib.ListenOverflows"><a name="API-linuxmib-ListenOverflows"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::linuxmib.ListenOverflows —
- Count of times a listen queue overflowed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">linuxmib.ListenOverflows </pre></div><div class="refsect1" title="Values"><a name="idp10143200"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- Pointer to the struct sock being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- Value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10148400"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">linuxmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>ListenOverflows</code></em> (equivalent to SNMP's MIB
- LINUX_MIB_LISTENOVERFLOWS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-linuxmib-ListenDrops.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-linuxmib-TCPMemoryPressures.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::linuxmib.ListenDrops</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::linuxmib.TCPMemoryPressures</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::linuxmib.TCPMemoryPressures</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-linuxmib-ListenOverflows.html" title="probe::linuxmib.ListenOverflows"><link rel="next" href="API-tcpmib-ActiveOpens.html" title="probe::tcpmib.ActiveOpens"></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>probe::linuxmib.TCPMemoryPressures</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-linuxmib-ListenOverflows.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcpmib-ActiveOpens.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::linuxmib.TCPMemoryPressures"><a name="API-linuxmib-TCPMemoryPressures"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::linuxmib.TCPMemoryPressures —
- Count of times memory pressure was used
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">linuxmib.TCPMemoryPressures </pre></div><div class="refsect1" title="Values"><a name="idp10158576"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- Pointer to the struct sock being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- Value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10163776"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">linuxmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>TCPMemoryPressures</code></em> (equivalent to SNMP's MIB
- LINUX_MIB_TCPMEMORYPRESSURES)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-linuxmib-ListenOverflows.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcpmib-ActiveOpens.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::linuxmib.ListenOverflows</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcpmib.ActiveOpens</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::linuxmib_filter_key</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-ipmib-tcp-remote-port.html" title="function::ipmib_tcp_remote_port"><link rel="next" href="API-tcpmib-filter-key.html" title="function::tcpmib_filter_key"></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::linuxmib_filter_key</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ipmib-tcp-remote-port.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcpmib-filter-key.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::linuxmib_filter_key"><a name="API-linuxmib-filter-key"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::linuxmib_filter_key —
- Default filter function for linuxmib.* probes
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- linuxmib_filter_key:long(sk:long,op:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9856256"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- pointer to the struct sock
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be counted if <em class="parameter"><code>sk</code></em> passes the filter
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp9862096"></a><h2>Description</h2><p>
- This function is a default filter function.
- The user can replace this function with their own.
- The user-supplied filter function returns an index key based on the values
- in <em class="parameter"><code>sk</code></em>.
- A return value of 0 means this particular <em class="parameter"><code>sk</code></em> should be not be counted.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ipmib-tcp-remote-port.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcpmib-filter-key.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ipmib_tcp_remote_port</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::tcpmib_filter_key</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::local_clock_ms</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-jiffies.html" title="function::jiffies"><link rel="next" href="API-local-clock-ns.html" title="function::local_clock_ns"></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::local_clock_ms</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-jiffies.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-local-clock-ns.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::local_clock_ms"><a name="API-local-clock-ms"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::local_clock_ms —
- Number of milliseconds on the local cpu's clock
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- local_clock_ms:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5858000"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5859152"></a><h2>Description</h2><p>
- This function returns the number of milliseconds on the local
- cpu's clock. This is always monotonic comparing on the same cpu, but may
- have some drift between cpus (within about a jiffy).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-jiffies.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-local-clock-ns.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::jiffies</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::local_clock_ns</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::local_clock_ns</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-local-clock-ms.html" title="function::local_clock_ms"><link rel="next" href="API-local-clock-s.html" title="function::local_clock_s"></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::local_clock_ns</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-local-clock-ms.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-local-clock-s.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::local_clock_ns"><a name="API-local-clock-ns"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::local_clock_ns —
- Number of nanoseconds on the local cpu's clock
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- local_clock_ns:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5866608"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5867760"></a><h2>Description</h2><p>
- This function returns the number of nanoseconds on the local
- cpu's clock. This is always monotonic comparing on the same cpu, but may
- have some drift between cpus (within about a jiffy).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-local-clock-ms.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-local-clock-s.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::local_clock_ms</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::local_clock_s</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::local_clock_s</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-local-clock-ns.html" title="function::local_clock_ns"><link rel="next" href="API-local-clock-us.html" title="function::local_clock_us"></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::local_clock_s</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-local-clock-ns.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-local-clock-us.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::local_clock_s"><a name="API-local-clock-s"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::local_clock_s —
- Number of seconds on the local cpu's clock
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- local_clock_s:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5875216"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5876368"></a><h2>Description</h2><p>
- This function returns the number of seconds on the local cpu's
- clock. This is always monotonic comparing on the same cpu, but may have
- some drift between cpus (within about a jiffy).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-local-clock-ns.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-local-clock-us.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::local_clock_ns</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::local_clock_us</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::local_clock_us</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-local-clock-s.html" title="function::local_clock_s"><link rel="next" href="API-read-stopwatch-ms.html" title="function::read_stopwatch_ms"></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::local_clock_us</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-local-clock-s.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-read-stopwatch-ms.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::local_clock_us"><a name="API-local-clock-us"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::local_clock_us —
- Number of microseconds on the local cpu's clock
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- local_clock_us:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5883824"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5884976"></a><h2>Description</h2><p>
- This function returns the number of microseconds on the local
- cpu's clock. This is always monotonic comparing on the same cpu, but may
- have some drift between cpus (within about a jiffy).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-local-clock-s.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-read-stopwatch-ms.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::local_clock_s</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::read_stopwatch_ms</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::log</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="logging.stp.html" title="Chapter 21. Logging Tapset"><link rel="prev" href="API-ftrace.html" title="function::ftrace"><link rel="next" href="API-printk.html" title="function::printk"></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::log</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ftrace.html">Prev</a> </td><th width="60%" align="center">Chapter 21. Logging Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-printk.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::log"><a name="API-log"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::log —
- Send a line to the common trace buffer
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- log(msg:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11129072"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>msg</code></em></span></dt><dd><p>
- The formatted message string
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11132240"></a><h2>Description</h2><p>
- This function logs data. log sends the
- message immediately to staprun and to the bulk transport
- (relayfs) if it is being used. If the last character given
- is not a newline, then one is added. This function is not
- as effecient as printf and should be used only for urgent
- messages.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ftrace.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="logging.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-printk.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ftrace</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::printk</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::long_arg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-is-return.html" title="function::is_return"><link rel="next" href="API-longlong-arg.html" title="function::longlong_arg"></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::long_arg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-is-return.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-longlong-arg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::long_arg"><a name="API-long-arg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::long_arg —
- Return function argument as signed long
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- long_arg:long(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4906800"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- index of argument to return
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp4909856"></a><h2>Description</h2><p>
- Return the value of argument n as a signed long.
- On architectures where a long is 32 bits, the value is sign-extended
- to 64 bits.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-is-return.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-longlong-arg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::is_return</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::longlong_arg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::longlong_arg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-long-arg.html" title="function::long_arg"><link rel="next" href="API-modname.html" title="function::modname"></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::longlong_arg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-long-arg.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-modname.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::longlong_arg"><a name="API-longlong-arg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::longlong_arg —
- Return function argument as 64-bit value
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- longlong_arg:long(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4917264"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- index of argument to return
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp4920320"></a><h2>Description</h2><p>
- Return the value of argument n as a 64-bit value.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-long-arg.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-modname.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::long_arg</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::modname</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::mdelay</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="guru-delay.stp.html" title="Chapter 26. Guru tapsets"><link rel="prev" href="guru-delay.stp.html" title="Chapter 26. Guru tapsets"><link rel="next" href="API-panic.html" title="function::panic"></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::mdelay</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="guru-delay.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 26. Guru tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-panic.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::mdelay"><a name="API-mdelay"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::mdelay —
- millisecond delay
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- mdelay(ms:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11945904"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ms</code></em></span></dt><dd><p>
- Number of milliseconds to delay.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11949136"></a><h2>Description</h2><p>
- This function inserts a multi-millisecond busy-delay into a probe handler.
- It requires guru mode.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="guru-delay.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="guru-delay.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-panic.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 26. Guru tapsets </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::panic</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::mem_page_size</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-bytes-to-string.html" title="function::bytes_to_string"><link rel="next" href="API-pages-to-string.html" title="function::pages_to_string"></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::mem_page_size</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-bytes-to-string.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-pages-to-string.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::mem_page_size"><a name="API-mem-page-size"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::mem_page_size —
- Number of bytes in a page for this architecture
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- mem_page_size:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6044384"></a><h2>Arguments</h2><p>
- None
- </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-bytes-to-string.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-pages-to-string.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::bytes_to_string</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::pages_to_string</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::modname</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-longlong-arg.html" title="function::longlong_arg"><link rel="next" href="API-module-name.html" title="function::module_name"></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::modname</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-longlong-arg.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-module-name.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::modname"><a name="API-modname"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::modname —
- Return the kernel module name loaded at the address
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- modname:string(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4927648"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The address to map to a kernel module name
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp4930704"></a><h2>Description</h2><p>
- Returns the module name associated with the given
- address if known. If not known it will raise an error. If the
- address was not in a kernel module, but in the kernel itself, then
- the string <span class="quote">“<span class="quote">kernel</span>”</span> will be returned.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-longlong-arg.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-module-name.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::longlong_arg</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::module_name</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::module_name</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-modname.html" title="function::modname"><link rel="next" href="API-pexecname.html" title="function::pexecname"></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::module_name</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-modname.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-pexecname.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::module_name"><a name="API-module-name"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::module_name —
- The module name of the current script
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- module_name:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4938560"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp4939712"></a><h2>Description</h2><p>
- This function returns the name of the stap module.
- Either generated randomly (stap_[0-9a-f]+_[0-9a-f]+)
- or set by stap -m <module_name>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-modname.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-pexecname.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::modname</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::pexecname</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::msecs_to_string</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="task_time_stp.html" title="Chapter 7. Task Time Tapset"><link rel="prev" href="API-cputime-to-string.html" title="function::cputime_to_string"><link rel="next" href="API-task-stime.html" title="function::task_stime"></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::msecs_to_string</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-cputime-to-string.html">Prev</a> </td><th width="60%" align="center">Chapter 7. Task Time Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-task-stime.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::msecs_to_string"><a name="API-msecs-to-string"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::msecs_to_string —
- Human readable string for given milliseconds
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- msecs_to_string:string(msecs:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6447680"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>msecs</code></em></span></dt><dd><p>
- Number of milliseconds to translate.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp6450896"></a><h2>Description</h2><p>
- Returns a string representing the number of
- milliseconds as a human readable string consisting of <span class="quote">“<span class="quote">XmY.ZZZs</span>”</span>,
- where X is the number of minutes, Y is the number of seconds and
- ZZZ is the number of milliseconds.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-cputime-to-string.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="task_time_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-task-stime.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::cputime_to_string</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::task_stime</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netdev.change_mac</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-ntohs.html" title="function::ntohs"><link rel="next" href="API-netdev-change-mtu.html" title="probe::netdev.change_mtu"></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>probe::netdev.change_mac</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ntohs.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netdev-change-mtu.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netdev.change_mac"><a name="API-netdev-change-mac"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netdev.change_mac —
- Called when the netdev_name has the MAC changed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netdev.change_mac </pre></div><div class="refsect1" title="Values"><a name="idp7713424"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev_name</code></em></span></dt><dd><p>
- The device that will have the MAC changed
- </p></dd><dt><span class="term"><em class="parameter"><code>new_mac</code></em></span></dt><dd><p>
- The new MAC address
- </p></dd><dt><span class="term"><em class="parameter"><code>mac_len</code></em></span></dt><dd><p>
- The MAC length
- </p></dd><dt><span class="term"><em class="parameter"><code>old_mac</code></em></span></dt><dd><p>
- The current MAC address
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ntohs.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netdev-change-mtu.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ntohs</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netdev.change_mtu</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netdev.change_mtu</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netdev-change-mac.html" title="probe::netdev.change_mac"><link rel="next" href="API-netdev-change-rx-flag.html" title="probe::netdev.change_rx_flag"></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>probe::netdev.change_mtu</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netdev-change-mac.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netdev-change-rx-flag.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netdev.change_mtu"><a name="API-netdev-change-mtu"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netdev.change_mtu —
- Called when the netdev MTU is changed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netdev.change_mtu </pre></div><div class="refsect1" title="Values"><a name="idp7729392"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev_name</code></em></span></dt><dd><p>
- The device that will have the MTU changed
- </p></dd><dt><span class="term"><em class="parameter"><code>new_mtu</code></em></span></dt><dd><p>
- The new MTU
- </p></dd><dt><span class="term"><em class="parameter"><code>old_mtu</code></em></span></dt><dd><p>
- The current MTU
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netdev-change-mac.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netdev-change-rx-flag.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netdev.change_mac</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netdev.change_rx_flag</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netdev.change_rx_flag</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netdev-change-mtu.html" title="probe::netdev.change_mtu"><link rel="next" href="API-netdev-close.html" title="probe::netdev.close"></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>probe::netdev.change_rx_flag</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netdev-change-mtu.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netdev-close.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netdev.change_rx_flag"><a name="API-netdev-change-rx-flag"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netdev.change_rx_flag —
- Called when the device RX flag will be changed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netdev.change_rx_flag </pre></div><div class="refsect1" title="Values"><a name="idp7743376"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev_name</code></em></span></dt><dd><p>
- The device that will be changed
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- The new flags
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netdev-change-mtu.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netdev-close.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netdev.change_mtu</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netdev.close</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netdev.close</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netdev-change-rx-flag.html" title="probe::netdev.change_rx_flag"><link rel="next" href="API-netdev-get-stats.html" title="probe::netdev.get_stats"></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>probe::netdev.close</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netdev-change-rx-flag.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netdev-get-stats.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netdev.close"><a name="API-netdev-close"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netdev.close —
- Called when the device is closed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netdev.close </pre></div><div class="refsect1" title="Values"><a name="idp7755344"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev_name</code></em></span></dt><dd><p>
- The device that is going to be closed
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netdev-change-rx-flag.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netdev-get-stats.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netdev.change_rx_flag</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netdev.get_stats</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netdev.get_stats</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netdev-close.html" title="probe::netdev.close"><link rel="next" href="API-netdev-hard-transmit.html" title="probe::netdev.hard_transmit"></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>probe::netdev.get_stats</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netdev-close.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netdev-hard-transmit.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netdev.get_stats"><a name="API-netdev-get-stats"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netdev.get_stats —
- Called when someone asks the device statistics
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netdev.get_stats </pre></div><div class="refsect1" title="Values"><a name="idp7765232"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev_name</code></em></span></dt><dd><p>
- The device that is going to provide the statistics
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netdev-close.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netdev-hard-transmit.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netdev.close</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netdev.hard_transmit</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netdev.hard_transmit</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netdev-get-stats.html" title="probe::netdev.get_stats"><link rel="next" href="API-netdev-ioctl.html" title="probe::netdev.ioctl"></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>probe::netdev.hard_transmit</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netdev-get-stats.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netdev-ioctl.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netdev.hard_transmit"><a name="API-netdev-hard-transmit"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netdev.hard_transmit —
- Called when the devices is going to TX (hard)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netdev.hard_transmit </pre></div><div class="refsect1" title="Values"><a name="idp7775216"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- The protocol used in the transmission
- </p></dd><dt><span class="term"><em class="parameter"><code>dev_name</code></em></span></dt><dd><p>
- The device scheduled to transmit
- </p></dd><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- The length of the transmit buffer.
- </p></dd><dt><span class="term"><em class="parameter"><code>truesize</code></em></span></dt><dd><p>
- The size of the data to be transmitted.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netdev-get-stats.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netdev-ioctl.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netdev.get_stats</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netdev.ioctl</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netdev.ioctl</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netdev-hard-transmit.html" title="probe::netdev.hard_transmit"><link rel="next" href="API-netdev-open.html" title="probe::netdev.open"></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>probe::netdev.ioctl</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netdev-hard-transmit.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netdev-open.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netdev.ioctl"><a name="API-netdev-ioctl"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netdev.ioctl —
- Called when the device suffers an IOCTL
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netdev.ioctl </pre></div><div class="refsect1" title="Values"><a name="idp7791264"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>cmd</code></em></span></dt><dd><p>
- The IOCTL request
- </p></dd><dt><span class="term"><em class="parameter"><code>arg</code></em></span></dt><dd><p>
- The IOCTL argument (usually the netdev interface)
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netdev-hard-transmit.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netdev-open.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netdev.hard_transmit</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netdev.open</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netdev.open</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netdev-ioctl.html" title="probe::netdev.ioctl"><link rel="next" href="API-netdev-receive.html" title="probe::netdev.receive"></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>probe::netdev.open</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netdev-ioctl.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netdev-receive.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netdev.open"><a name="API-netdev-open"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netdev.open —
- Called when the device is opened
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netdev.open </pre></div><div class="refsect1" title="Values"><a name="idp7803184"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev_name</code></em></span></dt><dd><p>
- The device that is going to be opened
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netdev-ioctl.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netdev-receive.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netdev.ioctl</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netdev.receive</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netdev.receive</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netdev-open.html" title="probe::netdev.open"><link rel="next" href="API-netdev-register.html" title="probe::netdev.register"></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>probe::netdev.receive</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netdev-open.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netdev-register.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netdev.receive"><a name="API-netdev-receive"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netdev.receive —
- Data received from network device.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netdev.receive </pre></div><div class="refsect1" title="Values"><a name="idp7813008"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol of received packet.
- </p></dd><dt><span class="term"><em class="parameter"><code>dev_name</code></em></span></dt><dd><p>
- The name of the device. e.g: eth0, ath1.
- </p></dd><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- The length of the receiving buffer.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netdev-open.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netdev-register.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netdev.open</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netdev.register</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netdev.register</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netdev-receive.html" title="probe::netdev.receive"><link rel="next" href="API-netdev-rx.html" title="probe::netdev.rx"></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>probe::netdev.register</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netdev-receive.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netdev-rx.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netdev.register"><a name="API-netdev-register"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netdev.register —
- Called when the device is registered
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netdev.register </pre></div><div class="refsect1" title="Values"><a name="idp7826944"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev_name</code></em></span></dt><dd><p>
- The device that is going to be registered
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netdev-receive.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netdev-rx.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netdev.receive</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netdev.rx</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netdev.rx</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netdev-register.html" title="probe::netdev.register"><link rel="next" href="API-netdev-set-promiscuity.html" title="probe::netdev.set_promiscuity"></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>probe::netdev.rx</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netdev-register.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netdev-set-promiscuity.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netdev.rx"><a name="API-netdev-rx"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netdev.rx —
- Called when the device is going to receive a packet
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netdev.rx </pre></div><div class="refsect1" title="Values"><a name="idp7836800"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- The packet protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>dev_name</code></em></span></dt><dd><p>
- The device received the packet
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netdev-register.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netdev-set-promiscuity.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netdev.register</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netdev.set_promiscuity</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netdev.set_promiscuity</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netdev-rx.html" title="probe::netdev.rx"><link rel="next" href="API-netdev-transmit.html" title="probe::netdev.transmit"></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>probe::netdev.set_promiscuity</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netdev-rx.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netdev-transmit.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netdev.set_promiscuity"><a name="API-netdev-set-promiscuity"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netdev.set_promiscuity —
- Called when the device enters/leaves promiscuity
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netdev.set_promiscuity </pre></div><div class="refsect1" title="Values"><a name="idp7848848"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev_name</code></em></span></dt><dd><p>
- The device that is entering/leaving promiscuity mode
- </p></dd><dt><span class="term"><em class="parameter"><code>enable</code></em></span></dt><dd><p>
- If the device is entering promiscuity mode
- </p></dd><dt><span class="term"><em class="parameter"><code>inc</code></em></span></dt><dd><p>
- Count the number of promiscuity openers
- </p></dd><dt><span class="term"><em class="parameter"><code>disable</code></em></span></dt><dd><p>
- If the device is leaving promiscuity mode
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netdev-rx.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netdev-transmit.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netdev.rx</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netdev.transmit</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netdev.transmit</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netdev-set-promiscuity.html" title="probe::netdev.set_promiscuity"><link rel="next" href="API-netdev-unregister.html" title="probe::netdev.unregister"></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>probe::netdev.transmit</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netdev-set-promiscuity.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netdev-unregister.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netdev.transmit"><a name="API-netdev-transmit"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netdev.transmit —
- Network device transmitting buffer
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netdev.transmit </pre></div><div class="refsect1" title="Values"><a name="idp7864928"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- The protocol of this packet(defined in include/linux/if_ether.h).
- </p></dd><dt><span class="term"><em class="parameter"><code>dev_name</code></em></span></dt><dd><p>
- The name of the device. e.g: eth0, ath1.
- </p></dd><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- The length of the transmit buffer.
- </p></dd><dt><span class="term"><em class="parameter"><code>truesize</code></em></span></dt><dd><p>
- The size of the data to be transmitted.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netdev-set-promiscuity.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netdev-unregister.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netdev.set_promiscuity</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netdev.unregister</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netdev.unregister</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netdev-transmit.html" title="probe::netdev.transmit"><link rel="next" href="API-netfilter-arp-forward.html" title="probe::netfilter.arp.forward"></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>probe::netdev.unregister</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netdev-transmit.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netfilter-arp-forward.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netdev.unregister"><a name="API-netdev-unregister"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netdev.unregister —
- Called when the device is being unregistered
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netdev.unregister </pre></div><div class="refsect1" title="Values"><a name="idp7880992"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev_name</code></em></span></dt><dd><p>
- The device that is going to be unregistered
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netdev-transmit.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netfilter-arp-forward.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netdev.transmit</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netfilter.arp.forward</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netfilter.arp.forward</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netdev-unregister.html" title="probe::netdev.unregister"><link rel="next" href="API-netfilter-arp-in.html" title="probe::netfilter.arp.in"></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>probe::netfilter.arp.forward</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netdev-unregister.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netfilter-arp-in.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netfilter.arp.forward"><a name="API-netfilter-arp-forward"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netfilter.arp.forward —
- - Called for each ARP packet to be forwarded
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netfilter.arp.forward </pre></div><div class="refsect1" title="Values"><a name="idp7890896"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>indev</code></em></span></dt><dd><p>
- Address of net_device representing input device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_accept</code></em></span></dt><dd><p>
- Constant used to signify an 'accept' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_sha</code></em></span></dt><dd><p>
- Ethernet+IP only (ar_pro==0x800): source hardware (MAC) address
- </p></dd><dt><span class="term"><em class="parameter"><code>pf</code></em></span></dt><dd><p>
- Protocol family -- always <span class="quote">“<span class="quote">arp</span>”</span>
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_sip</code></em></span></dt><dd><p>
- Ethernet+IP only (ar_pro==0x800): source IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_queue</code></em></span></dt><dd><p>
- Constant used to signify a 'queue' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_op</code></em></span></dt><dd><p>
- ARP opcode (command)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stolen</code></em></span></dt><dd><p>
- Constant used to signify a 'stolen' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev_name</code></em></span></dt><dd><p>
- Name of network device packet will be routed to (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_drop</code></em></span></dt><dd><p>
- Constant used to signify a 'drop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_hln</code></em></span></dt><dd><p>
- Length of hardware address
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_pro</code></em></span></dt><dd><p>
- Format of protocol address
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_pln</code></em></span></dt><dd><p>
- Length of protocol address
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_tip</code></em></span></dt><dd><p>
- Ethernet+IP only (ar_pro==0x800): target IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stop</code></em></span></dt><dd><p>
- Constant used to signify a 'stop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>arphdr</code></em></span></dt><dd><p>
- Address of ARP header
- </p></dd><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- The length of the packet buffer contents, in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev</code></em></span></dt><dd><p>
- Address of net_device representing output device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_tha</code></em></span></dt><dd><p>
- Ethernet+IP only (ar_pro==0x800): target hardware (MAC) address
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_data</code></em></span></dt><dd><p>
- Address of ARP packet data region (after the header)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_repeat</code></em></span></dt><dd><p>
- Constant used to signify a 'repeat' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>indev_name</code></em></span></dt><dd><p>
- Name of network device packet was received on (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_hrd</code></em></span></dt><dd><p>
- Format of hardware address
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netdev-unregister.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netfilter-arp-in.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netdev.unregister</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netfilter.arp.in</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netfilter.arp.in</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netfilter-arp-forward.html" title="probe::netfilter.arp.forward"><link rel="next" href="API-netfilter-arp-out.html" title="probe::netfilter.arp.out"></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>probe::netfilter.arp.in</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netfilter-arp-forward.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netfilter-arp-out.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netfilter.arp.in"><a name="API-netfilter-arp-in"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netfilter.arp.in —
- - Called for each incoming ARP packet
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netfilter.arp.in </pre></div><div class="refsect1" title="Values"><a name="idp7945968"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>indev</code></em></span></dt><dd><p>
- Address of net_device representing input device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_accept</code></em></span></dt><dd><p>
- Constant used to signify an 'accept' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_sha</code></em></span></dt><dd><p>
- Ethernet+IP only (ar_pro==0x800): source hardware (MAC) address
- </p></dd><dt><span class="term"><em class="parameter"><code>pf</code></em></span></dt><dd><p>
- Protocol family -- always <span class="quote">“<span class="quote">arp</span>”</span>
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_sip</code></em></span></dt><dd><p>
- Ethernet+IP only (ar_pro==0x800): source IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_queue</code></em></span></dt><dd><p>
- Constant used to signify a 'queue' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_op</code></em></span></dt><dd><p>
- ARP opcode (command)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stolen</code></em></span></dt><dd><p>
- Constant used to signify a 'stolen' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev_name</code></em></span></dt><dd><p>
- Name of network device packet will be routed to (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_drop</code></em></span></dt><dd><p>
- Constant used to signify a 'drop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_hln</code></em></span></dt><dd><p>
- Length of hardware address
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_pro</code></em></span></dt><dd><p>
- Format of protocol address
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_pln</code></em></span></dt><dd><p>
- Length of protocol address
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_tip</code></em></span></dt><dd><p>
- Ethernet+IP only (ar_pro==0x800): target IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stop</code></em></span></dt><dd><p>
- Constant used to signify a 'stop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>arphdr</code></em></span></dt><dd><p>
- Address of ARP header
- </p></dd><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- The length of the packet buffer contents, in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev</code></em></span></dt><dd><p>
- Address of net_device representing output device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_tha</code></em></span></dt><dd><p>
- Ethernet+IP only (ar_pro==0x800): target hardware (MAC) address
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_data</code></em></span></dt><dd><p>
- Address of ARP packet data region (after the header)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_repeat</code></em></span></dt><dd><p>
- Constant used to signify a 'repeat' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>indev_name</code></em></span></dt><dd><p>
- Name of network device packet was received on (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_hrd</code></em></span></dt><dd><p>
- Format of hardware address
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netfilter-arp-forward.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netfilter-arp-out.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netfilter.arp.forward</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netfilter.arp.out</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netfilter.arp.out</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netfilter-arp-in.html" title="probe::netfilter.arp.in"><link rel="next" href="API-netfilter-bridge-forward.html" title="probe::netfilter.bridge.forward"></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>probe::netfilter.arp.out</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netfilter-arp-in.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netfilter-bridge-forward.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netfilter.arp.out"><a name="API-netfilter-arp-out"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netfilter.arp.out —
- - Called for each outgoing ARP packet
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netfilter.arp.out </pre></div><div class="refsect1" title="Values"><a name="idp8001120"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>indev</code></em></span></dt><dd><p>
- Address of net_device representing input device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_accept</code></em></span></dt><dd><p>
- Constant used to signify an 'accept' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_sha</code></em></span></dt><dd><p>
- Ethernet+IP only (ar_pro==0x800): source hardware (MAC) address
- </p></dd><dt><span class="term"><em class="parameter"><code>pf</code></em></span></dt><dd><p>
- Protocol family -- always <span class="quote">“<span class="quote">arp</span>”</span>
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_sip</code></em></span></dt><dd><p>
- Ethernet+IP only (ar_pro==0x800): source IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_queue</code></em></span></dt><dd><p>
- Constant used to signify a 'queue' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_op</code></em></span></dt><dd><p>
- ARP opcode (command)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stolen</code></em></span></dt><dd><p>
- Constant used to signify a 'stolen' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev_name</code></em></span></dt><dd><p>
- Name of network device packet will be routed to (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_drop</code></em></span></dt><dd><p>
- Constant used to signify a 'drop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_hln</code></em></span></dt><dd><p>
- Length of hardware address
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_pro</code></em></span></dt><dd><p>
- Format of protocol address
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_pln</code></em></span></dt><dd><p>
- Length of protocol address
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_tip</code></em></span></dt><dd><p>
- Ethernet+IP only (ar_pro==0x800): target IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stop</code></em></span></dt><dd><p>
- Constant used to signify a 'stop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>arphdr</code></em></span></dt><dd><p>
- Address of ARP header
- </p></dd><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- The length of the packet buffer contents, in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev</code></em></span></dt><dd><p>
- Address of net_device representing output device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_tha</code></em></span></dt><dd><p>
- Ethernet+IP only (ar_pro==0x800): target hardware (MAC) address
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_data</code></em></span></dt><dd><p>
- Address of ARP packet data region (after the header)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_repeat</code></em></span></dt><dd><p>
- Constant used to signify a 'repeat' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>indev_name</code></em></span></dt><dd><p>
- Name of network device packet was received on (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>ar_hrd</code></em></span></dt><dd><p>
- Format of hardware address
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netfilter-arp-in.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netfilter-bridge-forward.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netfilter.arp.in</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netfilter.bridge.forward</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netfilter.bridge.forward</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netfilter-arp-out.html" title="probe::netfilter.arp.out"><link rel="next" href="API-netfilter-bridge-local-in.html" title="probe::netfilter.bridge.local_in"></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>probe::netfilter.bridge.forward</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netfilter-arp-out.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netfilter-bridge-local-in.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netfilter.bridge.forward"><a name="API-netfilter-bridge-forward"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netfilter.bridge.forward —
- Called on an incoming bridging packet destined for some other computer
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netfilter.bridge.forward </pre></div><div class="refsect1" title="Values"><a name="idp8056304"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>indev</code></em></span></dt><dd><p>
- Address of net_device representing input device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_accept</code></em></span></dt><dd><p>
- Constant used to signify an 'accept' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>pf</code></em></span></dt><dd><p>
- Protocol family -- always <span class="quote">“<span class="quote">bridge</span>”</span>
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_queue</code></em></span></dt><dd><p>
- Constant used to signify a 'queue' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stolen</code></em></span></dt><dd><p>
- Constant used to signify a 'stolen' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev_name</code></em></span></dt><dd><p>
- Name of network device packet will be routed to (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_drop</code></em></span></dt><dd><p>
- Constant used to signify a 'drop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stop</code></em></span></dt><dd><p>
- Constant used to signify a 'stop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- The length of the packet buffer contents, in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev</code></em></span></dt><dd><p>
- Address of net_device representing output device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_repeat</code></em></span></dt><dd><p>
- Constant used to signify a 'repeat' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>indev_name</code></em></span></dt><dd><p>
- Name of network device packet was received on (if known)
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netfilter-arp-out.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netfilter-bridge-local-in.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netfilter.arp.out</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netfilter.bridge.local_in</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netfilter.bridge.local_in</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netfilter-bridge-forward.html" title="probe::netfilter.bridge.forward"><link rel="next" href="API-netfilter-bridge-local-out.html" title="probe::netfilter.bridge.local_out"></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>probe::netfilter.bridge.local_in</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netfilter-bridge-forward.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netfilter-bridge-local-out.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netfilter.bridge.local_in"><a name="API-netfilter-bridge-local-in"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netfilter.bridge.local_in —
- Called on a bridging packet destined for the local computer
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netfilter.bridge.local_in </pre></div><div class="refsect1" title="Values"><a name="idp8089184"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>indev</code></em></span></dt><dd><p>
- Address of net_device representing input device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_accept</code></em></span></dt><dd><p>
- Constant used to signify an 'accept' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>pf</code></em></span></dt><dd><p>
- Protocol family -- always <span class="quote">“<span class="quote">bridge</span>”</span>
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_queue</code></em></span></dt><dd><p>
- Constant used to signify a 'queue' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stolen</code></em></span></dt><dd><p>
- Constant used to signify a 'stolen' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev_name</code></em></span></dt><dd><p>
- Name of network device packet will be routed to (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_drop</code></em></span></dt><dd><p>
- Constant used to signify a 'drop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stop</code></em></span></dt><dd><p>
- Constant used to signify a 'stop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- The length of the packet buffer contents, in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev</code></em></span></dt><dd><p>
- Address of net_device representing output device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_repeat</code></em></span></dt><dd><p>
- Constant used to signify a 'repeat' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>indev_name</code></em></span></dt><dd><p>
- Name of network device packet was received on (if known)
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netfilter-bridge-forward.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netfilter-bridge-local-out.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netfilter.bridge.forward</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netfilter.bridge.local_out</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netfilter.bridge.local_out</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netfilter-bridge-local-in.html" title="probe::netfilter.bridge.local_in"><link rel="next" href="API-netfilter-bridge-post-routing.html" title="probe::netfilter.bridge.post_routing"></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>probe::netfilter.bridge.local_out</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netfilter-bridge-local-in.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netfilter-bridge-post-routing.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netfilter.bridge.local_out"><a name="API-netfilter-bridge-local-out"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netfilter.bridge.local_out —
- Called on a bridging packet coming from a local process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netfilter.bridge.local_out </pre></div><div class="refsect1" title="Values"><a name="idp8122016"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>indev</code></em></span></dt><dd><p>
- Address of net_device representing input device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_accept</code></em></span></dt><dd><p>
- Constant used to signify an 'accept' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>pf</code></em></span></dt><dd><p>
- Protocol family -- always <span class="quote">“<span class="quote">bridge</span>”</span>
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_queue</code></em></span></dt><dd><p>
- Constant used to signify a 'queue' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stolen</code></em></span></dt><dd><p>
- Constant used to signify a 'stolen' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev_name</code></em></span></dt><dd><p>
- Name of network device packet will be routed to (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_drop</code></em></span></dt><dd><p>
- Constant used to signify a 'drop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stop</code></em></span></dt><dd><p>
- Constant used to signify a 'stop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- The length of the packet buffer contents, in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev</code></em></span></dt><dd><p>
- Address of net_device representing output device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_repeat</code></em></span></dt><dd><p>
- Constant used to signify a 'repeat' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>indev_name</code></em></span></dt><dd><p>
- Name of network device packet was received on (if known)
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netfilter-bridge-local-in.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netfilter-bridge-post-routing.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netfilter.bridge.local_in</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netfilter.bridge.post_routing</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netfilter.bridge.post_routing</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netfilter-bridge-local-out.html" title="probe::netfilter.bridge.local_out"><link rel="next" href="API-netfilter-bridge-pre-routing.html" title="probe::netfilter.bridge.pre_routing"></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>probe::netfilter.bridge.post_routing</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netfilter-bridge-local-out.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netfilter-bridge-pre-routing.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netfilter.bridge.post_routing"><a name="API-netfilter-bridge-post-routing"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netfilter.bridge.post_routing —
- - Called before a bridging packet hits the wire
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netfilter.bridge.post_routing </pre></div><div class="refsect1" title="Values"><a name="idp8154816"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>indev</code></em></span></dt><dd><p>
- Address of net_device representing input device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_accept</code></em></span></dt><dd><p>
- Constant used to signify an 'accept' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>pf</code></em></span></dt><dd><p>
- Protocol family -- always <span class="quote">“<span class="quote">bridge</span>”</span>
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_queue</code></em></span></dt><dd><p>
- Constant used to signify a 'queue' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stolen</code></em></span></dt><dd><p>
- Constant used to signify a 'stolen' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev_name</code></em></span></dt><dd><p>
- Name of network device packet will be routed to (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_drop</code></em></span></dt><dd><p>
- Constant used to signify a 'drop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stop</code></em></span></dt><dd><p>
- Constant used to signify a 'stop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- The length of the packet buffer contents, in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev</code></em></span></dt><dd><p>
- Address of net_device representing output device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_repeat</code></em></span></dt><dd><p>
- Constant used to signify a 'repeat' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>indev_name</code></em></span></dt><dd><p>
- Name of network device packet was received on (if known)
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netfilter-bridge-local-out.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netfilter-bridge-pre-routing.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netfilter.bridge.local_out</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netfilter.bridge.pre_routing</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netfilter.bridge.pre_routing</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netfilter-bridge-post-routing.html" title="probe::netfilter.bridge.post_routing"><link rel="next" href="API-netfilter-ip-forward.html" title="probe::netfilter.ip.forward"></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>probe::netfilter.bridge.pre_routing</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netfilter-bridge-post-routing.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netfilter-ip-forward.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netfilter.bridge.pre_routing"><a name="API-netfilter-bridge-pre-routing"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netfilter.bridge.pre_routing —
- - Called before a bridging packet is routed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netfilter.bridge.pre_routing </pre></div><div class="refsect1" title="Values"><a name="idp8187680"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>indev</code></em></span></dt><dd><p>
- Address of net_device representing input device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_accept</code></em></span></dt><dd><p>
- Constant used to signify an 'accept' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>pf</code></em></span></dt><dd><p>
- Protocol family -- always <span class="quote">“<span class="quote">bridge</span>”</span>
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_queue</code></em></span></dt><dd><p>
- Constant used to signify a 'queue' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stolen</code></em></span></dt><dd><p>
- Constant used to signify a 'stolen' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev_name</code></em></span></dt><dd><p>
- Name of network device packet will be routed to (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_drop</code></em></span></dt><dd><p>
- Constant used to signify a 'drop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stop</code></em></span></dt><dd><p>
- Constant used to signify a 'stop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- The length of the packet buffer contents, in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev</code></em></span></dt><dd><p>
- Address of net_device representing output device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_repeat</code></em></span></dt><dd><p>
- Constant used to signify a 'repeat' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>indev_name</code></em></span></dt><dd><p>
- Name of network device packet was received on (if known)
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netfilter-bridge-post-routing.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netfilter-ip-forward.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netfilter.bridge.post_routing</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netfilter.ip.forward</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netfilter.ip.forward</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netfilter-bridge-pre-routing.html" title="probe::netfilter.bridge.pre_routing"><link rel="next" href="API-netfilter-ip-local-in.html" title="probe::netfilter.ip.local_in"></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>probe::netfilter.ip.forward</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netfilter-bridge-pre-routing.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netfilter-ip-local-in.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netfilter.ip.forward"><a name="API-netfilter-ip-forward"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netfilter.ip.forward —
- Called on an incoming IP packet addressed to some other computer
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netfilter.ip.forward </pre></div><div class="refsect1" title="Values"><a name="idp8220448"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>urg</code></em></span></dt><dd><p>
- TCP URG flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Packet protocol from driver (ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>indev</code></em></span></dt><dd><p>
- Address of net_device representing input device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_accept</code></em></span></dt><dd><p>
- Constant used to signify an 'accept' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>pf</code></em></span></dt><dd><p>
- Protocol family -- either <span class="quote">“<span class="quote">ipv4</span>”</span> or <span class="quote">“<span class="quote">ipv6</span>”</span>
- </p></dd><dt><span class="term"><em class="parameter"><code>ipproto_tcp</code></em></span></dt><dd><p>
- Constant used to signify that the packet protocol is TCP
- </p></dd><dt><span class="term"><em class="parameter"><code>rst</code></em></span></dt><dd><p>
- TCP RST flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>dport</code></em></span></dt><dd><p>
- TCP or UDP destination port (ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_queue</code></em></span></dt><dd><p>
- Constant used to signify a 'queue' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stolen</code></em></span></dt><dd><p>
- Constant used to signify a 'stolen' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>ipproto_udp</code></em></span></dt><dd><p>
- Constant used to signify that the packet protocol is UDP
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev_name</code></em></span></dt><dd><p>
- Name of network device packet will be routed to (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>ack</code></em></span></dt><dd><p>
- TCP ACK flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>fin</code></em></span></dt><dd><p>
- TCP FIN flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_drop</code></em></span></dt><dd><p>
- Constant used to signify a 'drop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>psh</code></em></span></dt><dd><p>
- TCP PSH flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>saddr</code></em></span></dt><dd><p>
- A string representing the source IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stop</code></em></span></dt><dd><p>
- Constant used to signify a 'stop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- The length of the packet buffer contents, in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>daddr</code></em></span></dt><dd><p>
- A string representing the destination IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev</code></em></span></dt><dd><p>
- Address of net_device representing output device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>syn</code></em></span></dt><dd><p>
- TCP SYN flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>sport</code></em></span></dt><dd><p>
- TCP or UDP source port (ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_repeat</code></em></span></dt><dd><p>
- Constant used to signify a 'repeat' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>indev_name</code></em></span></dt><dd><p>
- Name of network device packet was received on (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- IP address family
- </p></dd><dt><span class="term"><em class="parameter"><code>iphdr</code></em></span></dt><dd><p>
- Address of IP header
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netfilter-bridge-pre-routing.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netfilter-ip-local-in.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netfilter.bridge.pre_routing</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netfilter.ip.local_in</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netfilter.ip.local_in</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netfilter-ip-forward.html" title="probe::netfilter.ip.forward"><link rel="next" href="API-netfilter-ip-local-out.html" title="probe::netfilter.ip.local_out"></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>probe::netfilter.ip.local_in</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netfilter-ip-forward.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netfilter-ip-local-out.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netfilter.ip.local_in"><a name="API-netfilter-ip-local-in"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netfilter.ip.local_in —
- Called on an incoming IP packet addressed to the local computer
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netfilter.ip.local_in </pre></div><div class="refsect1" title="Values"><a name="idp8284192"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>urg</code></em></span></dt><dd><p>
- TCP URG flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Packet protocol from driver (ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>indev</code></em></span></dt><dd><p>
- Address of net_device representing input device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_accept</code></em></span></dt><dd><p>
- Constant used to signify an 'accept' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>pf</code></em></span></dt><dd><p>
- Protocol family -- either <span class="quote">“<span class="quote">ipv4</span>”</span> or <span class="quote">“<span class="quote">ipv6</span>”</span>
- </p></dd><dt><span class="term"><em class="parameter"><code>ipproto_tcp</code></em></span></dt><dd><p>
- Constant used to signify that the packet protocol is TCP
- </p></dd><dt><span class="term"><em class="parameter"><code>rst</code></em></span></dt><dd><p>
- TCP RST flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>dport</code></em></span></dt><dd><p>
- TCP or UDP destination port (ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_queue</code></em></span></dt><dd><p>
- Constant used to signify a 'queue' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stolen</code></em></span></dt><dd><p>
- Constant used to signify a 'stolen' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>ipproto_udp</code></em></span></dt><dd><p>
- Constant used to signify that the packet protocol is UDP
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev_name</code></em></span></dt><dd><p>
- Name of network device packet will be routed to (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>ack</code></em></span></dt><dd><p>
- TCP ACK flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>fin</code></em></span></dt><dd><p>
- TCP FIN flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_drop</code></em></span></dt><dd><p>
- Constant used to signify a 'drop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>psh</code></em></span></dt><dd><p>
- TCP PSH flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>saddr</code></em></span></dt><dd><p>
- A string representing the source IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stop</code></em></span></dt><dd><p>
- Constant used to signify a 'stop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- The length of the packet buffer contents, in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>daddr</code></em></span></dt><dd><p>
- A string representing the destination IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev</code></em></span></dt><dd><p>
- Address of net_device representing output device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>syn</code></em></span></dt><dd><p>
- TCP SYN flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>sport</code></em></span></dt><dd><p>
- TCP or UDP source port (ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_repeat</code></em></span></dt><dd><p>
- Constant used to signify a 'repeat' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>indev_name</code></em></span></dt><dd><p>
- Name of network device packet was received on (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- IP address family
- </p></dd><dt><span class="term"><em class="parameter"><code>iphdr</code></em></span></dt><dd><p>
- Address of IP header
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netfilter-ip-forward.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netfilter-ip-local-out.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netfilter.ip.forward</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netfilter.ip.local_out</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netfilter.ip.local_out</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netfilter-ip-local-in.html" title="probe::netfilter.ip.local_in"><link rel="next" href="API-netfilter-ip-post-routing.html" title="probe::netfilter.ip.post_routing"></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>probe::netfilter.ip.local_out</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netfilter-ip-local-in.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netfilter-ip-post-routing.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netfilter.ip.local_out"><a name="API-netfilter-ip-local-out"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netfilter.ip.local_out —
- Called on an outgoing IP packet
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netfilter.ip.local_out </pre></div><div class="refsect1" title="Values"><a name="idp8347776"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>urg</code></em></span></dt><dd><p>
- TCP URG flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Packet protocol from driver (ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>indev</code></em></span></dt><dd><p>
- Address of net_device representing input device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_accept</code></em></span></dt><dd><p>
- Constant used to signify an 'accept' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>pf</code></em></span></dt><dd><p>
- Protocol family -- either <span class="quote">“<span class="quote">ipv4</span>”</span> or <span class="quote">“<span class="quote">ipv6</span>”</span>
- </p></dd><dt><span class="term"><em class="parameter"><code>ipproto_tcp</code></em></span></dt><dd><p>
- Constant used to signify that the packet protocol is TCP
- </p></dd><dt><span class="term"><em class="parameter"><code>rst</code></em></span></dt><dd><p>
- TCP RST flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>dport</code></em></span></dt><dd><p>
- TCP or UDP destination port (ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_queue</code></em></span></dt><dd><p>
- Constant used to signify a 'queue' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stolen</code></em></span></dt><dd><p>
- Constant used to signify a 'stolen' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>ipproto_udp</code></em></span></dt><dd><p>
- Constant used to signify that the packet protocol is UDP
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev_name</code></em></span></dt><dd><p>
- Name of network device packet will be routed to (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>ack</code></em></span></dt><dd><p>
- TCP ACK flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>fin</code></em></span></dt><dd><p>
- TCP FIN flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_drop</code></em></span></dt><dd><p>
- Constant used to signify a 'drop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>psh</code></em></span></dt><dd><p>
- TCP PSH flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>saddr</code></em></span></dt><dd><p>
- A string representing the source IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stop</code></em></span></dt><dd><p>
- Constant used to signify a 'stop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- The length of the packet buffer contents, in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>daddr</code></em></span></dt><dd><p>
- A string representing the destination IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev</code></em></span></dt><dd><p>
- Address of net_device representing output device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>syn</code></em></span></dt><dd><p>
- TCP SYN flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>sport</code></em></span></dt><dd><p>
- TCP or UDP source port (ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_repeat</code></em></span></dt><dd><p>
- Constant used to signify a 'repeat' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>indev_name</code></em></span></dt><dd><p>
- Name of network device packet was received on (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- IP address family
- </p></dd><dt><span class="term"><em class="parameter"><code>iphdr</code></em></span></dt><dd><p>
- Address of IP header
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netfilter-ip-local-in.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netfilter-ip-post-routing.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netfilter.ip.local_in</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netfilter.ip.post_routing</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netfilter.ip.post_routing</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netfilter-ip-local-out.html" title="probe::netfilter.ip.local_out"><link rel="next" href="API-netfilter-ip-pre-routing.html" title="probe::netfilter.ip.pre_routing"></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>probe::netfilter.ip.post_routing</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netfilter-ip-local-out.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netfilter-ip-pre-routing.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netfilter.ip.post_routing"><a name="API-netfilter-ip-post-routing"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netfilter.ip.post_routing —
- Called immediately before an outgoing IP packet leaves the computer
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netfilter.ip.post_routing </pre></div><div class="refsect1" title="Values"><a name="idp8411424"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>urg</code></em></span></dt><dd><p>
- TCP URG flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Packet protocol from driver (ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>indev</code></em></span></dt><dd><p>
- Address of net_device representing input device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_accept</code></em></span></dt><dd><p>
- Constant used to signify an 'accept' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>pf</code></em></span></dt><dd><p>
- Protocol family -- either <span class="quote">“<span class="quote">ipv4</span>”</span> or <span class="quote">“<span class="quote">ipv6</span>”</span>
- </p></dd><dt><span class="term"><em class="parameter"><code>ipproto_tcp</code></em></span></dt><dd><p>
- Constant used to signify that the packet protocol is TCP
- </p></dd><dt><span class="term"><em class="parameter"><code>rst</code></em></span></dt><dd><p>
- TCP RST flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>dport</code></em></span></dt><dd><p>
- TCP or UDP destination port (ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_queue</code></em></span></dt><dd><p>
- Constant used to signify a 'queue' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stolen</code></em></span></dt><dd><p>
- Constant used to signify a 'stolen' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>ipproto_udp</code></em></span></dt><dd><p>
- Constant used to signify that the packet protocol is UDP
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev_name</code></em></span></dt><dd><p>
- Name of network device packet will be routed to (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>ack</code></em></span></dt><dd><p>
- TCP ACK flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>fin</code></em></span></dt><dd><p>
- TCP FIN flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_drop</code></em></span></dt><dd><p>
- Constant used to signify a 'drop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>psh</code></em></span></dt><dd><p>
- TCP PSH flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>saddr</code></em></span></dt><dd><p>
- A string representing the source IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stop</code></em></span></dt><dd><p>
- Constant used to signify a 'stop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- The length of the packet buffer contents, in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>daddr</code></em></span></dt><dd><p>
- A string representing the destination IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev</code></em></span></dt><dd><p>
- Address of net_device representing output device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>syn</code></em></span></dt><dd><p>
- TCP SYN flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>sport</code></em></span></dt><dd><p>
- TCP or UDP source port (ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_repeat</code></em></span></dt><dd><p>
- Constant used to signify a 'repeat' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>indev_name</code></em></span></dt><dd><p>
- Name of network device packet was received on (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- IP address family
- </p></dd><dt><span class="term"><em class="parameter"><code>iphdr</code></em></span></dt><dd><p>
- Address of IP header
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netfilter-ip-local-out.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netfilter-ip-pre-routing.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netfilter.ip.local_out</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netfilter.ip.pre_routing</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::netfilter.ip.pre_routing</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netfilter-ip-post-routing.html" title="probe::netfilter.ip.post_routing"><link rel="next" href="API-sunrpc-clnt-bind-new-program.html" title="probe::sunrpc.clnt.bind_new_program"></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>probe::netfilter.ip.pre_routing</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netfilter-ip-post-routing.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-clnt-bind-new-program.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::netfilter.ip.pre_routing"><a name="API-netfilter-ip-pre-routing"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::netfilter.ip.pre_routing —
- Called before an IP packet is routed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">netfilter.ip.pre_routing </pre></div><div class="refsect1" title="Values"><a name="idp8474928"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>urg</code></em></span></dt><dd><p>
- TCP URG flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Packet protocol from driver (ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>indev</code></em></span></dt><dd><p>
- Address of net_device representing input device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_accept</code></em></span></dt><dd><p>
- Constant used to signify an 'accept' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>pf</code></em></span></dt><dd><p>
- Protocol family - either 'ipv4' or 'ipv6'
- </p></dd><dt><span class="term"><em class="parameter"><code>ipproto_tcp</code></em></span></dt><dd><p>
- Constant used to signify that the packet protocol is TCP
- </p></dd><dt><span class="term"><em class="parameter"><code>rst</code></em></span></dt><dd><p>
- TCP RST flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>dport</code></em></span></dt><dd><p>
- TCP or UDP destination port (ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_queue</code></em></span></dt><dd><p>
- Constant used to signify a 'queue' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stolen</code></em></span></dt><dd><p>
- Constant used to signify a 'stolen' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>ipproto_udp</code></em></span></dt><dd><p>
- Constant used to signify that the packet protocol is UDP
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev_name</code></em></span></dt><dd><p>
- Name of network device packet will be routed to (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>ack</code></em></span></dt><dd><p>
- TCP ACK flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>fin</code></em></span></dt><dd><p>
- TCP FIN flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_drop</code></em></span></dt><dd><p>
- Constant used to signify a 'drop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>psh</code></em></span></dt><dd><p>
- TCP PSH flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>saddr</code></em></span></dt><dd><p>
- A string representing the source IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_stop</code></em></span></dt><dd><p>
- Constant used to signify a 'stop' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- The length of the packet buffer contents, in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>daddr</code></em></span></dt><dd><p>
- A string representing the destination IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>outdev</code></em></span></dt><dd><p>
- Address of net_device representing output device, 0 if unknown
- </p></dd><dt><span class="term"><em class="parameter"><code>syn</code></em></span></dt><dd><p>
- TCP SYN flag (if protocol is TCP; ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>sport</code></em></span></dt><dd><p>
- TCP or UDP source port (ipv4 only)
- </p></dd><dt><span class="term"><em class="parameter"><code>indev_name</code></em></span></dt><dd><p>
- Name of network device packet was received on (if known)
- </p></dd><dt><span class="term"><em class="parameter"><code>nf_repeat</code></em></span></dt><dd><p>
- Constant used to signify a 'repeat' verdict
- </p></dd><dt><span class="term"><em class="parameter"><code>iphdr</code></em></span></dt><dd><p>
- Address of IP header
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- IP address family
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netfilter-ip-post-routing.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-clnt-bind-new-program.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netfilter.ip.post_routing</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.clnt.bind_new_program</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.aop.readpage</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsderror.html" title="function::nfsderror"><link rel="next" href="API-nfs-aop-readpages.html" title="probe::nfs.aop.readpages"></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>probe::nfs.aop.readpage</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsderror.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-aop-readpages.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.aop.readpage"><a name="API-nfs-aop-readpage"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.aop.readpage —
- NFS client synchronously reading a page
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.aop.readpage </pre></div><div class="refsect1" title="Values"><a name="idp12604768"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>i_size</code></em></span></dt><dd><p>
- file length in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- device identifier
- </p></dd><dt><span class="term"><em class="parameter"><code>rsize</code></em></span></dt><dd><p>
- read size (in bytes)
- </p></dd><dt><span class="term"><em class="parameter"><code>sb_flag</code></em></span></dt><dd><p>
- super block flags
- </p></dd><dt><span class="term"><em class="parameter"><code>file</code></em></span></dt><dd><p>
- file argument
- </p></dd><dt><span class="term"><em class="parameter"><code>page_index</code></em></span></dt><dd><p>
- offset within mapping, can used a page identifier
- and position identifier in the page frame
- </p></dd><dt><span class="term"><em class="parameter"><code>__page</code></em></span></dt><dd><p>
- the address of page
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- number of pages to be read in this execution
- </p></dd><dt><span class="term"><em class="parameter"><code>i_flag</code></em></span></dt><dd><p>
- file flags
- </p></dd><dt><span class="term"><em class="parameter"><code>ino</code></em></span></dt><dd><p>
- inode number
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12626128"></a><h2>Description</h2><p>
- Read the page over, only fires when a previous async
- read operation failed
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsderror.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-aop-readpages.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::nfsderror</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.aop.readpages</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.aop.readpages</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-aop-readpage.html" title="probe::nfs.aop.readpage"><link rel="next" href="API-nfs-aop-release-page.html" title="probe::nfs.aop.release_page"></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>probe::nfs.aop.readpages</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-aop-readpage.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-aop-release-page.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.aop.readpages"><a name="API-nfs-aop-readpages"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.aop.readpages —
- NFS client reading multiple pages
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.aop.readpages </pre></div><div class="refsect1" title="Values"><a name="idp12634176"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- device identifier
- </p></dd><dt><span class="term"><em class="parameter"><code>rsize</code></em></span></dt><dd><p>
- read size (in bytes)
- </p></dd><dt><span class="term"><em class="parameter"><code>file</code></em></span></dt><dd><p>
- filp argument
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- number of pages attempted to read in this execution
- </p></dd><dt><span class="term"><em class="parameter"><code>nr_pages</code></em></span></dt><dd><p>
- number of pages attempted to read in this execution
- </p></dd><dt><span class="term"><em class="parameter"><code>rpages</code></em></span></dt><dd><p>
- read size (in pages)
- </p></dd><dt><span class="term"><em class="parameter"><code>ino</code></em></span></dt><dd><p>
- inode number
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12649472"></a><h2>Description</h2><p>
- Fires when in readahead way, read several pages once
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-aop-readpage.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-aop-release-page.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.aop.readpage</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.aop.release_page</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.aop.release_page</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-aop-readpages.html" title="probe::nfs.aop.readpages"><link rel="next" href="API-nfs-aop-set-page-dirty.html" title="probe::nfs.aop.set_page_dirty"></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>probe::nfs.aop.release_page</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-aop-readpages.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-aop-set-page-dirty.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.aop.release_page"><a name="API-nfs-aop-release-page"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.aop.release_page —
- NFS client releasing page
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.aop.release_page </pre></div><div class="refsect1" title="Values"><a name="idp12657472"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- device identifier
- </p></dd><dt><span class="term"><em class="parameter"><code>page_index</code></em></span></dt><dd><p>
- offset within mapping, can used a page identifier
- and position identifier in the page frame
- </p></dd><dt><span class="term"><em class="parameter"><code>__page</code></em></span></dt><dd><p>
- the address of page
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- release pages
- </p></dd><dt><span class="term"><em class="parameter"><code>ino</code></em></span></dt><dd><p>
- inode number
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12668736"></a><h2>Description</h2><p>
- Fires when do a release operation on NFS.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-aop-readpages.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-aop-set-page-dirty.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.aop.readpages</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.aop.set_page_dirty</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.aop.set_page_dirty</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-aop-release-page.html" title="probe::nfs.aop.release_page"><link rel="next" href="API-nfs-aop-write-begin.html" title="probe::nfs.aop.write_begin"></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>probe::nfs.aop.set_page_dirty</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-aop-release-page.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-aop-write-begin.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.aop.set_page_dirty"><a name="API-nfs-aop-set-page-dirty"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.aop.set_page_dirty —
- NFS client marking page as dirty
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.aop.set_page_dirty </pre></div><div class="refsect1" title="Values"><a name="idp12676784"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>__page</code></em></span></dt><dd><p>
- the address of page
- </p></dd><dt><span class="term"><em class="parameter"><code>page_flag</code></em></span></dt><dd><p>
- page flags
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12681984"></a><h2>Description</h2><p>
- This probe attaches to the generic __set_page_dirty_nobuffers function.
- Thus, this probe is going to fire on many other file systems in
- addition to the NFS client.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-aop-release-page.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-aop-write-begin.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.aop.release_page</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.aop.write_begin</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.aop.write_begin</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-aop-set-page-dirty.html" title="probe::nfs.aop.set_page_dirty"><link rel="next" href="API-nfs-aop-write-end.html" title="probe::nfs.aop.write_end"></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>probe::nfs.aop.write_begin</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-aop-set-page-dirty.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-aop-write-end.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.aop.write_begin"><a name="API-nfs-aop-write-begin"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.aop.write_begin —
- NFS client begin to write data
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.aop.write_begin </pre></div><div class="refsect1" title="Values"><a name="idp12690064"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- device identifier
- </p></dd><dt><span class="term"><em class="parameter"><code>page_index</code></em></span></dt><dd><p>
- offset within mapping, can used a page identifier
- and position identifier in the page frame
- </p></dd><dt><span class="term"><em class="parameter"><code>__page</code></em></span></dt><dd><p>
- the address of page
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- write bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>to</code></em></span></dt><dd><p>
- end address of this write operation
- </p></dd><dt><span class="term"><em class="parameter"><code>ino</code></em></span></dt><dd><p>
- inode number
- </p></dd><dt><span class="term"><em class="parameter"><code>offset</code></em></span></dt><dd><p>
- start address of this write operation
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12705360"></a><h2>Description</h2><p>
- Occurs when write operation occurs on nfs. It prepare a page for writing,
- look for a request corresponding to the page. If there
- is one, and it belongs to another file, it flush it out
- before it tries to copy anything into the page.
- Also do the same if it finds a request from an existing
- dropped page
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-aop-set-page-dirty.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-aop-write-end.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.aop.set_page_dirty</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.aop.write_end</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.aop.write_end</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-aop-write-begin.html" title="probe::nfs.aop.write_begin"><link rel="next" href="API-nfs-aop-writepage.html" title="probe::nfs.aop.writepage"></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>probe::nfs.aop.write_end</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-aop-write-begin.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-aop-writepage.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.aop.write_end"><a name="API-nfs-aop-write-end"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.aop.write_end —
- NFS client complete writing data
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.aop.write_end </pre></div><div class="refsect1" title="Values"><a name="idp12713648"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>i_size</code></em></span></dt><dd><p>
- file length in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- device identifier
- </p></dd><dt><span class="term"><em class="parameter"><code>sb_flag</code></em></span></dt><dd><p>
- super block flags
- </p></dd><dt><span class="term"><em class="parameter"><code>page_index</code></em></span></dt><dd><p>
- offset within mapping, can used a page identifier and position identifier in the page frame
- </p></dd><dt><span class="term"><em class="parameter"><code>__page</code></em></span></dt><dd><p>
- the address of page
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- write bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>i_flag</code></em></span></dt><dd><p>
- file flags
- </p></dd><dt><span class="term"><em class="parameter"><code>to</code></em></span></dt><dd><p>
- end address of this write operation
- </p></dd><dt><span class="term"><em class="parameter"><code>ino</code></em></span></dt><dd><p>
- inode number
- </p></dd><dt><span class="term"><em class="parameter"><code>offset</code></em></span></dt><dd><p>
- start address of this write operation
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12734944"></a><h2>Description</h2><p>
- Fires when do a write operation on nfs,
- often after prepare_write
- </p><p>
-
- Update and possibly write a cached page of an NFS file.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-aop-write-begin.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-aop-writepage.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.aop.write_begin</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.aop.writepage</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.aop.writepage</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-aop-write-end.html" title="probe::nfs.aop.write_end"><link rel="next" href="API-nfs-aop-writepages.html" title="probe::nfs.aop.writepages"></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>probe::nfs.aop.writepage</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-aop-write-end.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-aop-writepages.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.aop.writepage"><a name="API-nfs-aop-writepage"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.aop.writepage —
- NFS client writing a mapped page to the NFS server
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.aop.writepage </pre></div><div class="refsect1" title="Values"><a name="idp12743344"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>for_reclaim</code></em></span></dt><dd><p>
- a flag of writeback_control,
- indicates if it's invoked from the page allocator
- </p></dd><dt><span class="term"><em class="parameter"><code>i_size</code></em></span></dt><dd><p>
- file length in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- device identifier
- </p></dd><dt><span class="term"><em class="parameter"><code>sb_flag</code></em></span></dt><dd><p>
- super block flags
- </p></dd><dt><span class="term"><em class="parameter"><code>page_index</code></em></span></dt><dd><p>
- offset within mapping,
- can used a page identifier and position identifier in the page frame
- </p></dd><dt><span class="term"><em class="parameter"><code>__page</code></em></span></dt><dd><p>
- the address of page
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- number of pages to be written in this execution
- </p></dd><dt><span class="term"><em class="parameter"><code>for_kupdate</code></em></span></dt><dd><p>
- a flag of writeback_control,
- indicates if it's a kupdate writeback
- </p></dd><dt><span class="term"><em class="parameter"><code>wsize</code></em></span></dt><dd><p>
- write size
- </p></dd><dt><span class="term"><em class="parameter"><code>i_flag</code></em></span></dt><dd><p>
- file flags
- </p></dd><dt><span class="term"><em class="parameter"><code>i_state</code></em></span></dt><dd><p>
- inode state flags
- </p></dd><dt><span class="term"><em class="parameter"><code>ino</code></em></span></dt><dd><p>
- inode number
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12768848"></a><h2>Description</h2><p>
- The priority of wb is decided by the flags
- <em class="parameter"><code>for_reclaim</code></em> and <em class="parameter"><code>for_kupdate</code></em>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-aop-write-end.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-aop-writepages.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.aop.write_end</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.aop.writepages</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.aop.writepages</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-aop-writepage.html" title="probe::nfs.aop.writepage"><link rel="next" href="API-nfs-fop-aio-read.html" title="probe::nfs.fop.aio_read"></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>probe::nfs.aop.writepages</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-aop-writepage.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-fop-aio-read.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.aop.writepages"><a name="API-nfs-aop-writepages"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.aop.writepages —
- NFS client writing several dirty pages to the NFS server
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.aop.writepages </pre></div><div class="refsect1" title="Values"><a name="idp12778240"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>for_reclaim</code></em></span></dt><dd><p>
- a flag of writeback_control,
- indicates if it's invoked from the page allocator
- </p></dd><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- device identifier
- </p></dd><dt><span class="term"><em class="parameter"><code>wpages</code></em></span></dt><dd><p>
- write size (in pages)
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- number of pages attempted to be written in this execution
- </p></dd><dt><span class="term"><em class="parameter"><code>for_kupdate</code></em></span></dt><dd><p>
- a flag of writeback_control,
- indicates if it's a kupdate writeback
- </p></dd><dt><span class="term"><em class="parameter"><code>wsize</code></em></span></dt><dd><p>
- write size
- </p></dd><dt><span class="term"><em class="parameter"><code>nr_to_write</code></em></span></dt><dd><p>
- number of pages attempted to be written in this execution
- </p></dd><dt><span class="term"><em class="parameter"><code>ino</code></em></span></dt><dd><p>
- inode number
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12795632"></a><h2>Description</h2><p>
- The priority of wb is decided by the flags
- <em class="parameter"><code>for_reclaim</code></em> and <em class="parameter"><code>for_kupdate</code></em>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-aop-writepage.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-fop-aio-read.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.aop.writepage</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.fop.aio_read</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.fop.aio_read</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-aop-writepages.html" title="probe::nfs.aop.writepages"><link rel="next" href="API-nfs-fop-aio-write.html" title="probe::nfs.fop.aio_write"></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>probe::nfs.fop.aio_read</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-aop-writepages.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-fop-aio-write.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.fop.aio_read"><a name="API-nfs-fop-aio-read"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.fop.aio_read —
- NFS client aio_read file operation
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.fop.aio_read </pre></div><div class="refsect1" title="Values"><a name="idp12805024"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>attrtimeo</code></em></span></dt><dd><p>
- how long the cached information is assumed to be valid.
- We need to revalidate the cached attrs for this inode
- if jiffies - read_cache_jiffies > attrtimeo.
- </p></dd><dt><span class="term"><em class="parameter"><code>cache_valid</code></em></span></dt><dd><p>
- cache related bit mask flag
- </p></dd><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
- read bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>parent_name</code></em></span></dt><dd><p>
- parent dir name
- </p></dd><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- device identifier
- </p></dd><dt><span class="term"><em class="parameter"><code>buf</code></em></span></dt><dd><p>
- the address of buf in user space
- </p></dd><dt><span class="term"><em class="parameter"><code>cache_time</code></em></span></dt><dd><p>
- when we started read-caching this inode
- </p></dd><dt><span class="term"><em class="parameter"><code>file_name</code></em></span></dt><dd><p>
- file name
- </p></dd><dt><span class="term"><em class="parameter"><code>pos</code></em></span></dt><dd><p>
- current position of file
- </p></dd><dt><span class="term"><em class="parameter"><code>ino</code></em></span></dt><dd><p>
- inode number
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-aop-writepages.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-fop-aio-write.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.aop.writepages</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.fop.aio_write</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.fop.aio_write</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-fop-aio-read.html" title="probe::nfs.fop.aio_read"><link rel="next" href="API-nfs-fop-check-flags.html" title="probe::nfs.fop.check_flags"></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>probe::nfs.fop.aio_write</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-fop-aio-read.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-fop-check-flags.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.fop.aio_write"><a name="API-nfs-fop-aio-write"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.fop.aio_write —
- NFS client aio_write file operation
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.fop.aio_write </pre></div><div class="refsect1" title="Values"><a name="idp12833296"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
- read bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>parent_name</code></em></span></dt><dd><p>
- parent dir name
- </p></dd><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- device identifier
- </p></dd><dt><span class="term"><em class="parameter"><code>buf</code></em></span></dt><dd><p>
- the address of buf in user space
- </p></dd><dt><span class="term"><em class="parameter"><code>file_name</code></em></span></dt><dd><p>
- file name
- </p></dd><dt><span class="term"><em class="parameter"><code>pos</code></em></span></dt><dd><p>
- offset of the file
- </p></dd><dt><span class="term"><em class="parameter"><code>ino</code></em></span></dt><dd><p>
- inode number
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-fop-aio-read.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-fop-check-flags.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.fop.aio_read</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.fop.check_flags</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.fop.check_flags</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-fop-aio-write.html" title="probe::nfs.fop.aio_write"><link rel="next" href="API-nfs-fop-flush.html" title="probe::nfs.fop.flush"></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>probe::nfs.fop.check_flags</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-fop-aio-write.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-fop-flush.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.fop.check_flags"><a name="API-nfs-fop-check-flags"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.fop.check_flags —
- NFS client checking flag operation
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.fop.check_flags </pre></div><div class="refsect1" title="Values"><a name="idp12855168"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>flag</code></em></span></dt><dd><p>
- file flag
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-fop-aio-write.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-fop-flush.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.fop.aio_write</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.fop.flush</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.fop.flush</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-fop-check-flags.html" title="probe::nfs.fop.check_flags"><link rel="next" href="API-nfs-fop-fsync.html" title="probe::nfs.fop.fsync"></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>probe::nfs.fop.flush</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-fop-check-flags.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-fop-fsync.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.fop.flush"><a name="API-nfs-fop-flush"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.fop.flush —
- NFS client flush file operation
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.fop.flush </pre></div><div class="refsect1" title="Values"><a name="idp12865024"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- device identifier
- </p></dd><dt><span class="term"><em class="parameter"><code>mode</code></em></span></dt><dd><p>
- file mode
- </p></dd><dt><span class="term"><em class="parameter"><code>ndirty</code></em></span></dt><dd><p>
- number of dirty page
- </p></dd><dt><span class="term"><em class="parameter"><code>ino</code></em></span></dt><dd><p>
- inode number
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-fop-check-flags.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-fop-fsync.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.fop.check_flags</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.fop.fsync</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.fop.fsync</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-fop-flush.html" title="probe::nfs.fop.flush"><link rel="next" href="API-nfs-fop-llseek.html" title="probe::nfs.fop.llseek"></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>probe::nfs.fop.fsync</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-fop-flush.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-fop-llseek.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.fop.fsync"><a name="API-nfs-fop-fsync"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.fop.fsync —
- NFS client fsync operation
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.fop.fsync </pre></div><div class="refsect1" title="Values"><a name="idp12880896"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- device identifier
- </p></dd><dt><span class="term"><em class="parameter"><code>ndirty</code></em></span></dt><dd><p>
- number of dirty pages
- </p></dd><dt><span class="term"><em class="parameter"><code>ino</code></em></span></dt><dd><p>
- inode number
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-fop-flush.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-fop-llseek.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.fop.flush</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.fop.llseek</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.fop.llseek</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-fop-fsync.html" title="probe::nfs.fop.fsync"><link rel="next" href="API-nfs-fop-lock.html" title="probe::nfs.fop.lock"></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>probe::nfs.fop.llseek</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-fop-fsync.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-fop-lock.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.fop.llseek"><a name="API-nfs-fop-llseek"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.fop.llseek —
- NFS client llseek operation
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.fop.llseek </pre></div><div class="refsect1" title="Values"><a name="idp12894768"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>whence_str</code></em></span></dt><dd><p>
- symbolic string representation of the position to seek from
- </p></dd><dt><span class="term"><em class="parameter"><code>whence</code></em></span></dt><dd><p>
- the position to seek from
- </p></dd><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- device identifier
- </p></dd><dt><span class="term"><em class="parameter"><code>ino</code></em></span></dt><dd><p>
- inode number
- </p></dd><dt><span class="term"><em class="parameter"><code>offset</code></em></span></dt><dd><p>
- the offset of the file will be repositioned
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-fop-fsync.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-fop-lock.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.fop.fsync</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.fop.lock</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.fop.lock</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-fop-llseek.html" title="probe::nfs.fop.llseek"><link rel="next" href="API-nfs-fop-mmap.html" title="probe::nfs.fop.mmap"></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>probe::nfs.fop.lock</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-fop-llseek.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-fop-mmap.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.fop.lock"><a name="API-nfs-fop-lock"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.fop.lock —
- NFS client file lock operation
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.fop.lock </pre></div><div class="refsect1" title="Values"><a name="idp12912672"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>cmd</code></em></span></dt><dd><p>
- cmd arguments
- </p></dd><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- device identifier
- </p></dd><dt><span class="term"><em class="parameter"><code>fl_type</code></em></span></dt><dd><p>
- lock type
- </p></dd><dt><span class="term"><em class="parameter"><code>fl_end</code></em></span></dt><dd><p>
- ending offset of locked region
- </p></dd><dt><span class="term"><em class="parameter"><code>fl_flag</code></em></span></dt><dd><p>
- lock flags
- </p></dd><dt><span class="term"><em class="parameter"><code>i_mode</code></em></span></dt><dd><p>
- file type and access rights
- </p></dd><dt><span class="term"><em class="parameter"><code>fl_start</code></em></span></dt><dd><p>
- starting offset of locked region
- </p></dd><dt><span class="term"><em class="parameter"><code>ino</code></em></span></dt><dd><p>
- inode number
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-fop-llseek.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-fop-mmap.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.fop.llseek</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.fop.mmap</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.fop.mmap</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-fop-lock.html" title="probe::nfs.fop.lock"><link rel="next" href="API-nfs-fop-open.html" title="probe::nfs.fop.open"></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>probe::nfs.fop.mmap</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-fop-lock.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-fop-open.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.fop.mmap"><a name="API-nfs-fop-mmap"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.fop.mmap —
- NFS client mmap operation
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.fop.mmap </pre></div><div class="refsect1" title="Values"><a name="idp12936544"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>attrtimeo</code></em></span></dt><dd><p>
- how long the cached information is assumed to be valid.
- We need to revalidate the cached attrs for this inode
- if jiffies - read_cache_jiffies > attrtimeo.
- </p></dd><dt><span class="term"><em class="parameter"><code>cache_valid</code></em></span></dt><dd><p>
- cache related bit mask flag
- </p></dd><dt><span class="term"><em class="parameter"><code>parent_name</code></em></span></dt><dd><p>
- parent dir name
- </p></dd><dt><span class="term"><em class="parameter"><code>vm_flag</code></em></span></dt><dd><p>
- vm flags
- </p></dd><dt><span class="term"><em class="parameter"><code>vm_start</code></em></span></dt><dd><p>
- start address within vm_mm
- </p></dd><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- device identifier
- </p></dd><dt><span class="term"><em class="parameter"><code>buf</code></em></span></dt><dd><p>
- the address of buf in user space
- </p></dd><dt><span class="term"><em class="parameter"><code>vm_end</code></em></span></dt><dd><p>
- the first byte after end address within vm_mm
- </p></dd><dt><span class="term"><em class="parameter"><code>cache_time</code></em></span></dt><dd><p>
- when we started read-caching this inode
- </p></dd><dt><span class="term"><em class="parameter"><code>file_name</code></em></span></dt><dd><p>
- file name
- </p></dd><dt><span class="term"><em class="parameter"><code>ino</code></em></span></dt><dd><p>
- inode number
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-fop-lock.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-fop-open.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.fop.lock</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.fop.open</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.fop.open</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-fop-mmap.html" title="probe::nfs.fop.mmap"><link rel="next" href="API-nfs-fop-read.html" title="probe::nfs.fop.read"></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>probe::nfs.fop.open</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-fop-mmap.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-fop-read.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.fop.open"><a name="API-nfs-fop-open"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.fop.open —
- NFS client file open operation
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.fop.open </pre></div><div class="refsect1" title="Values"><a name="idp12966848"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>i_size</code></em></span></dt><dd><p>
- file length in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- device identifier
- </p></dd><dt><span class="term"><em class="parameter"><code>flag</code></em></span></dt><dd><p>
- file flag
- </p></dd><dt><span class="term"><em class="parameter"><code>file_name</code></em></span></dt><dd><p>
- file name
- </p></dd><dt><span class="term"><em class="parameter"><code>ino</code></em></span></dt><dd><p>
- inode number
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-fop-mmap.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-fop-read.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.fop.mmap</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.fop.read</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.fop.read</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-fop-open.html" title="probe::nfs.fop.open"><link rel="next" href="API-nfs-fop-release.html" title="probe::nfs.fop.release"></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>probe::nfs.fop.read</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-fop-open.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-fop-release.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.fop.read"><a name="API-nfs-fop-read"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.fop.read —
- NFS client read operation
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.fop.read </pre></div><div class="refsect1" title="Values"><a name="idp12984656"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>devname</code></em></span></dt><dd><p>
- block device name
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12987856"></a><h2>Description</h2><p>
- SystemTap uses the vfs.do_sync_read probe to implement this probe
- and as a result will get operations other than the NFS client read
- operations.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-fop-open.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-fop-release.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.fop.open</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.fop.release</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.fop.release</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-fop-read.html" title="probe::nfs.fop.read"><link rel="next" href="API-nfs-fop-sendfile.html" title="probe::nfs.fop.sendfile"></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>probe::nfs.fop.release</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-fop-read.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-fop-sendfile.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.fop.release"><a name="API-nfs-fop-release"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.fop.release —
- NFS client release page operation
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.fop.release </pre></div><div class="refsect1" title="Values"><a name="idp12995952"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- device identifier
- </p></dd><dt><span class="term"><em class="parameter"><code>mode</code></em></span></dt><dd><p>
- file mode
- </p></dd><dt><span class="term"><em class="parameter"><code>ino</code></em></span></dt><dd><p>
- inode number
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-fop-read.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-fop-sendfile.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.fop.read</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.fop.sendfile</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.fop.sendfile</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-fop-release.html" title="probe::nfs.fop.release"><link rel="next" href="API-nfs-fop-write.html" title="probe::nfs.fop.write"></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>probe::nfs.fop.sendfile</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-fop-release.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-fop-write.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.fop.sendfile"><a name="API-nfs-fop-sendfile"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.fop.sendfile —
- NFS client send file operation
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.fop.sendfile </pre></div><div class="refsect1" title="Values"><a name="idp13009808"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>attrtimeo</code></em></span></dt><dd><p>
- how long the cached information is assumed to be valid.
- We need to revalidate the cached attrs for this inode
- if jiffies - read_cache_jiffies > attrtimeo.
- </p></dd><dt><span class="term"><em class="parameter"><code>cache_valid</code></em></span></dt><dd><p>
- cache related bit mask flag
- </p></dd><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
- read bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>ppos</code></em></span></dt><dd><p>
- current position of file
- </p></dd><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- device identifier
- </p></dd><dt><span class="term"><em class="parameter"><code>cache_time</code></em></span></dt><dd><p>
- when we started read-caching this inode
- </p></dd><dt><span class="term"><em class="parameter"><code>ino</code></em></span></dt><dd><p>
- inode number
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-fop-release.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-fop-write.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.fop.release</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.fop.write</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.fop.write</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-fop-sendfile.html" title="probe::nfs.fop.sendfile"><link rel="next" href="API-nfs-proc-commit.html" title="probe::nfs.proc.commit"></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>probe::nfs.fop.write</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-fop-sendfile.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-proc-commit.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.fop.write"><a name="API-nfs-fop-write"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.fop.write —
- NFS client write operation
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.fop.write </pre></div><div class="refsect1" title="Values"><a name="idp13031984"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>devname</code></em></span></dt><dd><p>
- block device name
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp13035184"></a><h2>Description</h2><p>
- SystemTap uses the vfs.do_sync_write probe to implement this probe
- and as a result will get operations other than the NFS client write
- operations.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-fop-sendfile.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-proc-commit.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.fop.sendfile</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.proc.commit</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.proc.commit_done</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-proc-commit.html" title="probe::nfs.proc.commit"><link rel="next" href="API-nfs-proc-commit-setup.html" title="probe::nfs.proc.commit_setup"></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>probe::nfs.proc.commit_done</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-proc-commit.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-proc-commit-setup.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.proc.commit_done"><a name="API-nfs-proc-commit-done"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.proc.commit_done —
- NFS client response to a commit RPC task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.proc.commit_done </pre></div><div class="refsect1" title="Values"><a name="idp13067344"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
- number of bytes committed
- </p></dd><dt><span class="term"><em class="parameter"><code>status</code></em></span></dt><dd><p>
- result of last operation
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- NFS version
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>valid</code></em></span></dt><dd><p>
- fattr->valid ,indicates which fields are valid
- </p></dd><dt><span class="term"><em class="parameter"><code>timestamp</code></em></span></dt><dd><p>
- V4 timestamp, which is used for lease renewal
- </p></dd><dt><span class="term"><em class="parameter"><code>server_ip</code></em></span></dt><dd><p>
- IP address of server
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp13082768"></a><h2>Description</h2><p>
- Fires when a reply to a commit RPC task is received
- or some commit operation error occur (timeout or socket shutdown).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-proc-commit.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-proc-commit-setup.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.proc.commit</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.proc.commit_setup</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.proc.commit_setup</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-proc-commit-done.html" title="probe::nfs.proc.commit_done"><link rel="next" href="API-nfs-proc-create.html" title="probe::nfs.proc.create"></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>probe::nfs.proc.commit_setup</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-proc-commit-done.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-proc-create.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.proc.commit_setup"><a name="API-nfs-proc-commit-setup"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.proc.commit_setup —
- NFS client setting up a commit RPC task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.proc.commit_setup </pre></div><div class="refsect1" title="Values"><a name="idp13090896"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
- bytes in this commit
- </p></dd><dt><span class="term"><em class="parameter"><code>bitmask1</code></em></span></dt><dd><p>
- V4 bitmask representing the set
- of attributes supported on this filesystem
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- NFS version
- </p></dd><dt><span class="term"><em class="parameter"><code>bitmask0</code></em></span></dt><dd><p>
- V4 bitmask representing the set
- of attributes supported on this filesystem
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- bytes in this commit
- </p></dd><dt><span class="term"><em class="parameter"><code>offset</code></em></span></dt><dd><p>
- the file offset
- </p></dd><dt><span class="term"><em class="parameter"><code>server_ip</code></em></span></dt><dd><p>
- IP address of server
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp13108320"></a><h2>Description</h2><p>
- The commit_setup function is used to setup a commit RPC task.
- Is is not doing the actual commit operation.
- It is does not exist in NFSv2.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-proc-commit-done.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-proc-create.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.proc.commit_done</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.proc.create</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.proc.commit</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-fop-write.html" title="probe::nfs.fop.write"><link rel="next" href="API-nfs-proc-commit-done.html" title="probe::nfs.proc.commit_done"></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>probe::nfs.proc.commit</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-fop-write.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-proc-commit-done.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.proc.commit"><a name="API-nfs-proc-commit"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.proc.commit —
- NFS client committing data on server
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.proc.commit </pre></div><div class="refsect1" title="Values"><a name="idp13043280"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>bitmask1</code></em></span></dt><dd><p>
- V4 bitmask representing the set
- of attributes supported on this filesystem
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- NFS version
- </p></dd><dt><span class="term"><em class="parameter"><code>bitmask0</code></em></span></dt><dd><p>
- V4 bitmask representing the set
- of attributes supported on this filesystem
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- read bytes in this execution
- </p></dd><dt><span class="term"><em class="parameter"><code>offset</code></em></span></dt><dd><p>
- the file offset
- </p></dd><dt><span class="term"><em class="parameter"><code>server_ip</code></em></span></dt><dd><p>
- IP address of server
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp13058688"></a><h2>Description</h2><p>
- All the nfs.proc.commit kernel functions were removed in kernel
- commit 200baa in December 2006, so these probes do not exist on Linux
- 2.6.21 and newer kernels.
- </p><p>
-
- Fires when client writes the buffered data to disk.
- The buffered data is asynchronously written by client earlier.
- The commit function works in sync way.
- This probe point does not exist in NFSv2.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-fop-write.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-proc-commit-done.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.fop.write</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.proc.commit_done</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.proc.create</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-proc-commit-setup.html" title="probe::nfs.proc.commit_setup"><link rel="next" href="API-nfs-proc-handle-exception.html" title="probe::nfs.proc.handle_exception"></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>probe::nfs.proc.create</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-proc-commit-setup.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-proc-handle-exception.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.proc.create"><a name="API-nfs-proc-create"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.proc.create —
- NFS client creating file on server
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.proc.create </pre></div><div class="refsect1" title="Values"><a name="idp13116336"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- NFS version (the function is used for all NFS version)
- </p></dd><dt><span class="term"><em class="parameter"><code>flag</code></em></span></dt><dd><p>
- indicates create mode (only for NFSv3 and NFSv4)
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>filelen</code></em></span></dt><dd><p>
- length of file name
- </p></dd><dt><span class="term"><em class="parameter"><code>filename</code></em></span></dt><dd><p>
- file name
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handler of parent dir
- </p></dd><dt><span class="term"><em class="parameter"><code>server_ip</code></em></span></dt><dd><p>
- IP address of server
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-proc-commit-setup.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-proc-handle-exception.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.proc.commit_setup</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.proc.handle_exception</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.proc.handle_exception</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-proc-create.html" title="probe::nfs.proc.create"><link rel="next" href="API-nfs-proc-lookup.html" title="probe::nfs.proc.lookup"></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>probe::nfs.proc.handle_exception</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-proc-create.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-proc-lookup.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.proc.handle_exception"><a name="API-nfs-proc-handle-exception"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.proc.handle_exception —
- NFS client handling an NFSv4 exception
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.proc.handle_exception </pre></div><div class="refsect1" title="Values"><a name="idp13138464"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>errorcode</code></em></span></dt><dd><p>
- indicates the type of error
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp13141664"></a><h2>Description</h2><p>
- This is the error handling routine for processes for NFSv4.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-proc-create.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-proc-lookup.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.proc.create</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.proc.lookup</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.proc.lookup</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-proc-handle-exception.html" title="probe::nfs.proc.handle_exception"><link rel="next" href="API-nfs-proc-open.html" title="probe::nfs.proc.open"></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>probe::nfs.proc.lookup</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-proc-handle-exception.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-proc-open.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.proc.lookup"><a name="API-nfs-proc-lookup"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.proc.lookup —
- NFS client opens/searches a file on server
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.proc.lookup </pre></div><div class="refsect1" title="Values"><a name="idp13149664"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name_len</code></em></span></dt><dd><p>
- the length of file name
- </p></dd><dt><span class="term"><em class="parameter"><code>filename</code></em></span></dt><dd><p>
- the name of file which client opens/searches on server
- </p></dd><dt><span class="term"><em class="parameter"><code>bitmask1</code></em></span></dt><dd><p>
- V4 bitmask representing the set
- of attributes supported on this filesystem
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- NFS version
- </p></dd><dt><span class="term"><em class="parameter"><code>bitmask0</code></em></span></dt><dd><p>
- V4 bitmask representing the set
- of attributes supported on this filesystem
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>server_ip</code></em></span></dt><dd><p>
- IP address of server
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-proc-handle-exception.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-proc-open.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.proc.handle_exception</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.proc.open</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.proc.open</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-proc-lookup.html" title="probe::nfs.proc.lookup"><link rel="next" href="API-nfs-proc-read.html" title="probe::nfs.proc.read"></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>probe::nfs.proc.open</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-proc-lookup.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-proc-read.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.proc.open"><a name="API-nfs-proc-open"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.proc.open —
- NFS client allocates file read/write context information
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.proc.open </pre></div><div class="refsect1" title="Values"><a name="idp13171808"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>mode</code></em></span></dt><dd><p>
- file mode
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- NFS version (the function is used for all NFS version)
- </p></dd><dt><span class="term"><em class="parameter"><code>flag</code></em></span></dt><dd><p>
- file flag
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>filename</code></em></span></dt><dd><p>
- file name
- </p></dd><dt><span class="term"><em class="parameter"><code>server_ip</code></em></span></dt><dd><p>
- IP address of server
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp13185072"></a><h2>Description</h2><p>
- Allocate file read/write context information
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-proc-lookup.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-proc-read.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.proc.lookup</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.proc.read</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.proc.read_done</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-proc-read.html" title="probe::nfs.proc.read"><link rel="next" href="API-nfs-proc-read-setup.html" title="probe::nfs.proc.read_setup"></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>probe::nfs.proc.read_done</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-proc-read.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-proc-read-setup.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.proc.read_done"><a name="API-nfs-proc-read-done"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.proc.read_done —
- NFS client response to a read RPC task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.proc.read_done </pre></div><div class="refsect1" title="Values"><a name="idp13214608"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
- number of bytes read
- </p></dd><dt><span class="term"><em class="parameter"><code>status</code></em></span></dt><dd><p>
- result of last operation
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- NFS version
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>timestamp</code></em></span></dt><dd><p>
- V4 timestamp, which is used for lease renewal
- </p></dd><dt><span class="term"><em class="parameter"><code>server_ip</code></em></span></dt><dd><p>
- IP address of server
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp13227904"></a><h2>Description</h2><p>
- Fires when a reply to a read RPC task is received or some read error occurs
- (timeout or socket shutdown).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-proc-read.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-proc-read-setup.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.proc.read</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.proc.read_setup</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.proc.read_setup</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-proc-read-done.html" title="probe::nfs.proc.read_done"><link rel="next" href="API-nfs-proc-release.html" title="probe::nfs.proc.release"></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>probe::nfs.proc.read_setup</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-proc-read-done.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-proc-release.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.proc.read_setup"><a name="API-nfs-proc-read-setup"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.proc.read_setup —
- NFS client setting up a read RPC task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.proc.read_setup </pre></div><div class="refsect1" title="Values"><a name="idp13235984"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
- read bytes in this execution
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- NFS version
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- read bytes in this execution
- </p></dd><dt><span class="term"><em class="parameter"><code>offset</code></em></span></dt><dd><p>
- the file offset
- </p></dd><dt><span class="term"><em class="parameter"><code>server_ip</code></em></span></dt><dd><p>
- IP address of server
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp13249248"></a><h2>Description</h2><p>
- The read_setup function is used to setup a read RPC task.
- It is not doing the actual read operation.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-proc-read-done.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-proc-release.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.proc.read_done</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.proc.release</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.proc.read</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-proc-open.html" title="probe::nfs.proc.open"><link rel="next" href="API-nfs-proc-read-done.html" title="probe::nfs.proc.read_done"></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>probe::nfs.proc.read</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-proc-open.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-proc-read-done.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.proc.read"><a name="API-nfs-proc-read"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.proc.read —
- NFS client synchronously reads file from server
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.proc.read </pre></div><div class="refsect1" title="Values"><a name="idp13193056"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
- read bytes in this execution
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- used to set task->tk_flags in rpc_init_task function
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- NFS version
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>offset</code></em></span></dt><dd><p>
- the file offset
- </p></dd><dt><span class="term"><em class="parameter"><code>server_ip</code></em></span></dt><dd><p>
- IP address of server
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp13206464"></a><h2>Description</h2><p>
- All the nfs.proc.read kernel functions were removed in kernel commit
- 8e0969 in December 2006, so these probes do not exist on Linux
- 2.6.21 and newer kernels.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-proc-open.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-proc-read-done.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.proc.open</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.proc.read_done</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.proc.release</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-proc-read-setup.html" title="probe::nfs.proc.read_setup"><link rel="next" href="API-nfs-proc-remove.html" title="probe::nfs.proc.remove"></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>probe::nfs.proc.release</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-proc-read-setup.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-proc-remove.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.proc.release"><a name="API-nfs-proc-release"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.proc.release —
- NFS client releases file read/write context information
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.proc.release </pre></div><div class="refsect1" title="Values"><a name="idp13257312"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>mode</code></em></span></dt><dd><p>
- file mode
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- NFS version (the function is used for all NFS version)
- </p></dd><dt><span class="term"><em class="parameter"><code>flag</code></em></span></dt><dd><p>
- file flag
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>filename</code></em></span></dt><dd><p>
- file name
- </p></dd><dt><span class="term"><em class="parameter"><code>server_ip</code></em></span></dt><dd><p>
- IP address of server
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp13270576"></a><h2>Description</h2><p>
- Release file read/write context information
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-proc-read-setup.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-proc-remove.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.proc.read_setup</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.proc.remove</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.proc.remove</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-proc-release.html" title="probe::nfs.proc.release"><link rel="next" href="API-nfs-proc-rename.html" title="probe::nfs.proc.rename"></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>probe::nfs.proc.remove</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-proc-release.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-proc-rename.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.proc.remove"><a name="API-nfs-proc-remove"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.proc.remove —
- NFS client removes a file on server
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.proc.remove </pre></div><div class="refsect1" title="Values"><a name="idp13278560"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- NFS version (the function is used for all NFS version)
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>filelen</code></em></span></dt><dd><p>
- length of file name
- </p></dd><dt><span class="term"><em class="parameter"><code>filename</code></em></span></dt><dd><p>
- file name
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handler of parent dir
- </p></dd><dt><span class="term"><em class="parameter"><code>server_ip</code></em></span></dt><dd><p>
- IP address of server
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-proc-release.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-proc-rename.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.proc.release</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.proc.rename</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.proc.rename</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-proc-remove.html" title="probe::nfs.proc.remove"><link rel="next" href="API-nfs-proc-write.html" title="probe::nfs.proc.write"></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>probe::nfs.proc.rename</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-proc-remove.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-proc-write.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.proc.rename"><a name="API-nfs-proc-rename"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.proc.rename —
- NFS client renames a file on server
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.proc.rename </pre></div><div class="refsect1" title="Values"><a name="idp13298512"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>new_fh</code></em></span></dt><dd><p>
- file handler of new parent dir
- </p></dd><dt><span class="term"><em class="parameter"><code>old_filelen</code></em></span></dt><dd><p>
- length of old file name
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- NFS version (the function is used for all NFS version)
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>new_filelen</code></em></span></dt><dd><p>
- length of new file name
- </p></dd><dt><span class="term"><em class="parameter"><code>old_fh</code></em></span></dt><dd><p>
- file handler of old parent dir
- </p></dd><dt><span class="term"><em class="parameter"><code>new_name</code></em></span></dt><dd><p>
- new file name
- </p></dd><dt><span class="term"><em class="parameter"><code>old_name</code></em></span></dt><dd><p>
- old file name
- </p></dd><dt><span class="term"><em class="parameter"><code>server_ip</code></em></span></dt><dd><p>
- IP address of server
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-proc-remove.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-proc-write.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.proc.remove</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.proc.write</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.proc.write_done</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-proc-write.html" title="probe::nfs.proc.write"><link rel="next" href="API-nfs-proc-write-setup.html" title="probe::nfs.proc.write_setup"></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>probe::nfs.proc.write_done</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-proc-write.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-proc-write-setup.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.proc.write_done"><a name="API-nfs-proc-write-done"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.proc.write_done —
- NFS client response to a write RPC task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.proc.write_done </pre></div><div class="refsect1" title="Values"><a name="idp13350352"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
- number of bytes written
- </p></dd><dt><span class="term"><em class="parameter"><code>status</code></em></span></dt><dd><p>
- result of last operation
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- NFS version
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>valid</code></em></span></dt><dd><p>
- fattr->valid ,indicates which fields are valid
- </p></dd><dt><span class="term"><em class="parameter"><code>timestamp</code></em></span></dt><dd><p>
- V4 timestamp, which is used for lease renewal
- </p></dd><dt><span class="term"><em class="parameter"><code>server_ip</code></em></span></dt><dd><p>
- IP address of server
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp13365776"></a><h2>Description</h2><p>
- Fires when a reply to a write RPC task is received or some write error occurs
- (timeout or socket shutdown).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-proc-write.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-proc-write-setup.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.proc.write</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.proc.write_setup</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.proc.write_setup</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-proc-write-done.html" title="probe::nfs.proc.write_done"><link rel="next" href="API-nfsd-close.html" title="probe::nfsd.close"></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>probe::nfs.proc.write_setup</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-proc-write-done.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-close.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.proc.write_setup"><a name="API-nfs-proc-write-setup"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.proc.write_setup —
- NFS client setting up a write RPC task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.proc.write_setup </pre></div><div class="refsect1" title="Values"><a name="idp13373888"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
- bytes written in this execution
- </p></dd><dt><span class="term"><em class="parameter"><code>bitmask1</code></em></span></dt><dd><p>
- V4 bitmask representing the set
- of attributes supported on this filesystem
- </p></dd><dt><span class="term"><em class="parameter"><code>how</code></em></span></dt><dd><p>
- used to set args.stable. The stable value could be:
- NFS_UNSTABLE,NFS_DATA_SYNC,NFS_FILE_SYNC
- (in nfs.proc3.write_setup and nfs.proc4.write_setup)
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- NFS version
- </p></dd><dt><span class="term"><em class="parameter"><code>bitmask0</code></em></span></dt><dd><p>
- V4 bitmask representing the set
- of attributes supported on this filesystem
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- bytes written in this execution
- </p></dd><dt><span class="term"><em class="parameter"><code>offset</code></em></span></dt><dd><p>
- the file offset
- </p></dd><dt><span class="term"><em class="parameter"><code>server_ip</code></em></span></dt><dd><p>
- IP address of server
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp13393456"></a><h2>Description</h2><p>
- The write_setup function is used to setup a write RPC task.
- It is not doing the actual write operation.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-proc-write-done.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-close.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.proc.write_done</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.close</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfs.proc.write</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-proc-rename.html" title="probe::nfs.proc.rename"><link rel="next" href="API-nfs-proc-write-done.html" title="probe::nfs.proc.write_done"></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>probe::nfs.proc.write</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-proc-rename.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-proc-write-done.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfs.proc.write"><a name="API-nfs-proc-write"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfs.proc.write —
- NFS client synchronously writes file to server
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfs.proc.write </pre></div><div class="refsect1" title="Values"><a name="idp13324640"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- used to set task->tk_flags in rpc_init_task function
- </p></dd><dt><span class="term"><em class="parameter"><code>bitmask1</code></em></span></dt><dd><p>
- V4 bitmask representing the set
- of attributes supported on this filesystem
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- NFS version
- </p></dd><dt><span class="term"><em class="parameter"><code>bitmask0</code></em></span></dt><dd><p>
- V4 bitmask representing the set
- of attributes supported on this filesystem
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- read bytes in this execution
- </p></dd><dt><span class="term"><em class="parameter"><code>server_ip</code></em></span></dt><dd><p>
- IP address of server
- </p></dd><dt><span class="term"><em class="parameter"><code>offset</code></em></span></dt><dd><p>
- the file offset
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp13342208"></a><h2>Description</h2><p>
- All the nfs.proc.write kernel functions were removed in kernel commit
- 200baa in December 2006, so these probes do not exist on Linux
- 2.6.21 and newer kernels.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-proc-rename.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-proc-write-done.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.proc.rename</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.proc.write_done</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.close</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfs-proc-write-setup.html" title="probe::nfs.proc.write_setup"><link rel="next" href="API-nfsd-commit.html" title="probe::nfsd.commit"></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>probe::nfsd.close</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfs-proc-write-setup.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-commit.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.close"><a name="API-nfsd-close"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.close —
- NFS server closing a file for client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.close </pre></div><div class="refsect1" title="Values"><a name="idp13401456"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>filename</code></em></span></dt><dd><p>
- file name
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfs-proc-write-setup.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-commit.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfs.proc.write_setup</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.commit</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.commit</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsd-close.html" title="probe::nfsd.close"><link rel="next" href="API-nfsd-create.html" title="probe::nfsd.create"></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>probe::nfsd.commit</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-close.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-create.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.commit"><a name="API-nfsd-commit"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.commit —
- NFS server committing all pending writes to stable storage
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.commit </pre></div><div class="refsect1" title="Values"><a name="idp13411392"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
- read bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>flag</code></em></span></dt><dd><p>
- indicates whether this execution is a sync operation
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- read bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handle (the first part is the length of the file handle)
- </p></dd><dt><span class="term"><em class="parameter"><code>client_ip</code></em></span></dt><dd><p>
- the ip address of client
- </p></dd><dt><span class="term"><em class="parameter"><code>offset</code></em></span></dt><dd><p>
- the offset of file
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-close.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-create.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.close</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.create</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.create</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsd-commit.html" title="probe::nfsd.commit"><link rel="next" href="API-nfsd-createv3.html" title="probe::nfsd.createv3"></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>probe::nfsd.create</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-commit.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-createv3.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.create"><a name="API-nfsd-create"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.create —
- NFS server creating a file(regular,dir,device,fifo) for client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.create </pre></div><div class="refsect1" title="Values"><a name="idp13431440"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>iap_mode</code></em></span></dt><dd><p>
- file access mode
- </p></dd><dt><span class="term"><em class="parameter"><code>iap_valid</code></em></span></dt><dd><p>
- Attribute flags
- </p></dd><dt><span class="term"><em class="parameter"><code>filelen</code></em></span></dt><dd><p>
- the length of file name
- </p></dd><dt><span class="term"><em class="parameter"><code>filename</code></em></span></dt><dd><p>
- file name
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handle (the first part is the length of the file handle)
- </p></dd><dt><span class="term"><em class="parameter"><code>client_ip</code></em></span></dt><dd><p>
- the ip address of client
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- file type(regular,dir,device,fifo ...)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp13446752"></a><h2>Description</h2><p>
- Sometimes nfsd will call nfsd_create_v3 instead of this this probe point.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-commit.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-createv3.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.commit</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.createv3</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.createv3</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsd-create.html" title="probe::nfsd.create"><link rel="next" href="API-nfsd-dispatch.html" title="probe::nfsd.dispatch"></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>probe::nfsd.createv3</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-create.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-dispatch.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.createv3"><a name="API-nfsd-createv3"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.createv3 —
- NFS server creating a regular file or set file attributes for client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.createv3 </pre></div><div class="refsect1" title="Values"><a name="idp13454800"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>iap_mode</code></em></span></dt><dd><p>
- file access mode
- </p></dd><dt><span class="term"><em class="parameter"><code>createmode</code></em></span></dt><dd><p>
- create mode .The possible values could be: NFS3_CREATE_EXCLUSIVE, NFS3_CREATE_UNCHECKED, or NFS3_CREATE_GUARDED
- </p></dd><dt><span class="term"><em class="parameter"><code>verifier</code></em></span></dt><dd><p>
- file attributes (atime,mtime,mode). It's used to reset file attributes for CREATE_EXCLUSIVE
- </p></dd><dt><span class="term"><em class="parameter"><code>iap_valid</code></em></span></dt><dd><p>
- Attribute flags
- </p></dd><dt><span class="term"><em class="parameter"><code>truncp</code></em></span></dt><dd><p>
- trunp arguments, indicates if the file shouldbe truncate
- </p></dd><dt><span class="term"><em class="parameter"><code>filelen</code></em></span></dt><dd><p>
- the length of file name
- </p></dd><dt><span class="term"><em class="parameter"><code>filename</code></em></span></dt><dd><p>
- file name
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handle (the first part is the length of the file handle)
- </p></dd><dt><span class="term"><em class="parameter"><code>client_ip</code></em></span></dt><dd><p>
- the ip address of client
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp13474320"></a><h2>Description</h2><p>
- This probepoints is only called by nfsd3_proc_create and
- nfsd4_open when op_claim_type is NFS4_OPEN_CLAIM_NULL.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-create.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-dispatch.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.create</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.dispatch</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.dispatch</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsd-createv3.html" title="probe::nfsd.createv3"><link rel="next" href="API-nfsd-lookup.html" title="probe::nfsd.lookup"></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>probe::nfsd.dispatch</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-createv3.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-lookup.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.dispatch"><a name="API-nfsd-dispatch"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.dispatch —
- NFS server receives an operation from client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.dispatch </pre></div><div class="refsect1" title="Values"><a name="idp13482368"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>proto</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>proc</code></em></span></dt><dd><p>
- procedure number
- </p></dd><dt><span class="term"><em class="parameter"><code>prog</code></em></span></dt><dd><p>
- program number
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- nfs version
- </p></dd><dt><span class="term"><em class="parameter"><code>client_ip</code></em></span></dt><dd><p>
- the ip address of client
- </p></dd><dt><span class="term"><em class="parameter"><code>xid</code></em></span></dt><dd><p>
- transmission id
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-createv3.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-lookup.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.createv3</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.lookup</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.lookup</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsd-dispatch.html" title="probe::nfsd.dispatch"><link rel="next" href="API-nfsd-open.html" title="probe::nfsd.open"></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>probe::nfsd.lookup</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-dispatch.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-open.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.lookup"><a name="API-nfsd-lookup"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.lookup —
- NFS server opening or searching file for a file for client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.lookup </pre></div><div class="refsect1" title="Values"><a name="idp13502352"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>filelen</code></em></span></dt><dd><p>
- the length of file name
- </p></dd><dt><span class="term"><em class="parameter"><code>filename</code></em></span></dt><dd><p>
- file name
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handle of parent dir(the first part is the length of the file handle)
- </p></dd><dt><span class="term"><em class="parameter"><code>client_ip</code></em></span></dt><dd><p>
- the ip address of client
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-dispatch.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-open.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.dispatch</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.open</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.open</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsd-lookup.html" title="probe::nfsd.lookup"><link rel="next" href="API-nfsd-proc-commit.html" title="probe::nfsd.proc.commit"></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>probe::nfsd.open</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-lookup.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-proc-commit.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.open"><a name="API-nfsd-open"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.open —
- NFS server opening a file for client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.open </pre></div><div class="refsect1" title="Values"><a name="idp13518336"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>access</code></em></span></dt><dd><p>
- indicates the type of open (read/write/commit/readdir...)
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handle (the first part is the length of the file handle)
- </p></dd><dt><span class="term"><em class="parameter"><code>client_ip</code></em></span></dt><dd><p>
- the ip address of client
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- type of file (regular file or dir)
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-lookup.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-proc-commit.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.lookup</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.proc.commit</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.proc.commit</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsd-open.html" title="probe::nfsd.open"><link rel="next" href="API-nfsd-proc-create.html" title="probe::nfsd.proc.create"></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>probe::nfsd.proc.commit</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-open.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-proc-create.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.proc.commit"><a name="API-nfsd-proc-commit"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.proc.commit —
- NFS server performing a commit operation for client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.proc.commit </pre></div><div class="refsect1" title="Values"><a name="idp13534352"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
- read bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>proto</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- nfs version
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- read bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handle (the first part is the length of the file handle)
- </p></dd><dt><span class="term"><em class="parameter"><code>client_ip</code></em></span></dt><dd><p>
- the ip address of client
- </p></dd><dt><span class="term"><em class="parameter"><code>offset</code></em></span></dt><dd><p>
- the offset of file
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-open.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-proc-create.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.open</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.proc.create</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.proc.create</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsd-proc-commit.html" title="probe::nfsd.proc.commit"><link rel="next" href="API-nfsd-proc-lookup.html" title="probe::nfsd.proc.lookup"></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>probe::nfsd.proc.create</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-proc-commit.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-proc-lookup.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.proc.create"><a name="API-nfsd-proc-create"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.proc.create —
- NFS server creating a file for client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.proc.create </pre></div><div class="refsect1" title="Values"><a name="idp13556304"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>proto</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- nfs version
- </p></dd><dt><span class="term"><em class="parameter"><code>filelen</code></em></span></dt><dd><p>
- length of file name
- </p></dd><dt><span class="term"><em class="parameter"><code>filename</code></em></span></dt><dd><p>
- file name
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handle (the first part is the length of the file handle)
- </p></dd><dt><span class="term"><em class="parameter"><code>client_ip</code></em></span></dt><dd><p>
- the ip address of client
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-proc-commit.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-proc-lookup.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.proc.commit</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.proc.lookup</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.proc.lookup</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsd-proc-create.html" title="probe::nfsd.proc.create"><link rel="next" href="API-nfsd-proc-read.html" title="probe::nfsd.proc.read"></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>probe::nfsd.proc.lookup</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-proc-create.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-proc-read.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.proc.lookup"><a name="API-nfsd-proc-lookup"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.proc.lookup —
- NFS server opening or searching for a file for client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.proc.lookup </pre></div><div class="refsect1" title="Values"><a name="idp13576320"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>proto</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>filelen</code></em></span></dt><dd><p>
- the length of file name
- </p></dd><dt><span class="term"><em class="parameter"><code>filename</code></em></span></dt><dd><p>
- file name
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handle of parent dir (the first part is the length of the file handle)
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- nfs version
- </p></dd><dt><span class="term"><em class="parameter"><code>client_ip</code></em></span></dt><dd><p>
- the ip address of client
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-proc-create.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-proc-read.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.proc.create</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.proc.read</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.proc.read</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsd-proc-lookup.html" title="probe::nfsd.proc.lookup"><link rel="next" href="API-nfsd-proc-remove.html" title="probe::nfsd.proc.remove"></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>probe::nfsd.proc.read</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-proc-lookup.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-proc-remove.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.proc.read"><a name="API-nfsd-proc-read"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.proc.read —
- NFS server reading file for client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.proc.read </pre></div><div class="refsect1" title="Values"><a name="idp13596272"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>vec</code></em></span></dt><dd><p>
- struct kvec, includes buf address in kernel address and length of each buffer
- </p></dd><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
- read bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>proto</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handle (the first part is the length of the file handle)
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- nfs version
- </p></dd><dt><span class="term"><em class="parameter"><code>client_ip</code></em></span></dt><dd><p>
- the ip address of client
- </p></dd><dt><span class="term"><em class="parameter"><code>vlen</code></em></span></dt><dd><p>
- read blocks
- </p></dd><dt><span class="term"><em class="parameter"><code>offset</code></em></span></dt><dd><p>
- the offset of file
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- read bytes
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-proc-lookup.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-proc-remove.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.proc.lookup</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.proc.remove</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.proc.remove</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsd-proc-read.html" title="probe::nfsd.proc.read"><link rel="next" href="API-nfsd-proc-rename.html" title="probe::nfsd.proc.rename"></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>probe::nfsd.proc.remove</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-proc-read.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-proc-rename.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.proc.remove"><a name="API-nfsd-proc-remove"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.proc.remove —
- NFS server removing a file for client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.proc.remove </pre></div><div class="refsect1" title="Values"><a name="idp13622272"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>proto</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- nfs version
- </p></dd><dt><span class="term"><em class="parameter"><code>filelen</code></em></span></dt><dd><p>
- length of file name
- </p></dd><dt><span class="term"><em class="parameter"><code>filename</code></em></span></dt><dd><p>
- file name
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handle (the first part is the length of the file handle)
- </p></dd><dt><span class="term"><em class="parameter"><code>client_ip</code></em></span></dt><dd><p>
- the ip address of client
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-proc-read.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-proc-rename.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.proc.read</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.proc.rename</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.proc.rename</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsd-proc-remove.html" title="probe::nfsd.proc.remove"><link rel="next" href="API-nfsd-proc-write.html" title="probe::nfsd.proc.write"></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>probe::nfsd.proc.rename</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-proc-remove.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-proc-write.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.proc.rename"><a name="API-nfsd-proc-rename"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.proc.rename —
- NFS Server renaming a file for client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.proc.rename </pre></div><div class="refsect1" title="Values"><a name="idp13642272"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>tlen</code></em></span></dt><dd><p>
- length of new file name
- </p></dd><dt><span class="term"><em class="parameter"><code>flen</code></em></span></dt><dd><p>
- length of old file name
- </p></dd><dt><span class="term"><em class="parameter"><code>tfh</code></em></span></dt><dd><p>
- file handler of new path
- </p></dd><dt><span class="term"><em class="parameter"><code>filename</code></em></span></dt><dd><p>
- old file name
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handler of old path
- </p></dd><dt><span class="term"><em class="parameter"><code>client_ip</code></em></span></dt><dd><p>
- the ip address of client
- </p></dd><dt><span class="term"><em class="parameter"><code>tname</code></em></span></dt><dd><p>
- new file name
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-proc-remove.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-proc-write.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.proc.remove</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.proc.write</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.proc.write</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsd-proc-rename.html" title="probe::nfsd.proc.rename"><link rel="next" href="API-nfsd-read.html" title="probe::nfsd.read"></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>probe::nfsd.proc.write</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-proc-rename.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-read.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.proc.write"><a name="API-nfsd-proc-write"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.proc.write —
- NFS server writing data to file for client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.proc.write </pre></div><div class="refsect1" title="Values"><a name="idp13664240"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
- read bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>proto</code></em></span></dt><dd><p>
- transfer protocol
- </p></dd><dt><span class="term"><em class="parameter"><code>version</code></em></span></dt><dd><p>
- nfs version
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- read bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>vec</code></em></span></dt><dd><p>
- struct kvec, includes buf address in kernel address and length of each buffer
- </p></dd><dt><span class="term"><em class="parameter"><code>client_ip</code></em></span></dt><dd><p>
- the ip address of client
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handle (the first part is the length of the file handle)
- </p></dd><dt><span class="term"><em class="parameter"><code>vlen</code></em></span></dt><dd><p>
- read blocks
- </p></dd><dt><span class="term"><em class="parameter"><code>offset</code></em></span></dt><dd><p>
- the offset of file
- </p></dd><dt><span class="term"><em class="parameter"><code>stable</code></em></span></dt><dd><p>
- argp->stable
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-proc-rename.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-read.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.proc.rename</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.read</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.read</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsd-proc-write.html" title="probe::nfsd.proc.write"><link rel="next" href="API-nfsd-rename.html" title="probe::nfsd.rename"></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>probe::nfsd.read</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-proc-write.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-rename.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.read"><a name="API-nfsd-read"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.read —
- NFS server reading data from a file for client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.read </pre></div><div class="refsect1" title="Values"><a name="idp13692240"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
- read bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>file</code></em></span></dt><dd><p>
- argument file, indicates if the file has been opened.
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- read bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>vec</code></em></span></dt><dd><p>
- struct kvec, includes buf address in kernel address and length of each buffer
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handle (the first part is the length of the file handle)
- </p></dd><dt><span class="term"><em class="parameter"><code>client_ip</code></em></span></dt><dd><p>
- the ip address of client
- </p></dd><dt><span class="term"><em class="parameter"><code>vlen</code></em></span></dt><dd><p>
- read blocks
- </p></dd><dt><span class="term"><em class="parameter"><code>offset</code></em></span></dt><dd><p>
- the offset of file
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-proc-write.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-rename.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.proc.write</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.rename</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.rename</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsd-read.html" title="probe::nfsd.read"><link rel="next" href="API-nfsd-unlink.html" title="probe::nfsd.unlink"></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>probe::nfsd.rename</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-read.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-unlink.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.rename"><a name="API-nfsd-rename"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.rename —
- NFS server renaming a file for client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.rename </pre></div><div class="refsect1" title="Values"><a name="idp13716320"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>tlen</code></em></span></dt><dd><p>
- length of new file name
- </p></dd><dt><span class="term"><em class="parameter"><code>flen</code></em></span></dt><dd><p>
- length of old file name
- </p></dd><dt><span class="term"><em class="parameter"><code>tfh</code></em></span></dt><dd><p>
- file handler of new path
- </p></dd><dt><span class="term"><em class="parameter"><code>filename</code></em></span></dt><dd><p>
- old file name
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handler of old path
- </p></dd><dt><span class="term"><em class="parameter"><code>client_ip</code></em></span></dt><dd><p>
- the ip address of client
- </p></dd><dt><span class="term"><em class="parameter"><code>tname</code></em></span></dt><dd><p>
- new file name
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-read.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-unlink.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.read</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.unlink</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.unlink</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsd-rename.html" title="probe::nfsd.rename"><link rel="next" href="API-nfsd-write.html" title="probe::nfsd.write"></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>probe::nfsd.unlink</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-rename.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfsd-write.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.unlink"><a name="API-nfsd-unlink"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.unlink —
- NFS server removing a file or a directory for client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.unlink </pre></div><div class="refsect1" title="Values"><a name="idp13738192"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>filelen</code></em></span></dt><dd><p>
- the length of file name
- </p></dd><dt><span class="term"><em class="parameter"><code>filename</code></em></span></dt><dd><p>
- file name
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handle (the first part is the length of the file handle)
- </p></dd><dt><span class="term"><em class="parameter"><code>client_ip</code></em></span></dt><dd><p>
- the ip address of client
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- file type (file or dir)
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-rename.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfsd-write.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.rename</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfsd.write</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::nfsd.write</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="API-nfsd-unlink.html" title="probe::nfsd.unlink"><link rel="next" href="speculation.stp.html" title="Chapter 31. Speculation"></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>probe::nfsd.write</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-unlink.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="speculation.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::nfsd.write"><a name="API-nfsd-write"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::nfsd.write —
- NFS server writing data to a file for client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">nfsd.write </pre></div><div class="refsect1" title="Values"><a name="idp13756192"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
- read bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>file</code></em></span></dt><dd><p>
- argument file, indicates if the file has been opened.
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- read bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>vec</code></em></span></dt><dd><p>
- struct kvec, includes buf address in kernel address and length of each buffer
- </p></dd><dt><span class="term"><em class="parameter"><code>fh</code></em></span></dt><dd><p>
- file handle (the first part is the length of the file handle)
- </p></dd><dt><span class="term"><em class="parameter"><code>client_ip</code></em></span></dt><dd><p>
- the ip address of client
- </p></dd><dt><span class="term"><em class="parameter"><code>vlen</code></em></span></dt><dd><p>
- read blocks
- </p></dd><dt><span class="term"><em class="parameter"><code>offset</code></em></span></dt><dd><p>
- the offset of file
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-unlink.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="speculation.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.unlink</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 31. Speculation</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::nfsderror</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="prev" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"><link rel="next" href="API-nfs-aop-readpage.html" title="probe::nfs.aop.readpage"></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::nfsderror</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="nfsd.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Network File Storage Tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-nfs-aop-readpage.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::nfsderror"><a name="API-nfsderror"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::nfsderror —
- Convert nfsd error number into string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- nfsderror:string(err:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12593600"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>err</code></em></span></dt><dd><p>
- errnum
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12596752"></a><h2>Description</h2><p>
- This function returns a string for the error number
- passed into the function.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="nfsd.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="nfsd.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-nfs-aop-readpage.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 30. Network File Storage Tapsets </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::nfs.aop.readpage</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ntohl</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-ip-ntop.html" title="function::ip_ntop"><link rel="next" href="API-ntohll.html" title="function::ntohll"></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::ntohl</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ip-ntop.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ntohll.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ntohl"><a name="API-ntohl"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ntohl —
- Convert 32-bit long from network to host order
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ntohl:long(x:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp7683792"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>x</code></em></span></dt><dd><p>
- Value to convert
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ip-ntop.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ntohll.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ip_ntop</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::ntohll</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ntohll</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-ntohl.html" title="function::ntohl"><link rel="next" href="API-ntohs.html" title="function::ntohs"></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::ntohll</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ntohl.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ntohs.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ntohll"><a name="API-ntohll"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ntohll —
- Convert 64-bit long long from network to host order
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ntohll:long(x:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp7693680"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>x</code></em></span></dt><dd><p>
- Value to convert
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ntohl.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ntohs.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ntohl</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::ntohs</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ntohs</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-ntohll.html" title="function::ntohll"><link rel="next" href="API-netdev-change-mac.html" title="probe::netdev.change_mac"></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::ntohs</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ntohll.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-netdev-change-mac.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ntohs"><a name="API-ntohs"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ntohs —
- Convert 16-bit short from network to host order
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ntohs:long(x:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp7703600"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>x</code></em></span></dt><dd><p>
- Value to convert
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ntohll.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-netdev-change-mac.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ntohll</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::netdev.change_mac</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::pages_to_string</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-mem-page-size.html" title="function::mem_page_size"><link rel="next" href="API-proc-mem-data.html" title="function::proc_mem_data"></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::pages_to_string</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-mem-page-size.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-proc-mem-data.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::pages_to_string"><a name="API-pages-to-string"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::pages_to_string —
- Turns pages into a human readable string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- pages_to_string:string(pages:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6051632"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>pages</code></em></span></dt><dd><p>
- Number of pages to translate.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp6054688"></a><h2>Description</h2><p>
- Multiplies pages by <code class="function">page_size</code> to get the number of
- bytes and returns the result of <code class="function">bytes_to_string</code>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-mem-page-size.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-proc-mem-data.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::mem_page_size</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::proc_mem_data</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::panic</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="guru-delay.stp.html" title="Chapter 26. Guru tapsets"><link rel="prev" href="API-mdelay.html" title="function::mdelay"><link rel="next" href="API-udelay.html" title="function::udelay"></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::panic</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-mdelay.html">Prev</a> </td><th width="60%" align="center">Chapter 26. Guru tapsets</th><td width="20%" align="right"> <a accesskey="n" href="API-udelay.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::panic"><a name="API-panic"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::panic —
- trigger a panic
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- panic(msg:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11957152"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>msg</code></em></span></dt><dd><p>
- message to pass to kernel's <code class="function">panic</code> function
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11961040"></a><h2>Description</h2><p>
- This function triggers an immediate panic of the running
- kernel with a user-specified panic message.
- It requires guru mode.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-mdelay.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="guru-delay.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-udelay.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::mdelay</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::udelay</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::pexecname</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-module-name.html" title="function::module_name"><link rel="next" href="API-pgrp.html" title="function::pgrp"></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::pexecname</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-module-name.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-pgrp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::pexecname"><a name="API-pexecname"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::pexecname —
- Returns the execname of a target process's parent process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- pexecname:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4947328"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp4948480"></a><h2>Description</h2><p>
- This function returns the execname of a target
- process's parent procces.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-module-name.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-pgrp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::module_name</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::pgrp</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::pgrp</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-pexecname.html" title="function::pexecname"><link rel="next" href="API-pid.html" title="function::pid"></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::pgrp</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-pexecname.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-pid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::pgrp"><a name="API-pgrp"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::pgrp —
- Returns the process group ID of the current process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- pgrp:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4955904"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp4957056"></a><h2>Description</h2><p>
- This function returns the process group ID of the
- current process.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-pexecname.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-pid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::pexecname</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::pid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::pid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-pgrp.html" title="function::pgrp"><link rel="next" href="API-pid2execname.html" title="function::pid2execname"></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::pid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-pgrp.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-pid2execname.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::pid"><a name="API-pid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::pid —
- Returns the ID of a target process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- pid:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4964400"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp4965552"></a><h2>Description</h2><p>
- This function returns the ID of a target process.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-pgrp.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-pid2execname.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::pgrp</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::pid2execname</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::pid2execname</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-pid.html" title="function::pid"><link rel="next" href="API-pid2task.html" title="function::pid2task"></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::pid2execname</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-pid.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-pid2task.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::pid2execname"><a name="API-pid2execname"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::pid2execname —
- The name of the given process identifier
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- pid2execname:string(pid:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4972800"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>pid</code></em></span></dt><dd><p>
- process identifier
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp4975856"></a><h2>Description</h2><p>
- Return the name of the given process id.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-pid.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-pid2task.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::pid</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::pid2task</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::pid2task</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-pid2execname.html" title="function::pid2execname"><link rel="next" href="API-pn.html" title="function::pn"></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::pid2task</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-pid2execname.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-pn.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::pid2task"><a name="API-pid2task"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::pid2task —
- The task_struct of the given process identifier
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- pid2task:long(pid:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4983104"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>pid</code></em></span></dt><dd><p>
- process identifier
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp4986160"></a><h2>Description</h2><p>
- Return the task struct of the given process id.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-pid2execname.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-pn.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::pid2execname</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::pn</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::pn</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-pid2task.html" title="function::pid2task"><link rel="next" href="API-pointer-arg.html" title="function::pointer_arg"></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::pn</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-pid2task.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-pointer-arg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::pn"><a name="API-pn"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::pn —
- Returns the active probe name
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- pn:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp4993408"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp4994560"></a><h2>Description</h2><p>
- This function returns the script-level probe point
- associated with a currently running probe handler, including
- wild-card expansion effects. Context: The current probe point.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-pid2task.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-pointer-arg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::pid2task</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::pointer_arg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::pointer_arg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-pn.html" title="function::pn"><link rel="next" href="API-pp.html" title="function::pp"></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::pointer_arg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-pn.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-pp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::pointer_arg"><a name="API-pointer-arg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::pointer_arg —
- Return function argument as pointer value
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- pointer_arg:long(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5002016"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- index of argument to return
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5005072"></a><h2>Description</h2><p>
- Return the unsigned value of argument n, same as ulong_arg.
- Can be used with any type of pointer.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-pn.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-pp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::pn</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::pp</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::pp</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-pointer-arg.html" title="function::pointer_arg"><link rel="next" href="API-ppfunc.html" title="function::ppfunc"></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::pp</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-pointer-arg.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-ppfunc.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::pp"><a name="API-pp"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::pp —
- Returns the active probe point
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- pp:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5012448"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5013600"></a><h2>Description</h2><p>
- This function returns the fully-resolved probe point
- associated with a currently running probe handler, including alias
- and wild-card expansion effects. Context: The current probe point.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-pointer-arg.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-ppfunc.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::pointer_arg</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::ppfunc</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ppfunc</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-pp.html" title="function::pp"><link rel="next" href="API-ppid.html" title="function::ppid"></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::ppfunc</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-pp.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-ppid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ppfunc"><a name="API-ppfunc"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ppfunc —
- Returns the function name parsed from <code class="function">pp</code>
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ppfunc:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5021680"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5022832"></a><h2>Description</h2><p>
- This returns the function name from the current <code class="function">pp</code>.
- Not all <code class="function">pp</code> have functions in them, in which case "" is returned.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-pp.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-ppid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::pp</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::ppid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ppid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-ppfunc.html" title="function::ppfunc"><link rel="next" href="API-print-backtrace.html" title="function::print_backtrace"></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::ppid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ppfunc.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-print-backtrace.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ppid"><a name="API-ppid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ppid —
- Returns the process ID of a target process's parent process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ppid:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5031408"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5032560"></a><h2>Description</h2><p>
- This function return the process ID of the target proccess's parent process.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ppfunc.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-print-backtrace.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ppfunc</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::print_backtrace</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::print_backtrace</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-ppid.html" title="function::ppid"><link rel="next" href="API-print-regs.html" title="function::print_regs"></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::print_backtrace</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ppid.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-print-regs.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::print_backtrace"><a name="API-print-backtrace"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::print_backtrace —
- Print kernel stack back trace
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- print_backtrace()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5039904"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5041056"></a><h2>Description</h2><p>
- This function is equivalent to print_stack(<code class="function">backtrace</code>),
- except that deeper stack nesting may be supported. See print_ubacktrace
- for user-space backtrace.
- The function does not return a value.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ppid.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-print-regs.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ppid</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::print_regs</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::print_regs</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-print-backtrace.html" title="function::print_backtrace"><link rel="next" href="API-print-stack.html" title="function::print_stack"></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::print_regs</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-print-backtrace.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-print-stack.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::print_regs"><a name="API-print-regs"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::print_regs —
- Print a register dump
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- print_regs()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5049088"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5050240"></a><h2>Description</h2><p>
- This function prints a register dump. Does nothing if no registers are available for the probe point.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-print-backtrace.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-print-stack.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::print_backtrace</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::print_stack</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::print_stack</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-print-regs.html" title="function::print_regs"><link rel="next" href="API-print-syms.html" title="function::print_syms"></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::print_stack</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-print-regs.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-print-syms.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::print_stack"><a name="API-print-stack"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::print_stack —
- Print out kernel stack from string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- print_stack(stk:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5057616"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>stk</code></em></span></dt><dd><p>
- String with list of hexadecimal addresses
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5060672"></a><h2>Description</h2><p>
- This function performs a symbolic lookup of the addresses
- in the given string,
- which is assumed to be the result of a prior call to
- <code class="function">backtrace</code>.
- </p><p>
-
- Print one line per address, including the address, the
- name of the function containing the address, and an estimate of
- its position within that function. Return nothing.
-</p></div><div class="refsect1" title="NOTE"><a name="idp5063056"></a><h2>NOTE</h2><p>
- it is recommended to use <code class="function">print_syms</code> instead of this function.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-print-regs.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-print-syms.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::print_regs</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::print_syms</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::print_syms</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-print-stack.html" title="function::print_stack"><link rel="next" href="API-print-ubacktrace.html" title="function::print_ubacktrace"></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::print_syms</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-print-stack.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-print-ubacktrace.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::print_syms"><a name="API-print-syms"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::print_syms —
- Print out kernel stack from string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- print_syms(callers:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5070928"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>callers</code></em></span></dt><dd><p>
- String with list of hexadecimal (kernel) addresses
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5074064"></a><h2>Description</h2><p>
- This function performs a symbolic lookup of the addresses
- in the given string,
- which are assumed to be the result of prior calls to <code class="function">stack</code>,
- <code class="function">callers</code>, and similar functions.
- </p><p>
-
- Prints one line per address, including the address, the
- name of the function containing the address, and an estimate of
- its position within that function, as obtained by <code class="function">symdata</code>.
- Returns nothing.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-print-stack.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-print-ubacktrace.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::print_stack</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::print_ubacktrace</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::print_ubacktrace_brief</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-print-ubacktrace.html" title="function::print_ubacktrace"><link rel="next" href="API-print-ustack.html" title="function::print_ustack"></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::print_ubacktrace_brief</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-print-ubacktrace.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-print-ustack.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::print_ubacktrace_brief"><a name="API-print-ubacktrace-brief"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::print_ubacktrace_brief —
- Print stack back trace for current user-space task.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- print_ubacktrace_brief()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5095328"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5096480"></a><h2>Description</h2><p>
- </p><p>
-
- Equivalent to <code class="function">print_ubacktrace</code>, but output for each symbol is
- shorter (just name and offset, or just the hex address of no symbol
- could be found).
-</p></div><div class="refsect1" title="Note"><a name="idp5098656"></a><h2>Note</h2><p>
- To get (full) backtraces for user space applications and shared
- shared libraries not mentioned in the current script run stap with
- -d /path/to/exe-or-so and/or add --ldd to load all needed unwind data.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-print-ubacktrace.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-print-ustack.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::print_ubacktrace</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::print_ustack</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::print_ubacktrace</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-print-syms.html" title="function::print_syms"><link rel="next" href="API-print-ubacktrace-brief.html" title="function::print_ubacktrace_brief"></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::print_ubacktrace</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-print-syms.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-print-ubacktrace-brief.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::print_ubacktrace"><a name="API-print-ubacktrace"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::print_ubacktrace —
- Print stack back trace for current user-space task.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- print_ubacktrace()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5083872"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5085024"></a><h2>Description</h2><p>
- </p><p>
-
- Equivalent to print_ustack(<code class="function">ubacktrace</code>), except that deeper stack
- nesting may be supported. Returns nothing. See <code class="function">print_backtrace</code>
- for kernel backtrace.
-</p></div><div class="refsect1" title="Note"><a name="idp5087776"></a><h2>Note</h2><p>
- To get (full) backtraces for user space applications and shared
- shared libraries not mentioned in the current script run stap with
- -d /path/to/exe-or-so and/or add --ldd to load all needed unwind data.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-print-syms.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-print-ubacktrace-brief.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::print_syms</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::print_ubacktrace_brief</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::print_ustack</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-print-ubacktrace-brief.html" title="function::print_ubacktrace_brief"><link rel="next" href="API-print-usyms.html" title="function::print_usyms"></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::print_ustack</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-print-ubacktrace-brief.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-print-usyms.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::print_ustack"><a name="API-print-ustack"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::print_ustack —
- Print out stack for the current task from string.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- print_ustack(stk:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5106208"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>stk</code></em></span></dt><dd><p>
- String with list of hexadecimal addresses for the current task.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5109360"></a><h2>Description</h2><p>
- Perform a symbolic lookup of the addresses in the given string,
- which is assumed to be the result of a prior call to
- <code class="function">ubacktrace</code> for the current task.
- </p><p>
-
- Print one line per address, including the address, the
- name of the function containing the address, and an estimate of
- its position within that function. Return nothing.
-</p></div><div class="refsect1" title="NOTE"><a name="idp5111728"></a><h2>NOTE</h2><p>
- it is recommended to use <code class="function">print_usyms</code> instead of this function.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-print-ubacktrace-brief.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-print-usyms.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::print_ubacktrace_brief</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::print_usyms</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::print_usyms</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-print-ustack.html" title="function::print_ustack"><link rel="next" href="API-probe-type.html" title="function::probe_type"></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::print_usyms</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-print-ustack.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-probe-type.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::print_usyms"><a name="API-print-usyms"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::print_usyms —
- Print out user stack from string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- print_usyms(callers:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5119600"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>callers</code></em></span></dt><dd><p>
- String with list of hexadecimal (user) addresses
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5122736"></a><h2>Description</h2><p>
- This function performs a symbolic lookup of the addresses
- in the given string,
- which are assumed to be the result of prior calls to <code class="function">ustack</code>,
- <code class="function">ucallers</code>, and similar functions.
- </p><p>
-
- Prints one line per address, including the address, the
- name of the function containing the address, and an estimate of
- its position within that function, as obtained by <code class="function">usymdata</code>.
- Returns nothing.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-print-ustack.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-probe-type.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::print_ustack</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::probe_type</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::printk</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="logging.stp.html" title="Chapter 21. Logging Tapset"><link rel="prev" href="API-log.html" title="function::log"><link rel="next" href="API-warn.html" title="function::warn"></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::printk</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-log.html">Prev</a> </td><th width="60%" align="center">Chapter 21. Logging Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-warn.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::printk"><a name="API-printk"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::printk —
- Send a message to the kernel trace buffer
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- printk(level:long,msg:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11140496"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>level</code></em></span></dt><dd><p>
- an integer for the severity level (0=KERN_EMERG ... 7=KERN_DEBUG)
- </p></dd><dt><span class="term"><em class="parameter"><code>msg</code></em></span></dt><dd><p>
- The formatted message string
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11145728"></a><h2>Description</h2><p>
- Print a line of text to the kernel dmesg/console with the
- given severity. An implicit end-of-line is added. This function may
- not be safely called from all kernel probe contexts, so is restricted
- to guru mode only.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-log.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="logging.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-warn.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::log</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::warn</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::probe_type</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-print-usyms.html" title="function::print_usyms"><link rel="next" href="API-probefunc.html" title="function::probefunc"></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::probe_type</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-print-usyms.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-probefunc.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::probe_type"><a name="API-probe-type"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::probe_type —
- The low level probe handler type of the current probe.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- probe_type:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5132544"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5133696"></a><h2>Description</h2><p>
- Returns a short string describing the low level probe handler
- type for the current probe point. This is for informational purposes only.
- Depending on the low level probe handler different context functions can
- or cannot provide information about the current event (for example some
- probe handlers only trigger in user space and have no associated kernel
- context). High-level probes might map to the same or different low-level
- probes (depending on systemtap version and/or kernel used).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-print-usyms.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-probefunc.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::print_usyms</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::probefunc</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::probefunc</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-probe-type.html" title="function::probe_type"><link rel="next" href="API-probemod.html" title="function::probemod"></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::probefunc</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-probe-type.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-probemod.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::probefunc"><a name="API-probefunc"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::probefunc —
- Return the probe point's function name, if known
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- probefunc:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5141552"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5142704"></a><h2>Description</h2><p>
- This function returns the name of the function being probed
- based on the current address, as computed by symname(<code class="function">addr</code>) or
- usymname(<code class="function">uaddr</code>) depending on probe context (whether the probe is
- a user probe or a kernel probe).
-</p></div><div class="refsect1" title="Please note"><a name="idp5145344"></a><h2>Please note</h2><p>
- this function's behaviour differs between SystemTap 2.0
- and earlier versions. Prior to 2.0, <code class="function">probefunc</code> obtained the function
- name from the probe point string as returned by <code class="function">pp</code>, and used the
- current address as a fallback.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-probe-type.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-probemod.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::probe_type</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::probemod</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::probemod</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-probefunc.html" title="function::probefunc"><link rel="next" href="API-pstrace.html" title="function::pstrace"></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::probemod</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-probefunc.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-pstrace.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::probemod"><a name="API-probemod"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::probemod —
- Return the probe point's kernel module name
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- probemod:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5154048"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5155200"></a><h2>Description</h2><p>
- This function returns the name of the kernel module
- containing the probe point, if known.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-probefunc.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-pstrace.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::probefunc</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::pstrace</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::proc_mem_data_pid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-proc-mem-data.html" title="function::proc_mem_data"><link rel="next" href="API-proc-mem-rss.html" title="function::proc_mem_rss"></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::proc_mem_data_pid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-proc-mem-data.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-proc-mem-rss.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::proc_mem_data_pid"><a name="API-proc-mem-data-pid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::proc_mem_data_pid —
- Program data size (data + stack) in pages
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- proc_mem_data_pid:long(pid:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6071840"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>pid</code></em></span></dt><dd><p>
- The pid of process to examine
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp6074896"></a><h2>Description</h2><p>
- Returns the given process data size (data + stack)
- in pages, or zero when the process doesn't exist or the number of
- pages couldn't be retrieved.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-proc-mem-data.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-proc-mem-rss.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::proc_mem_data</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::proc_mem_rss</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::proc_mem_data</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-pages-to-string.html" title="function::pages_to_string"><link rel="next" href="API-proc-mem-data-pid.html" title="function::proc_mem_data_pid"></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::proc_mem_data</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-pages-to-string.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-proc-mem-data-pid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::proc_mem_data"><a name="API-proc-mem-data"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::proc_mem_data —
- Program data size (data + stack) in pages
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- proc_mem_data:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6063264"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp6064416"></a><h2>Description</h2><p>
- Returns the current process data size (data + stack)
- in pages, or zero when there is no current process or the number of
- pages couldn't be retrieved.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-pages-to-string.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-proc-mem-data-pid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::pages_to_string</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::proc_mem_data_pid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::proc_mem_rss_pid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-proc-mem-rss.html" title="function::proc_mem_rss"><link rel="next" href="API-proc-mem-shr.html" title="function::proc_mem_shr"></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::proc_mem_rss_pid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-proc-mem-rss.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-proc-mem-shr.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::proc_mem_rss_pid"><a name="API-proc-mem-rss-pid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::proc_mem_rss_pid —
- Program resident set size in pages
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- proc_mem_rss_pid:long(pid:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6090896"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>pid</code></em></span></dt><dd><p>
- The pid of process to examine
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp6093952"></a><h2>Description</h2><p>
- Returns the resident set size in pages of the given
- process, or zero when the process doesn't exist or the number of
- pages couldn't be retrieved.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-proc-mem-rss.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-proc-mem-shr.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::proc_mem_rss</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::proc_mem_shr</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::proc_mem_rss</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-proc-mem-data-pid.html" title="function::proc_mem_data_pid"><link rel="next" href="API-proc-mem-rss-pid.html" title="function::proc_mem_rss_pid"></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::proc_mem_rss</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-proc-mem-data-pid.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-proc-mem-rss-pid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::proc_mem_rss"><a name="API-proc-mem-rss"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::proc_mem_rss —
- Program resident set size in pages
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- proc_mem_rss:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6082320"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp6083472"></a><h2>Description</h2><p>
- Returns the resident set size in pages of the current
- process, or zero when there is no current process or the number of
- pages couldn't be retrieved.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-proc-mem-data-pid.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-proc-mem-rss-pid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::proc_mem_data_pid</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::proc_mem_rss_pid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::proc_mem_shr_pid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-proc-mem-shr.html" title="function::proc_mem_shr"><link rel="next" href="API-proc-mem-size.html" title="function::proc_mem_size"></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::proc_mem_shr_pid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-proc-mem-shr.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-proc-mem-size.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::proc_mem_shr_pid"><a name="API-proc-mem-shr-pid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::proc_mem_shr_pid —
- Program shared pages (from shared mappings)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- proc_mem_shr_pid:long(pid:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6109968"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>pid</code></em></span></dt><dd><p>
- The pid of process to examine
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp6113024"></a><h2>Description</h2><p>
- Returns the shared pages (from shared mappings) of the
- given process, or zero when the process doesn't exist or the
- number of pages couldn't be retrieved.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-proc-mem-shr.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-proc-mem-size.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::proc_mem_shr</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::proc_mem_size</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::proc_mem_shr</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-proc-mem-rss-pid.html" title="function::proc_mem_rss_pid"><link rel="next" href="API-proc-mem-shr-pid.html" title="function::proc_mem_shr_pid"></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::proc_mem_shr</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-proc-mem-rss-pid.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-proc-mem-shr-pid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::proc_mem_shr"><a name="API-proc-mem-shr"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::proc_mem_shr —
- Program shared pages (from shared mappings)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- proc_mem_shr:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6101376"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp6102528"></a><h2>Description</h2><p>
- Returns the shared pages (from shared mappings) of the
- current process, or zero when there is no current process or the
- number of pages couldn't be retrieved.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-proc-mem-rss-pid.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-proc-mem-shr-pid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::proc_mem_rss_pid</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::proc_mem_shr_pid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::proc_mem_size_pid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-proc-mem-size.html" title="function::proc_mem_size"><link rel="next" href="API-proc-mem-string.html" title="function::proc_mem_string"></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::proc_mem_size_pid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-proc-mem-size.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-proc-mem-string.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::proc_mem_size_pid"><a name="API-proc-mem-size-pid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::proc_mem_size_pid —
- Total program virtual memory size in pages
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- proc_mem_size_pid:long(pid:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6129040"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>pid</code></em></span></dt><dd><p>
- The pid of process to examine
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp6132096"></a><h2>Description</h2><p>
- Returns the total virtual memory size in pages of the
- given process, or zero when that process doesn't exist or the
- number of pages couldn't be retrieved.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-proc-mem-size.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-proc-mem-string.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::proc_mem_size</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::proc_mem_string</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::proc_mem_size</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-proc-mem-shr-pid.html" title="function::proc_mem_shr_pid"><link rel="next" href="API-proc-mem-size-pid.html" title="function::proc_mem_size_pid"></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::proc_mem_size</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-proc-mem-shr-pid.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-proc-mem-size-pid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::proc_mem_size"><a name="API-proc-mem-size"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::proc_mem_size —
- Total program virtual memory size in pages
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- proc_mem_size:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6120448"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp6121600"></a><h2>Description</h2><p>
- Returns the total virtual memory size in pages of the
- current process, or zero when there is no current process or the
- number of pages couldn't be retrieved.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-proc-mem-shr-pid.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-proc-mem-size-pid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::proc_mem_shr_pid</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::proc_mem_size_pid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::proc_mem_string_pid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-proc-mem-string.html" title="function::proc_mem_string"><link rel="next" href="API-proc-mem-txt.html" title="function::proc_mem_txt"></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::proc_mem_string_pid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-proc-mem-string.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-proc-mem-txt.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::proc_mem_string_pid"><a name="API-proc-mem-string-pid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::proc_mem_string_pid —
- Human readable string of process memory usage
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- proc_mem_string_pid:string(pid:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6148544"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>pid</code></em></span></dt><dd><p>
- The pid of process to examine
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp6151600"></a><h2>Description</h2><p>
- Returns a human readable string showing the size, rss,
- shr, txt and data of the memory used by the given process.
- For example <span class="quote">“<span class="quote">size: 301m, rss: 11m, shr: 8m, txt: 52k, data: 2248k</span>”</span>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-proc-mem-string.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-proc-mem-txt.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::proc_mem_string</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::proc_mem_txt</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::proc_mem_string</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-proc-mem-size-pid.html" title="function::proc_mem_size_pid"><link rel="next" href="API-proc-mem-string-pid.html" title="function::proc_mem_string_pid"></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::proc_mem_string</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-proc-mem-size-pid.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-proc-mem-string-pid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::proc_mem_string"><a name="API-proc-mem-string"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::proc_mem_string —
- Human readable string of current proc memory usage
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- proc_mem_string:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6139600"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp6140752"></a><h2>Description</h2><p>
- Returns a human readable string showing the size, rss,
- shr, txt and data of the memory used by the current process.
- For example <span class="quote">“<span class="quote">size: 301m, rss: 11m, shr: 8m, txt: 52k, data: 2248k</span>”</span>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-proc-mem-size-pid.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-proc-mem-string-pid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::proc_mem_size_pid</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::proc_mem_string_pid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::proc_mem_txt_pid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-proc-mem-txt.html" title="function::proc_mem_txt"><link rel="next" href="API-vm-fault-contains.html" title="function::vm_fault_contains"></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::proc_mem_txt_pid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-proc-mem-txt.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-vm-fault-contains.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::proc_mem_txt_pid"><a name="API-proc-mem-txt-pid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::proc_mem_txt_pid —
- Program text (code) size in pages
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- proc_mem_txt_pid:long(pid:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6167968"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>pid</code></em></span></dt><dd><p>
- The pid of process to examine
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp6171024"></a><h2>Description</h2><p>
- Returns the given process text (code) size in pages,
- or zero when the process doesn't exist or the number of pages
- couldn't be retrieved.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-proc-mem-txt.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-vm-fault-contains.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::proc_mem_txt</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::vm_fault_contains</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::proc_mem_txt</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-proc-mem-string-pid.html" title="function::proc_mem_string_pid"><link rel="next" href="API-proc-mem-txt-pid.html" title="function::proc_mem_txt_pid"></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::proc_mem_txt</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-proc-mem-string-pid.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-proc-mem-txt-pid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::proc_mem_txt"><a name="API-proc-mem-txt"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::proc_mem_txt —
- Program text (code) size in pages
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- proc_mem_txt:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6159392"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp6160544"></a><h2>Description</h2><p>
- Returns the current process text (code) size in pages,
- or zero when there is no current process or the number of pages
- couldn't be retrieved.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-proc-mem-string-pid.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-proc-mem-txt-pid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::proc_mem_string_pid</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::proc_mem_txt_pid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::pstrace</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-probemod.html" title="function::probemod"><link rel="next" href="API-register.html" title="function::register"></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::pstrace</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-probemod.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-register.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::pstrace"><a name="API-pstrace"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::pstrace —
- Chain of processes and pids back to init(1)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- pstrace:string(task:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5162560"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- Pointer to task struct of process
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5165616"></a><h2>Description</h2><p>
- This function returns a string listing execname and pid for each
- process starting from <em class="parameter"><code>task</code></em> back to the process ancestor
- that init(1) spawned.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-probemod.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-register.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::probemod</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::register</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::qs_done</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="queue_stats.stp.html" title="Chapter 22. Queue Statistics Tapset"><link rel="prev" href="queue_stats.stp.html" title="Chapter 22. Queue Statistics Tapset"><link rel="next" href="API-qs-run.html" title="function::qs_run"></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::qs_done</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="queue_stats.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 22. Queue Statistics Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-qs-run.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::qs_done"><a name="API-qs-done"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::qs_done —
- Function to record finishing request
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- qs_done(qname:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11166544"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>qname</code></em></span></dt><dd><p>
- the name of the service that finished
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11169760"></a><h2>Description</h2><p>
- This function records that a request
- originally from the given queue has completed being
- serviced.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="queue_stats.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="queue_stats.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-qs-run.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 22. Queue Statistics Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::qs_run</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::qs_run</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="queue_stats.stp.html" title="Chapter 22. Queue Statistics Tapset"><link rel="prev" href="API-qs-done.html" title="function::qs_done"><link rel="next" href="API-qs-wait.html" title="function::qs_wait"></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::qs_run</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-qs-done.html">Prev</a> </td><th width="60%" align="center">Chapter 22. Queue Statistics Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-qs-wait.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::qs_run"><a name="API-qs-run"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::qs_run —
- Function to record being moved from wait queue to being serviced
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- qs_run(qname:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11177792"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>qname</code></em></span></dt><dd><p>
- the name of the service being moved and started
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11181024"></a><h2>Description</h2><p>
- This function records that the previous enqueued
- request was removed from the given wait queue and is now
- being serviced.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-qs-done.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="queue_stats.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-qs-wait.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::qs_done</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::qs_wait</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::qs_wait</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="queue_stats.stp.html" title="Chapter 22. Queue Statistics Tapset"><link rel="prev" href="API-qs-run.html" title="function::qs_run"><link rel="next" href="API-qsq-blocked.html" title="function::qsq_blocked"></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::qs_wait</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-qs-run.html">Prev</a> </td><th width="60%" align="center">Chapter 22. Queue Statistics Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-qsq-blocked.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::qs_wait"><a name="API-qs-wait"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::qs_wait —
- Function to record enqueue requests
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- qs_wait(qname:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11189104"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>qname</code></em></span></dt><dd><p>
- the name of the queue requesting enqueue
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11192320"></a><h2>Description</h2><p>
- This function records that a new request
- was enqueued for the given queue name.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-qs-run.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="queue_stats.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-qsq-blocked.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::qs_run</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::qsq_blocked</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::qsq_blocked</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="queue_stats.stp.html" title="Chapter 22. Queue Statistics Tapset"><link rel="prev" href="API-qs-wait.html" title="function::qs_wait"><link rel="next" href="API-qsq-print.html" title="function::qsq_print"></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::qsq_blocked</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-qs-wait.html">Prev</a> </td><th width="60%" align="center">Chapter 22. Queue Statistics Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-qsq-print.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::qsq_blocked"><a name="API-qsq-blocked"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::qsq_blocked —
- Returns the time reqest was on the wait queue
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- qsq_blocked:long(qname:string,scale:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11200368"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>qname</code></em></span></dt><dd><p>
- queue name
- </p></dd><dt><span class="term"><em class="parameter"><code>scale</code></em></span></dt><dd><p>
- scale variable to take account for interval fraction
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11205600"></a><h2>Description</h2><p>
- This function returns the fraction of elapsed time during
- which one or more requests were on the wait queue.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-qs-wait.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="queue_stats.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-qsq-print.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::qs_wait</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::qsq_print</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::qsq_print</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="queue_stats.stp.html" title="Chapter 22. Queue Statistics Tapset"><link rel="prev" href="API-qsq-blocked.html" title="function::qsq_blocked"><link rel="next" href="API-qsq-service-time.html" title="function::qsq_service_time"></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::qsq_print</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-qsq-blocked.html">Prev</a> </td><th width="60%" align="center">Chapter 22. Queue Statistics Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-qsq-service-time.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::qsq_print"><a name="API-qsq-print"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::qsq_print —
- Prints a line of statistics for the given queue
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- qsq_print(qname:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11213552"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>qname</code></em></span></dt><dd><p>
- queue name
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11216736"></a><h2>Description</h2><p>
- This function prints a line containing the following
-</p></div><div class="refsect1" title="statistics for the given queue"><a name="idp11218000"></a><h2>statistics for the given queue</h2><p>
- the queue name,
- the average rate of requests per second,
- the average wait queue length,
- the average time on the wait queue,
- the average time to service a request,
- the percentage of time the wait queue was used,
- and the percentage of time request was being serviced.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-qsq-blocked.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="queue_stats.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-qsq-service-time.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::qsq_blocked</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::qsq_service_time</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::qsq_service_time</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="queue_stats.stp.html" title="Chapter 22. Queue Statistics Tapset"><link rel="prev" href="API-qsq-print.html" title="function::qsq_print"><link rel="next" href="API-qsq-start.html" title="function::qsq_start"></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::qsq_service_time</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-qsq-print.html">Prev</a> </td><th width="60%" align="center">Chapter 22. Queue Statistics Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-qsq-start.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::qsq_service_time"><a name="API-qsq-service-time"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::qsq_service_time —
- Amount of time per request service
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- qsq_service_time:long(qname:string,scale:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11226256"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>qname</code></em></span></dt><dd><p>
- queue name
- </p></dd><dt><span class="term"><em class="parameter"><code>scale</code></em></span></dt><dd><p>
- scale variable to take account for interval fraction
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11231488"></a><h2>Description</h2><p>
- This function returns the average time in microseconds
- required to service a request once it is removed from the wait queue.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-qsq-print.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="queue_stats.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-qsq-start.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::qsq_print</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::qsq_start</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::qsq_start</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="queue_stats.stp.html" title="Chapter 22. Queue Statistics Tapset"><link rel="prev" href="API-qsq-service-time.html" title="function::qsq_service_time"><link rel="next" href="API-qsq-throughput.html" title="function::qsq_throughput"></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::qsq_start</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-qsq-service-time.html">Prev</a> </td><th width="60%" align="center">Chapter 22. Queue Statistics Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-qsq-throughput.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::qsq_start"><a name="API-qsq-start"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::qsq_start —
- Function to reset the stats for a queue
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- qsq_start(qname:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11239504"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>qname</code></em></span></dt><dd><p>
- the name of the service that finished
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11242720"></a><h2>Description</h2><p>
- This function resets the statistics counters for the given
- queue, and restarts tracking from the moment the function was called.
- This function is also used to create intialize a queue.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-qsq-service-time.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="queue_stats.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-qsq-throughput.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::qsq_service_time</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::qsq_throughput</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::qsq_throughput</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="queue_stats.stp.html" title="Chapter 22. Queue Statistics Tapset"><link rel="prev" href="API-qsq-start.html" title="function::qsq_start"><link rel="next" href="API-qsq-utilization.html" title="function::qsq_utilization"></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::qsq_throughput</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-qsq-start.html">Prev</a> </td><th width="60%" align="center">Chapter 22. Queue Statistics Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-qsq-utilization.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::qsq_throughput"><a name="API-qsq-throughput"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::qsq_throughput —
- Number of requests served per unit time
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- qsq_throughput:long(qname:string,scale:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11250912"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>qname</code></em></span></dt><dd><p>
- queue name
- </p></dd><dt><span class="term"><em class="parameter"><code>scale</code></em></span></dt><dd><p>
- scale variable to take account for interval fraction
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11256144"></a><h2>Description</h2><p>
- This function returns the average number or requests
- served per microsecond.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-qsq-start.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="queue_stats.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-qsq-utilization.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::qsq_start</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::qsq_utilization</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::qsq_utilization</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="queue_stats.stp.html" title="Chapter 22. Queue Statistics Tapset"><link rel="prev" href="API-qsq-throughput.html" title="function::qsq_throughput"><link rel="next" href="API-qsq-wait-queue-length.html" title="function::qsq_wait_queue_length"></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::qsq_utilization</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-qsq-throughput.html">Prev</a> </td><th width="60%" align="center">Chapter 22. Queue Statistics Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-qsq-wait-queue-length.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::qsq_utilization"><a name="API-qsq-utilization"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::qsq_utilization —
- Fraction of time that any request was being serviced
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- qsq_utilization:long(qname:string,scale:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11264240"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>qname</code></em></span></dt><dd><p>
- queue name
- </p></dd><dt><span class="term"><em class="parameter"><code>scale</code></em></span></dt><dd><p>
- scale variable to take account for interval fraction
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11269472"></a><h2>Description</h2><p>
- This function returns the average time in microseconds
- that at least one request was being serviced.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-qsq-throughput.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="queue_stats.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-qsq-wait-queue-length.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::qsq_throughput</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::qsq_wait_queue_length</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::qsq_wait_queue_length</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="queue_stats.stp.html" title="Chapter 22. Queue Statistics Tapset"><link rel="prev" href="API-qsq-utilization.html" title="function::qsq_utilization"><link rel="next" href="API-qsq-wait-time.html" title="function::qsq_wait_time"></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::qsq_wait_queue_length</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-qsq-utilization.html">Prev</a> </td><th width="60%" align="center">Chapter 22. Queue Statistics Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-qsq-wait-time.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::qsq_wait_queue_length"><a name="API-qsq-wait-queue-length"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::qsq_wait_queue_length —
- length of wait queue
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- qsq_wait_queue_length:long(qname:string,scale:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11277616"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>qname</code></em></span></dt><dd><p>
- queue name
- </p></dd><dt><span class="term"><em class="parameter"><code>scale</code></em></span></dt><dd><p>
- scale variable to take account for interval fraction
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11282848"></a><h2>Description</h2><p>
- This function returns the average length of the wait queue
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-qsq-utilization.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="queue_stats.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-qsq-wait-time.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::qsq_utilization</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::qsq_wait_time</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::qsq_wait_time</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="queue_stats.stp.html" title="Chapter 22. Queue Statistics Tapset"><link rel="prev" href="API-qsq-wait-queue-length.html" title="function::qsq_wait_queue_length"><link rel="next" href="random.stp.html" title="Chapter 23. Random functions Tapset"></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::qsq_wait_time</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-qsq-wait-queue-length.html">Prev</a> </td><th width="60%" align="center">Chapter 22. Queue Statistics Tapset</th><td width="20%" align="right"> <a accesskey="n" href="random.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::qsq_wait_time"><a name="API-qsq-wait-time"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::qsq_wait_time —
- Amount of time in queue + service per request
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- qsq_wait_time:long(qname:string,scale:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11290768"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>qname</code></em></span></dt><dd><p>
- queue name
- </p></dd><dt><span class="term"><em class="parameter"><code>scale</code></em></span></dt><dd><p>
- scale variable to take account for interval fraction
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11296000"></a><h2>Description</h2><p>
- This function returns the average time in microseconds
- that it took for a request to be serviced (<code class="function">qs_wait</code> to <code class="function">qa_done</code>).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-qsq-wait-queue-length.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="queue_stats.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="random.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::qsq_wait_queue_length</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 23. Random functions Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::randint</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="random.stp.html" title="Chapter 23. Random functions Tapset"><link rel="prev" href="random.stp.html" title="Chapter 23. Random functions Tapset"><link rel="next" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"></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::randint</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="random.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 23. Random functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="conversions.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::randint"><a name="API-randint"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::randint —
- Return a random number between [0,n)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- randint:long(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11306784"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- Number past upper limit of range, not larger than 2**20.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="random.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="random.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="conversions.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 23. Random functions Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 24. String and data retrieving functions Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::read_stopwatch_ms</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-local-clock-us.html" title="function::local_clock_us"><link rel="next" href="API-read-stopwatch-ns.html" title="function::read_stopwatch_ns"></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::read_stopwatch_ms</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-local-clock-us.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-read-stopwatch-ns.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::read_stopwatch_ms"><a name="API-read-stopwatch-ms"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::read_stopwatch_ms —
- Reads the time in milliseconds for a stopwatch
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- read_stopwatch_ms:long(name:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5892432"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- stopwatch name
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5895488"></a><h2>Description</h2><p>
- Returns time in milliseconds for stopwatch <em class="parameter"><code>name</code></em>.
- Creates stopwatch <em class="parameter"><code>name</code></em> if it does not currently exist.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-local-clock-us.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-read-stopwatch-ns.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::local_clock_us</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::read_stopwatch_ns</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::read_stopwatch_ns</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-read-stopwatch-ms.html" title="function::read_stopwatch_ms"><link rel="next" href="API-read-stopwatch-s.html" title="function::read_stopwatch_s"></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::read_stopwatch_ns</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-read-stopwatch-ms.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-read-stopwatch-s.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::read_stopwatch_ns"><a name="API-read-stopwatch-ns"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::read_stopwatch_ns —
- Reads the time in nanoseconds for a stopwatch
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- read_stopwatch_ns:long(name:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5903984"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- stopwatch name
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5907040"></a><h2>Description</h2><p>
- Returns time in nanoseconds for stopwatch <em class="parameter"><code>name</code></em>.
- Creates stopwatch <em class="parameter"><code>name</code></em> if it does not currently exist.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-read-stopwatch-ms.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-read-stopwatch-s.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::read_stopwatch_ms</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::read_stopwatch_s</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::read_stopwatch_s</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-read-stopwatch-ns.html" title="function::read_stopwatch_ns"><link rel="next" href="API-read-stopwatch-us.html" title="function::read_stopwatch_us"></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::read_stopwatch_s</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-read-stopwatch-ns.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-read-stopwatch-us.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::read_stopwatch_s"><a name="API-read-stopwatch-s"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::read_stopwatch_s —
- Reads the time in seconds for a stopwatch
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- read_stopwatch_s:long(name:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5915536"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- stopwatch name
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5918592"></a><h2>Description</h2><p>
- Returns time in seconds for stopwatch <em class="parameter"><code>name</code></em>.
- Creates stopwatch <em class="parameter"><code>name</code></em> if it does not currently exist.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-read-stopwatch-ns.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-read-stopwatch-us.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::read_stopwatch_ns</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::read_stopwatch_us</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::read_stopwatch_us</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-read-stopwatch-s.html" title="function::read_stopwatch_s"><link rel="next" href="API-start-stopwatch.html" title="function::start_stopwatch"></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::read_stopwatch_us</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-read-stopwatch-s.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-start-stopwatch.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::read_stopwatch_us"><a name="API-read-stopwatch-us"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::read_stopwatch_us —
- Reads the time in microseconds for a stopwatch
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- read_stopwatch_us:long(name:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5927088"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- stopwatch name
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5930144"></a><h2>Description</h2><p>
- Returns time in microseconds for stopwatch <em class="parameter"><code>name</code></em>.
- Creates stopwatch <em class="parameter"><code>name</code></em> if it does not currently exist.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-read-stopwatch-s.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-start-stopwatch.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::read_stopwatch_s</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::start_stopwatch</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::real_mount</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="dentry.stp.html" title="Chapter 20. Directory-entry (dentry) Tapset"><link rel="prev" href="API-inode-name.html" title="function::inode_name"><link rel="next" href="API-reverse-path-walk.html" title="function::reverse_path_walk"></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::real_mount</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-inode-name.html">Prev</a> </td><th width="60%" align="center">Chapter 20. Directory-entry (dentry) Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-reverse-path-walk.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::real_mount"><a name="API-real-mount"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::real_mount —
- get the 'struct mount' pointer
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- real_mount:long(vfsmnt:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11055632"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>vfsmnt</code></em></span></dt><dd><p>
- Pointer to 'struct vfsmount'
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11058832"></a><h2>Description</h2><p>
- </p><p>
-
- Returns the 'struct mount' pointer value for a 'struct vfsmount'
- pointer.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-inode-name.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="dentry.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-reverse-path-walk.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::inode_name</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::reverse_path_walk</span></td></tr></table></div></body></html>
+++ /dev/null
-<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.76.1"><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="idp5173600"></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="idp5176656"></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></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>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::registers_valid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-register.html" title="function::register"><link rel="next" href="API-regparm.html" title="function::regparm"></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::registers_valid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-register.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-regparm.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::registers_valid"><a name="API-registers-valid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::registers_valid —
- Determines validity of <code class="function">register</code> and <code class="function">u_register</code> in current context
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- registers_valid:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5187392"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5188544"></a><h2>Description</h2><p>
- This function returns 1 if <code class="function">register</code> and <code class="function">u_register</code>
- can be used in the current context, or 0 otherwise.
- For example, <code class="function">registers_valid</code> returns 0
- when called from a begin or end probe.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-register.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-regparm.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::register</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::regparm</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::regparm</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-registers-valid.html" title="function::registers_valid"><link rel="next" href="API-remote-id.html" title="function::remote_id"></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::regparm</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-registers-valid.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-remote-id.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::regparm"><a name="API-regparm"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::regparm —
- Specify regparm value used to compile function
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- regparm(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5197760"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- original regparm value
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5200816"></a><h2>Description</h2><p>
- Call this function with argument n before accessing function
- arguments using the *_arg function is the function was build with the
- gcc -mregparm=n option.
- </p><p>
-
- (The i386 kernel is built with \-mregparm=3, so systemtap considers
- regparm(3) the default for kernel functions on that architecture.)
- Only valid on i386 and x86_64 (when probing 32bit applications).
- Produces an error on other architectures.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-registers-valid.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-remote-id.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::registers_valid</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::remote_id</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::remote_id</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-regparm.html" title="function::regparm"><link rel="next" href="API-remote-uri.html" title="function::remote_uri"></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::remote_id</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-regparm.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-remote-uri.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::remote_id"><a name="API-remote-id"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::remote_id —
- The index of this instance in a remote execution.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- remote_id:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5208864"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5210016"></a><h2>Description</h2><p>
- This function returns a number 0..N, which is the unique
- index of this particular script execution from a swarm of
- <span class="quote">“<span class="quote">stap --remote A --remote B ...</span>”</span> runs, and is the same number
- <span class="quote">“<span class="quote">stap --remote-prefix</span>”</span> would print. The function returns -1 if the
- script was not launched with <span class="quote">“<span class="quote">stap --remote</span>”</span>, or if the remote
- staprun/stapsh are older than version 1.7.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-regparm.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-remote-uri.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::regparm</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::remote_uri</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::remote_uri</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-remote-id.html" title="function::remote_id"><link rel="next" href="API-s32-arg.html" title="function::s32_arg"></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::remote_uri</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-remote-id.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-s32-arg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::remote_uri"><a name="API-remote-uri"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::remote_uri —
- The name of this instance in a remote execution.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- remote_uri:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5218816"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5219968"></a><h2>Description</h2><p>
- This function returns the remote host used to invoke
- this particular script execution from a swarm of <span class="quote">“<span class="quote">stap --remote</span>”</span> runs.
- It may not be unique among the swarm.
- The function returns an empty string if the script was not launched with
- <span class="quote">“<span class="quote">stap --remote</span>”</span>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-remote-id.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-s32-arg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::remote_id</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::s32_arg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::return_str</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="errno.stp.html" title="Chapter 18. Errno Tapset"><link rel="prev" href="API-errno-str.html" title="function::errno_str"><link rel="next" href="API-returnstr.html" title="function::returnstr"></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::return_str</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-errno-str.html">Prev</a> </td><th width="60%" align="center">Chapter 18. Errno Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-returnstr.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::return_str"><a name="API-return-str"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::return_str —
- Formats the return value as a string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- return_str:string(format:long,ret:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp10939440"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>format</code></em></span></dt><dd><p>
- Variable to determine return type base value
- </p></dd><dt><span class="term"><em class="parameter"><code>ret</code></em></span></dt><dd><p>
- Return value (typically <code class="envar">$return</code>)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10945088"></a><h2>Description</h2><p>
- This function is used by the syscall tapset, and
- returns a string. Set format equal to 1 for a decimal,
- 2 for hex, 3 for octal.
- </p><p>
-
- Note that this function is preferred over <code class="function">returnstr</code>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-errno-str.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="errno.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-returnstr.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::errno_str</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::returnstr</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::returnstr</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="errno.stp.html" title="Chapter 18. Errno Tapset"><link rel="prev" href="API-return-str.html" title="function::return_str"><link rel="next" href="API-returnval.html" title="function::returnval"></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::returnstr</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-return-str.html">Prev</a> </td><th width="60%" align="center">Chapter 18. Errno Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-returnval.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::returnstr"><a name="API-returnstr"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::returnstr —
- Formats the return value as a string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- returnstr:string(format:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp10954192"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>format</code></em></span></dt><dd><p>
- Variable to determine return type base value
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10957408"></a><h2>Description</h2><p>
- This function is used by the nd_syscall tapset, and
- returns a string. Set format equal to 1 for a decimal,
- 2 for hex, 3 for octal.
- </p><p>
-
- Note that this function should only be used in dwarfless probes
- (i.e. 'kprobe.function(<span class="quote">“<span class="quote">foo</span>”</span>)'). Other probes should use
- <code class="function">return_str</code>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-return-str.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="errno.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-returnval.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::return_str</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::returnval</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::returnval</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="errno.stp.html" title="Chapter 18. Errno Tapset"><link rel="prev" href="API-returnstr.html" title="function::returnstr"><link rel="next" href="dev.stp.html" title="Chapter 19. Device Tapset"></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::returnval</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-returnstr.html">Prev</a> </td><th width="60%" align="center">Chapter 18. Errno Tapset</th><td width="20%" align="right"> <a accesskey="n" href="dev.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::returnval"><a name="API-returnval"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::returnval —
- Possible return value of probed function
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- returnval:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp10966912"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp10968128"></a><h2>Description</h2><p>
- Return the value of the register in which function values
- are typically returned. Can be used in probes where <code class="envar">$return</code> isn't
- available. This is only a guess of the actual return value and can be
- totally wrong. Normally only used in dwarfless probes.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-returnstr.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="errno.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="dev.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::returnstr</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 19. Device Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::reverse_path_walk</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="dentry.stp.html" title="Chapter 20. Directory-entry (dentry) Tapset"><link rel="prev" href="API-real-mount.html" title="function::real_mount"><link rel="next" href="API-task-dentry-path.html" title="function::task_dentry_path"></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::reverse_path_walk</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-real-mount.html">Prev</a> </td><th width="60%" align="center">Chapter 20. Directory-entry (dentry) Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-task-dentry-path.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::reverse_path_walk"><a name="API-reverse-path-walk"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::reverse_path_walk —
- get the full dirent path
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- reverse_path_walk:string(dentry:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11067104"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dentry</code></em></span></dt><dd><p>
- Pointer to dentry.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11070304"></a><h2>Description</h2><p>
- </p><p>
-
- Returns the path name (partial path to mount point).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-real-mount.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="dentry.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-task-dentry-path.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::real_mount</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::task_dentry_path</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::s32_arg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-remote-uri.html" title="function::remote_uri"><link rel="next" href="API-s64-arg.html" title="function::s64_arg"></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::s32_arg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-remote-uri.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-s64-arg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::s32_arg"><a name="API-s32-arg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::s32_arg —
- Return function argument as signed 32-bit value
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- s32_arg:long(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5228256"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- index of argument to return
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5231312"></a><h2>Description</h2><p>
- Return the signed 32-bit value of argument n,
- same as int_arg.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-remote-uri.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-s64-arg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::remote_uri</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::s64_arg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::s64_arg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-s32-arg.html" title="function::s32_arg"><link rel="next" href="API-sid.html" title="function::sid"></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::s64_arg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-s32-arg.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-sid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::s64_arg"><a name="API-s64-arg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::s64_arg —
- Return function argument as signed 64-bit value
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- s64_arg:long(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5238640"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- index of argument to return
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5241696"></a><h2>Description</h2><p>
- Return the signed 64-bit value of argument n,
- same as longlong_arg.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-s32-arg.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-sid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::s32_arg</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::sid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sa_flags_str</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-is-sig-blocked.html" title="function::is_sig_blocked"><link rel="next" href="API-sa-handler-str.html" title="function::sa_handler_str"></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::sa_flags_str</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-is-sig-blocked.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sa-handler-str.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sa_flags_str"><a name="API-sa-flags-str"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sa_flags_str —
- Returns the string representation of sa_flags
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- sa_flags_str:string(sa_flags:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp10453312"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sa_flags</code></em></span></dt><dd><p>
- the set of flags to convert to string.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-is-sig-blocked.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sa-handler-str.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::is_sig_blocked</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::sa_handler_str</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sa_handler_str</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-sa-flags-str.html" title="function::sa_flags_str"><link rel="next" href="API-signal-str.html" title="function::signal_str"></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::sa_handler_str</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sa-flags-str.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-str.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sa_handler_str"><a name="API-sa-handler-str"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sa_handler_str —
- Returns the string representation of an sa_handler
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- sa_handler_str(handler:)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp10463328"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>handler</code></em></span></dt><dd><p>
- the sa_handler to convert to string.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10466544"></a><h2>Description</h2><p>
- Returns the string representation of an sa_handler.
- If it is not SIG_DFL, SIG_IGN or SIG_ERR, it will return the address
- of the handler.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sa-flags-str.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-str.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sa_flags_str</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::signal_str</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scheduler.balance</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"><link rel="prev" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"><link rel="next" href="API-scheduler-cpu-off.html" title="probe::scheduler.cpu_off"></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>probe::scheduler.balance</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="sched.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Scheduler Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scheduler-cpu-off.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scheduler.balance"><a name="API-scheduler-balance"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scheduler.balance —
- A cpu attempting to find more work.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scheduler.balance </pre></div><div class="refsect1" title="Values"><a name="idp6523616"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp6526816"></a><h2>Context</h2><p>
- The cpu looking for more work.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="sched.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="sched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scheduler-cpu-off.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 8. Scheduler Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scheduler.cpu_off</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scheduler.cpu_off</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"><link rel="prev" href="API-scheduler-balance.html" title="probe::scheduler.balance"><link rel="next" href="API-scheduler-cpu-on.html" title="probe::scheduler.cpu_on"></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>probe::scheduler.cpu_off</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scheduler-balance.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Scheduler Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scheduler-cpu-on.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scheduler.cpu_off"><a name="API-scheduler-cpu-off"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scheduler.cpu_off —
- Process is about to stop running on a cpu
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scheduler.cpu_off </pre></div><div class="refsect1" title="Values"><a name="idp6534768"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task_prev</code></em></span></dt><dd><p>
- the process leaving the cpu (same as current)
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>idle</code></em></span></dt><dd><p>
- boolean indicating whether current is the idle process
- </p></dd><dt><span class="term"><em class="parameter"><code>task_next</code></em></span></dt><dd><p>
- the process replacing current
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp6544096"></a><h2>Context</h2><p>
- The process leaving the cpu.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scheduler-balance.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="sched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scheduler-cpu-on.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scheduler.balance</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scheduler.cpu_on</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scheduler.cpu_on</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"><link rel="prev" href="API-scheduler-cpu-off.html" title="probe::scheduler.cpu_off"><link rel="next" href="API-scheduler-ctxswitch.html" title="probe::scheduler.ctxswitch"></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>probe::scheduler.cpu_on</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scheduler-cpu-off.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Scheduler Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scheduler-ctxswitch.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scheduler.cpu_on"><a name="API-scheduler-cpu-on"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scheduler.cpu_on —
- Process is beginning execution on a cpu
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scheduler.cpu_on </pre></div><div class="refsect1" title="Values"><a name="idp6551952"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task_prev</code></em></span></dt><dd><p>
- the process that was previously running on this cpu
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>idle</code></em></span></dt><dd><p>
- - boolean indicating whether current is the idle process
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp6559248"></a><h2>Context</h2><p>
- The resuming process.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scheduler-cpu-off.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="sched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scheduler-ctxswitch.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scheduler.cpu_off</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scheduler.ctxswitch</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scheduler.ctxswitch</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"><link rel="prev" href="API-scheduler-cpu-on.html" title="probe::scheduler.cpu_on"><link rel="next" href="API-scheduler-kthread-stop.html" title="probe::scheduler.kthread_stop"></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>probe::scheduler.ctxswitch</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scheduler-cpu-on.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Scheduler Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scheduler-kthread-stop.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scheduler.ctxswitch"><a name="API-scheduler-ctxswitch"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scheduler.ctxswitch —
- A context switch is occuring.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scheduler.ctxswitch </pre></div><div class="refsect1" title="Values"><a name="idp6567232"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>prev_pid</code></em></span></dt><dd><p>
- The PID of the process to be switched out
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>next_task_name</code></em></span></dt><dd><p>
- The name of the process to be switched in
- </p></dd><dt><span class="term"><em class="parameter"><code>nexttsk_state</code></em></span></dt><dd><p>
- the state of the process to be switched in
- </p></dd><dt><span class="term"><em class="parameter"><code>prev_priority</code></em></span></dt><dd><p>
- The priority of the process to be switched out
- </p></dd><dt><span class="term"><em class="parameter"><code>next_pid</code></em></span></dt><dd><p>
- The PID of the process to be switched in
- </p></dd><dt><span class="term"><em class="parameter"><code>next_priority</code></em></span></dt><dd><p>
- The priority of the process to be switched in
- </p></dd><dt><span class="term"><em class="parameter"><code>prevtsk_state</code></em></span></dt><dd><p>
- the state of the process to be switched out
- </p></dd><dt><span class="term"><em class="parameter"><code>next_tid</code></em></span></dt><dd><p>
- The TID of the process to be switched in
- </p></dd><dt><span class="term"><em class="parameter"><code>prev_task_name</code></em></span></dt><dd><p>
- The name of the process to be switched out
- </p></dd><dt><span class="term"><em class="parameter"><code>prev_tid</code></em></span></dt><dd><p>
- The TID of the process to be switched out
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scheduler-cpu-on.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="sched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scheduler-kthread-stop.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scheduler.cpu_on</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scheduler.kthread_stop</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scheduler.kthread_stop.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"><link rel="prev" href="API-scheduler-kthread-stop.html" title="probe::scheduler.kthread_stop"><link rel="next" href="API-scheduler-migrate.html" title="probe::scheduler.migrate"></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>probe::scheduler.kthread_stop.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scheduler-kthread-stop.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Scheduler Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scheduler-migrate.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scheduler.kthread_stop.return"><a name="API-scheduler-kthread-stop-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scheduler.kthread_stop.return —
- A kthread is stopped and gets the return value
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scheduler.kthread_stop.return </pre></div><div class="refsect1" title="Values"><a name="idp6609536"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>return_value</code></em></span></dt><dd><p>
- return value after stopping the thread
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scheduler-kthread-stop.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="sched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scheduler-migrate.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scheduler.kthread_stop</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scheduler.migrate</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scheduler.kthread_stop</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"><link rel="prev" href="API-scheduler-ctxswitch.html" title="probe::scheduler.ctxswitch"><link rel="next" href="API-scheduler-kthread-stop-return.html" title="probe::scheduler.kthread_stop.return"></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>probe::scheduler.kthread_stop</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scheduler-ctxswitch.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Scheduler Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scheduler-kthread-stop-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scheduler.kthread_stop"><a name="API-scheduler-kthread-stop"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scheduler.kthread_stop —
- A thread created by kthread_create is being stopped
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scheduler.kthread_stop </pre></div><div class="refsect1" title="Values"><a name="idp6597600"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>thread_priority</code></em></span></dt><dd><p>
- priority of the thread
- </p></dd><dt><span class="term"><em class="parameter"><code>thread_pid</code></em></span></dt><dd><p>
- PID of the thread being stopped
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scheduler-ctxswitch.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="sched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scheduler-kthread-stop-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scheduler.ctxswitch</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scheduler.kthread_stop.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scheduler.migrate</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"><link rel="prev" href="API-scheduler-kthread-stop-return.html" title="probe::scheduler.kthread_stop.return"><link rel="next" href="API-scheduler-process-exit.html" title="probe::scheduler.process_exit"></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>probe::scheduler.migrate</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scheduler-kthread-stop-return.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Scheduler Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scheduler-process-exit.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scheduler.migrate"><a name="API-scheduler-migrate"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scheduler.migrate —
- Task migrating across cpus
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scheduler.migrate </pre></div><div class="refsect1" title="Values"><a name="idp6621408"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>priority</code></em></span></dt><dd><p>
- priority of the task being migrated
- </p></dd><dt><span class="term"><em class="parameter"><code>cpu_from</code></em></span></dt><dd><p>
- the original cpu
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- the process that is being migrated
- </p></dd><dt><span class="term"><em class="parameter"><code>cpu_to</code></em></span></dt><dd><p>
- the destination cpu
- </p></dd><dt><span class="term"><em class="parameter"><code>pid</code></em></span></dt><dd><p>
- PID of the task being migrated
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scheduler-kthread-stop-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="sched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scheduler-process-exit.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scheduler.kthread_stop.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scheduler.process_exit</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scheduler.process_exit</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"><link rel="prev" href="API-scheduler-migrate.html" title="probe::scheduler.migrate"><link rel="next" href="API-scheduler-process-fork.html" title="probe::scheduler.process_fork"></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>probe::scheduler.process_exit</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scheduler-migrate.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Scheduler Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scheduler-process-fork.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scheduler.process_exit"><a name="API-scheduler-process-exit"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scheduler.process_exit —
- Process exiting
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scheduler.process_exit </pre></div><div class="refsect1" title="Values"><a name="idp6641408"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>priority</code></em></span></dt><dd><p>
- priority of the process exiting
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>pid</code></em></span></dt><dd><p>
- PID of the process exiting
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scheduler-migrate.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="sched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scheduler-process-fork.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scheduler.migrate</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scheduler.process_fork</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scheduler.process_fork</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"><link rel="prev" href="API-scheduler-process-exit.html" title="probe::scheduler.process_exit"><link rel="next" href="API-scheduler-process-free.html" title="probe::scheduler.process_free"></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>probe::scheduler.process_fork</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scheduler-process-exit.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Scheduler Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scheduler-process-free.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scheduler.process_fork"><a name="API-scheduler-process-fork"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scheduler.process_fork —
- Process forked
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scheduler.process_fork </pre></div><div class="refsect1" title="Values"><a name="idp6655328"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>parent_pid</code></em></span></dt><dd><p>
- PID of the parent process
- </p></dd><dt><span class="term"><em class="parameter"><code>child_pid</code></em></span></dt><dd><p>
- PID of the child process
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scheduler-process-exit.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="sched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scheduler-process-free.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scheduler.process_exit</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scheduler.process_free</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scheduler.process_free</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"><link rel="prev" href="API-scheduler-process-fork.html" title="probe::scheduler.process_fork"><link rel="next" href="API-scheduler-process-wait.html" title="probe::scheduler.process_wait"></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>probe::scheduler.process_free</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scheduler-process-fork.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Scheduler Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scheduler-process-wait.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scheduler.process_free"><a name="API-scheduler-process-free"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scheduler.process_free —
- Scheduler freeing a data structure for a process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scheduler.process_free </pre></div><div class="refsect1" title="Values"><a name="idp6669328"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>priority</code></em></span></dt><dd><p>
- priority of the process getting freed
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>pid</code></em></span></dt><dd><p>
- PID of the process getting freed
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scheduler-process-fork.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="sched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scheduler-process-wait.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scheduler.process_fork</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scheduler.process_wait</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scheduler.process_wait</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"><link rel="prev" href="API-scheduler-process-free.html" title="probe::scheduler.process_free"><link rel="next" href="API-scheduler-signal-send.html" title="probe::scheduler.signal_send"></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>probe::scheduler.process_wait</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scheduler-process-free.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Scheduler Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scheduler-signal-send.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scheduler.process_wait"><a name="API-scheduler-process-wait"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scheduler.process_wait —
- Scheduler starting to wait on a process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scheduler.process_wait </pre></div><div class="refsect1" title="Values"><a name="idp6683360"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>pid</code></em></span></dt><dd><p>
- PID of the process scheduler is waiting on
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scheduler-process-free.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="sched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scheduler-signal-send.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scheduler.process_free</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scheduler.signal_send</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scheduler.signal_send</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"><link rel="prev" href="API-scheduler-process-wait.html" title="probe::scheduler.process_wait"><link rel="next" href="API-scheduler-tick.html" title="probe::scheduler.tick"></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>probe::scheduler.signal_send</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scheduler-process-wait.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Scheduler Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scheduler-tick.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scheduler.signal_send"><a name="API-scheduler-signal-send"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scheduler.signal_send —
- Sending a signal
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scheduler.signal_send </pre></div><div class="refsect1" title="Values"><a name="idp6695344"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>signal_number</code></em></span></dt><dd><p>
- signal number
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>pid</code></em></span></dt><dd><p>
- pid of the process sending signal
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scheduler-process-wait.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="sched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scheduler-tick.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scheduler.process_wait</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scheduler.tick</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scheduler.tick</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"><link rel="prev" href="API-scheduler-signal-send.html" title="probe::scheduler.signal_send"><link rel="next" href="API-scheduler-wait-task.html" title="probe::scheduler.wait_task"></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>probe::scheduler.tick</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scheduler-signal-send.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Scheduler Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scheduler-wait-task.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scheduler.tick"><a name="API-scheduler-tick"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scheduler.tick —
- Schedulers internal tick, a processes timeslice accounting is updated
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scheduler.tick </pre></div><div class="refsect1" title="Values"><a name="idp6709328"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>idle</code></em></span></dt><dd><p>
- boolean indicating whether current is the idle process
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp6714576"></a><h2>Context</h2><p>
- The process whose accounting will be updated.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scheduler-signal-send.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="sched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scheduler-wait-task.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scheduler.signal_send</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scheduler.wait_task</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scheduler.wait_task</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"><link rel="prev" href="API-scheduler-tick.html" title="probe::scheduler.tick"><link rel="next" href="API-scheduler-wakeup.html" title="probe::scheduler.wakeup"></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>probe::scheduler.wait_task</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scheduler-tick.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Scheduler Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scheduler-wakeup.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scheduler.wait_task"><a name="API-scheduler-wait-task"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scheduler.wait_task —
- Waiting on a task to unschedule (become inactive)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scheduler.wait_task </pre></div><div class="refsect1" title="Values"><a name="idp6722544"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>task_pid</code></em></span></dt><dd><p>
- PID of the task the scheduler is waiting on
- </p></dd><dt><span class="term"><em class="parameter"><code>task_priority</code></em></span></dt><dd><p>
- priority of the task
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scheduler-tick.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="sched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scheduler-wakeup.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scheduler.tick</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scheduler.wakeup</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scheduler.wakeup_new</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"><link rel="prev" href="API-scheduler-wakeup.html" title="probe::scheduler.wakeup"><link rel="next" href="iosched.stp.html" title="Chapter 9. IO Scheduler and block IO Tapset"></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>probe::scheduler.wakeup_new</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scheduler-wakeup.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Scheduler Tapset</th><td width="20%" align="right"> <a accesskey="n" href="iosched.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scheduler.wakeup_new"><a name="API-scheduler-wakeup-new"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scheduler.wakeup_new —
- Newly created task is woken up for the first time
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scheduler.wakeup_new </pre></div><div class="refsect1" title="Values"><a name="idp6756624"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task_cpu</code></em></span></dt><dd><p>
- cpu of the task woken up
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>task_pid</code></em></span></dt><dd><p>
- PID of the new task woken up
- </p></dd><dt><span class="term"><em class="parameter"><code>task_priority</code></em></span></dt><dd><p>
- priority of the new task
- </p></dd><dt><span class="term"><em class="parameter"><code>task_state</code></em></span></dt><dd><p>
- state of the task woken up
- </p></dd><dt><span class="term"><em class="parameter"><code>task_tid</code></em></span></dt><dd><p>
- TID of the new task woken up
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scheduler-wakeup.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="sched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="iosched.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scheduler.wakeup</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 9. IO Scheduler and block IO Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scheduler.wakeup</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"><link rel="prev" href="API-scheduler-wait-task.html" title="probe::scheduler.wait_task"><link rel="next" href="API-scheduler-wakeup-new.html" title="probe::scheduler.wakeup_new"></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>probe::scheduler.wakeup</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scheduler-wait-task.html">Prev</a> </td><th width="60%" align="center">Chapter 8. Scheduler Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scheduler-wakeup-new.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scheduler.wakeup"><a name="API-scheduler-wakeup"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scheduler.wakeup —
- Task is woken up
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scheduler.wakeup </pre></div><div class="refsect1" title="Values"><a name="idp6736512"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task_cpu</code></em></span></dt><dd><p>
- cpu of the task being woken up
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>task_pid</code></em></span></dt><dd><p>
- PID of the task being woken up
- </p></dd><dt><span class="term"><em class="parameter"><code>task_priority</code></em></span></dt><dd><p>
- priority of the task being woken up
- </p></dd><dt><span class="term"><em class="parameter"><code>task_state</code></em></span></dt><dd><p>
- state of the task being woken up
- </p></dd><dt><span class="term"><em class="parameter"><code>task_tid</code></em></span></dt><dd><p>
- tid of the task being woken up
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scheduler-wait-task.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="sched.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scheduler-wakeup-new.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scheduler.wait_task</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scheduler.wakeup_new</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scsi.iocompleted</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="scsi.stp.html" title="Chapter 10. SCSI Tapset"><link rel="prev" href="scsi.stp.html" title="Chapter 10. SCSI Tapset"><link rel="next" href="API-scsi-iodispatching.html" title="probe::scsi.iodispatching"></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>probe::scsi.iocompleted</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="scsi.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 10. SCSI Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scsi-iodispatching.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scsi.iocompleted"><a name="API-scsi-iocompleted"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scsi.iocompleted —
- SCSI mid-layer running the completion processing for block device I/O requests
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scsi.iocompleted </pre></div><div class="refsect1" title="Values"><a name="idp7128064"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>device_state_str</code></em></span></dt><dd><p>
- The current state of the device, as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>dev_id</code></em></span></dt><dd><p>
- The scsi device id
- </p></dd><dt><span class="term"><em class="parameter"><code>channel</code></em></span></dt><dd><p>
- The channel number
- </p></dd><dt><span class="term"><em class="parameter"><code>data_direction</code></em></span></dt><dd><p>
- The data_direction specifies whether this command is from/to
- the device
- </p></dd><dt><span class="term"><em class="parameter"><code>lun</code></em></span></dt><dd><p>
- The lun number
- </p></dd><dt><span class="term"><em class="parameter"><code>host_no</code></em></span></dt><dd><p>
- The host number
- </p></dd><dt><span class="term"><em class="parameter"><code>data_direction_str</code></em></span></dt><dd><p>
- Data direction, as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>device_state</code></em></span></dt><dd><p>
- The current state of the device
- </p></dd><dt><span class="term"><em class="parameter"><code>req_addr</code></em></span></dt><dd><p>
- The current struct request pointer, as a number
- </p></dd><dt><span class="term"><em class="parameter"><code>goodbytes</code></em></span></dt><dd><p>
- The bytes completed
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="scsi.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="scsi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scsi-iodispatching.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 10. SCSI Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scsi.iodispatching</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scsi.iodispatching</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="scsi.stp.html" title="Chapter 10. SCSI Tapset"><link rel="prev" href="API-scsi-iocompleted.html" title="probe::scsi.iocompleted"><link rel="next" href="API-scsi-iodone.html" title="probe::scsi.iodone"></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>probe::scsi.iodispatching</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scsi-iocompleted.html">Prev</a> </td><th width="60%" align="center">Chapter 10. SCSI Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scsi-iodone.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scsi.iodispatching"><a name="API-scsi-iodispatching"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scsi.iodispatching —
- SCSI mid-layer dispatched low-level SCSI command
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scsi.iodispatching </pre></div><div class="refsect1" title="Values"><a name="idp7156272"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>device_state_str</code></em></span></dt><dd><p>
- The current state of the device, as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>dev_id</code></em></span></dt><dd><p>
- The scsi device id
- </p></dd><dt><span class="term"><em class="parameter"><code>channel</code></em></span></dt><dd><p>
- The channel number
- </p></dd><dt><span class="term"><em class="parameter"><code>data_direction</code></em></span></dt><dd><p>
- The data_direction specifies whether this command is from/to the device
- 0 (DMA_BIDIRECTIONAL), 1 (DMA_TO_DEVICE),
- 2 (DMA_FROM_DEVICE), 3 (DMA_NONE)
- </p></dd><dt><span class="term"><em class="parameter"><code>lun</code></em></span></dt><dd><p>
- The lun number
- </p></dd><dt><span class="term"><em class="parameter"><code>request_bufflen</code></em></span></dt><dd><p>
- The request buffer length
- </p></dd><dt><span class="term"><em class="parameter"><code>host_no</code></em></span></dt><dd><p>
- The host number
- </p></dd><dt><span class="term"><em class="parameter"><code>device_state</code></em></span></dt><dd><p>
- The current state of the device
- </p></dd><dt><span class="term"><em class="parameter"><code>data_direction_str</code></em></span></dt><dd><p>
- Data direction, as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>req_addr</code></em></span></dt><dd><p>
- The current struct request pointer, as a number
- </p></dd><dt><span class="term"><em class="parameter"><code>request_buffer</code></em></span></dt><dd><p>
- The request buffer address
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scsi-iocompleted.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="scsi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scsi-iodone.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scsi.iocompleted</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scsi.iodone</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scsi.iodone</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="scsi.stp.html" title="Chapter 10. SCSI Tapset"><link rel="prev" href="API-scsi-iodispatching.html" title="probe::scsi.iodispatching"><link rel="next" href="API-scsi-ioentry.html" title="probe::scsi.ioentry"></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>probe::scsi.iodone</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scsi-iodispatching.html">Prev</a> </td><th width="60%" align="center">Chapter 10. SCSI Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scsi-ioentry.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scsi.iodone"><a name="API-scsi-iodone"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scsi.iodone —
- SCSI command completed by low level driver and enqueued into the done queue.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scsi.iodone </pre></div><div class="refsect1" title="Values"><a name="idp7186528"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>device_state_str</code></em></span></dt><dd><p>
- The current state of the device, as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>dev_id</code></em></span></dt><dd><p>
- The scsi device id
- </p></dd><dt><span class="term"><em class="parameter"><code>channel</code></em></span></dt><dd><p>
- The channel number
- </p></dd><dt><span class="term"><em class="parameter"><code>data_direction</code></em></span></dt><dd><p>
- The data_direction specifies whether this command is
- from/to the device.
- </p></dd><dt><span class="term"><em class="parameter"><code>lun</code></em></span></dt><dd><p>
- The lun number
- </p></dd><dt><span class="term"><em class="parameter"><code>host_no</code></em></span></dt><dd><p>
- The host number
- </p></dd><dt><span class="term"><em class="parameter"><code>data_direction_str</code></em></span></dt><dd><p>
- Data direction, as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>device_state</code></em></span></dt><dd><p>
- The current state of the device
- </p></dd><dt><span class="term"><em class="parameter"><code>scsi_timer_pending</code></em></span></dt><dd><p>
- 1 if a timer is pending on this request
- </p></dd><dt><span class="term"><em class="parameter"><code>req_addr</code></em></span></dt><dd><p>
- The current struct request pointer, as a number
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scsi-iodispatching.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="scsi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scsi-ioentry.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scsi.iodispatching</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scsi.ioentry</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scsi.ioentry</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="scsi.stp.html" title="Chapter 10. SCSI Tapset"><link rel="prev" href="API-scsi-iodone.html" title="probe::scsi.iodone"><link rel="next" href="API-scsi-ioexecute.html" title="probe::scsi.ioexecute"></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>probe::scsi.ioentry</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scsi-iodone.html">Prev</a> </td><th width="60%" align="center">Chapter 10. SCSI Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scsi-ioexecute.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scsi.ioentry"><a name="API-scsi-ioentry"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scsi.ioentry —
- Prepares a SCSI mid-layer request
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scsi.ioentry </pre></div><div class="refsect1" title="Values"><a name="idp7214640"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>disk_major</code></em></span></dt><dd><p>
- The major number of the disk (-1 if no information)
- </p></dd><dt><span class="term"><em class="parameter"><code>device_state_str</code></em></span></dt><dd><p>
- The current state of the device, as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>device_state</code></em></span></dt><dd><p>
- The current state of the device
- </p></dd><dt><span class="term"><em class="parameter"><code>req_addr</code></em></span></dt><dd><p>
- The current struct request pointer, as a number
- </p></dd><dt><span class="term"><em class="parameter"><code>disk_minor</code></em></span></dt><dd><p>
- The minor number of the disk (-1 if no information)
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scsi-iodone.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="scsi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scsi-ioexecute.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scsi.iodone</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scsi.ioexecute</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scsi.ioexecute</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="scsi.stp.html" title="Chapter 10. SCSI Tapset"><link rel="prev" href="API-scsi-ioentry.html" title="probe::scsi.ioentry"><link rel="next" href="API-scsi-set-state.html" title="probe::scsi.set_state"></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>probe::scsi.ioexecute</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scsi-ioentry.html">Prev</a> </td><th width="60%" align="center">Chapter 10. SCSI Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-scsi-set-state.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scsi.ioexecute"><a name="API-scsi-ioexecute"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scsi.ioexecute —
- Create mid-layer SCSI request and wait for the result
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scsi.ioexecute </pre></div><div class="refsect1" title="Values"><a name="idp7232720"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>retries</code></em></span></dt><dd><p>
- Number of times to retry request
- </p></dd><dt><span class="term"><em class="parameter"><code>device_state_str</code></em></span></dt><dd><p>
- The current state of the device, as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>dev_id</code></em></span></dt><dd><p>
- The scsi device id
- </p></dd><dt><span class="term"><em class="parameter"><code>channel</code></em></span></dt><dd><p>
- The channel number
- </p></dd><dt><span class="term"><em class="parameter"><code>data_direction</code></em></span></dt><dd><p>
- The data_direction specifies whether this command is
- from/to the device.
- </p></dd><dt><span class="term"><em class="parameter"><code>lun</code></em></span></dt><dd><p>
- The lun number
- </p></dd><dt><span class="term"><em class="parameter"><code>timeout</code></em></span></dt><dd><p>
- Request timeout in seconds
- </p></dd><dt><span class="term"><em class="parameter"><code>request_bufflen</code></em></span></dt><dd><p>
- The data buffer buffer length
- </p></dd><dt><span class="term"><em class="parameter"><code>host_no</code></em></span></dt><dd><p>
- The host number
- </p></dd><dt><span class="term"><em class="parameter"><code>data_direction_str</code></em></span></dt><dd><p>
- Data direction, as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>device_state</code></em></span></dt><dd><p>
- The current state of the device
- </p></dd><dt><span class="term"><em class="parameter"><code>request_buffer</code></em></span></dt><dd><p>
- The data buffer address
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scsi-ioentry.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="scsi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-scsi-set-state.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scsi.ioentry</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scsi.set_state</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::scsi.set_state</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="scsi.stp.html" title="Chapter 10. SCSI Tapset"><link rel="prev" href="API-scsi-ioexecute.html" title="probe::scsi.ioexecute"><link rel="next" href="tty.stp.html" title="Chapter 11. TTY Tapset"></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>probe::scsi.set_state</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scsi-ioexecute.html">Prev</a> </td><th width="60%" align="center">Chapter 10. SCSI Tapset</th><td width="20%" align="right"> <a accesskey="n" href="tty.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::scsi.set_state"><a name="API-scsi-set-state"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::scsi.set_state —
- Order SCSI device state change
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">scsi.set_state </pre></div><div class="refsect1" title="Values"><a name="idp7264848"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>state_str</code></em></span></dt><dd><p>
- The new state of the device, as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>dev_id</code></em></span></dt><dd><p>
- The scsi device id
- </p></dd><dt><span class="term"><em class="parameter"><code>channel</code></em></span></dt><dd><p>
- The channel number
- </p></dd><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- The new state of the device
- </p></dd><dt><span class="term"><em class="parameter"><code>old_state_str</code></em></span></dt><dd><p>
- The current state of the device, as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>lun</code></em></span></dt><dd><p>
- The lun number
- </p></dd><dt><span class="term"><em class="parameter"><code>old_state</code></em></span></dt><dd><p>
- The current state of the device
- </p></dd><dt><span class="term"><em class="parameter"><code>host_no</code></em></span></dt><dd><p>
- The host number
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scsi-ioexecute.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="scsi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="tty.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scsi.ioexecute</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 11. TTY Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::set_kernel_char</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions-guru.stp.html" title="Chapter 25. String and data writing functions Tapset"><link rel="prev" href="conversions-guru.stp.html" title="Chapter 25. String and data writing functions Tapset"><link rel="next" href="API-set-kernel-int.html" title="function::set_kernel_int"></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::set_kernel_char</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="conversions-guru.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 25. String and data writing functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-set-kernel-int.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::set_kernel_char"><a name="API-set-kernel-char"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::set_kernel_char —
- Writes a char value to kernel memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- set_kernel_char(addr:long,val:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11848272"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to write the char to
- </p></dd><dt><span class="term"><em class="parameter"><code>val</code></em></span></dt><dd><p>
- The char which is to be written
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11853488"></a><h2>Description</h2><p>
- Writes the char value to a given kernel memory address.
- Reports an error when writing to the given address fails.
- Requires the use of guru mode (-g).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="conversions-guru.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions-guru.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-set-kernel-int.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 25. String and data writing functions Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::set_kernel_int</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::set_kernel_int</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions-guru.stp.html" title="Chapter 25. String and data writing functions Tapset"><link rel="prev" href="API-set-kernel-char.html" title="function::set_kernel_char"><link rel="next" href="API-set-kernel-long.html" title="function::set_kernel_long"></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::set_kernel_int</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-set-kernel-char.html">Prev</a> </td><th width="60%" align="center">Chapter 25. String and data writing functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-set-kernel-long.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::set_kernel_int"><a name="API-set-kernel-int"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::set_kernel_int —
- Writes an int value to kernel memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- set_kernel_int(addr:long,val:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11861648"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to write the int to
- </p></dd><dt><span class="term"><em class="parameter"><code>val</code></em></span></dt><dd><p>
- The int which is to be written
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11866864"></a><h2>Description</h2><p>
- Writes the int value to a given kernel memory address.
- Reports an error when writing to the given address fails.
- Requires the use of guru mode (-g).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-set-kernel-char.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions-guru.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-set-kernel-long.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::set_kernel_char</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::set_kernel_long</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::set_kernel_long</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions-guru.stp.html" title="Chapter 25. String and data writing functions Tapset"><link rel="prev" href="API-set-kernel-int.html" title="function::set_kernel_int"><link rel="next" href="API-set-kernel-pointer.html" title="function::set_kernel_pointer"></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::set_kernel_long</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-set-kernel-int.html">Prev</a> </td><th width="60%" align="center">Chapter 25. String and data writing functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-set-kernel-pointer.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::set_kernel_long"><a name="API-set-kernel-long"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::set_kernel_long —
- Writes a long value to kernel memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- set_kernel_long(addr:long,val:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11875024"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to write the long to
- </p></dd><dt><span class="term"><em class="parameter"><code>val</code></em></span></dt><dd><p>
- The long which is to be written
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11880240"></a><h2>Description</h2><p>
- Writes the long value to a given kernel memory address.
- Reports an error when writing to the given address fails.
- Requires the use of guru mode (-g).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-set-kernel-int.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions-guru.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-set-kernel-pointer.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::set_kernel_int</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::set_kernel_pointer</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::set_kernel_pointer</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions-guru.stp.html" title="Chapter 25. String and data writing functions Tapset"><link rel="prev" href="API-set-kernel-long.html" title="function::set_kernel_long"><link rel="next" href="API-set-kernel-short.html" title="function::set_kernel_short"></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::set_kernel_pointer</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-set-kernel-long.html">Prev</a> </td><th width="60%" align="center">Chapter 25. String and data writing functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-set-kernel-short.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::set_kernel_pointer"><a name="API-set-kernel-pointer"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::set_kernel_pointer —
- Writes a pointer value to kernel memory.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- set_kernel_pointer(addr:long,val:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11888400"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to write the pointer to
- </p></dd><dt><span class="term"><em class="parameter"><code>val</code></em></span></dt><dd><p>
- The pointer which is to be written
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11893616"></a><h2>Description</h2><p>
- Writes the pointer value to a given kernel memory address.
- Reports an error when writing to the given address fails.
- Requires the use of guru mode (-g).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-set-kernel-long.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions-guru.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-set-kernel-short.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::set_kernel_long</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::set_kernel_short</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::set_kernel_short</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions-guru.stp.html" title="Chapter 25. String and data writing functions Tapset"><link rel="prev" href="API-set-kernel-pointer.html" title="function::set_kernel_pointer"><link rel="next" href="API-set-kernel-string.html" title="function::set_kernel_string"></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::set_kernel_short</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-set-kernel-pointer.html">Prev</a> </td><th width="60%" align="center">Chapter 25. String and data writing functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-set-kernel-string.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::set_kernel_short"><a name="API-set-kernel-short"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::set_kernel_short —
- Writes a short value to kernel memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- set_kernel_short(addr:long,val:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11901728"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to write the short to
- </p></dd><dt><span class="term"><em class="parameter"><code>val</code></em></span></dt><dd><p>
- The short which is to be written
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11906944"></a><h2>Description</h2><p>
- Writes the short value to a given kernel memory address.
- Reports an error when writing to the given address fails.
- Requires the use of guru mode (-g).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-set-kernel-pointer.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions-guru.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-set-kernel-string.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::set_kernel_pointer</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::set_kernel_string</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::set_kernel_string_n</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions-guru.stp.html" title="Chapter 25. String and data writing functions Tapset"><link rel="prev" href="API-set-kernel-string.html" title="function::set_kernel_string"><link rel="next" href="guru-delay.stp.html" title="Chapter 26. Guru tapsets"></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::set_kernel_string_n</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-set-kernel-string.html">Prev</a> </td><th width="60%" align="center">Chapter 25. String and data writing functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="guru-delay.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::set_kernel_string_n"><a name="API-set-kernel-string-n"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::set_kernel_string_n —
- Writes a string of given length to kernel memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- set_kernel_string_n(addr:long,n:long,val:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11928416"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to write the string to
- </p></dd><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- The maximum length of the string
- </p></dd><dt><span class="term"><em class="parameter"><code>val</code></em></span></dt><dd><p>
- The string which is to be written
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11935632"></a><h2>Description</h2><p>
- Writes the given string up to a maximum given length to a
- given kernel memory address. Reports an error on string copy fault.
- Requires the use of guru mode (-g).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-set-kernel-string.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions-guru.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="guru-delay.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::set_kernel_string</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 26. Guru tapsets</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::set_kernel_string</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions-guru.stp.html" title="Chapter 25. String and data writing functions Tapset"><link rel="prev" href="API-set-kernel-short.html" title="function::set_kernel_short"><link rel="next" href="API-set-kernel-string-n.html" title="function::set_kernel_string_n"></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::set_kernel_string</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-set-kernel-short.html">Prev</a> </td><th width="60%" align="center">Chapter 25. String and data writing functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-set-kernel-string-n.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::set_kernel_string"><a name="API-set-kernel-string"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::set_kernel_string —
- Writes a string to kernel memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- set_kernel_string(addr:long,val:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11915040"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The kernel address to write the string to
- </p></dd><dt><span class="term"><em class="parameter"><code>val</code></em></span></dt><dd><p>
- The string which is to be written
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11920256"></a><h2>Description</h2><p>
- Writes the given string to a given kernel
- memory address. Reports an error on string copy fault.
- Requires the use of guru mode (-g).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-set-kernel-short.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions-guru.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-set-kernel-string-n.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::set_kernel_short</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::set_kernel_string_n</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-s64-arg.html" title="function::s64_arg"><link rel="next" href="API-sprint-backtrace.html" title="function::sprint_backtrace"></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::sid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-s64-arg.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-sprint-backtrace.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sid"><a name="API-sid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sid —
- Returns the session ID of the current process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- sid:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5249040"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5250192"></a><h2>Description</h2><p>
- The session ID of a process is the process group ID
- of the session leader. Session ID is stored in the signal_struct
- since Kernel 2.6.0.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-s64-arg.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-sprint-backtrace.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::s64_arg</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::sprint_backtrace</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.check_ignored.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-check-ignored.html" title="probe::signal.check_ignored"><link rel="next" href="API-signal-checkperm.html" title="probe::signal.checkperm"></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>probe::signal.check_ignored.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-check-ignored.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-checkperm.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.check_ignored.return"><a name="API-signal-check-ignored-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.check_ignored.return —
- Check to see signal is ignored completed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.check_ignored.return </pre></div><div class="refsect1" title="Values"><a name="idp10510640"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>retstr</code></em></span></dt><dd><p>
- Return value as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-check-ignored.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-checkperm.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.check_ignored</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.checkperm</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.check_ignored</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-sigset-mask-str.html" title="function::sigset_mask_str"><link rel="next" href="API-signal-check-ignored-return.html" title="probe::signal.check_ignored.return"></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>probe::signal.check_ignored</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sigset-mask-str.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-check-ignored-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.check_ignored"><a name="API-signal-check-ignored"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.check_ignored —
- Checking to see signal is ignored
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.check_ignored </pre></div><div class="refsect1" title="Values"><a name="idp10494560"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sig_name</code></em></span></dt><dd><p>
- A string representation of the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>sig</code></em></span></dt><dd><p>
- The number of the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>pid_name</code></em></span></dt><dd><p>
- Name of the process receiving the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_pid</code></em></span></dt><dd><p>
- The PID of the process receiving the signal
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sigset-mask-str.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-check-ignored-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sigset_mask_str</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.check_ignored.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.checkperm.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-checkperm.html" title="probe::signal.checkperm"><link rel="next" href="API-signal-do-action.html" title="probe::signal.do_action"></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>probe::signal.checkperm.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-checkperm.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-do-action.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.checkperm.return"><a name="API-signal-checkperm-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.checkperm.return —
- Check performed on a sent signal completed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.checkperm.return </pre></div><div class="refsect1" title="Values"><a name="idp10546768"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>retstr</code></em></span></dt><dd><p>
- Return value as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-checkperm.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-do-action.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.checkperm</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.do_action</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.checkperm</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-check-ignored-return.html" title="probe::signal.check_ignored.return"><link rel="next" href="API-signal-checkperm-return.html" title="probe::signal.checkperm.return"></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>probe::signal.checkperm</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-check-ignored-return.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-checkperm-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.checkperm"><a name="API-signal-checkperm"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.checkperm —
- Check being performed on a sent signal
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.checkperm </pre></div><div class="refsect1" title="Values"><a name="idp10522592"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- A task handle to the signal recipient
- </p></dd><dt><span class="term"><em class="parameter"><code>sinfo</code></em></span></dt><dd><p>
- The address of the siginfo structure
- </p></dd><dt><span class="term"><em class="parameter"><code>si_code</code></em></span></dt><dd><p>
- Indicates the signal type
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_name</code></em></span></dt><dd><p>
- A string representation of the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>sig</code></em></span></dt><dd><p>
- The number of the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>pid_name</code></em></span></dt><dd><p>
- Name of the process receiving the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_pid</code></em></span></dt><dd><p>
- The PID of the process receiving the signal
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-check-ignored-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-checkperm-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.check_ignored.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.checkperm.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.do_action.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-do-action.html" title="probe::signal.do_action"><link rel="next" href="API-signal-flush.html" title="probe::signal.flush"></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>probe::signal.do_action.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-do-action.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-flush.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.do_action.return"><a name="API-signal-do-action-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.do_action.return —
- Examining or changing a signal action completed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.do_action.return </pre></div><div class="refsect1" title="Values"><a name="idp10580720"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>retstr</code></em></span></dt><dd><p>
- Return value as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-do-action.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-flush.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.do_action</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.flush</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.do_action</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-checkperm-return.html" title="probe::signal.checkperm.return"><link rel="next" href="API-signal-do-action-return.html" title="probe::signal.do_action.return"></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>probe::signal.do_action</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-checkperm-return.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-do-action-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.do_action"><a name="API-signal-do-action"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.do_action —
- Examining or changing a signal action
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.do_action </pre></div><div class="refsect1" title="Values"><a name="idp10558608"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sa_mask</code></em></span></dt><dd><p>
- The new mask of the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_name</code></em></span></dt><dd><p>
- A string representation of the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>oldsigact_addr</code></em></span></dt><dd><p>
- The address of the old sigaction
- struct associated with the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>sig</code></em></span></dt><dd><p>
- The signal to be examined/changed
- </p></dd><dt><span class="term"><em class="parameter"><code>sa_handler</code></em></span></dt><dd><p>
- The new handler of the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>sigact_addr</code></em></span></dt><dd><p>
- The address of the new sigaction
- struct associated with the signal
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-checkperm-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-do-action-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.checkperm.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.do_action.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.flush</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-do-action-return.html" title="probe::signal.do_action.return"><link rel="next" href="API-signal-force-segv.html" title="probe::signal.force_segv"></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>probe::signal.flush</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-do-action-return.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-force-segv.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.flush"><a name="API-signal-flush"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.flush —
- Flushing all pending signals for a task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.flush </pre></div><div class="refsect1" title="Values"><a name="idp10592624"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- The task handler of the process performing the flush
- </p></dd><dt><span class="term"><em class="parameter"><code>pid_name</code></em></span></dt><dd><p>
- The name of the process associated with the task
- performing the flush
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_pid</code></em></span></dt><dd><p>
- The PID of the process associated with the task
- performing the flush
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-do-action-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-force-segv.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.do_action.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.force_segv</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.force_segv.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-force-segv.html" title="probe::signal.force_segv"><link rel="next" href="API-signal-handle.html" title="probe::signal.handle"></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>probe::signal.force_segv.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-force-segv.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-handle.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.force_segv.return"><a name="API-signal-force-segv-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.force_segv.return —
- Forcing send of SIGSEGV complete
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.force_segv.return </pre></div><div class="refsect1" title="Values"><a name="idp10626784"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>retstr</code></em></span></dt><dd><p>
- Return value as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-force-segv.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-handle.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.force_segv</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.handle</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.force_segv</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-flush.html" title="probe::signal.flush"><link rel="next" href="API-signal-force-segv-return.html" title="probe::signal.force_segv.return"></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>probe::signal.force_segv</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-flush.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-force-segv-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.force_segv"><a name="API-signal-force-segv"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.force_segv —
- Forcing send of SIGSEGV
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.force_segv </pre></div><div class="refsect1" title="Values"><a name="idp10608688"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_name</code></em></span></dt><dd><p>
- A string representation of the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>sig</code></em></span></dt><dd><p>
- The number of the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>pid_name</code></em></span></dt><dd><p>
- Name of the process receiving the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_pid</code></em></span></dt><dd><p>
- The PID of the process receiving the signal
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-flush.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-force-segv-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.flush</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.force_segv.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.handle.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-handle.html" title="probe::signal.handle"><link rel="next" href="API-signal-pending.html" title="probe::signal.pending"></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>probe::signal.handle.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-handle.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-pending.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.handle.return"><a name="API-signal-handle-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.handle.return —
- Signal handler invocation completed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.handle.return </pre></div><div class="refsect1" title="Values"><a name="idp10665104"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>retstr</code></em></span></dt><dd><p>
- Return value as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10670320"></a><h2>Description</h2><p>
- (deprecated in SystemTap 2.1)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-handle.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-pending.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.handle</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.pending</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.handle</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-force-segv-return.html" title="probe::signal.force_segv.return"><link rel="next" href="API-signal-handle-return.html" title="probe::signal.handle.return"></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>probe::signal.handle</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-force-segv-return.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-handle-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.handle"><a name="API-signal-handle"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.handle —
- Signal handler being invoked
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.handle </pre></div><div class="refsect1" title="Values"><a name="idp10638720"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>regs</code></em></span></dt><dd><p>
- The address of the kernel-mode stack area (deprecated in
- SystemTap 2.1)
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_code</code></em></span></dt><dd><p>
- The si_code value of the siginfo signal
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_mode</code></em></span></dt><dd><p>
- Indicates whether the signal was a user-mode or kernel-mode signal
- </p></dd><dt><span class="term"><em class="parameter"><code>sinfo</code></em></span></dt><dd><p>
- The address of the siginfo table
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_name</code></em></span></dt><dd><p>
- A string representation of the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>oldset_addr</code></em></span></dt><dd><p>
- The address of the bitmask array of blocked signals
- (deprecated in SystemTap 2.1)
- </p></dd><dt><span class="term"><em class="parameter"><code>sig</code></em></span></dt><dd><p>
- The signal number that invoked the signal handler
- </p></dd><dt><span class="term"><em class="parameter"><code>ka_addr</code></em></span></dt><dd><p>
- The address of the k_sigaction table
- associated with the signal
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-force-segv-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-handle-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.force_segv.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.handle.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.pending.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-pending.html" title="probe::signal.pending"><link rel="next" href="API-signal-procmask.html" title="probe::signal.procmask"></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>probe::signal.pending.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-pending.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-procmask.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.pending.return"><a name="API-signal-pending-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.pending.return —
- Examination of pending signal completed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.pending.return </pre></div><div class="refsect1" title="Values"><a name="idp10693728"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>retstr</code></em></span></dt><dd><p>
- Return value as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-pending.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-procmask.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.pending</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.procmask</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.pending</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-handle-return.html" title="probe::signal.handle.return"><link rel="next" href="API-signal-pending-return.html" title="probe::signal.pending.return"></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>probe::signal.pending</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-handle-return.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-pending-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.pending"><a name="API-signal-pending"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.pending —
- Examining pending signal
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.pending </pre></div><div class="refsect1" title="Values"><a name="idp10678272"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>sigset_size</code></em></span></dt><dd><p>
- The size of the user-space signal set
- </p></dd><dt><span class="term"><em class="parameter"><code>sigset_add</code></em></span></dt><dd><p>
- The address of the user-space signal set
- (sigset_t)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10685552"></a><h2>Description</h2><p>
- This probe is used to examine a set of signals pending for delivery
- to a specific thread. This normally occurs when the
- do_sigpending kernel function is executed.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-handle-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-pending-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.handle.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.pending.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.procmask.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-procmask.html" title="probe::signal.procmask"><link rel="next" href="API-signal-send.html" title="probe::signal.send"></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>probe::signal.procmask.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-procmask.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-send.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.procmask.return"><a name="API-signal-procmask-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.procmask.return —
- Examining or changing blocked signals completed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.procmask.return </pre></div><div class="refsect1" title="Values"><a name="idp10723984"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>retstr</code></em></span></dt><dd><p>
- Return value as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-procmask.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-send.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.procmask</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.send</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.procmask</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-pending-return.html" title="probe::signal.pending.return"><link rel="next" href="API-signal-procmask-return.html" title="probe::signal.procmask.return"></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>probe::signal.procmask</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-pending-return.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-procmask-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.procmask"><a name="API-signal-procmask"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.procmask —
- Examining or changing blocked signals
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.procmask </pre></div><div class="refsect1" title="Values"><a name="idp10705680"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>how</code></em></span></dt><dd><p>
- Indicates how to change the blocked signals; possible values are
- SIG_BLOCK=0 (for blocking signals),
- SIG_UNBLOCK=1 (for unblocking signals), and
- SIG_SETMASK=2 for setting the signal mask.
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>oldsigset_addr</code></em></span></dt><dd><p>
- The old address of the signal set
- (sigset_t)
- </p></dd><dt><span class="term"><em class="parameter"><code>sigset</code></em></span></dt><dd><p>
- The actual value to be set for sigset_t
- (correct?)
- </p></dd><dt><span class="term"><em class="parameter"><code>sigset_addr</code></em></span></dt><dd><p>
- The address of the signal set (sigset_t)
- to be implemented
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-pending-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-procmask-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.pending.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.procmask.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.send.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-send.html" title="probe::signal.send"><link rel="next" href="API-signal-send-sig-queue.html" title="probe::signal.send_sig_queue"></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>probe::signal.send.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-send.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-send-sig-queue.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.send.return"><a name="API-signal-send-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.send.return —
- Signal being sent to a process completed (deprecated in SystemTap 2.1)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.send.return </pre></div><div class="refsect1" title="Values"><a name="idp10765488"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>retstr</code></em></span></dt><dd><p>
- The return value to either __group_send_sig_info, specific_send_sig_info, or send_sigqueue
- </p></dd><dt><span class="term"><em class="parameter"><code>send2queue</code></em></span></dt><dd><p>
- Indicates whether the sent signal was sent to an existing sigqueue
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- The name of the function used to send out the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>shared</code></em></span></dt><dd><p>
- Indicates whether the sent signal is shared by the thread group.
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp10774928"></a><h2>Context</h2><p>
- The signal's sender. (correct?)
-</p></div><div class="refsect1" title="Description"><a name="idp10776160"></a><h2>Description</h2><p>
- Possible __group_send_sig_info and
- specific_send_sig_info return values are as follows;
- </p><p>
-
- 0 -- The signal is successfully sent to a process,
- which means that, (1) the signal was ignored by the receiving process,
- (2) this is a non-RT signal and the system already has one queued, and
- (3) the signal was successfully added to the sigqueue of the receiving process.
- </p><p>
-
- -EAGAIN -- The sigqueue of the receiving process is
- overflowing, the signal was RT, and the signal was sent by a user using something other
- than <code class="function">kill</code>.
- </p><p>
-
- Possible send_group_sigqueue and
- send_sigqueue return values are as follows;
- </p><p>
-
- 0 -- The signal was either successfully added into the
- sigqueue of the receiving process, or a SI_TIMER entry is already
- queued (in which case, the overrun count will be simply incremented).
- </p><p>
-
- 1 -- The signal was ignored by the receiving process.
- </p><p>
-
- -1 -- (send_sigqueue only) The task was marked
- exiting, allowing * posix_timer_event to redirect it to the group
- leader.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-send.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-send-sig-queue.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.send</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.send_sig_queue</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.send_sig_queue.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-send-sig-queue.html" title="probe::signal.send_sig_queue"><link rel="next" href="API-signal-sys-tgkill.html" title="probe::signal.sys_tgkill"></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>probe::signal.send_sig_queue.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-send-sig-queue.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-sys-tgkill.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.send_sig_queue.return"><a name="API-signal-send-sig-queue-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.send_sig_queue.return —
- Queuing a signal to a process completed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.send_sig_queue.return </pre></div><div class="refsect1" title="Values"><a name="idp10807696"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>retstr</code></em></span></dt><dd><p>
- Return value as a string
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-send-sig-queue.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-sys-tgkill.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.send_sig_queue</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.sys_tgkill</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.send_sig_queue</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-send-return.html" title="probe::signal.send.return"><link rel="next" href="API-signal-send-sig-queue-return.html" title="probe::signal.send_sig_queue.return"></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>probe::signal.send_sig_queue</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-send-return.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-send-sig-queue-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.send_sig_queue"><a name="API-signal-send-sig-queue"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.send_sig_queue —
- Queuing a signal to a process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.send_sig_queue </pre></div><div class="refsect1" title="Values"><a name="idp10787536"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sigqueue_addr</code></em></span></dt><dd><p>
- The address of the signal queue
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_name</code></em></span></dt><dd><p>
- A string representation of the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>sig</code></em></span></dt><dd><p>
- The queued signal
- </p></dd><dt><span class="term"><em class="parameter"><code>pid_name</code></em></span></dt><dd><p>
- Name of the process to which the signal is queued
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_pid</code></em></span></dt><dd><p>
- The PID of the process to which the signal is queued
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-send-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-send-sig-queue-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.send.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.send_sig_queue.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.send</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-procmask-return.html" title="probe::signal.procmask.return"><link rel="next" href="API-signal-send-return.html" title="probe::signal.send.return"></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>probe::signal.send</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-procmask-return.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-send-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.send"><a name="API-signal-send"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.send —
- Signal being sent to a process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.send </pre></div><div class="refsect1" title="Values"><a name="idp10735920"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>send2queue</code></em></span></dt><dd><p>
- Indicates whether the signal is sent to an existing
- sigqueue (deprecated in SystemTap 2.1)
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- The name of the function used to send out the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- A task handle to the signal recipient
- </p></dd><dt><span class="term"><em class="parameter"><code>sinfo</code></em></span></dt><dd><p>
- The address of siginfo struct
- </p></dd><dt><span class="term"><em class="parameter"><code>si_code</code></em></span></dt><dd><p>
- Indicates the signal type
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_name</code></em></span></dt><dd><p>
- A string representation of the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>sig</code></em></span></dt><dd><p>
- The number of the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>shared</code></em></span></dt><dd><p>
- Indicates whether the signal is shared by the thread group
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_pid</code></em></span></dt><dd><p>
- The PID of the process receiving the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>pid_name</code></em></span></dt><dd><p>
- The name of the signal recipient
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp10757456"></a><h2>Context</h2><p>
- The signal's sender.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-procmask-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-send-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.procmask.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.send.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::signal_str</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-sa-handler-str.html" title="function::sa_handler_str"><link rel="next" href="API-sigset-mask-str.html" title="function::sigset_mask_str"></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::signal_str</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sa-handler-str.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sigset-mask-str.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::signal_str"><a name="API-signal-str"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::signal_str —
- Returns the string representation of a signal number
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- signal_str(num:)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp10474640"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>num</code></em></span></dt><dd><p>
- the signal number to convert to string.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sa-handler-str.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sigset-mask-str.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sa_handler_str</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::sigset_mask_str</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.sys_tgkill.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-sys-tgkill.html" title="probe::signal.sys_tgkill"><link rel="next" href="API-signal-sys-tkill.html" title="probe::signal.sys_tkill"></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>probe::signal.sys_tgkill.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-sys-tgkill.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-sys-tkill.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.sys_tgkill.return"><a name="API-signal-sys-tgkill-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.sys_tgkill.return —
- Sending kill signal to a thread group completed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.sys_tgkill.return </pre></div><div class="refsect1" title="Values"><a name="idp10841120"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>retstr</code></em></span></dt><dd><p>
- The return value to either __group_send_sig_info,
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-sys-tgkill.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-sys-tkill.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.sys_tgkill</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.sys_tkill</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.sys_tgkill</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-send-sig-queue-return.html" title="probe::signal.send_sig_queue.return"><link rel="next" href="API-signal-sys-tgkill-return.html" title="probe::signal.sys_tgkill.return"></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>probe::signal.sys_tgkill</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-send-sig-queue-return.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-sys-tgkill-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.sys_tgkill"><a name="API-signal-sys-tgkill"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.sys_tgkill —
- Sending kill signal to a thread group
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.sys_tgkill </pre></div><div class="refsect1" title="Values"><a name="idp10819632"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_name</code></em></span></dt><dd><p>
- A string representation of the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>sig</code></em></span></dt><dd><p>
- The specific kill signal sent to the process
- </p></dd><dt><span class="term"><em class="parameter"><code>tgid</code></em></span></dt><dd><p>
- The thread group ID of the thread receiving the kill signal
- </p></dd><dt><span class="term"><em class="parameter"><code>pid_name</code></em></span></dt><dd><p>
- The name of the signal recipient
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_pid</code></em></span></dt><dd><p>
- The PID of the thread receiving the kill signal
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10832992"></a><h2>Description</h2><p>
- The tgkill call is similar to tkill,
- except that it also allows the caller to specify the thread group ID of
- the thread to be signalled. This protects against TID reuse.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-send-sig-queue-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-sys-tgkill-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.send_sig_queue.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.sys_tgkill.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.sys_tkill</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-sys-tgkill-return.html" title="probe::signal.sys_tgkill.return"><link rel="next" href="API-signal-syskill.html" title="probe::signal.syskill"></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>probe::signal.sys_tkill</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-sys-tgkill-return.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-syskill.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.sys_tkill"><a name="API-signal-sys-tkill"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.sys_tkill —
- Sending a kill signal to a thread
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.sys_tkill </pre></div><div class="refsect1" title="Values"><a name="idp10853056"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_name</code></em></span></dt><dd><p>
- A string representation of the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>sig</code></em></span></dt><dd><p>
- The specific signal sent to the process
- </p></dd><dt><span class="term"><em class="parameter"><code>pid_name</code></em></span></dt><dd><p>
- The name of the signal recipient
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_pid</code></em></span></dt><dd><p>
- The PID of the process receiving the kill signal
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10864368"></a><h2>Description</h2><p>
- The tkill call is analogous to kill(2),
- except that it also allows a process within a specific thread group to
- be targeted. Such processes are targeted through their unique
- thread IDs (TID).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-sys-tgkill-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-syskill.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.sys_tgkill.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.syskill</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.syskill.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-syskill.html" title="probe::signal.syskill"><link rel="next" href="API-signal-systkill-return.html" title="probe::signal.systkill.return"></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>probe::signal.syskill.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-syskill.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-systkill-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.syskill.return"><a name="API-signal-syskill-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.syskill.return —
- Sending kill signal completed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.syskill.return </pre></div><div class="refsect1" title="Values"><a name="idp10890592"></a><h2>Values</h2><p>
- None
- </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-syskill.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-systkill-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.syskill</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.systkill.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.syskill</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-sys-tkill.html" title="probe::signal.sys_tkill"><link rel="next" href="API-signal-syskill-return.html" title="probe::signal.syskill.return"></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>probe::signal.syskill</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-sys-tkill.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-syskill-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.syskill"><a name="API-signal-syskill"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.syskill —
- Sending kill signal to a process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.syskill </pre></div><div class="refsect1" title="Values"><a name="idp10872512"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_name</code></em></span></dt><dd><p>
- A string representation of the signal
- </p></dd><dt><span class="term"><em class="parameter"><code>sig</code></em></span></dt><dd><p>
- The specific signal sent to the process
- </p></dd><dt><span class="term"><em class="parameter"><code>pid_name</code></em></span></dt><dd><p>
- The name of the signal recipient
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_pid</code></em></span></dt><dd><p>
- The PID of the process receiving the signal
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-sys-tkill.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-syskill-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.sys_tkill</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.syskill.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.systkill.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-syskill-return.html" title="probe::signal.syskill.return"><link rel="next" href="API-signal-wakeup.html" title="probe::signal.wakeup"></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>probe::signal.systkill.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-syskill-return.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-wakeup.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.systkill.return"><a name="API-signal-systkill-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.systkill.return —
- Sending kill signal to a thread completed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.systkill.return </pre></div><div class="refsect1" title="Values"><a name="idp10898608"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>retstr</code></em></span></dt><dd><p>
- The return value to either __group_send_sig_info,
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-syskill-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-wakeup.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.syskill.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.wakeup</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.wakeup</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-systkill-return.html" title="probe::signal.systkill.return"><link rel="next" href="errno.stp.html" title="Chapter 18. Errno Tapset"></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>probe::signal.wakeup</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-systkill-return.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="errno.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.wakeup"><a name="API-signal-wakeup"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.wakeup —
- Sleeping process being wakened for signal
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.wakeup </pre></div><div class="refsect1" title="Values"><a name="idp10910592"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>resume</code></em></span></dt><dd><p>
- Indicates whether to wake up a task in a
- STOPPED or TRACED state
- </p></dd><dt><span class="term"><em class="parameter"><code>state_mask</code></em></span></dt><dd><p>
- A string representation indicating the mask
- of task states to wake. Possible values are
- TASK_INTERRUPTIBLE, TASK_STOPPED,
- TASK_TRACED, TASK_WAKEKILL, and TASK_INTERRUPTIBLE.
- </p></dd><dt><span class="term"><em class="parameter"><code>pid_name</code></em></span></dt><dd><p>
- Name of the process to wake
- </p></dd><dt><span class="term"><em class="parameter"><code>sig_pid</code></em></span></dt><dd><p>
- The PID of the process to wake
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-systkill-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="errno.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.systkill.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 18. Errno Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sigset_mask_str</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter 17. Signal Tapset"><link rel="prev" href="API-signal-str.html" title="function::signal_str"><link rel="next" href="API-signal-check-ignored.html" title="probe::signal.check_ignored"></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::sigset_mask_str</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-str.html">Prev</a> </td><th width="60%" align="center">Chapter 17. Signal Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-signal-check-ignored.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sigset_mask_str"><a name="API-sigset-mask-str"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sigset_mask_str —
- Returns the string representation of a sigset
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- sigset_mask_str:string(mask:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp10484544"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>mask</code></em></span></dt><dd><p>
- the sigset to convert to string.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-str.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-signal-check-ignored.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::signal_str</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::signal.check_ignored</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sock_fam_num2str</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-inet-get-local-port.html" title="function::inet_get_local_port"><link rel="next" href="API-sock-fam-str2num.html" title="function::sock_fam_str2num"></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::sock_fam_num2str</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-inet-get-local-port.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sock-fam-str2num.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sock_fam_num2str"><a name="API-sock-fam-num2str"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sock_fam_num2str —
- Given a protocol family number, return a string representation
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- sock_fam_num2str:string(family:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9258480"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- The family number
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-inet-get-local-port.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sock-fam-str2num.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::inet_get_local_port</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::sock_fam_str2num</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sock_fam_str2num</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-sock-fam-num2str.html" title="function::sock_fam_num2str"><link rel="next" href="API-sock-prot-num2str.html" title="function::sock_prot_num2str"></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::sock_fam_str2num</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sock-fam-num2str.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sock-prot-num2str.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sock_fam_str2num"><a name="API-sock-fam-str2num"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sock_fam_str2num —
- Given a protocol family name (string), return the corresponding protocol family number
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- sock_fam_str2num:long(family:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9268528"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- The family name
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sock-fam-num2str.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sock-prot-num2str.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sock_fam_num2str</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::sock_prot_num2str</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sock_prot_num2str</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-sock-fam-str2num.html" title="function::sock_fam_str2num"><link rel="next" href="API-sock-prot-str2num.html" title="function::sock_prot_str2num"></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::sock_prot_num2str</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sock-fam-str2num.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sock-prot-str2num.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sock_prot_num2str"><a name="API-sock-prot-num2str"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sock_prot_num2str —
- Given a protocol number, return a string representation
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- sock_prot_num2str:string(proto:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9278544"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>proto</code></em></span></dt><dd><p>
- The protocol number
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sock-fam-str2num.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sock-prot-str2num.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sock_fam_str2num</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::sock_prot_str2num</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sock_prot_str2num</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-sock-prot-num2str.html" title="function::sock_prot_num2str"><link rel="next" href="API-sock-state-num2str.html" title="function::sock_state_num2str"></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::sock_prot_str2num</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sock-prot-num2str.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sock-state-num2str.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sock_prot_str2num"><a name="API-sock-prot-str2num"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sock_prot_str2num —
- Given a protocol name (string), return the corresponding protocol number
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- sock_prot_str2num:long(proto:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9288576"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>proto</code></em></span></dt><dd><p>
- The protocol name
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sock-prot-num2str.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sock-state-num2str.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sock_prot_num2str</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::sock_state_num2str</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sock_state_num2str</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-sock-prot-str2num.html" title="function::sock_prot_str2num"><link rel="next" href="API-sock-state-str2num.html" title="function::sock_state_str2num"></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::sock_state_num2str</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sock-prot-str2num.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sock-state-str2num.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sock_state_num2str"><a name="API-sock-state-num2str"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sock_state_num2str —
- Given a socket state number, return a string representation
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- sock_state_num2str:string(state:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9298544"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- The state number
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sock-prot-str2num.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sock-state-str2num.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sock_prot_str2num</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::sock_state_str2num</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sock_state_str2num</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-sock-state-num2str.html" title="function::sock_state_num2str"><link rel="next" href="API-socket-aio-read.html" title="probe::socket.aio_read"></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::sock_state_str2num</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sock-state-num2str.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-aio-read.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sock_state_str2num"><a name="API-sock-state-str2num"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sock_state_str2num —
- Given a socket state string, return the corresponding state number
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- sock_state_str2num:long(state:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9308464"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- The state name
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sock-state-num2str.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-aio-read.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sock_state_num2str</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.aio_read</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.aio_read.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-socket-aio-read.html" title="probe::socket.aio_read"><link rel="next" href="API-socket-aio-write.html" title="probe::socket.aio_write"></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>probe::socket.aio_read.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-aio-read.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-aio-write.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.aio_read.return"><a name="API-socket-aio-read-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.aio_read.return —
- Conclusion of message received via <code class="function">sock_aio_read</code>
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.aio_read.return </pre></div><div class="refsect1" title="Values"><a name="idp9345008"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>success</code></em></span></dt><dd><p>
- Was receive successful? (1 = yes, 0 = no)
- </p></dd><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol value
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- Socket flags value
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- Socket state value
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Size of message received (in bytes) or error code if success = 0
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- Socket type value
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- Protocol family value
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9362384"></a><h2>Context</h2><p>
- The message receiver.
-</p></div><div class="refsect1" title="Description"><a name="idp9363616"></a><h2>Description</h2><p>
- Fires at the conclusion of receiving a message on a socket
- via the <code class="function">sock_aio_read</code> function
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-aio-read.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-aio-write.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.aio_read</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.aio_write</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.aio_read</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-sock-state-str2num.html" title="function::sock_state_str2num"><link rel="next" href="API-socket-aio-read-return.html" title="probe::socket.aio_read.return"></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>probe::socket.aio_read</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sock-state-str2num.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-aio-read-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.aio_read"><a name="API-socket-aio-read"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.aio_read —
- Receiving message via <code class="function">sock_aio_read</code>
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.aio_read </pre></div><div class="refsect1" title="Values"><a name="idp9319072"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol value
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- Socket flags value
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- Socket state value
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Message size in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- Socket type value
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- Protocol family value
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9334368"></a><h2>Context</h2><p>
- The message sender
-</p></div><div class="refsect1" title="Description"><a name="idp9335584"></a><h2>Description</h2><p>
- Fires at the beginning of receiving a message on a socket
- via the <code class="function">sock_aio_read</code> function
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sock-state-str2num.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-aio-read-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sock_state_str2num</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.aio_read.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.aio_write.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-socket-aio-write.html" title="probe::socket.aio_write"><link rel="next" href="API-socket-close.html" title="probe::socket.close"></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>probe::socket.aio_write.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-aio-write.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-close.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.aio_write.return"><a name="API-socket-aio-write-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.aio_write.return —
- Conclusion of message send via <code class="function">sock_aio_write</code>
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.aio_write.return </pre></div><div class="refsect1" title="Values"><a name="idp9398880"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>success</code></em></span></dt><dd><p>
- Was receive successful? (1 = yes, 0 = no)
- </p></dd><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol value
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- Socket flags value
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- Socket state value
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Size of message received (in bytes) or error code if success = 0
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- Socket type value
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- Protocol family value
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9416256"></a><h2>Context</h2><p>
- The message receiver.
-</p></div><div class="refsect1" title="Description"><a name="idp9417488"></a><h2>Description</h2><p>
- Fires at the conclusion of sending a message on a socket
- via the <code class="function">sock_aio_write</code> function
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-aio-write.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-close.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.aio_write</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.close</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.aio_write</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-socket-aio-read-return.html" title="probe::socket.aio_read.return"><link rel="next" href="API-socket-aio-write-return.html" title="probe::socket.aio_write.return"></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>probe::socket.aio_write</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-aio-read-return.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-aio-write-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.aio_write"><a name="API-socket-aio-write"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.aio_write —
- Message send via <code class="function">sock_aio_write</code>
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.aio_write </pre></div><div class="refsect1" title="Values"><a name="idp9372960"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol value
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- Socket flags value
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- Socket state value
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Message size in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- Socket type value
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- Protocol family value
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9388256"></a><h2>Context</h2><p>
- The message sender
-</p></div><div class="refsect1" title="Description"><a name="idp9389472"></a><h2>Description</h2><p>
- Fires at the beginning of sending a message on a socket
- via the <code class="function">sock_aio_write</code> function
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-aio-read-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-aio-write-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.aio_read.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.aio_write.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.close.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-socket-close.html" title="probe::socket.close"><link rel="next" href="API-socket-create.html" title="probe::socket.create"></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>probe::socket.close.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-close.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-create.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.close.return"><a name="API-socket-close-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.close.return —
- Return from closing a socket
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.close.return </pre></div><div class="refsect1" title="Values"><a name="idp9448720"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9451920"></a><h2>Context</h2><p>
- The requester (user process or kernel)
-</p></div><div class="refsect1" title="Description"><a name="idp9453168"></a><h2>Description</h2><p>
- Fires at the conclusion of closing a socket.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-close.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-create.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.close</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.create</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.close</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-socket-aio-write-return.html" title="probe::socket.aio_write.return"><link rel="next" href="API-socket-close-return.html" title="probe::socket.close.return"></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>probe::socket.close</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-aio-write-return.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-close-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.close"><a name="API-socket-close"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.close —
- Close a socket
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.close </pre></div><div class="refsect1" title="Values"><a name="idp9426192"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol value
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- Socket flags value
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- Socket state value
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- Socket type value
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- Protocol family value
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9439472"></a><h2>Context</h2><p>
- The requester (user process or kernel)
-</p></div><div class="refsect1" title="Description"><a name="idp9440720"></a><h2>Description</h2><p>
- Fires at the beginning of closing a socket.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-aio-write-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-close-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.aio_write.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.close.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.create.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-socket-create.html" title="probe::socket.create"><link rel="next" href="API-socket-readv.html" title="probe::socket.readv"></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>probe::socket.create.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-create.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-readv.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.create.return"><a name="API-socket-create-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.create.return —
- Return from Creation of a socket
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.create.return </pre></div><div class="refsect1" title="Values"><a name="idp9481632"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>success</code></em></span></dt><dd><p>
- Was socket creation successful? (1 = yes, 0 = no)
- </p></dd><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol value
- </p></dd><dt><span class="term"><em class="parameter"><code>err</code></em></span></dt><dd><p>
- Error code if success == 0
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>requester</code></em></span></dt><dd><p>
- Requested by user process or the kernel (1 = kernel, 0 = user)
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- Socket type value
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- Protocol family value
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9497024"></a><h2>Context</h2><p>
- The requester (user process or kernel)
-</p></div><div class="refsect1" title="Description"><a name="idp9498272"></a><h2>Description</h2><p>
- Fires at the conclusion of creating a socket.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-create.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-readv.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.create</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.readv</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.create</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-socket-close-return.html" title="probe::socket.close.return"><link rel="next" href="API-socket-create-return.html" title="probe::socket.create.return"></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>probe::socket.create</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-close-return.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-create-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.create"><a name="API-socket-create"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.create —
- Creation of a socket
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.create </pre></div><div class="refsect1" title="Values"><a name="idp9461088"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol value
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>requester</code></em></span></dt><dd><p>
- Requested by user process or the kernel (1 = kernel, 0 = user)
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- Socket type value
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- Protocol family value
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9472400"></a><h2>Context</h2><p>
- The requester (see requester variable)
-</p></div><div class="refsect1" title="Description"><a name="idp9473648"></a><h2>Description</h2><p>
- Fires at the beginning of creating a socket.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-close-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-create-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.close.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.create.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.readv.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-socket-readv.html" title="probe::socket.readv"><link rel="next" href="API-socket-receive.html" title="probe::socket.receive"></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>probe::socket.readv.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-readv.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-receive.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.readv.return"><a name="API-socket-readv-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.readv.return —
- Conclusion of receiving a message via <code class="function">sock_readv</code>
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.readv.return </pre></div><div class="refsect1" title="Values"><a name="idp9532832"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>success</code></em></span></dt><dd><p>
- Was receive successful? (1 = yes, 0 = no)
- </p></dd><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol value
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- Socket flags value
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- Socket state value
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Size of message received (in bytes) or error code if success = 0
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- Socket type value
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- Protocol family value
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9550208"></a><h2>Context</h2><p>
- The message receiver.
-</p></div><div class="refsect1" title="Description"><a name="idp9551440"></a><h2>Description</h2><p>
- Fires at the conclusion of receiving a message on a socket
- via the <code class="function">sock_readv</code> function
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-readv.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-receive.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.readv</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.receive</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.readv</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-socket-create-return.html" title="probe::socket.create.return"><link rel="next" href="API-socket-readv-return.html" title="probe::socket.readv.return"></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>probe::socket.readv</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-create-return.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-readv-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.readv"><a name="API-socket-readv"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.readv —
- Receiving a message via <code class="function">sock_readv</code>
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.readv </pre></div><div class="refsect1" title="Values"><a name="idp9506928"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol value
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- Socket flags value
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- Socket state value
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Message size in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- Socket type value
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- Protocol family value
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9522224"></a><h2>Context</h2><p>
- The message sender
-</p></div><div class="refsect1" title="Description"><a name="idp9523440"></a><h2>Description</h2><p>
- Fires at the beginning of receiving a message on a socket
- via the <code class="function">sock_readv</code> function
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-create-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-readv-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.create.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.readv.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.receive</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-socket-readv-return.html" title="probe::socket.readv.return"><link rel="next" href="API-socket-recvmsg.html" title="probe::socket.recvmsg"></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>probe::socket.receive</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-readv-return.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-recvmsg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.receive"><a name="API-socket-receive"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.receive —
- Message received on a socket.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.receive </pre></div><div class="refsect1" title="Values"><a name="idp9560096"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>success</code></em></span></dt><dd><p>
- Was send successful? (1 = yes, 0 = no)
- </p></dd><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol value
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- Socket flags value
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- Socket state value
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Size of message received (in bytes) or error code if success = 0
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- Socket type value
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- Protocol family value
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9577472"></a><h2>Context</h2><p>
- The message receiver
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-readv-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-recvmsg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.readv.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.recvmsg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.recvmsg.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-socket-recvmsg.html" title="probe::socket.recvmsg"><link rel="next" href="API-socket-send.html" title="probe::socket.send"></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>probe::socket.recvmsg.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-recvmsg.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-send.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.recvmsg.return"><a name="API-socket-recvmsg-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.recvmsg.return —
- Return from Message being received on socket
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.recvmsg.return </pre></div><div class="refsect1" title="Values"><a name="idp9610640"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>success</code></em></span></dt><dd><p>
- Was receive successful? (1 = yes, 0 = no)
- </p></dd><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol value
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- Socket flags value
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- Socket state value
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Size of message received (in bytes) or error code if success = 0
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- Socket type value
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- Protocol family value
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9628016"></a><h2>Context</h2><p>
- The message receiver.
-</p></div><div class="refsect1" title="Description"><a name="idp9629248"></a><h2>Description</h2><p>
- Fires at the conclusion of receiving a message on a socket
- via the <code class="function">sock_recvmsg</code> function.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-recvmsg.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-send.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.recvmsg</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.send</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.recvmsg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-socket-receive.html" title="probe::socket.receive"><link rel="next" href="API-socket-recvmsg-return.html" title="probe::socket.recvmsg.return"></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>probe::socket.recvmsg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-receive.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-recvmsg-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.recvmsg"><a name="API-socket-recvmsg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.recvmsg —
- Message being received on socket
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.recvmsg </pre></div><div class="refsect1" title="Values"><a name="idp9585376"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol value
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- Socket flags value
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- Socket state value
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Message size in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- Socket type value
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- Protocol family value
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9600672"></a><h2>Context</h2><p>
- The message receiver.
-</p></div><div class="refsect1" title="Description"><a name="idp9601904"></a><h2>Description</h2><p>
- Fires at the beginning of receiving a message on a socket
- via the <code class="function">sock_recvmsg</code> function
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-receive.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-recvmsg-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.receive</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.recvmsg.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.send</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-socket-recvmsg-return.html" title="probe::socket.recvmsg.return"><link rel="next" href="API-socket-sendmsg.html" title="probe::socket.sendmsg"></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>probe::socket.send</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-recvmsg-return.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-sendmsg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.send"><a name="API-socket-send"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.send —
- Message sent on a socket.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.send </pre></div><div class="refsect1" title="Values"><a name="idp9637968"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>success</code></em></span></dt><dd><p>
- Was send successful? (1 = yes, 0 = no)
- </p></dd><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol value
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- Socket flags value
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- Socket state value
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Size of message sent (in bytes) or error code if success = 0
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- Socket type value
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- Protocol family value
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9655328"></a><h2>Context</h2><p>
- The message sender
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-recvmsg-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-sendmsg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.recvmsg.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.sendmsg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.sendmsg.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-socket-sendmsg.html" title="probe::socket.sendmsg"><link rel="next" href="API-socket-writev.html" title="probe::socket.writev"></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>probe::socket.sendmsg.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-sendmsg.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-writev.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.sendmsg.return"><a name="API-socket-sendmsg-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.sendmsg.return —
- Return from socket.sendmsg.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.sendmsg.return </pre></div><div class="refsect1" title="Values"><a name="idp9688512"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>success</code></em></span></dt><dd><p>
- Was send successful? (1 = yes, 0 = no)
- </p></dd><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol value
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- Socket flags value
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- Socket state value
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Size of message sent (in bytes) or error code if success = 0
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- Socket type value
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- Protocol family value
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9705872"></a><h2>Context</h2><p>
- The message sender.
-</p></div><div class="refsect1" title="Description"><a name="idp9707104"></a><h2>Description</h2><p>
- Fires at the conclusion of sending a message on a socket
- via the <code class="function">sock_sendmsg</code> function
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-sendmsg.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-writev.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.sendmsg</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.writev</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.sendmsg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-socket-send.html" title="probe::socket.send"><link rel="next" href="API-socket-sendmsg-return.html" title="probe::socket.sendmsg.return"></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>probe::socket.sendmsg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-send.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-sendmsg-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.sendmsg"><a name="API-socket-sendmsg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.sendmsg —
- Message is currently being sent on a socket.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.sendmsg </pre></div><div class="refsect1" title="Values"><a name="idp9663232"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol value
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- Socket flags value
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- Socket state value
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Message size in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- Socket type value
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- Protocol family value
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9678528"></a><h2>Context</h2><p>
- The message sender
-</p></div><div class="refsect1" title="Description"><a name="idp9679744"></a><h2>Description</h2><p>
- Fires at the beginning of sending a message on a socket
- via the <code class="function">sock_sendmsg</code> function
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-send.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-sendmsg-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.send</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.sendmsg.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.writev.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-socket-writev.html" title="probe::socket.writev"><link rel="next" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"></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>probe::socket.writev.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-writev.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="snmp.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.writev.return"><a name="API-socket-writev-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.writev.return —
- Conclusion of message sent via <code class="function">socket_writev</code>
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.writev.return </pre></div><div class="refsect1" title="Values"><a name="idp9742416"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>success</code></em></span></dt><dd><p>
- Was send successful? (1 = yes, 0 = no)
- </p></dd><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol value
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- Socket flags value
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- Socket state value
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Size of message sent (in bytes) or error code if success = 0
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- Socket type value
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- Protocol family value
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9759776"></a><h2>Context</h2><p>
- The message receiver.
-</p></div><div class="refsect1" title="Description"><a name="idp9761008"></a><h2>Description</h2><p>
- Fires at the conclusion of sending a message on a socket
- via the <code class="function">sock_writev</code> function
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-writev.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="snmp.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.writev</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 15. SNMP Information Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::socket.writev</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="socket.stp.html" title="Chapter 14. Socket Tapset"><link rel="prev" href="API-socket-sendmsg-return.html" title="probe::socket.sendmsg.return"><link rel="next" href="API-socket-writev-return.html" title="probe::socket.writev.return"></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>probe::socket.writev</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-sendmsg-return.html">Prev</a> </td><th width="60%" align="center">Chapter 14. Socket Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-socket-writev-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::socket.writev"><a name="API-socket-writev"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::socket.writev —
- Message sent via <code class="function">socket_writev</code>
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">socket.writev </pre></div><div class="refsect1" title="Values"><a name="idp9716496"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Protocol value
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- Socket flags value
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>state</code></em></span></dt><dd><p>
- Socket state value
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Message size in bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- Socket type value
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- Protocol family value
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9731792"></a><h2>Context</h2><p>
- The message sender
-</p></div><div class="refsect1" title="Description"><a name="idp9733008"></a><h2>Description</h2><p>
- Fires at the beginning of sending a message on a socket
- via the <code class="function">sock_writev</code> function
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-sendmsg-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="socket.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-socket-writev-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.sendmsg.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::socket.writev.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::softirq.entry</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="irq.stp.html" title="Chapter 12. Interrupt Request (IRQ) Tapset"><link rel="prev" href="API-irq-handler-exit.html" title="probe::irq_handler.exit"><link rel="next" href="API-softirq-exit.html" title="probe::softirq.exit"></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>probe::softirq.entry</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-irq-handler-exit.html">Prev</a> </td><th width="60%" align="center">Chapter 12. Interrupt Request (IRQ) Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-softirq-exit.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::softirq.entry"><a name="API-softirq-entry"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::softirq.entry —
- Execution of handler for a pending softirq starting
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">softirq.entry </pre></div><div class="refsect1" title="Values"><a name="idp7549184"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>vec</code></em></span></dt><dd><p>
- softirq_action vector
- </p></dd><dt><span class="term"><em class="parameter"><code>h</code></em></span></dt><dd><p>
- struct softirq_action* for current pending softirq
- </p></dd><dt><span class="term"><em class="parameter"><code>vec_nr</code></em></span></dt><dd><p>
- softirq vector number
- </p></dd><dt><span class="term"><em class="parameter"><code>action</code></em></span></dt><dd><p>
- pointer to softirq handler just about to execute
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-irq-handler-exit.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="irq.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-softirq-exit.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::irq_handler.exit</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::softirq.exit</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::softirq.exit</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="irq.stp.html" title="Chapter 12. Interrupt Request (IRQ) Tapset"><link rel="prev" href="API-softirq-entry.html" title="probe::softirq.entry"><link rel="next" href="API-workqueue-create.html" title="probe::workqueue.create"></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>probe::softirq.exit</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-softirq-entry.html">Prev</a> </td><th width="60%" align="center">Chapter 12. Interrupt Request (IRQ) Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-workqueue-create.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::softirq.exit"><a name="API-softirq-exit"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::softirq.exit —
- Execution of handler for a pending softirq completed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">softirq.exit </pre></div><div class="refsect1" title="Values"><a name="idp7565184"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>vec</code></em></span></dt><dd><p>
- softirq_action vector
- </p></dd><dt><span class="term"><em class="parameter"><code>h</code></em></span></dt><dd><p>
- struct softirq_action* for just executed softirq
- </p></dd><dt><span class="term"><em class="parameter"><code>vec_nr</code></em></span></dt><dd><p>
- softirq vector number
- </p></dd><dt><span class="term"><em class="parameter"><code>action</code></em></span></dt><dd><p>
- pointer to softirq handler that just finished execution
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-softirq-entry.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="irq.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-workqueue-create.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::softirq.entry</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::workqueue.create</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::speculate</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="speculation.stp.html" title="Chapter 31. Speculation"><link rel="prev" href="API-discard.html" title="function::discard"><link rel="next" href="API-speculation.html" title="function::speculation"></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::speculate</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-discard.html">Prev</a> </td><th width="60%" align="center">Chapter 31. Speculation</th><td width="20%" align="right"> <a accesskey="n" href="API-speculation.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::speculate"><a name="API-speculate"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::speculate —
- Store a string for possible output later
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- speculate(id:long,output:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp13804208"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>id</code></em></span></dt><dd><p>
- buffer id to store the information in
- </p></dd><dt><span class="term"><em class="parameter"><code>output</code></em></span></dt><dd><p>
- string to write out when commit occurs
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp13809424"></a><h2>Description</h2><p>
- Add a string to the speculaive buffer for id.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-discard.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="speculation.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-speculation.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::discard</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::speculation</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::speculation</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="speculation.stp.html" title="Chapter 31. Speculation"><link rel="prev" href="API-speculate.html" title="function::speculate"></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::speculation</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-speculate.html">Prev</a> </td><th width="60%" align="center">Chapter 31. Speculation</th><td width="20%" align="right"> </td></tr></table><hr></div><div class="refentry" title="function::speculation"><a name="API-speculation"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::speculation —
- Allocate a new id for speculative output
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- speculation:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp13817424"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp13818640"></a><h2>Description</h2><p>
- </p><p>
-
- The <code class="function">speculation</code> function is called when a new speculation buffer is needed.
- It returns an id for the speculative output.
- There can be multiple threads being speculated on concurrently.
- This id is used by other speculation functions to keep the threads
- separate.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-speculate.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="speculation.stp.html">Up</a></td><td width="40%" align="right"> </td></tr><tr><td width="40%" align="left" valign="top"><span>function::speculate</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> </td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sprint_backtrace</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-sid.html" title="function::sid"><link rel="next" href="API-sprint-stack.html" title="function::sprint_stack"></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::sprint_backtrace</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sid.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-sprint-stack.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sprint_backtrace"><a name="API-sprint-backtrace"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sprint_backtrace —
- Return stack back trace as string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- sprint_backtrace:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5257600"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5258752"></a><h2>Description</h2><p>
- </p><p>
-
- Returns a simple (kernel) backtrace. One line per address.
- Includes the symbol name (or hex address if symbol
- couldn't be resolved) and module name (if found). Includes the
- offset from the start of the function if found, otherwise the
- offset will be added to the module (if found, between
- brackets). Returns the backtrace as string (each line terminated by
- a newline character). Note that the returned stack will be
- truncated to MAXSTRINGLEN, to print fuller and richer stacks use
- <code class="function">print_backtrace</code>. Equivalent to sprint_stack(<code class="function">backtrace</code>),
- but more efficient (no need to translate between hex strings and
- final backtrace string).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sid.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-sprint-stack.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sid</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::sprint_stack</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sprint_stack</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-sprint-backtrace.html" title="function::sprint_backtrace"><link rel="next" href="API-sprint-syms.html" title="function::sprint_syms"></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::sprint_stack</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sprint-backtrace.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-sprint-syms.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sprint_stack"><a name="API-sprint-stack"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sprint_stack —
- Return stack for kernel addresses from string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- sprint_stack:string(stk:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5268144"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>stk</code></em></span></dt><dd><p>
- String with list of hexadecimal (kernel) addresses
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5271280"></a><h2>Description</h2><p>
- Perform a symbolic lookup of the addresses in the given string,
- which is assumed to be the result of a prior call to <code class="function">backtrace</code>.
- </p><p>
-
- Returns a simple backtrace from the given hex string. One line per
- address. Includes the symbol name (or hex address if symbol
- couldn't be resolved) and module name (if found). Includes the
- offset from the start of the function if found, otherwise the
- offset will be added to the module (if found, between
- brackets). Returns the backtrace as string (each line terminated by
- a newline character). Note that the returned stack will be
- truncated to MAXSTRINGLEN, to print fuller and richer stacks use
- print_stack.
-</p></div><div class="refsect1" title="NOTE"><a name="idp5274016"></a><h2>NOTE</h2><p>
- it is recommended to use <code class="function">sprint_syms</code> instead of this function.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sprint-backtrace.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-sprint-syms.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sprint_backtrace</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::sprint_syms</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sprint_syms</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-sprint-stack.html" title="function::sprint_stack"><link rel="next" href="API-sprint-ubacktrace.html" title="function::sprint_ubacktrace"></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::sprint_syms</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sprint-stack.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-sprint-ubacktrace.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sprint_syms"><a name="API-sprint-syms"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sprint_syms —
- Return stack for kernel addresses from string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- sprint_syms(callers:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5281888"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>callers</code></em></span></dt><dd><p>
- String with list of hexadecimal (kernel) addresses
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5285024"></a><h2>Description</h2><p>
- Perform a symbolic lookup of the addresses in the given string,
- which are assumed to be the result of a prior calls to <code class="function">stack</code>,
- <code class="function">callers</code>, and similar functions.
- </p><p>
-
- Returns a simple backtrace from the given hex string. One line per
- address. Includes the symbol name (or hex address if symbol
- couldn't be resolved) and module name (if found), as obtained from
- <code class="function">symdata</code>. Includes the offset from the start of the function if
- found, otherwise the offset will be added to the module (if found, between
- brackets). Returns the backtrace as string (each line terminated by
- a newline character). Note that the returned stack will be
- truncated to MAXSTRINGLEN, to print fuller and richer stacks use
- <code class="function">print_syms</code>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sprint-stack.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-sprint-ubacktrace.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sprint_stack</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::sprint_ubacktrace</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sprint_ubacktrace</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-sprint-syms.html" title="function::sprint_syms"><link rel="next" href="API-sprint-ustack.html" title="function::sprint_ustack"></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::sprint_ubacktrace</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sprint-syms.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-sprint-ustack.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sprint_ubacktrace"><a name="API-sprint-ubacktrace"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sprint_ubacktrace —
- Return stack back trace for current user-space task as string.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- sprint_ubacktrace:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5295824"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5296976"></a><h2>Description</h2><p>
- </p><p>
-
- Returns a simple backtrace for the current task. One line per
- address. Includes the symbol name (or hex address if symbol
- couldn't be resolved) and module name (if found). Includes the
- offset from the start of the function if found, otherwise the
- offset will be added to the module (if found, between
- brackets). Returns the backtrace as string (each line terminated by
- a newline character). Note that the returned stack will be
- truncated to MAXSTRINGLEN, to print fuller and richer stacks use
- <code class="function">print_ubacktrace</code>. Equivalent to sprint_ustack(<code class="function">ubacktrace</code>),
- but more efficient (no need to translate between hex strings and
- final backtrace string).
-</p></div><div class="refsect1" title="Note"><a name="idp5300288"></a><h2>Note</h2><p>
- To get (full) backtraces for user space applications and shared
- shared libraries not mentioned in the current script run stap with
- -d /path/to/exe-or-so and/or add --ldd to load all needed unwind data.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sprint-syms.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-sprint-ustack.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sprint_syms</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::sprint_ustack</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sprint_ustack</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-sprint-ubacktrace.html" title="function::sprint_ubacktrace"><link rel="next" href="API-sprint-usyms.html" title="function::sprint_usyms"></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::sprint_ustack</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sprint-ubacktrace.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-sprint-usyms.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sprint_ustack"><a name="API-sprint-ustack"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sprint_ustack —
- Return stack for the current task from string.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- sprint_ustack:string(stk:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5307760"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>stk</code></em></span></dt><dd><p>
- String with list of hexadecimal addresses for the current task.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5310912"></a><h2>Description</h2><p>
- Perform a symbolic lookup of the addresses in the given string,
- which is assumed to be the result of a prior call to
- <code class="function">ubacktrace</code> for the current task.
- </p><p>
-
- Returns a simple backtrace from the given hex string. One line per
- address. Includes the symbol name (or hex address if symbol
- couldn't be resolved) and module name (if found). Includes the
- offset from the start of the function if found, otherwise the
- offset will be added to the module (if found, between
- brackets). Returns the backtrace as string (each line terminated by
- a newline character). Note that the returned stack will be
- truncated to MAXSTRINGLEN, to print fuller and richer stacks use
- print_ustack.
-</p></div><div class="refsect1" title="NOTE"><a name="idp5314192"></a><h2>NOTE</h2><p>
- it is recommended to use <code class="function">sprint_usyms</code> instead of this function.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sprint-ubacktrace.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-sprint-usyms.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sprint_ubacktrace</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::sprint_usyms</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::sprint_usyms</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-sprint-ustack.html" title="function::sprint_ustack"><link rel="next" href="API-stack.html" title="function::stack"></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::sprint_usyms</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sprint-ustack.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-stack.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::sprint_usyms"><a name="API-sprint-usyms"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::sprint_usyms —
- Return stack for user addresses from string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- sprint_usyms(callers:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5322064"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>callers</code></em></span></dt><dd><p>
- String with list of hexadecimal (user) addresses
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5325200"></a><h2>Description</h2><p>
- Perform a symbolic lookup of the addresses in the given string,
- which are assumed to be the result of a prior calls to <code class="function">ustack</code>,
- <code class="function">ucallers</code>, and similar functions.
- </p><p>
-
- Returns a simple backtrace from the given hex string. One line per
- address. Includes the symbol name (or hex address if symbol
- couldn't be resolved) and module name (if found), as obtained from
- <code class="function">usymdata</code>. Includes the offset from the start of the function if
- found, otherwise the offset will be added to the module (if found, between
- brackets). Returns the backtrace as string (each line terminated by
- a newline character). Note that the returned stack will be
- truncated to MAXSTRINGLEN, to print fuller and richer stacks use
- <code class="function">print_usyms</code>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sprint-ustack.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-stack.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sprint_ustack</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::stack</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::stack_size</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-stack.html" title="function::stack"><link rel="next" href="API-stack-unused.html" title="function::stack_unused"></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::stack_size</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stack.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-stack-unused.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::stack_size"><a name="API-stack-size"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::stack_size —
- Return the size of the kernel stack
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- stack_size:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5347184"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5348336"></a><h2>Description</h2><p>
- This function returns the size of the kernel stack.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stack.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-stack-unused.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::stack</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::stack_unused</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::stack_unused</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-stack-size.html" title="function::stack_size"><link rel="next" href="API-stack-used.html" title="function::stack_used"></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::stack_unused</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stack-size.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-stack-used.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::stack_unused"><a name="API-stack-unused"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::stack_unused —
- Returns the amount of kernel stack currently available
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- stack_unused:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5355744"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5356896"></a><h2>Description</h2><p>
- This function determines how many bytes are
- currently available in the kernel stack.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stack-size.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-stack-used.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::stack_size</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::stack_used</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::stack_used</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-stack-unused.html" title="function::stack_unused"><link rel="next" href="API-stp-pid.html" title="function::stp_pid"></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::stack_used</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stack-unused.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-stp-pid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::stack_used"><a name="API-stack-used"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::stack_used —
- Returns the amount of kernel stack used
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- stack_used:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5364256"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5365408"></a><h2>Description</h2><p>
- This function determines how many bytes are
- currently used in the kernel stack.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stack-unused.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-stp-pid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::stack_unused</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::stp_pid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::stack</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-sprint-usyms.html" title="function::sprint_usyms"><link rel="next" href="API-stack-size.html" title="function::stack_size"></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::stack</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sprint-usyms.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-stack-size.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::stack"><a name="API-stack"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::stack —
- Return address at given depth of kernel stack backtrace
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- stack:long(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5336000"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- number of levels to descend in the stack.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5339056"></a><h2>Description</h2><p>
- Performs a simple (kernel) backtrace, and returns the
- element at the specified position. The results of the backtrace itself
- are cached, so that the backtrace computation is performed at most once
- no matter how many times <code class="function">stack</code> is called, or in what order.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sprint-usyms.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-stack-size.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::sprint_usyms</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::stack_size</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.cache_add_mod</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="next" href="API-stap-cache-add-nss.html" title="probe::stap.cache_add_nss"></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>probe::stap.cache_add_mod</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="stap_staticmarkers.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-cache-add-nss.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.cache_add_mod"><a name="API-stap-cache-add-mod"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.cache_add_mod —
- Adding kernel instrumentation module to cache
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.cache_add_mod </pre></div><div class="refsect1" title="Values"><a name="idp12266624"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dest_path</code></em></span></dt><dd><p>
- the path the .ko file is going to (incl filename)
- </p></dd><dt><span class="term"><em class="parameter"><code>source_path</code></em></span></dt><dd><p>
- the path the .ko file is coming from (incl filename)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12271904"></a><h2>Description</h2><p>
- Fires just before the file is actually moved. Note: if moving fails,
- cache_add_src and cache_add_nss will not fire.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="stap_staticmarkers.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-cache-add-nss.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 29. SystemTap Translator Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.cache_add_nss</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.cache_add_nss</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-cache-add-mod.html" title="probe::stap.cache_add_mod"><link rel="next" href="API-stap-cache-add-src.html" title="probe::stap.cache_add_src"></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>probe::stap.cache_add_nss</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-cache-add-mod.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-cache-add-src.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.cache_add_nss"><a name="API-stap-cache-add-nss"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.cache_add_nss —
- Add NSS (Network Security Services) information to cache
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.cache_add_nss </pre></div><div class="refsect1" title="Values"><a name="idp12280016"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dest_path</code></em></span></dt><dd><p>
- the path the .sgn file is coming from (incl filename)
- </p></dd><dt><span class="term"><em class="parameter"><code>source_path</code></em></span></dt><dd><p>
- the path the .sgn file is coming from (incl filename)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12285296"></a><h2>Description</h2><p>
- Fires just before the file is actually moved. Note: stap must compiled
- with NSS support; if moving the kernel module fails, this probe will
- not fire.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-cache-add-mod.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-cache-add-src.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.cache_add_mod</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.cache_add_src</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.cache_add_src</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-cache-add-nss.html" title="probe::stap.cache_add_nss"><link rel="next" href="API-stap-cache-clean.html" title="probe::stap.cache_clean"></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>probe::stap.cache_add_src</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-cache-add-nss.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-cache-clean.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.cache_add_src"><a name="API-stap-cache-add-src"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.cache_add_src —
- Adding C code translation to cache
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.cache_add_src </pre></div><div class="refsect1" title="Values"><a name="idp12293376"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dest_path</code></em></span></dt><dd><p>
- the path the .c file is going to (incl filename)
- </p></dd><dt><span class="term"><em class="parameter"><code>source_path</code></em></span></dt><dd><p>
- the path the .c file is coming from (incl filename)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12298656"></a><h2>Description</h2><p>
- Fires just before the file is actually moved. Note: if moving the
- kernel module fails, this probe will not fire.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-cache-add-nss.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-cache-clean.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.cache_add_nss</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.cache_clean</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.cache_clean</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-cache-add-src.html" title="probe::stap.cache_add_src"><link rel="next" href="API-stap-cache-get.html" title="probe::stap.cache_get"></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>probe::stap.cache_clean</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-cache-add-src.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-cache-get.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.cache_clean"><a name="API-stap-cache-clean"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.cache_clean —
- Removing file from stap cache
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.cache_clean </pre></div><div class="refsect1" title="Values"><a name="idp12306704"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>path</code></em></span></dt><dd><p>
- the path to the .ko/.c file being removed
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12309920"></a><h2>Description</h2><p>
- Fires just before the call to unlink the module/source file.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-cache-add-src.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-cache-get.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.cache_add_src</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.cache_get</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.cache_get</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-cache-clean.html" title="probe::stap.cache_clean"><link rel="next" href="API-stap-pass0.html" title="probe::stap.pass0"></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>probe::stap.cache_get</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-cache-clean.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-pass0.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.cache_get"><a name="API-stap-cache-get"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.cache_get —
- Found item in stap cache
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.cache_get </pre></div><div class="refsect1" title="Values"><a name="idp12317856"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>source_path</code></em></span></dt><dd><p>
- the path of the .c source file
- </p></dd><dt><span class="term"><em class="parameter"><code>module_path</code></em></span></dt><dd><p>
- the path of the .ko kernel module file
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12323104"></a><h2>Description</h2><p>
- Fires just before the return of get_from_cache, when the cache grab
- is successful.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-cache-clean.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-pass0.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.cache_clean</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.pass0</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.pass0.end</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-pass0.html" title="probe::stap.pass0"><link rel="next" href="API-stap-pass1-end.html" title="probe::stap.pass1.end"></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>probe::stap.pass0.end</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-pass0.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-pass1-end.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.pass0.end"><a name="API-stap-pass0-end"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.pass0.end —
- Finished stap pass0 (parsing command line arguments)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.pass0.end </pre></div><div class="refsect1" title="Values"><a name="idp12342336"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>session</code></em></span></dt><dd><p>
- the systemtap_session variable s
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12345552"></a><h2>Description</h2><p>
- pass0.end fires just before the <code class="function">gettimeofday</code> call for pass1.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-pass0.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-pass1-end.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.pass0</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.pass1.end</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.pass0</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-cache-get.html" title="probe::stap.cache_get"><link rel="next" href="API-stap-pass0-end.html" title="probe::stap.pass0.end"></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>probe::stap.pass0</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-cache-get.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-pass0-end.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.pass0"><a name="API-stap-pass0"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.pass0 —
- Starting stap pass0 (parsing command line arguments)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.pass0 </pre></div><div class="refsect1" title="Values"><a name="idp12331104"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>session</code></em></span></dt><dd><p>
- the systemtap_session variable s
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12334320"></a><h2>Description</h2><p>
- pass0 fires after command line arguments have been parsed.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-cache-get.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-pass0-end.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.cache_get</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.pass0.end</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.pass1.end</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-pass0-end.html" title="probe::stap.pass0.end"><link rel="next" href="API-stap-pass1a.html" title="probe::stap.pass1a"></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>probe::stap.pass1.end</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-pass0-end.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-pass1a.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.pass1.end"><a name="API-stap-pass1-end"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.pass1.end —
- Finished stap pass1 (parsing scripts)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.pass1.end </pre></div><div class="refsect1" title="Values"><a name="idp12354240"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>session</code></em></span></dt><dd><p>
- the systemtap_session variable s
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12357456"></a><h2>Description</h2><p>
- pass1.end fires just before the jump to cleanup if s.last_pass = 1.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-pass0-end.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-pass1a.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.pass0.end</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.pass1a</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.pass1a</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-pass1-end.html" title="probe::stap.pass1.end"><link rel="next" href="API-stap-pass1b.html" title="probe::stap.pass1b"></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>probe::stap.pass1a</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-pass1-end.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-pass1b.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.pass1a"><a name="API-stap-pass1a"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.pass1a —
- Starting stap pass1 (parsing user script)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.pass1a </pre></div><div class="refsect1" title="Values"><a name="idp12365424"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>session</code></em></span></dt><dd><p>
- the systemtap_session variable s
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12368640"></a><h2>Description</h2><p>
- pass1a fires just after the call to <code class="function">gettimeofday</code>, before the
- user script is parsed.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-pass1-end.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-pass1b.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.pass1.end</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.pass1b</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.pass1b</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-pass1a.html" title="probe::stap.pass1a"><link rel="next" href="API-stap-pass2.html" title="probe::stap.pass2"></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>probe::stap.pass1b</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-pass1a.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-pass2.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.pass1b"><a name="API-stap-pass1b"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.pass1b —
- Starting stap pass1 (parsing library scripts)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.pass1b </pre></div><div class="refsect1" title="Values"><a name="idp12377248"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>session</code></em></span></dt><dd><p>
- the systemtap_session variable s
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12380464"></a><h2>Description</h2><p>
- pass1b fires just before the library scripts are parsed.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-pass1a.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-pass2.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.pass1a</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.pass2</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.pass2.end</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-pass2.html" title="probe::stap.pass2"><link rel="next" href="API-stap-pass3.html" title="probe::stap.pass3"></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>probe::stap.pass2.end</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-pass2.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-pass3.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.pass2.end"><a name="API-stap-pass2-end"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.pass2.end —
- Finished stap pass2 (elaboration)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.pass2.end </pre></div><div class="refsect1" title="Values"><a name="idp12400400"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>session</code></em></span></dt><dd><p>
- the systemtap_session variable s
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12403616"></a><h2>Description</h2><p>
- pass2.end fires just before the jump to cleanup if s.last_pass = 2
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-pass2.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-pass3.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.pass2</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.pass3</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.pass2</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-pass1b.html" title="probe::stap.pass1b"><link rel="next" href="API-stap-pass2-end.html" title="probe::stap.pass2.end"></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>probe::stap.pass2</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-pass1b.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-pass2-end.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.pass2"><a name="API-stap-pass2"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.pass2 —
- Starting stap pass2 (elaboration)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.pass2 </pre></div><div class="refsect1" title="Values"><a name="idp12388464"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>session</code></em></span></dt><dd><p>
- the systemtap_session variable s
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12391680"></a><h2>Description</h2><p>
- pass2 fires just after the call to <code class="function">gettimeofday</code>, just before the
- call to semantic_pass.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-pass1b.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-pass2-end.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.pass1b</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.pass2.end</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.pass3.end</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-pass3.html" title="probe::stap.pass3"><link rel="next" href="API-stap-pass4.html" title="probe::stap.pass4"></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>probe::stap.pass3.end</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-pass3.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-pass4.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.pass3.end"><a name="API-stap-pass3-end"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.pass3.end —
- Finished stap pass3 (translation to C)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.pass3.end </pre></div><div class="refsect1" title="Values"><a name="idp12423456"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>session</code></em></span></dt><dd><p>
- the systemtap_session variable s
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12426672"></a><h2>Description</h2><p>
- pass3.end fires just before the jump to cleanup if s.last_pass = 3
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-pass3.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-pass4.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.pass3</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.pass4</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.pass3</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-pass2-end.html" title="probe::stap.pass2.end"><link rel="next" href="API-stap-pass3-end.html" title="probe::stap.pass3.end"></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>probe::stap.pass3</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-pass2-end.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-pass3-end.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.pass3"><a name="API-stap-pass3"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.pass3 —
- Starting stap pass3 (translation to C)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.pass3 </pre></div><div class="refsect1" title="Values"><a name="idp12411568"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>session</code></em></span></dt><dd><p>
- the systemtap_session variable s
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12414784"></a><h2>Description</h2><p>
- pass3 fires just after the call to <code class="function">gettimeofday</code>, just before the
- call to translate_pass.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-pass2-end.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-pass3-end.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.pass2.end</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.pass3.end</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.pass4.end</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-pass4.html" title="probe::stap.pass4"><link rel="next" href="API-stap-pass5.html" title="probe::stap.pass5"></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>probe::stap.pass4.end</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-pass4.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-pass5.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.pass4.end"><a name="API-stap-pass4-end"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.pass4.end —
- Finished stap pass4 (compile C code into kernel module)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.pass4.end </pre></div><div class="refsect1" title="Values"><a name="idp12446640"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>session</code></em></span></dt><dd><p>
- the systemtap_session variable s
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12449856"></a><h2>Description</h2><p>
- pass4.end fires just before the jump to cleanup if s.last_pass = 4
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-pass4.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-pass5.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.pass4</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.pass5</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.pass4</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-pass3-end.html" title="probe::stap.pass3.end"><link rel="next" href="API-stap-pass4-end.html" title="probe::stap.pass4.end"></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>probe::stap.pass4</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-pass3-end.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-pass4-end.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.pass4"><a name="API-stap-pass4"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.pass4 —
- Starting stap pass4 (compile C code into kernel module)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.pass4 </pre></div><div class="refsect1" title="Values"><a name="idp12434688"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>session</code></em></span></dt><dd><p>
- the systemtap_session variable s
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12437904"></a><h2>Description</h2><p>
- pass4 fires just after the call to <code class="function">gettimeofday</code>, just before the
- call to compile_pass.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-pass3-end.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-pass4-end.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.pass3.end</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.pass4.end</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.pass5.end</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-pass5.html" title="probe::stap.pass5"><link rel="next" href="API-stap-pass6.html" title="probe::stap.pass6"></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>probe::stap.pass5.end</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-pass5.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-pass6.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.pass5.end"><a name="API-stap-pass5-end"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.pass5.end —
- Finished stap pass5 (running the instrumentation)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.pass5.end </pre></div><div class="refsect1" title="Values"><a name="idp12469696"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>session</code></em></span></dt><dd><p>
- the systemtap_session variable s
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12472912"></a><h2>Description</h2><p>
- pass5.end fires just before the cleanup label
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-pass5.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-pass6.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.pass5</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.pass6</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.pass5</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-pass4-end.html" title="probe::stap.pass4.end"><link rel="next" href="API-stap-pass5-end.html" title="probe::stap.pass5.end"></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>probe::stap.pass5</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-pass4-end.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-pass5-end.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.pass5"><a name="API-stap-pass5"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.pass5 —
- Starting stap pass5 (running the instrumentation)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.pass5 </pre></div><div class="refsect1" title="Values"><a name="idp12457824"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>session</code></em></span></dt><dd><p>
- the systemtap_session variable s
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12461040"></a><h2>Description</h2><p>
- pass5 fires just after the call to <code class="function">gettimeofday</code>, just before the
- call to run_pass.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-pass4-end.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-pass5-end.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.pass4.end</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.pass5.end</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.pass6.end</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-pass6.html" title="probe::stap.pass6"><link rel="next" href="API-stap-system.html" title="probe::stap.system"></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>probe::stap.pass6.end</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-pass6.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-system.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.pass6.end"><a name="API-stap-pass6-end"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.pass6.end —
- Finished stap pass6 (cleanup)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.pass6.end </pre></div><div class="refsect1" title="Values"><a name="idp12492064"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>session</code></em></span></dt><dd><p>
- the systemtap_session variable s
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12495280"></a><h2>Description</h2><p>
- pass6.end fires just before main's return.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-pass6.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-system.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.pass6</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.system</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.pass6</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-pass5-end.html" title="probe::stap.pass5.end"><link rel="next" href="API-stap-pass6-end.html" title="probe::stap.pass6.end"></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>probe::stap.pass6</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-pass5-end.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-pass6-end.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.pass6"><a name="API-stap-pass6"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.pass6 —
- Starting stap pass6 (cleanup)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.pass6 </pre></div><div class="refsect1" title="Values"><a name="idp12480880"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>session</code></em></span></dt><dd><p>
- the systemtap_session variable s
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12484096"></a><h2>Description</h2><p>
- pass6 fires just after the cleanup label, essentially the same spot
- as pass5.end
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-pass5-end.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-pass6-end.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.pass5.end</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.pass6.end</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.system.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-system.html" title="probe::stap.system"><link rel="next" href="API-stap-system-spawn.html" title="probe::stap.system.spawn"></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>probe::stap.system.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-system.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-system-spawn.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.system.return"><a name="API-stap-system-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.system.return —
- Finished a command from stap
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.system.return </pre></div><div class="refsect1" title="Values"><a name="idp12514544"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ret</code></em></span></dt><dd><p>
- a return code associated with running waitpid on the spawned process;
- a non-zero value indicates error
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12517792"></a><h2>Description</h2><p>
- Fires just before the return of the stap_system function, after waitpid.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-system.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-system-spawn.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.system</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.system.spawn</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.system.spawn</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-system-return.html" title="probe::stap.system.return"><link rel="next" href="API-stapio-receive-control-message.html" title="probe::stapio.receive_control_message"></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>probe::stap.system.spawn</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-system-return.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stapio-receive-control-message.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.system.spawn"><a name="API-stap-system-spawn"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.system.spawn —
- stap spawned new process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.system.spawn </pre></div><div class="refsect1" title="Values"><a name="idp12525824"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ret</code></em></span></dt><dd><p>
- the return value from posix_spawn
- </p></dd><dt><span class="term"><em class="parameter"><code>pid</code></em></span></dt><dd><p>
- the pid of the spawned process
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12531008"></a><h2>Description</h2><p>
- Fires just after the call to posix_spawn.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-system-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stapio-receive-control-message.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.system.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stapio.receive_control_message</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stap.system</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-pass6-end.html" title="probe::stap.pass6.end"><link rel="next" href="API-stap-system-return.html" title="probe::stap.system.return"></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>probe::stap.system</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-pass6-end.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-stap-system-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stap.system"><a name="API-stap-system"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stap.system —
- Starting a command from stap
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stap.system </pre></div><div class="refsect1" title="Values"><a name="idp12503248"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>command</code></em></span></dt><dd><p>
- the command string to be run by posix_spawn (as sh -c <str>)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12506544"></a><h2>Description</h2><p>
- Fires at the entry of the stap_system command.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-pass6-end.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stap-system-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.pass6.end</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.system.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::stapio.receive_control_message</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stap-system-spawn.html" title="probe::stap.system.spawn"><link rel="next" href="API-staprun-insert-module.html" title="probe::staprun.insert_module"></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>probe::stapio.receive_control_message</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stap-system-spawn.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-staprun-insert-module.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::stapio.receive_control_message"><a name="API-stapio-receive-control-message"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::stapio.receive_control_message —
- Received a control message
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">stapio.receive_control_message </pre></div><div class="refsect1" title="Values"><a name="idp12539056"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>len</code></em></span></dt><dd><p>
- the length (in bytes) of the data blob
- </p></dd><dt><span class="term"><em class="parameter"><code>data</code></em></span></dt><dd><p>
- a ptr to a binary blob of data sent as the control message
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- type of message being send; defined in runtime/transport/transport_msgs.h
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12546352"></a><h2>Description</h2><p>
- Fires just after a message was receieved and before it's processed.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stap-system-spawn.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-staprun-insert-module.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stap.system.spawn</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::staprun.insert_module</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::staprun.insert_module</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-stapio-receive-control-message.html" title="probe::stapio.receive_control_message"><link rel="next" href="API-staprun-remove-module.html" title="probe::staprun.remove_module"></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>probe::staprun.insert_module</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stapio-receive-control-message.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-staprun-remove-module.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::staprun.insert_module"><a name="API-staprun-insert-module"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::staprun.insert_module —
- Inserting SystemTap instrumentation module
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">staprun.insert_module </pre></div><div class="refsect1" title="Values"><a name="idp12554432"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>path</code></em></span></dt><dd><p>
- the full path to the .ko kernel module about to be inserted
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12557664"></a><h2>Description</h2><p>
- Fires just before the call to insert the module.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stapio-receive-control-message.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-staprun-remove-module.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::stapio.receive_control_message</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::staprun.remove_module</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::staprun.remove_module</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-staprun-insert-module.html" title="probe::staprun.insert_module"><link rel="next" href="API-staprun-send-control-message.html" title="probe::staprun.send_control_message"></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>probe::staprun.remove_module</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-staprun-insert-module.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-staprun-send-control-message.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::staprun.remove_module"><a name="API-staprun-remove-module"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::staprun.remove_module —
- Removing SystemTap instrumentation module
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">staprun.remove_module </pre></div><div class="refsect1" title="Values"><a name="idp12565664"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- the stap module name to be removed (without the .ko extension)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12568912"></a><h2>Description</h2><p>
- Fires just before the call to remove the module.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-staprun-insert-module.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-staprun-send-control-message.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::staprun.insert_module</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::staprun.send_control_message</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::staprun.send_control_message</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"><link rel="prev" href="API-staprun-remove-module.html" title="probe::staprun.remove_module"><link rel="next" href="nfsd.stp.html" title="Chapter 30. Network File Storage Tapsets"></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>probe::staprun.send_control_message</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-staprun-remove-module.html">Prev</a> </td><th width="60%" align="center">Chapter 29. SystemTap Translator Tapset</th><td width="20%" align="right"> <a accesskey="n" href="nfsd.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::staprun.send_control_message"><a name="API-staprun-send-control-message"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::staprun.send_control_message —
- Sending a control message
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">staprun.send_control_message </pre></div><div class="refsect1" title="Values"><a name="idp12576912"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>len</code></em></span></dt><dd><p>
- the length (in bytes) of the data blob
- </p></dd><dt><span class="term"><em class="parameter"><code>data</code></em></span></dt><dd><p>
- a ptr to a binary blob of data sent as the control message
- </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
- type of message being send; defined in runtime/transport/transport_msgs.h
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12584208"></a><h2>Description</h2><p>
- Fires at the beginning of the send_request function.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-staprun-remove-module.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="stap_staticmarkers.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="nfsd.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::staprun.remove_module</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 30. Network File Storage Tapsets</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::start_stopwatch</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-read-stopwatch-us.html" title="function::read_stopwatch_us"><link rel="next" href="API-stop-stopwatch.html" title="function::stop_stopwatch"></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::start_stopwatch</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-read-stopwatch-us.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-stop-stopwatch.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::start_stopwatch"><a name="API-start-stopwatch"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::start_stopwatch —
- Start a stopwatch
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- start_stopwatch(name:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5938640"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- the stopwatch name
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5941696"></a><h2>Description</h2><p>
- Start stopwatch <em class="parameter"><code>name</code></em>.
- Creates stopwatch <em class="parameter"><code>name</code></em> if it does not currently exist.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-read-stopwatch-us.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stop-stopwatch.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::read_stopwatch_us</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::stop_stopwatch</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::stop_stopwatch</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"><link rel="prev" href="API-start-stopwatch.html" title="function::start_stopwatch"><link rel="next" href="ctime.stp.html" title="Chapter 4. Time utility functions"></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::stop_stopwatch</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-start-stopwatch.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Timestamp Functions</th><td width="20%" align="right"> <a accesskey="n" href="ctime.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::stop_stopwatch"><a name="API-stop-stopwatch"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::stop_stopwatch —
- Stop a stopwatch
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- stop_stopwatch(name:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5950192"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- the stopwatch name
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5953248"></a><h2>Description</h2><p>
- Stop stopwatch <em class="parameter"><code>name</code></em>.
- Creates stopwatch <em class="parameter"><code>name</code></em> if it does not currently exist.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-start-stopwatch.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="timestamp_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ctime.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::start_stopwatch</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 4. Time utility functions</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::stp_pid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-stack-used.html" title="function::stack_used"><link rel="next" href="API-symdata.html" title="function::symdata"></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::stp_pid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stack-used.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-symdata.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::stp_pid"><a name="API-stp-pid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::stp_pid —
- The process id of the stapio process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- stp_pid:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5372752"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5373904"></a><h2>Description</h2><p>
- This function returns the process id of the
- stapio process that launched this script. There could be
- other SystemTap scripts and stapio processes running on
- the system.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stack-used.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-symdata.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::stack_used</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::symdata</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::str_replace</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="string.stp.html" title="Chapter 27. A collection of standard string functions"><link rel="prev" href="API-isinstr.html" title="function::isinstr"><link rel="next" href="API-stringat.html" title="function::stringat"></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::str_replace</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-isinstr.html">Prev</a> </td><th width="60%" align="center">Chapter 27. A collection of standard string functions</th><td width="20%" align="right"> <a accesskey="n" href="API-stringat.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::str_replace"><a name="API-str-replace"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::str_replace —
- str_replace Replaces all instances of a substring with another
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- str_replace:string(prnt_str:string,srch_str:string,rplc_str:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12007712"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>prnt_str</code></em></span></dt><dd><p>
- the string to search and replace in
- </p></dd><dt><span class="term"><em class="parameter"><code>srch_str</code></em></span></dt><dd><p>
- the substring which is used to search in <em class="parameter"><code>prnt_str</code></em> string
- </p></dd><dt><span class="term"><em class="parameter"><code>rplc_str</code></em></span></dt><dd><p>
- the substring which is used to replace <em class="parameter"><code>srch_str</code></em>
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12016400"></a><h2>Description</h2><p>
- This function returns the given string with
- substrings replaced.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-isinstr.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="string.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-stringat.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::isinstr</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::stringat</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::stringat</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="string.stp.html" title="Chapter 27. A collection of standard string functions"><link rel="prev" href="API-str-replace.html" title="function::str_replace"><link rel="next" href="API-strlen.html" title="function::strlen"></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::stringat</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-str-replace.html">Prev</a> </td><th width="60%" align="center">Chapter 27. A collection of standard string functions</th><td width="20%" align="right"> <a accesskey="n" href="API-strlen.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::stringat"><a name="API-stringat"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::stringat —
- Returns the char at a given position in the string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- stringat:long(str:string,pos:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12024416"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>str</code></em></span></dt><dd><p>
- the string to fetch the character from
- </p></dd><dt><span class="term"><em class="parameter"><code>pos</code></em></span></dt><dd><p>
- the position to get the character from (first character is 0)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12029680"></a><h2>Description</h2><p>
- This function returns the character at a given position in
- the string or zero if thestring doesn't have as many characters.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-str-replace.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="string.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-strlen.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::str_replace</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::strlen</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::strlen</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="string.stp.html" title="Chapter 27. A collection of standard string functions"><link rel="prev" href="API-stringat.html" title="function::stringat"><link rel="next" href="API-strtol.html" title="function::strtol"></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::strlen</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stringat.html">Prev</a> </td><th width="60%" align="center">Chapter 27. A collection of standard string functions</th><td width="20%" align="right"> <a accesskey="n" href="API-strtol.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::strlen"><a name="API-strlen"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::strlen —
- Returns the length of a string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- strlen:long(s:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12037744"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>s</code></em></span></dt><dd><p>
- the string
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12040896"></a><h2>Description</h2><p>
- This function returns the length of the string, which
- can be zero up to MAXSTRINGLEN.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stringat.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="string.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-strtol.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::stringat</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::strtol</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::strtol</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="string.stp.html" title="Chapter 27. A collection of standard string functions"><link rel="prev" href="API-strlen.html" title="function::strlen"><link rel="next" href="API-substr.html" title="function::substr"></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::strtol</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-strlen.html">Prev</a> </td><th width="60%" align="center">Chapter 27. A collection of standard string functions</th><td width="20%" align="right"> <a accesskey="n" href="API-substr.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::strtol"><a name="API-strtol"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::strtol —
- strtol - Convert a string to a long
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- strtol:long(str:string,base:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12048896"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>str</code></em></span></dt><dd><p>
- string to convert
- </p></dd><dt><span class="term"><em class="parameter"><code>base</code></em></span></dt><dd><p>
- the base to use
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12054080"></a><h2>Description</h2><p>
- This function converts the string representation of a number to an integer.
- The <em class="parameter"><code>base</code></em> parameter indicates the number base to assume for the string (eg. 16 for hex, 8 for octal, 2 for binary).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-strlen.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="string.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-substr.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::strlen</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::substr</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::substr</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="string.stp.html" title="Chapter 27. A collection of standard string functions"><link rel="prev" href="API-strtol.html" title="function::strtol"><link rel="next" href="API-text-str.html" title="function::text_str"></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::substr</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-strtol.html">Prev</a> </td><th width="60%" align="center">Chapter 27. A collection of standard string functions</th><td width="20%" align="right"> <a accesskey="n" href="API-text-str.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::substr"><a name="API-substr"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::substr —
- Returns a substring
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- substr:string(str:string,start:long,length:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12062944"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>str</code></em></span></dt><dd><p>
- the string to take a substring from
- </p></dd><dt><span class="term"><em class="parameter"><code>start</code></em></span></dt><dd><p>
- starting position of the extracted string (first character is 0)
- </p></dd><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- length of string to return
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12070208"></a><h2>Description</h2><p>
- Returns the substring of the given string at the given
- start position with the given length (or smaller if the length of the
- original string is less than start + length, or length is bigger than
- MAXSTRINGLEN).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-strtol.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="string.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-text-str.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::strtol</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::text_str</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.clnt.bind_new_program</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-netfilter-ip-pre-routing.html" title="probe::netfilter.ip.pre_routing"><link rel="next" href="API-sunrpc-clnt-call-async.html" title="probe::sunrpc.clnt.call_async"></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>probe::sunrpc.clnt.bind_new_program</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-netfilter-ip-pre-routing.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-clnt-call-async.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.clnt.bind_new_program"><a name="API-sunrpc-clnt-bind-new-program"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.clnt.bind_new_program —
- Bind a new RPC program to an existing client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.clnt.bind_new_program </pre></div><div class="refsect1" title="Values"><a name="idp8537696"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>prog</code></em></span></dt><dd><p>
- the number of new RPC program
- </p></dd><dt><span class="term"><em class="parameter"><code>progname</code></em></span></dt><dd><p>
- the name of new RPC program
- </p></dd><dt><span class="term"><em class="parameter"><code>old_vers</code></em></span></dt><dd><p>
- the version of old RPC program
- </p></dd><dt><span class="term"><em class="parameter"><code>old_progname</code></em></span></dt><dd><p>
- the name of old RPC program
- </p></dd><dt><span class="term"><em class="parameter"><code>vers</code></em></span></dt><dd><p>
- the version of new RPC program
- </p></dd><dt><span class="term"><em class="parameter"><code>servername</code></em></span></dt><dd><p>
- the server machine name
- </p></dd><dt><span class="term"><em class="parameter"><code>old_prog</code></em></span></dt><dd><p>
- the number of old RPC program
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-netfilter-ip-pre-routing.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-clnt-call-async.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::netfilter.ip.pre_routing</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.clnt.call_async</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.clnt.call_async</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-clnt-bind-new-program.html" title="probe::sunrpc.clnt.bind_new_program"><link rel="next" href="API-sunrpc-clnt-call-sync.html" title="probe::sunrpc.clnt.call_sync"></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>probe::sunrpc.clnt.call_async</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-clnt-bind-new-program.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-clnt-call-sync.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.clnt.call_async"><a name="API-sunrpc-clnt-call-async"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.clnt.call_async —
- Make an asynchronous RPC call
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.clnt.call_async </pre></div><div class="refsect1" title="Values"><a name="idp8559840"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>prog</code></em></span></dt><dd><p>
- the RPC program number
- </p></dd><dt><span class="term"><em class="parameter"><code>progname</code></em></span></dt><dd><p>
- the RPC program name
- </p></dd><dt><span class="term"><em class="parameter"><code>procname</code></em></span></dt><dd><p>
- the procedure name in this RPC call
- </p></dd><dt><span class="term"><em class="parameter"><code>proc</code></em></span></dt><dd><p>
- the procedure number in this RPC call
- </p></dd><dt><span class="term"><em class="parameter"><code>dead</code></em></span></dt><dd><p>
- whether this client is abandoned
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- flags
- </p></dd><dt><span class="term"><em class="parameter"><code>vers</code></em></span></dt><dd><p>
- the RPC program version number
- </p></dd><dt><span class="term"><em class="parameter"><code>port</code></em></span></dt><dd><p>
- the port number
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- the IP protocol number
- </p></dd><dt><span class="term"><em class="parameter"><code>servername</code></em></span></dt><dd><p>
- the server machine name
- </p></dd><dt><span class="term"><em class="parameter"><code>xid</code></em></span></dt><dd><p>
- current transmission id
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-clnt-bind-new-program.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-clnt-call-sync.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.clnt.bind_new_program</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.clnt.call_sync</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.clnt.call_sync</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-clnt-call-async.html" title="probe::sunrpc.clnt.call_async"><link rel="next" href="API-sunrpc-clnt-clone-client.html" title="probe::sunrpc.clnt.clone_client"></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>probe::sunrpc.clnt.call_sync</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-clnt-call-async.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-clnt-clone-client.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.clnt.call_sync"><a name="API-sunrpc-clnt-call-sync"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.clnt.call_sync —
- Make a synchronous RPC call
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.clnt.call_sync </pre></div><div class="refsect1" title="Values"><a name="idp8589936"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>prog</code></em></span></dt><dd><p>
- the RPC program number
- </p></dd><dt><span class="term"><em class="parameter"><code>progname</code></em></span></dt><dd><p>
- the RPC program name
- </p></dd><dt><span class="term"><em class="parameter"><code>procname</code></em></span></dt><dd><p>
- the procedure name in this RPC call
- </p></dd><dt><span class="term"><em class="parameter"><code>proc</code></em></span></dt><dd><p>
- the procedure number in this RPC call
- </p></dd><dt><span class="term"><em class="parameter"><code>dead</code></em></span></dt><dd><p>
- whether this client is abandoned
- </p></dd><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- flags
- </p></dd><dt><span class="term"><em class="parameter"><code>vers</code></em></span></dt><dd><p>
- the RPC program version number
- </p></dd><dt><span class="term"><em class="parameter"><code>port</code></em></span></dt><dd><p>
- the port number
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- the IP protocol number
- </p></dd><dt><span class="term"><em class="parameter"><code>servername</code></em></span></dt><dd><p>
- the server machine name
- </p></dd><dt><span class="term"><em class="parameter"><code>xid</code></em></span></dt><dd><p>
- current transmission id
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-clnt-call-async.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-clnt-clone-client.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.clnt.call_async</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.clnt.clone_client</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.clnt.clone_client</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-clnt-call-sync.html" title="probe::sunrpc.clnt.call_sync"><link rel="next" href="API-sunrpc-clnt-create-client.html" title="probe::sunrpc.clnt.create_client"></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>probe::sunrpc.clnt.clone_client</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-clnt-call-sync.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-clnt-create-client.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.clnt.clone_client"><a name="API-sunrpc-clnt-clone-client"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.clnt.clone_client —
- Clone an RPC client structure
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.clnt.clone_client </pre></div><div class="refsect1" title="Values"><a name="idp8620112"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>servername</code></em></span></dt><dd><p>
- the server machine name
- </p></dd><dt><span class="term"><em class="parameter"><code>vers</code></em></span></dt><dd><p>
- the RPC program version number
- </p></dd><dt><span class="term"><em class="parameter"><code>prog</code></em></span></dt><dd><p>
- the RPC program number
- </p></dd><dt><span class="term"><em class="parameter"><code>authflavor</code></em></span></dt><dd><p>
- the authentication flavor
- </p></dd><dt><span class="term"><em class="parameter"><code>progname</code></em></span></dt><dd><p>
- the RPC program name
- </p></dd><dt><span class="term"><em class="parameter"><code>port</code></em></span></dt><dd><p>
- the port number
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- the IP protocol number
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-clnt-call-sync.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-clnt-create-client.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.clnt.call_sync</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.clnt.create_client</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.clnt.create_client</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-clnt-clone-client.html" title="probe::sunrpc.clnt.clone_client"><link rel="next" href="API-sunrpc-clnt-restart-call.html" title="probe::sunrpc.clnt.restart_call"></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>probe::sunrpc.clnt.create_client</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-clnt-clone-client.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-clnt-restart-call.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.clnt.create_client"><a name="API-sunrpc-clnt-create-client"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.clnt.create_client —
- Create an RPC client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.clnt.create_client </pre></div><div class="refsect1" title="Values"><a name="idp8642160"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>servername</code></em></span></dt><dd><p>
- the server machine name
- </p></dd><dt><span class="term"><em class="parameter"><code>vers</code></em></span></dt><dd><p>
- the RPC program version number
- </p></dd><dt><span class="term"><em class="parameter"><code>prog</code></em></span></dt><dd><p>
- the RPC program number
- </p></dd><dt><span class="term"><em class="parameter"><code>authflavor</code></em></span></dt><dd><p>
- the authentication flavor
- </p></dd><dt><span class="term"><em class="parameter"><code>progname</code></em></span></dt><dd><p>
- the RPC program name
- </p></dd><dt><span class="term"><em class="parameter"><code>port</code></em></span></dt><dd><p>
- the port number
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- the IP protocol number
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-clnt-clone-client.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-clnt-restart-call.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.clnt.clone_client</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.clnt.restart_call</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.clnt.restart_call</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-clnt-create-client.html" title="probe::sunrpc.clnt.create_client"><link rel="next" href="API-sunrpc-clnt-shutdown-client.html" title="probe::sunrpc.clnt.shutdown_client"></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>probe::sunrpc.clnt.restart_call</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-clnt-create-client.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-clnt-shutdown-client.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.clnt.restart_call"><a name="API-sunrpc-clnt-restart-call"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.clnt.restart_call —
- Restart an asynchronous RPC call
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.clnt.restart_call </pre></div><div class="refsect1" title="Values"><a name="idp8664288"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>tk_priority</code></em></span></dt><dd><p>
- the task priority
- </p></dd><dt><span class="term"><em class="parameter"><code>prog</code></em></span></dt><dd><p>
- the RPC program number
- </p></dd><dt><span class="term"><em class="parameter"><code>tk_pid</code></em></span></dt><dd><p>
- the debugging aid of task
- </p></dd><dt><span class="term"><em class="parameter"><code>tk_flags</code></em></span></dt><dd><p>
- the task flags
- </p></dd><dt><span class="term"><em class="parameter"><code>servername</code></em></span></dt><dd><p>
- the server machine name
- </p></dd><dt><span class="term"><em class="parameter"><code>tk_runstate</code></em></span></dt><dd><p>
- the task run status
- </p></dd><dt><span class="term"><em class="parameter"><code>xid</code></em></span></dt><dd><p>
- the transmission id
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-clnt-create-client.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-clnt-shutdown-client.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.clnt.create_client</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.clnt.shutdown_client</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.clnt.shutdown_client</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-clnt-restart-call.html" title="probe::sunrpc.clnt.restart_call"><link rel="next" href="API-sunrpc-sched-delay.html" title="probe::sunrpc.sched.delay"></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>probe::sunrpc.clnt.shutdown_client</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-clnt-restart-call.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-sched-delay.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.clnt.shutdown_client"><a name="API-sunrpc-clnt-shutdown-client"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.clnt.shutdown_client —
- Shutdown an RPC client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.clnt.shutdown_client </pre></div><div class="refsect1" title="Values"><a name="idp8686240"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>om_ops</code></em></span></dt><dd><p>
- the count of operations
- </p></dd><dt><span class="term"><em class="parameter"><code>om_bytes_sent</code></em></span></dt><dd><p>
- the count of bytes out
- </p></dd><dt><span class="term"><em class="parameter"><code>prog</code></em></span></dt><dd><p>
- the RPC program number
- </p></dd><dt><span class="term"><em class="parameter"><code>authflavor</code></em></span></dt><dd><p>
- the authentication flavor
- </p></dd><dt><span class="term"><em class="parameter"><code>progname</code></em></span></dt><dd><p>
- the RPC program name
- </p></dd><dt><span class="term"><em class="parameter"><code>om_queue</code></em></span></dt><dd><p>
- the jiffies queued for xmit
- </p></dd><dt><span class="term"><em class="parameter"><code>om_rtt</code></em></span></dt><dd><p>
- the RPC RTT jiffies
- </p></dd><dt><span class="term"><em class="parameter"><code>om_bytes_recv</code></em></span></dt><dd><p>
- the count of bytes in
- </p></dd><dt><span class="term"><em class="parameter"><code>tasks</code></em></span></dt><dd><p>
- the number of references
- </p></dd><dt><span class="term"><em class="parameter"><code>netreconn</code></em></span></dt><dd><p>
- the count of reconnections
- </p></dd><dt><span class="term"><em class="parameter"><code>vers</code></em></span></dt><dd><p>
- the RPC program version number
- </p></dd><dt><span class="term"><em class="parameter"><code>om_execute</code></em></span></dt><dd><p>
- the RPC execution jiffies
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- the IP protocol number
- </p></dd><dt><span class="term"><em class="parameter"><code>port</code></em></span></dt><dd><p>
- the port number
- </p></dd><dt><span class="term"><em class="parameter"><code>clones</code></em></span></dt><dd><p>
- the number of clones
- </p></dd><dt><span class="term"><em class="parameter"><code>servername</code></em></span></dt><dd><p>
- the server machine name
- </p></dd><dt><span class="term"><em class="parameter"><code>rpccnt</code></em></span></dt><dd><p>
- the count of RPC calls
- </p></dd><dt><span class="term"><em class="parameter"><code>om_ntrans</code></em></span></dt><dd><p>
- the count of RPC transmissions
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-clnt-restart-call.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-sched-delay.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.clnt.restart_call</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.sched.delay</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.sched.delay</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-clnt-shutdown-client.html" title="probe::sunrpc.clnt.shutdown_client"><link rel="next" href="API-sunrpc-sched-execute.html" title="probe::sunrpc.sched.execute"></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>probe::sunrpc.sched.delay</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-clnt-shutdown-client.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-sched-execute.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.sched.delay"><a name="API-sunrpc-sched-delay"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.sched.delay —
- Delay an RPC task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.sched.delay </pre></div><div class="refsect1" title="Values"><a name="idp8730432"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>prog</code></em></span></dt><dd><p>
- the program number in the RPC call
- </p></dd><dt><span class="term"><em class="parameter"><code>delay</code></em></span></dt><dd><p>
- the time delayed
- </p></dd><dt><span class="term"><em class="parameter"><code>tk_pid</code></em></span></dt><dd><p>
- the debugging id of the task
- </p></dd><dt><span class="term"><em class="parameter"><code>tk_flags</code></em></span></dt><dd><p>
- the flags of the task
- </p></dd><dt><span class="term"><em class="parameter"><code>vers</code></em></span></dt><dd><p>
- the program version in the RPC call
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- the IP protocol in the RPC call
- </p></dd><dt><span class="term"><em class="parameter"><code>xid</code></em></span></dt><dd><p>
- the transmission id in the RPC call
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-clnt-shutdown-client.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-sched-execute.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.clnt.shutdown_client</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.sched.execute</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.sched.execute</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-sched-delay.html" title="probe::sunrpc.sched.delay"><link rel="next" href="API-sunrpc-sched-new-task.html" title="probe::sunrpc.sched.new_task"></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>probe::sunrpc.sched.execute</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-sched-delay.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-sched-new-task.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.sched.execute"><a name="API-sunrpc-sched-execute"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.sched.execute —
- Execute the RPC `scheduler'
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.sched.execute </pre></div><div class="refsect1" title="Values"><a name="idp8752544"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>prog</code></em></span></dt><dd><p>
- the program number in the RPC call
- </p></dd><dt><span class="term"><em class="parameter"><code>tk_pid</code></em></span></dt><dd><p>
- the debugging id of the task
- </p></dd><dt><span class="term"><em class="parameter"><code>tk_flags</code></em></span></dt><dd><p>
- the flags of the task
- </p></dd><dt><span class="term"><em class="parameter"><code>vers</code></em></span></dt><dd><p>
- the program version in the RPC call
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- the IP protocol in the RPC call
- </p></dd><dt><span class="term"><em class="parameter"><code>xid</code></em></span></dt><dd><p>
- the transmission id in the RPC call
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-sched-delay.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-sched-new-task.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.sched.delay</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.sched.new_task</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.sched.new_task</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-sched-execute.html" title="probe::sunrpc.sched.execute"><link rel="next" href="API-sunrpc-sched-release-task.html" title="probe::sunrpc.sched.release_task"></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>probe::sunrpc.sched.new_task</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-sched-execute.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-sched-release-task.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.sched.new_task"><a name="API-sunrpc-sched-new-task"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.sched.new_task —
- Create new task for the specified client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.sched.new_task </pre></div><div class="refsect1" title="Values"><a name="idp8772592"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>prog</code></em></span></dt><dd><p>
- the program number in the RPC call
- </p></dd><dt><span class="term"><em class="parameter"><code>tk_flags</code></em></span></dt><dd><p>
- the flags of the task
- </p></dd><dt><span class="term"><em class="parameter"><code>vers</code></em></span></dt><dd><p>
- the program version in the RPC call
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- the IP protocol in the RPC call
- </p></dd><dt><span class="term"><em class="parameter"><code>xid</code></em></span></dt><dd><p>
- the transmission id in the RPC call
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-sched-execute.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-sched-release-task.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.sched.execute</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.sched.release_task</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.sched.release_task</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-sched-new-task.html" title="probe::sunrpc.sched.new_task"><link rel="next" href="API-sunrpc-svc-create.html" title="probe::sunrpc.svc.create"></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>probe::sunrpc.sched.release_task</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-sched-new-task.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-svc-create.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.sched.release_task"><a name="API-sunrpc-sched-release-task"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.sched.release_task —
- Release all resources associated with a task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.sched.release_task </pre></div><div class="refsect1" title="Values"><a name="idp8790704"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>prog</code></em></span></dt><dd><p>
- the program number in the RPC call
- </p></dd><dt><span class="term"><em class="parameter"><code>tk_flags</code></em></span></dt><dd><p>
- the flags of the task
- </p></dd><dt><span class="term"><em class="parameter"><code>vers</code></em></span></dt><dd><p>
- the program version in the RPC call
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- the IP protocol in the RPC call
- </p></dd><dt><span class="term"><em class="parameter"><code>xid</code></em></span></dt><dd><p>
- the transmission id in the RPC call
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp8802000"></a><h2>Description</h2><p>
- <code class="function">rpc_release_task</code> function might not be found for a particular kernel.
- So, if we can't find it, just return '-1' for everything.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-sched-new-task.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-svc-create.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.sched.new_task</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.svc.create</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.svc.create</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-sched-release-task.html" title="probe::sunrpc.sched.release_task"><link rel="next" href="API-sunrpc-svc-destroy.html" title="probe::sunrpc.svc.destroy"></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>probe::sunrpc.svc.create</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-sched-release-task.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-svc-destroy.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.svc.create"><a name="API-sunrpc-svc-create"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.svc.create —
- Create an RPC service
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.svc.create </pre></div><div class="refsect1" title="Values"><a name="idp8810688"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>prog</code></em></span></dt><dd><p>
- the number of the program
- </p></dd><dt><span class="term"><em class="parameter"><code>progname</code></em></span></dt><dd><p>
- the name of the program
- </p></dd><dt><span class="term"><em class="parameter"><code>pg_nvers</code></em></span></dt><dd><p>
- the number of supported versions
- </p></dd><dt><span class="term"><em class="parameter"><code>bufsize</code></em></span></dt><dd><p>
- the buffer size
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-sched-release-task.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-svc-destroy.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.sched.release_task</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.svc.destroy</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.svc.destroy</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-svc-create.html" title="probe::sunrpc.svc.create"><link rel="next" href="API-sunrpc-svc-drop.html" title="probe::sunrpc.svc.drop"></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>probe::sunrpc.svc.destroy</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-svc-create.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-svc-drop.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.svc.destroy"><a name="API-sunrpc-svc-destroy"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.svc.destroy —
- Destroy an RPC service
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.svc.destroy </pre></div><div class="refsect1" title="Values"><a name="idp8826592"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sv_name</code></em></span></dt><dd><p>
- the service name
- </p></dd><dt><span class="term"><em class="parameter"><code>sv_prog</code></em></span></dt><dd><p>
- the number of the program
- </p></dd><dt><span class="term"><em class="parameter"><code>nettcpconn</code></em></span></dt><dd><p>
- the count of accepted TCP connections
- </p></dd><dt><span class="term"><em class="parameter"><code>netcnt</code></em></span></dt><dd><p>
- the count of received RPC requests
- </p></dd><dt><span class="term"><em class="parameter"><code>rpcbadauth</code></em></span></dt><dd><p>
- the count of requests drooped for authentication failure
- </p></dd><dt><span class="term"><em class="parameter"><code>sv_nrthreads</code></em></span></dt><dd><p>
- the number of concurrent threads
- </p></dd><dt><span class="term"><em class="parameter"><code>sv_progname</code></em></span></dt><dd><p>
- the name of the program
- </p></dd><dt><span class="term"><em class="parameter"><code>rpcbadfmt</code></em></span></dt><dd><p>
- the count of requests dropped for bad formats
- </p></dd><dt><span class="term"><em class="parameter"><code>rpccnt</code></em></span></dt><dd><p>
- the count of valid RPC requests
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-svc-create.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-svc-drop.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.svc.create</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.svc.drop</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.svc.drop</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-svc-destroy.html" title="probe::sunrpc.svc.destroy"><link rel="next" href="API-sunrpc-svc-process.html" title="probe::sunrpc.svc.process"></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>probe::sunrpc.svc.drop</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-svc-destroy.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-svc-process.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.svc.drop"><a name="API-sunrpc-svc-drop"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.svc.drop —
- Drop RPC request
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.svc.drop </pre></div><div class="refsect1" title="Values"><a name="idp8852704"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>rq_prot</code></em></span></dt><dd><p>
- the IP protocol of the reqeust
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_proc</code></em></span></dt><dd><p>
- the procedure number in the request
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_vers</code></em></span></dt><dd><p>
- the program version in the request
- </p></dd><dt><span class="term"><em class="parameter"><code>sv_name</code></em></span></dt><dd><p>
- the service name
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_xid</code></em></span></dt><dd><p>
- the transmission id in the request
- </p></dd><dt><span class="term"><em class="parameter"><code>peer_ip</code></em></span></dt><dd><p>
- the peer address where the request is from
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_prog</code></em></span></dt><dd><p>
- the program number in the request
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-svc-destroy.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-svc-process.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.svc.destroy</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.svc.process</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.svc.process</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-svc-drop.html" title="probe::sunrpc.svc.drop"><link rel="next" href="API-sunrpc-svc-recv.html" title="probe::sunrpc.svc.recv"></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>probe::sunrpc.svc.process</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-svc-drop.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-svc-recv.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.svc.process"><a name="API-sunrpc-svc-process"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.svc.process —
- Process an RPC request
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.svc.process </pre></div><div class="refsect1" title="Values"><a name="idp8874848"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>rq_prot</code></em></span></dt><dd><p>
- the IP protocol of the reqeust
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_proc</code></em></span></dt><dd><p>
- the procedure number in the request
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_vers</code></em></span></dt><dd><p>
- the program version in the request
- </p></dd><dt><span class="term"><em class="parameter"><code>sv_name</code></em></span></dt><dd><p>
- the service name
- </p></dd><dt><span class="term"><em class="parameter"><code>sv_prog</code></em></span></dt><dd><p>
- the number of the program
- </p></dd><dt><span class="term"><em class="parameter"><code>sv_nrthreads</code></em></span></dt><dd><p>
- the number of concurrent threads
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_xid</code></em></span></dt><dd><p>
- the transmission id in the request
- </p></dd><dt><span class="term"><em class="parameter"><code>peer_ip</code></em></span></dt><dd><p>
- the peer address where the request is from
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_prog</code></em></span></dt><dd><p>
- the program number in the request
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-svc-drop.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-svc-recv.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.svc.drop</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.svc.recv</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.svc.recv</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-svc-process.html" title="probe::sunrpc.svc.process"><link rel="next" href="API-sunrpc-svc-register.html" title="probe::sunrpc.svc.register"></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>probe::sunrpc.svc.recv</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-svc-process.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-svc-register.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.svc.recv"><a name="API-sunrpc-svc-recv"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.svc.recv —
- Listen for the next RPC request on any socket
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.svc.recv </pre></div><div class="refsect1" title="Values"><a name="idp8901024"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sv_name</code></em></span></dt><dd><p>
- the service name
- </p></dd><dt><span class="term"><em class="parameter"><code>sv_prog</code></em></span></dt><dd><p>
- the number of the program
- </p></dd><dt><span class="term"><em class="parameter"><code>timeout</code></em></span></dt><dd><p>
- the timeout of waiting for data
- </p></dd><dt><span class="term"><em class="parameter"><code>sv_nrthreads</code></em></span></dt><dd><p>
- the number of concurrent threads
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-svc-process.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-svc-register.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.svc.process</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.svc.register</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.svc.register</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-svc-recv.html" title="probe::sunrpc.svc.recv"><link rel="next" href="API-sunrpc-svc-send.html" title="probe::sunrpc.svc.send"></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>probe::sunrpc.svc.register</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-svc-recv.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-sunrpc-svc-send.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.svc.register"><a name="API-sunrpc-svc-register"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.svc.register —
- Register an RPC service with the local portmapper
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.svc.register </pre></div><div class="refsect1" title="Values"><a name="idp8917088"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>prog</code></em></span></dt><dd><p>
- the number of the program
- </p></dd><dt><span class="term"><em class="parameter"><code>progname</code></em></span></dt><dd><p>
- the name of the program
- </p></dd><dt><span class="term"><em class="parameter"><code>sv_name</code></em></span></dt><dd><p>
- the service name
- </p></dd><dt><span class="term"><em class="parameter"><code>port</code></em></span></dt><dd><p>
- the port number
- </p></dd><dt><span class="term"><em class="parameter"><code>prot</code></em></span></dt><dd><p>
- the IP protocol number
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp8928352"></a><h2>Description</h2><p>
- If <em class="parameter"><code>proto</code></em> and <em class="parameter"><code>port</code></em> are both 0, then unregister a service.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-svc-recv.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-sunrpc-svc-send.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.svc.recv</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::sunrpc.svc.send</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::sunrpc.svc.send</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-svc-register.html" title="probe::sunrpc.svc.register"><link rel="next" href="API-tcp-disconnect.html" title="probe::tcp.disconnect"></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>probe::sunrpc.svc.send</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-svc-register.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcp-disconnect.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::sunrpc.svc.send"><a name="API-sunrpc-svc-send"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::sunrpc.svc.send —
- Return reply to RPC client
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">sunrpc.svc.send </pre></div><div class="refsect1" title="Values"><a name="idp8937760"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>rq_prot</code></em></span></dt><dd><p>
- the IP protocol of the reqeust
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_proc</code></em></span></dt><dd><p>
- the procedure number in the request
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_vers</code></em></span></dt><dd><p>
- the program version in the request
- </p></dd><dt><span class="term"><em class="parameter"><code>sv_name</code></em></span></dt><dd><p>
- the service name
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_xid</code></em></span></dt><dd><p>
- the transmission id in the request
- </p></dd><dt><span class="term"><em class="parameter"><code>peer_ip</code></em></span></dt><dd><p>
- the peer address where the request is from
- </p></dd><dt><span class="term"><em class="parameter"><code>rq_prog</code></em></span></dt><dd><p>
- the program number in the request
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-svc-register.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcp-disconnect.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.svc.register</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcp.disconnect</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::symdata</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-stp-pid.html" title="function::stp_pid"><link rel="next" href="API-symname.html" title="function::symname"></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::symdata</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stp-pid.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-symname.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::symdata"><a name="API-symdata"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::symdata —
- Return the kernel symbol and module offset for the address
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- symdata:string(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5381424"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The address to translate
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5384480"></a><h2>Description</h2><p>
- Returns the (function) symbol name associated with the
- given address if known, the offset from the start and size of the
- symbol, plus module name (between brackets). If symbol is unknown,
- but module is known, the offset inside the module, plus the size of
- the module is added. If any element is not known it will be
- omitted and if the symbol name is unknown it will return the hex
- string for the given address.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stp-pid.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-symname.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::stp_pid</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::symname</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::symname</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-symdata.html" title="function::symdata"><link rel="next" href="API-target.html" title="function::target"></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::symname</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-symdata.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-target.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::symname"><a name="API-symname"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::symname —
- Return the kernel symbol associated with the given address
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- symname:string(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5392256"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The address to translate
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5395312"></a><h2>Description</h2><p>
- Returns the (function) symbol name associated with the
- given address if known. If not known it will return the hex string
- representation of addr.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-symdata.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-target.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::symdata</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::target</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::system</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="system.stp.html" title="Chapter 5. Shell command functions"><link rel="prev" href="system.stp.html" title="Chapter 5. Shell command functions"><link rel="next" href="memory_stp.html" title="Chapter 6. Memory Tapset"></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::system</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="system.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Shell command functions</th><td width="20%" align="right"> <a accesskey="n" href="memory_stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::system"><a name="API-system"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::system —
- Issue a command to the system
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- system(cmd:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6010752"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>cmd</code></em></span></dt><dd><p>
- the command to issue to the system
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp6013808"></a><h2>Description</h2><p>
- This function runs a command on the system. The
- command is started in the background some time after the current
- probe completes. The command is run with the same UID as the user
- running the stap or staprun command.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="system.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="system.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="memory_stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 5. Shell command functions </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 6. Memory Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::target_set_pid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="kprocess.stp.html" title="Chapter 16. Kernel Process Tapset"><link rel="prev" href="kprocess.stp.html" title="Chapter 16. Kernel Process Tapset"><link rel="next" href="API-target-set-report.html" title="function::target_set_report"></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::target_set_pid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="kprocess.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 16. Kernel Process Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-target-set-report.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::target_set_pid"><a name="API-target-set-pid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::target_set_pid —
- Does pid descend from target process?
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- target_set_pid(pid:)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp10314480"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>pid</code></em></span></dt><dd><p>
- The pid of the process to query
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10317664"></a><h2>Description</h2><p>
- This function returns whether the given process-id is
- within the <span class="quote">“<span class="quote">target set</span>”</span>, that is whether it is a descendant of the
- top-level <code class="function">target</code> process.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="kprocess.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="kprocess.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-target-set-report.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 16. Kernel Process Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::target_set_report</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::target_set_report</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="kprocess.stp.html" title="Chapter 16. Kernel Process Tapset"><link rel="prev" href="API-target-set-pid.html" title="function::target_set_pid"><link rel="next" href="API-kprocess-create.html" title="probe::kprocess.create"></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::target_set_report</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-target-set-pid.html">Prev</a> </td><th width="60%" align="center">Chapter 16. Kernel Process Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-kprocess-create.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::target_set_report"><a name="API-target-set-report"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::target_set_report —
- Print a report about the target set
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- target_set_report()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp10326944"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp10328160"></a><h2>Description</h2><p>
- This function prints a report about the processes in the
- target set, and their ancestry.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-target-set-pid.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="kprocess.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-kprocess-create.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::target_set_pid</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::kprocess.create</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::target</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-symname.html" title="function::symname"><link rel="next" href="API-task-backtrace.html" title="function::task_backtrace"></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::target</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-symname.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-task-backtrace.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::target"><a name="API-target"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::target —
- Return the process ID of the target process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- target:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5402736"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5403888"></a><h2>Description</h2><p>
- This function returns the process ID of the target
- process. This is useful in conjunction with the -x PID or
- -c CMD command-line options to stap. An example of its use is
- to create scripts that filter on a specific process.
- </p><p>
-
- -x <pid>
- <code class="function">target</code> returns the pid specified by -x
- </p><p>
-
- -c <command>
- <code class="function">target</code> returns the pid for the executed command specified by -c
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-symname.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-task-backtrace.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::symname</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::task_backtrace</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_backtrace</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-target.html" title="function::target"><link rel="next" href="API-task-cpu.html" title="function::task_cpu"></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::task_backtrace</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-target.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-task-cpu.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_backtrace"><a name="API-task-backtrace"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_backtrace —
- Hex backtrace of an arbitrary task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_backtrace:string(task:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5413232"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- pointer to task_struct
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5416288"></a><h2>Description</h2><p>
- This function returns a string of hex addresses
- that are a backtrace of the stack of a particular task
- Output may be truncated as per maximum string length.
- Deprecated in SystemTap 1.6.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-target.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-task-cpu.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::target</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::task_cpu</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_cpu</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-task-backtrace.html" title="function::task_backtrace"><link rel="next" href="API-task-current.html" title="function::task_current"></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::task_cpu</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-backtrace.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-task-current.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_cpu"><a name="API-task-cpu"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_cpu —
- The scheduled cpu of the task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_cpu:long(task:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5423744"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- task_struct pointer
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5426800"></a><h2>Description</h2><p>
- This function returns the scheduled cpu for the given task.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-backtrace.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-task-current.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_backtrace</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::task_current</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_current</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-task-cpu.html" title="function::task_cpu"><link rel="next" href="API-task-egid.html" title="function::task_egid"></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::task_current</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-cpu.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-task-egid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_current"><a name="API-task-current"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_current —
- The current task_struct of the current task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_current:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5434128"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5435280"></a><h2>Description</h2><p>
- This function returns the task_struct representing the current process.
- This address can be passed to the various task_*() functions to extract
- more task-specific data.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-cpu.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-task-egid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_cpu</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::task_egid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_dentry_path</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="dentry.stp.html" title="Chapter 20. Directory-entry (dentry) Tapset"><link rel="prev" href="API-reverse-path-walk.html" title="function::reverse_path_walk"><link rel="next" href="logging.stp.html" title="Chapter 21. Logging Tapset"></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::task_dentry_path</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-reverse-path-walk.html">Prev</a> </td><th width="60%" align="center">Chapter 20. Directory-entry (dentry) Tapset</th><td width="20%" align="right"> <a accesskey="n" href="logging.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_dentry_path"><a name="API-task-dentry-path"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_dentry_path —
- get the full dentry path
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_dentry_path:string(task:long,dentry:long,vfsmnt:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11078560"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- task_struct pointer.
- </p></dd><dt><span class="term"><em class="parameter"><code>dentry</code></em></span></dt><dd><p>
- direntry pointer.
- </p></dd><dt><span class="term"><em class="parameter"><code>vfsmnt</code></em></span></dt><dd><p>
- vfsmnt pointer.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11085792"></a><h2>Description</h2><p>
- </p><p>
-
- Returns the full dirent name (full path to the root), like
- the kernel d_path function.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-reverse-path-walk.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="dentry.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="logging.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::reverse_path_walk</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 21. Logging Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_egid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-task-current.html" title="function::task_current"><link rel="next" href="API-task-euid.html" title="function::task_euid"></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::task_egid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-current.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-task-euid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_egid"><a name="API-task-egid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_egid —
- The effective group identifier of the task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_egid:long(task:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5442720"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- task_struct pointer
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5445776"></a><h2>Description</h2><p>
- This function returns the effective group id of the given task.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-current.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-task-euid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_current</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::task_euid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_euid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-task-egid.html" title="function::task_egid"><link rel="next" href="API-task-execname.html" title="function::task_execname"></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::task_euid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-egid.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-task-execname.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_euid"><a name="API-task-euid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_euid —
- The effective user identifier of the task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_euid:long(task:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5453104"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- task_struct pointer
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5456160"></a><h2>Description</h2><p>
- This function returns the effective user id of the given task.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-egid.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-task-execname.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_egid</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::task_execname</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_execname</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-task-euid.html" title="function::task_euid"><link rel="next" href="API-task-gid.html" title="function::task_gid"></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::task_execname</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-euid.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-task-gid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_execname"><a name="API-task-execname"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_execname —
- The name of the task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_execname:string(task:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5463488"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- task_struct pointer
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5466544"></a><h2>Description</h2><p>
- Return the name of the given task.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-euid.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-task-gid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_euid</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::task_gid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_gid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-task-execname.html" title="function::task_execname"><link rel="next" href="API-task-max-file-handles.html" title="function::task_max_file_handles"></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::task_gid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-execname.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-task-max-file-handles.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_gid"><a name="API-task-gid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_gid —
- The group identifier of the task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_gid:long(task:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5473792"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- task_struct pointer
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5476848"></a><h2>Description</h2><p>
- This function returns the group id of the given task.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-execname.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-task-max-file-handles.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_execname</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::task_max_file_handles</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_max_file_handles</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-task-gid.html" title="function::task_gid"><link rel="next" href="API-task-nice.html" title="function::task_nice"></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::task_max_file_handles</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-gid.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-task-nice.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_max_file_handles"><a name="API-task-max-file-handles"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_max_file_handles —
- The max number of open files for the task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_max_file_handles:long(task:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5484176"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- task_struct pointer
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5487232"></a><h2>Description</h2><p>
- This function returns the maximum number of file handlers for the given task.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-gid.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-task-nice.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_gid</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::task_nice</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_nice</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-task-max-file-handles.html" title="function::task_max_file_handles"><link rel="next" href="API-task-open-file-handles.html" title="function::task_open_file_handles"></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::task_nice</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-max-file-handles.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-task-open-file-handles.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_nice"><a name="API-task-nice"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_nice —
- The nice value of the task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_nice:long(task:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5494576"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- task_struct pointer
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5497632"></a><h2>Description</h2><p>
- This function returns the nice value of the given task.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-max-file-handles.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-task-open-file-handles.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_max_file_handles</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::task_open_file_handles</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_open_file_handles</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-task-nice.html" title="function::task_nice"><link rel="next" href="API-task-parent.html" title="function::task_parent"></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::task_open_file_handles</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-nice.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-task-parent.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_open_file_handles"><a name="API-task-open-file-handles"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_open_file_handles —
- The number of open files of the task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_open_file_handles:long(task:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5504960"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- task_struct pointer
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5508016"></a><h2>Description</h2><p>
- This function returns the number of open file handlers for the given task.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-nice.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-task-parent.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_nice</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::task_parent</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_parent</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-task-open-file-handles.html" title="function::task_open_file_handles"><link rel="next" href="API-task-pid.html" title="function::task_pid"></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::task_parent</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-open-file-handles.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-task-pid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_parent"><a name="API-task-parent"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_parent —
- The task_struct of the parent task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_parent:long(task:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5515360"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- task_struct pointer
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5518416"></a><h2>Description</h2><p>
- This function returns the parent task_struct of
- the given task. This address can be passed to the various
- task_*() functions to extract more task-specific data.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-open-file-handles.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-task-pid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_open_file_handles</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::task_pid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_pid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-task-parent.html" title="function::task_parent"><link rel="next" href="API-task-prio.html" title="function::task_prio"></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::task_pid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-parent.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-task-prio.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_pid"><a name="API-task-pid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_pid —
- The process identifier of the task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_pid:long(task:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5525856"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- task_struct pointer
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5528912"></a><h2>Description</h2><p>
- This fucntion returns the process id of the given task.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-parent.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-task-prio.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_parent</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::task_prio</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_prio</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-task-pid.html" title="function::task_pid"><link rel="next" href="API-task-state.html" title="function::task_state"></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::task_prio</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-pid.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-task-state.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_prio"><a name="API-task-prio"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_prio —
- The priority value of the task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_prio:long(task:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5536240"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- task_struct pointer
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5539296"></a><h2>Description</h2><p>
- This function returns the priority value of the given task.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-pid.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-task-state.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_pid</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::task_state</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_state</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-task-prio.html" title="function::task_prio"><link rel="next" href="API-task-tid.html" title="function::task_tid"></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::task_state</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-prio.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-task-tid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_state"><a name="API-task-state"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_state —
- The state of the task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_state:long(task:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5546624"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- task_struct pointer
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5549680"></a><h2>Description</h2><p>
- Return the state of the given task, one of:
- TASK_RUNNING (0), TASK_INTERRUPTIBLE (1), TASK_UNINTERRUPTIBLE (2),
- TASK_STOPPED (4), TASK_TRACED (8), EXIT_ZOMBIE (16), or EXIT_DEAD (32).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-prio.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-task-tid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_prio</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::task_tid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_stime_tid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="task_time_stp.html" title="Chapter 7. Task Time Tapset"><link rel="prev" href="API-task-stime.html" title="function::task_stime"><link rel="next" href="API-task-time-string.html" title="function::task_time_string"></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::task_stime_tid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-stime.html">Prev</a> </td><th width="60%" align="center">Chapter 7. Task Time Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-task-time-string.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_stime_tid"><a name="API-task-stime-tid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_stime_tid —
- System time of the given task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_stime_tid:long(tid:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6468848"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>tid</code></em></span></dt><dd><p>
- Thread id of the given task
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp6472016"></a><h2>Description</h2><p>
- Returns the system time of the given task in cputime,
- or zero if the task doesn't exist.
- Does not include any time used by other tasks in this process, nor
- does it include any time of the children of this task.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-stime.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="task_time_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-task-time-string.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_stime</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::task_time_string</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_stime</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="task_time_stp.html" title="Chapter 7. Task Time Tapset"><link rel="prev" href="API-msecs-to-string.html" title="function::msecs_to_string"><link rel="next" href="API-task-stime-tid.html" title="function::task_stime_tid"></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::task_stime</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-msecs-to-string.html">Prev</a> </td><th width="60%" align="center">Chapter 7. Task Time Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-task-stime-tid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_stime"><a name="API-task-stime"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_stime —
- System time of the current task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_stime:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6459472"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp6460688"></a><h2>Description</h2><p>
- Returns the system time of the current task in cputime.
- Does not include any time used by other tasks in this process, nor
- does it include any time of the children of this task.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-msecs-to-string.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="task_time_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-task-stime-tid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::msecs_to_string</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::task_stime_tid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_tid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-task-state.html" title="function::task_state"><link rel="next" href="API-task-uid.html" title="function::task_uid"></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::task_tid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-state.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-task-uid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_tid"><a name="API-task-tid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_tid —
- The thread identifier of the task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_tid:long(task:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5557136"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- task_struct pointer
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5560192"></a><h2>Description</h2><p>
- This function returns the thread id of the given task.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-state.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-task-uid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_state</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::task_uid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_time_string_tid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="task_time_stp.html" title="Chapter 7. Task Time Tapset"><link rel="prev" href="API-task-time-string.html" title="function::task_time_string"><link rel="next" href="API-task-utime.html" title="function::task_utime"></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::task_time_string_tid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-time-string.html">Prev</a> </td><th width="60%" align="center">Chapter 7. Task Time Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-task-utime.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_time_string_tid"><a name="API-task-time-string-tid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_time_string_tid —
- Human readable string of task time usage
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_time_string_tid:string(tid:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6489984"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>tid</code></em></span></dt><dd><p>
- Thread id of the given task
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp6493152"></a><h2>Description</h2><p>
- Returns a human readable string showing the user and
- system time the given task has used up to now. For example
- <span class="quote">“<span class="quote">usr: 0m12.908s, sys: 1m6.851s</span>”</span>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-time-string.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="task_time_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-task-utime.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_time_string</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::task_utime</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_time_string</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="task_time_stp.html" title="Chapter 7. Task Time Tapset"><link rel="prev" href="API-task-stime-tid.html" title="function::task_stime_tid"><link rel="next" href="API-task-time-string-tid.html" title="function::task_time_string_tid"></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::task_time_string</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-stime-tid.html">Prev</a> </td><th width="60%" align="center">Chapter 7. Task Time Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-task-time-string-tid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_time_string"><a name="API-task-time-string"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_time_string —
- Human readable string of task time usage
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_time_string:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6480224"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp6481440"></a><h2>Description</h2><p>
- Returns a human readable string showing the user and
- system time the current task has used up to now. For example
- <span class="quote">“<span class="quote">usr: 0m12.908s, sys: 1m6.851s</span>”</span>.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-stime-tid.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="task_time_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-task-time-string-tid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_stime_tid</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::task_time_string_tid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_uid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-task-tid.html" title="function::task_tid"><link rel="next" href="API-tid.html" title="function::tid"></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::task_uid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-tid.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-tid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_uid"><a name="API-task-uid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_uid —
- The user identifier of the task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_uid:long(task:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5567520"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- task_struct pointer
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5570576"></a><h2>Description</h2><p>
- This function returns the user id of the given task.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-tid.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-tid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_tid</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::tid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_utime_tid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="task_time_stp.html" title="Chapter 7. Task Time Tapset"><link rel="prev" href="API-task-utime.html" title="function::task_utime"><link rel="next" href="sched.stp.html" title="Chapter 8. Scheduler Tapset"></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::task_utime_tid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-utime.html">Prev</a> </td><th width="60%" align="center">Chapter 7. Task Time Tapset</th><td width="20%" align="right"> <a accesskey="n" href="sched.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_utime_tid"><a name="API-task-utime-tid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_utime_tid —
- User time of the given task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_utime_tid:long(tid:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6510944"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>tid</code></em></span></dt><dd><p>
- Thread id of the given task
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp6514112"></a><h2>Description</h2><p>
- Returns the user time of the given task in cputime,
- or zero if the task doesn't exist.
- Does not include any time used by other tasks in this process, nor
- does it include any time of the children of this task.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-utime.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="task_time_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="sched.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_utime</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 8. Scheduler Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::task_utime</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="task_time_stp.html" title="Chapter 7. Task Time Tapset"><link rel="prev" href="API-task-time-string-tid.html" title="function::task_time_string_tid"><link rel="next" href="API-task-utime-tid.html" title="function::task_utime_tid"></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::task_utime</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-time-string-tid.html">Prev</a> </td><th width="60%" align="center">Chapter 7. Task Time Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-task-utime-tid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::task_utime"><a name="API-task-utime"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::task_utime —
- User time of the current task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- task_utime:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6501568"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp6502784"></a><h2>Description</h2><p>
- Returns the user time of the current task in cputime.
- Does not include any time used by other tasks in this process, nor
- does it include any time of the children of this task.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-time-string-tid.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="task_time_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-task-utime-tid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_time_string_tid</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::task_utime_tid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcp.disconnect.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-tcp-disconnect.html" title="probe::tcp.disconnect"><link rel="next" href="API-tcp-receive.html" title="probe::tcp.receive"></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>probe::tcp.disconnect.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcp-disconnect.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcp-receive.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcp.disconnect.return"><a name="API-tcp-disconnect-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcp.disconnect.return —
- TCP socket disconnection complete
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcp.disconnect.return </pre></div><div class="refsect1" title="Values"><a name="idp8985200"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ret</code></em></span></dt><dd><p>
- Error code (0: no error)
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp8990384"></a><h2>Context</h2><p>
- The process which disconnects tcp
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcp-disconnect.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcp-receive.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcp.disconnect</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcp.receive</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcp.disconnect</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-sunrpc-svc-send.html" title="probe::sunrpc.svc.send"><link rel="next" href="API-tcp-disconnect-return.html" title="probe::tcp.disconnect.return"></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>probe::tcp.disconnect</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-sunrpc-svc-send.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcp-disconnect-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcp.disconnect"><a name="API-tcp-disconnect"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcp.disconnect —
- TCP socket disconnection
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcp.disconnect </pre></div><div class="refsect1" title="Values"><a name="idp8959872"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- TCP flags (e.g. FIN, etc)
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>dport</code></em></span></dt><dd><p>
- TCP destination port
- </p></dd><dt><span class="term"><em class="parameter"><code>saddr</code></em></span></dt><dd><p>
- A string representing the source IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>daddr</code></em></span></dt><dd><p>
- A string representing the destination IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>sport</code></em></span></dt><dd><p>
- TCP source port
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- IP address family
- </p></dd><dt><span class="term"><em class="parameter"><code>sock</code></em></span></dt><dd><p>
- Network socket
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp8977232"></a><h2>Context</h2><p>
- The process which disconnects tcp
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-sunrpc-svc-send.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcp-disconnect-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::sunrpc.svc.send</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcp.disconnect.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcp.receive</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-tcp-disconnect-return.html" title="probe::tcp.disconnect.return"><link rel="next" href="API-tcp-recvmsg.html" title="probe::tcp.recvmsg"></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>probe::tcp.receive</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcp-disconnect-return.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcp-recvmsg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcp.receive"><a name="API-tcp-receive"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcp.receive —
- Called when a TCP packet is received
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcp.receive </pre></div><div class="refsect1" title="Values"><a name="idp8998352"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>urg</code></em></span></dt><dd><p>
- TCP URG flag
- </p></dd><dt><span class="term"><em class="parameter"><code>protocol</code></em></span></dt><dd><p>
- Packet protocol from driver
- </p></dd><dt><span class="term"><em class="parameter"><code>psh</code></em></span></dt><dd><p>
- TCP PSH flag
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>rst</code></em></span></dt><dd><p>
- TCP RST flag
- </p></dd><dt><span class="term"><em class="parameter"><code>dport</code></em></span></dt><dd><p>
- TCP destination port
- </p></dd><dt><span class="term"><em class="parameter"><code>saddr</code></em></span></dt><dd><p>
- A string representing the source IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>daddr</code></em></span></dt><dd><p>
- A string representing the destination IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>ack</code></em></span></dt><dd><p>
- TCP ACK flag
- </p></dd><dt><span class="term"><em class="parameter"><code>fin</code></em></span></dt><dd><p>
- TCP FIN flag
- </p></dd><dt><span class="term"><em class="parameter"><code>syn</code></em></span></dt><dd><p>
- TCP SYN flag
- </p></dd><dt><span class="term"><em class="parameter"><code>sport</code></em></span></dt><dd><p>
- TCP source port
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- IP address family
- </p></dd><dt><span class="term"><em class="parameter"><code>iphdr</code></em></span></dt><dd><p>
- IP header address
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcp-disconnect-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcp-recvmsg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcp.disconnect.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcp.recvmsg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcp.recvmsg.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-tcp-recvmsg.html" title="probe::tcp.recvmsg"><link rel="next" href="API-tcp-sendmsg.html" title="probe::tcp.sendmsg"></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>probe::tcp.recvmsg.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcp-recvmsg.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcp-sendmsg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcp.recvmsg.return"><a name="API-tcp-recvmsg-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcp.recvmsg.return —
- Receiving TCP message complete
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcp.recvmsg.return </pre></div><div class="refsect1" title="Values"><a name="idp9059616"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>dport</code></em></span></dt><dd><p>
- TCP destination port
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Number of bytes received or error code if an error occurred.
- </p></dd><dt><span class="term"><em class="parameter"><code>saddr</code></em></span></dt><dd><p>
- A string representing the source IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>daddr</code></em></span></dt><dd><p>
- A string representing the destination IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>sport</code></em></span></dt><dd><p>
- TCP source port
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- IP address family
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9074992"></a><h2>Context</h2><p>
- The process which receives a tcp message
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcp-recvmsg.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcp-sendmsg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcp.recvmsg</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcp.sendmsg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcp.recvmsg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-tcp-receive.html" title="probe::tcp.receive"><link rel="next" href="API-tcp-recvmsg-return.html" title="probe::tcp.recvmsg.return"></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>probe::tcp.recvmsg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcp-receive.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcp-recvmsg-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcp.recvmsg"><a name="API-tcp-recvmsg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcp.recvmsg —
- Receiving TCP message
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcp.recvmsg </pre></div><div class="refsect1" title="Values"><a name="idp9034240"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>dport</code></em></span></dt><dd><p>
- TCP destination port
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Number of bytes to be received
- </p></dd><dt><span class="term"><em class="parameter"><code>saddr</code></em></span></dt><dd><p>
- A string representing the source IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>daddr</code></em></span></dt><dd><p>
- A string representing the destination IP address
- </p></dd><dt><span class="term"><em class="parameter"><code>sport</code></em></span></dt><dd><p>
- TCP source port
- </p></dd><dt><span class="term"><em class="parameter"><code>sock</code></em></span></dt><dd><p>
- Network socket
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- IP address family
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9051616"></a><h2>Context</h2><p>
- The process which receives a tcp message
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcp-receive.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcp-recvmsg-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcp.receive</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcp.recvmsg.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcp.sendmsg.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-tcp-sendmsg.html" title="probe::tcp.sendmsg"><link rel="next" href="API-tcp-setsockopt.html" title="probe::tcp.setsockopt"></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>probe::tcp.sendmsg.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcp-sendmsg.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcp-setsockopt.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcp.sendmsg.return"><a name="API-tcp-sendmsg-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcp.sendmsg.return —
- Sending TCP message is done
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcp.sendmsg.return </pre></div><div class="refsect1" title="Values"><a name="idp9100112"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Number of bytes sent or error code if an error occurred.
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9105360"></a><h2>Context</h2><p>
- The process which sends a tcp message
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcp-sendmsg.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcp-setsockopt.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcp.sendmsg</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcp.setsockopt</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcp.sendmsg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-tcp-recvmsg-return.html" title="probe::tcp.recvmsg.return"><link rel="next" href="API-tcp-sendmsg-return.html" title="probe::tcp.sendmsg.return"></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>probe::tcp.sendmsg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcp-recvmsg-return.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcp-sendmsg-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcp.sendmsg"><a name="API-tcp-sendmsg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcp.sendmsg —
- Sending a tcp message
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcp.sendmsg </pre></div><div class="refsect1" title="Values"><a name="idp9082912"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Number of bytes to send
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- IP address family
- </p></dd><dt><span class="term"><em class="parameter"><code>sock</code></em></span></dt><dd><p>
- Network socket
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9092160"></a><h2>Context</h2><p>
- The process which sends a tcp message
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcp-recvmsg-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcp-sendmsg-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcp.recvmsg.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcp.sendmsg.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcp.setsockopt.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-tcp-setsockopt.html" title="probe::tcp.setsockopt"><link rel="next" href="API-udp-disconnect.html" title="probe::udp.disconnect"></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>probe::tcp.setsockopt.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcp-setsockopt.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-udp-disconnect.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcp.setsockopt.return"><a name="API-tcp-setsockopt-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcp.setsockopt.return —
- Return from <code class="function">setsockopt</code>
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcp.setsockopt.return </pre></div><div class="refsect1" title="Values"><a name="idp9138576"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ret</code></em></span></dt><dd><p>
- Error code (0: no error)
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9143760"></a><h2>Context</h2><p>
- The process which calls setsockopt
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcp-setsockopt.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-udp-disconnect.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcp.setsockopt</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::udp.disconnect</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcp.setsockopt</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-tcp-sendmsg-return.html" title="probe::tcp.sendmsg.return"><link rel="next" href="API-tcp-setsockopt-return.html" title="probe::tcp.setsockopt.return"></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>probe::tcp.setsockopt</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcp-sendmsg-return.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcp-setsockopt-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcp.setsockopt"><a name="API-tcp-setsockopt"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcp.setsockopt —
- Call to <code class="function">setsockopt</code>
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcp.setsockopt </pre></div><div class="refsect1" title="Values"><a name="idp9113936"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>optlen</code></em></span></dt><dd><p>
- Used to access values for <code class="function">setsockopt</code>
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>optname</code></em></span></dt><dd><p>
- TCP socket options (e.g. TCP_NODELAY, TCP_MAXSEG, etc)
- </p></dd><dt><span class="term"><em class="parameter"><code>optstr</code></em></span></dt><dd><p>
- Resolves optname to a human-readable format
- </p></dd><dt><span class="term"><em class="parameter"><code>level</code></em></span></dt><dd><p>
- The level at which the socket options will be manipulated
- </p></dd><dt><span class="term"><em class="parameter"><code>family</code></em></span></dt><dd><p>
- IP address family
- </p></dd><dt><span class="term"><em class="parameter"><code>sock</code></em></span></dt><dd><p>
- Network socket
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9130000"></a><h2>Context</h2><p>
- The process which calls setsockopt
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcp-sendmsg-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcp-setsockopt-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcp.sendmsg.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcp.setsockopt.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcpmib.ActiveOpens</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-linuxmib-TCPMemoryPressures.html" title="probe::linuxmib.TCPMemoryPressures"><link rel="next" href="API-tcpmib-AttemptFails.html" title="probe::tcpmib.AttemptFails"></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>probe::tcpmib.ActiveOpens</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-linuxmib-TCPMemoryPressures.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcpmib-AttemptFails.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcpmib.ActiveOpens"><a name="API-tcpmib-ActiveOpens"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcpmib.ActiveOpens —
- Count an active opening of a socket
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcpmib.ActiveOpens </pre></div><div class="refsect1" title="Values"><a name="idp10174016"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- pointer to the struct sock being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10179216"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">tcpmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>ActiveOpens</code></em> (equivalent to SNMP's MIB
- TCP_MIB_ACTIVEOPENS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-linuxmib-TCPMemoryPressures.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcpmib-AttemptFails.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::linuxmib.TCPMemoryPressures</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcpmib.AttemptFails</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcpmib.AttemptFails</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-tcpmib-ActiveOpens.html" title="probe::tcpmib.ActiveOpens"><link rel="next" href="API-tcpmib-CurrEstab.html" title="probe::tcpmib.CurrEstab"></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>probe::tcpmib.AttemptFails</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcpmib-ActiveOpens.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcpmib-CurrEstab.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcpmib.AttemptFails"><a name="API-tcpmib-AttemptFails"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcpmib.AttemptFails —
- Count a failed attempt to open a socket
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcpmib.AttemptFails </pre></div><div class="refsect1" title="Values"><a name="idp10189392"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- pointer to the struct sock being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10194592"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">tcpmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>AttemptFails</code></em> (equivalent to SNMP's MIB
- TCP_MIB_ATTEMPTFAILS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcpmib-ActiveOpens.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcpmib-CurrEstab.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcpmib.ActiveOpens</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcpmib.CurrEstab</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcpmib.CurrEstab</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-tcpmib-AttemptFails.html" title="probe::tcpmib.AttemptFails"><link rel="next" href="API-tcpmib-EstabResets.html" title="probe::tcpmib.EstabResets"></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>probe::tcpmib.CurrEstab</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcpmib-AttemptFails.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcpmib-EstabResets.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcpmib.CurrEstab"><a name="API-tcpmib-CurrEstab"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcpmib.CurrEstab —
- Update the count of open sockets
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcpmib.CurrEstab </pre></div><div class="refsect1" title="Values"><a name="idp10204784"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- pointer to the struct sock being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10209984"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">tcpmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>CurrEstab</code></em> (equivalent to SNMP's MIB
- TCP_MIB_CURRESTAB)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcpmib-AttemptFails.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcpmib-EstabResets.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcpmib.AttemptFails</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcpmib.EstabResets</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcpmib.EstabResets</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-tcpmib-CurrEstab.html" title="probe::tcpmib.CurrEstab"><link rel="next" href="API-tcpmib-InSegs.html" title="probe::tcpmib.InSegs"></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>probe::tcpmib.EstabResets</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcpmib-CurrEstab.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcpmib-InSegs.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcpmib.EstabResets"><a name="API-tcpmib-EstabResets"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcpmib.EstabResets —
- Count the reset of a socket
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcpmib.EstabResets </pre></div><div class="refsect1" title="Values"><a name="idp10220192"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- pointer to the struct sock being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10225392"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">tcpmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>EstabResets</code></em> (equivalent to SNMP's MIB
- TCP_MIB_ESTABRESETS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcpmib-CurrEstab.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcpmib-InSegs.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcpmib.CurrEstab</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcpmib.InSegs</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcpmib.InSegs</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-tcpmib-EstabResets.html" title="probe::tcpmib.EstabResets"><link rel="next" href="API-tcpmib-OutRsts.html" title="probe::tcpmib.OutRsts"></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>probe::tcpmib.InSegs</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcpmib-EstabResets.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcpmib-OutRsts.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcpmib.InSegs"><a name="API-tcpmib-InSegs"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcpmib.InSegs —
- Count an incoming tcp segment
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcpmib.InSegs </pre></div><div class="refsect1" title="Values"><a name="idp10235504"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- pointer to the struct sock being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10240704"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">tcpmib_filter_key</code> (or <code class="function">ipmib_filter_key</code> for tcp v4).
- If the packet passes the filter is is
- counted in the global <em class="parameter"><code>InSegs</code></em> (equivalent to SNMP's MIB
- TCP_MIB_INSEGS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcpmib-EstabResets.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcpmib-OutRsts.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcpmib.EstabResets</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcpmib.OutRsts</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcpmib.OutRsts</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-tcpmib-InSegs.html" title="probe::tcpmib.InSegs"><link rel="next" href="API-tcpmib-OutSegs.html" title="probe::tcpmib.OutSegs"></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>probe::tcpmib.OutRsts</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcpmib-InSegs.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcpmib-OutSegs.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcpmib.OutRsts"><a name="API-tcpmib-OutRsts"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcpmib.OutRsts —
- Count the sending of a reset packet
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcpmib.OutRsts </pre></div><div class="refsect1" title="Values"><a name="idp10251568"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- pointer to the struct sock being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10256768"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">tcpmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>OutRsts</code></em> (equivalent to SNMP's MIB
- TCP_MIB_OUTRSTS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcpmib-InSegs.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcpmib-OutSegs.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcpmib.InSegs</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcpmib.OutSegs</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcpmib.OutSegs</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-tcpmib-OutRsts.html" title="probe::tcpmib.OutRsts"><link rel="next" href="API-tcpmib-PassiveOpens.html" title="probe::tcpmib.PassiveOpens"></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>probe::tcpmib.OutSegs</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcpmib-OutRsts.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcpmib-PassiveOpens.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcpmib.OutSegs"><a name="API-tcpmib-OutSegs"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcpmib.OutSegs —
- Count the sending of a TCP segment
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcpmib.OutSegs </pre></div><div class="refsect1" title="Values"><a name="idp10266912"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- pointer to the struct sock being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10272112"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">tcpmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>OutSegs</code></em> (equivalent to SNMP's MIB
- TCP_MIB_OUTSEGS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcpmib-OutRsts.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcpmib-PassiveOpens.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcpmib.OutRsts</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcpmib.PassiveOpens</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcpmib.PassiveOpens</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-tcpmib-OutSegs.html" title="probe::tcpmib.OutSegs"><link rel="next" href="API-tcpmib-RetransSegs.html" title="probe::tcpmib.RetransSegs"></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>probe::tcpmib.PassiveOpens</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcpmib-OutSegs.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcpmib-RetransSegs.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcpmib.PassiveOpens"><a name="API-tcpmib-PassiveOpens"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcpmib.PassiveOpens —
- Count the passive creation of a socket
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcpmib.PassiveOpens </pre></div><div class="refsect1" title="Values"><a name="idp10282288"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- pointer to the struct sock being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10287488"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">tcpmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>PassiveOpens</code></em> (equivalent to SNMP's MIB
- TCP_MIB_PASSIVEOPENS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcpmib-OutSegs.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcpmib-RetransSegs.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcpmib.OutSegs</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tcpmib.RetransSegs</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tcpmib.RetransSegs</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-tcpmib-PassiveOpens.html" title="probe::tcpmib.PassiveOpens"><link rel="next" href="kprocess.stp.html" title="Chapter 16. Kernel Process Tapset"></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>probe::tcpmib.RetransSegs</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcpmib-PassiveOpens.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="kprocess.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tcpmib.RetransSegs"><a name="API-tcpmib-RetransSegs"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tcpmib.RetransSegs —
- Count the retransmission of a TCP segment
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tcpmib.RetransSegs </pre></div><div class="refsect1" title="Values"><a name="idp10297664"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- pointer to the struct sock being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be added to the counter (default value of 1)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp10302864"></a><h2>Description</h2><p>
- The packet pointed to by <em class="parameter"><code>skb</code></em> is filtered by the function
- <code class="function">tcpmib_filter_key</code>. If the packet passes the filter is is
- counted in the global <em class="parameter"><code>RetransSegs</code></em> (equivalent to SNMP's MIB
- TCP_MIB_RETRANSSEGS)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcpmib-PassiveOpens.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="kprocess.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcpmib.PassiveOpens</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 16. Kernel Process Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::tcpmib_filter_key</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-linuxmib-filter-key.html" title="function::linuxmib_filter_key"><link rel="next" href="API-tcpmib-get-state.html" title="function::tcpmib_get_state"></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::tcpmib_filter_key</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-linuxmib-filter-key.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcpmib-get-state.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::tcpmib_filter_key"><a name="API-tcpmib-filter-key"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::tcpmib_filter_key —
- Default filter function for tcpmib.* probes
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- tcpmib_filter_key:long(sk:long,op:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9871712"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- pointer to the struct sock being acted on
- </p></dd><dt><span class="term"><em class="parameter"><code>op</code></em></span></dt><dd><p>
- value to be counted if <em class="parameter"><code>sk</code></em> passes the filter
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp9877568"></a><h2>Description</h2><p>
- This function is a default filter function.
- The user can replace this function with their own.
- The user-supplied filter function returns an index key based on the values
- in <em class="parameter"><code>sk</code></em>.
- A return value of 0 means this particular <em class="parameter"><code>sk</code></em> should be not be counted.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-linuxmib-filter-key.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcpmib-get-state.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::linuxmib_filter_key</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::tcpmib_get_state</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::tcpmib_get_state</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-tcpmib-filter-key.html" title="function::tcpmib_filter_key"><link rel="next" href="API-tcpmib-local-addr.html" title="function::tcpmib_local_addr"></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::tcpmib_get_state</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcpmib-filter-key.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcpmib-local-addr.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::tcpmib_get_state"><a name="API-tcpmib-get-state"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::tcpmib_get_state —
- Get a socket's state
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- tcpmib_get_state:long(sk:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9887104"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- pointer to a struct sock
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp9890272"></a><h2>Description</h2><p>
- Returns the sk_state from a struct sock.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcpmib-filter-key.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcpmib-local-addr.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::tcpmib_filter_key</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::tcpmib_local_addr</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::tcpmib_local_addr</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-tcpmib-get-state.html" title="function::tcpmib_get_state"><link rel="next" href="API-tcpmib-local-port.html" title="function::tcpmib_local_port"></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::tcpmib_local_addr</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcpmib-get-state.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcpmib-local-port.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::tcpmib_local_addr"><a name="API-tcpmib-local-addr"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::tcpmib_local_addr —
- Get the source address
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- tcpmib_local_addr:long(sk:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9898288"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- pointer to a struct inet_sock
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp9901472"></a><h2>Description</h2><p>
- Returns the saddr from a struct inet_sock in host order.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcpmib-get-state.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcpmib-local-port.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::tcpmib_get_state</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::tcpmib_local_port</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::tcpmib_local_port</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-tcpmib-local-addr.html" title="function::tcpmib_local_addr"><link rel="next" href="API-tcpmib-remote-addr.html" title="function::tcpmib_remote_addr"></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::tcpmib_local_port</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcpmib-local-addr.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcpmib-remote-addr.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::tcpmib_local_port"><a name="API-tcpmib-local-port"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::tcpmib_local_port —
- Get the local port
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- tcpmib_local_port:long(sk:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9909504"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- pointer to a struct inet_sock
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp9912688"></a><h2>Description</h2><p>
- Returns the sport from a struct inet_sock in host order.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcpmib-local-addr.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcpmib-remote-addr.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::tcpmib_local_addr</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::tcpmib_remote_addr</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::tcpmib_remote_addr</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-tcpmib-local-port.html" title="function::tcpmib_local_port"><link rel="next" href="API-tcpmib-remote-port.html" title="function::tcpmib_remote_port"></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::tcpmib_remote_addr</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcpmib-local-port.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tcpmib-remote-port.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::tcpmib_remote_addr"><a name="API-tcpmib-remote-addr"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::tcpmib_remote_addr —
- Get the remote address
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- tcpmib_remote_addr:long(sk:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9920720"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- pointer to a struct inet_sock
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp9923904"></a><h2>Description</h2><p>
- Returns the daddr from a struct inet_sock in host order.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcpmib-local-port.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tcpmib-remote-port.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::tcpmib_local_port</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::tcpmib_remote_port</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::tcpmib_remote_port</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="snmp.stp.html" title="Chapter 15. SNMP Information Tapset"><link rel="prev" href="API-tcpmib-remote-addr.html" title="function::tcpmib_remote_addr"><link rel="next" href="API-ipmib-ForwDatagrams.html" title="probe::ipmib.ForwDatagrams"></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::tcpmib_remote_port</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcpmib-remote-addr.html">Prev</a> </td><th width="60%" align="center">Chapter 15. SNMP Information Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-ipmib-ForwDatagrams.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::tcpmib_remote_port"><a name="API-tcpmib-remote-port"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::tcpmib_remote_port —
- Get the remote port
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- tcpmib_remote_port:long(sk:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp9931824"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>sk</code></em></span></dt><dd><p>
- pointer to a struct inet_sock
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp9935008"></a><h2>Description</h2><p>
- Returns the dport from a struct inet_sock in host order.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcpmib-remote-addr.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="snmp.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-ipmib-ForwDatagrams.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::tcpmib_remote_addr</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ipmib.ForwDatagrams</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::text_str</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="string.stp.html" title="Chapter 27. A collection of standard string functions"><link rel="prev" href="API-substr.html" title="function::substr"><link rel="next" href="API-text-strn.html" title="function::text_strn"></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::text_str</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-substr.html">Prev</a> </td><th width="60%" align="center">Chapter 27. A collection of standard string functions</th><td width="20%" align="right"> <a accesskey="n" href="API-text-strn.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::text_str"><a name="API-text-str"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::text_str —
- Escape any non-printable chars in a string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- text_str:string(input:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12078336"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>input</code></em></span></dt><dd><p>
- the string to escape
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12081536"></a><h2>Description</h2><p>
- This function accepts a string argument,
- and any ASCII characters that are not
- printable are replaced by the corresponding escape sequence in the
- returned string.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-substr.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="string.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-text-strn.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::substr</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::text_strn</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::text_strn</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="string.stp.html" title="Chapter 27. A collection of standard string functions"><link rel="prev" href="API-text-str.html" title="function::text_str"><link rel="next" href="API-tokenize.html" title="function::tokenize"></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::text_strn</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-text-str.html">Prev</a> </td><th width="60%" align="center">Chapter 27. A collection of standard string functions</th><td width="20%" align="right"> <a accesskey="n" href="API-tokenize.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::text_strn"><a name="API-text-strn"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::text_strn —
- Escape any non-printable chars in a string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- text_strn:string(input:string,len:long,quoted:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12089696"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>input</code></em></span></dt><dd><p>
- the string to escape
- </p></dd><dt><span class="term"><em class="parameter"><code>len</code></em></span></dt><dd><p>
- maximum length of string to return (0 implies MAXSTRINGLEN)
- </p></dd><dt><span class="term"><em class="parameter"><code>quoted</code></em></span></dt><dd><p>
- put double quotes around the string. If input string is
- truncated it will have <span class="quote">“<span class="quote">...</span>”</span> after the second quote
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12097472"></a><h2>Description</h2><p>
- This function accepts a string of designated length,
- and any ASCII characters that are not
- printable are replaced by the corresponding escape sequence in the
- returned string.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-text-str.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="string.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tokenize.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::text_str</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::tokenize</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::thread_indent</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ansi.stp.html" title="Chapter 28. Utility functions for using ansi control chars in logs"><link rel="prev" href="API-indent.html" title="function::indent"><link rel="next" href="stap_staticmarkers.stp.html" title="Chapter 29. SystemTap Translator Tapset"></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::thread_indent</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-indent.html">Prev</a> </td><th width="60%" align="center">Chapter 28. Utility functions for using ansi control chars in logs</th><td width="20%" align="right"> <a accesskey="n" href="stap_staticmarkers.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::thread_indent"><a name="API-thread-indent"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::thread_indent —
- returns an amount of space with the current task information
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- thread_indent:string(delta:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12252096"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>delta</code></em></span></dt><dd><p>
- the amount of space added/removed for each call
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12255328"></a><h2>Description</h2><p>
- This function returns a string with appropriate
- indentation for a thread. Call it with a small positive or
- matching negative delta. If this is the real outermost,
- initial level of indentation, then the function resets the
- relative timestamp base to zero. An example is shown at the
- end of this file.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-indent.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ansi.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="stap_staticmarkers.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::indent</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 29. SystemTap Translator Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::tid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-task-uid.html" title="function::task_uid"><link rel="next" href="API-u32-arg.html" title="function::u32_arg"></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::tid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-uid.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-u32-arg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::tid"><a name="API-tid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::tid —
- Returns the thread ID of a target process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- tid:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5577904"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5579056"></a><h2>Description</h2><p>
- This function returns the thread ID of the target process.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-uid.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-u32-arg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_uid</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::u32_arg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::tokenize</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="string.stp.html" title="Chapter 27. A collection of standard string functions"><link rel="prev" href="API-text-strn.html" title="function::text_strn"><link rel="next" href="ansi.stp.html" title="Chapter 28. Utility functions for using ansi control chars in logs"></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::tokenize</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-text-strn.html">Prev</a> </td><th width="60%" align="center">Chapter 27. A collection of standard string functions</th><td width="20%" align="right"> <a accesskey="n" href="ansi.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::tokenize"><a name="API-tokenize"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::tokenize —
- Return the next non-empty token in a string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- tokenize:string(input:string,delim:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp12105632"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>input</code></em></span></dt><dd><p>
- string to tokenize. If empty, returns the next non-empty token
- in the string passed in the previous call to <code class="function">tokenize</code>.
- </p></dd><dt><span class="term"><em class="parameter"><code>delim</code></em></span></dt><dd><p>
- set of characters that delimit the tokens
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp12111664"></a><h2>Description</h2><p>
- This function returns the next non-empty token in the
- given input string, where the tokens are delimited by characters in
- the delim string. If the input string is non-empty, it returns the
- first token. If the input string is empty, it returns the next
- token in the string passed in the previous call to tokenize.
- If no delimiter is found, the entire remaining input string is
- returned. It returns empty when no more tokens are available.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-text-strn.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="string.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ansi.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::text_strn</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 28. Utility functions for using ansi control chars in logs</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tty.init</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="tty.stp.html" title="Chapter 11. TTY Tapset"><link rel="prev" href="tty.stp.html" title="Chapter 11. TTY Tapset"><link rel="next" href="API-tty-ioctl.html" title="probe::tty.ioctl"></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>probe::tty.init</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="tty.stp.html">Prev</a> </td><th width="60%" align="center">Chapter 11. TTY Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tty-ioctl.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tty.init"><a name="API-tty-init"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tty.init —
- Called when a tty is being initalized
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tty.init </pre></div><div class="refsect1" title="Values"><a name="idp7290336"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>driver_name</code></em></span></dt><dd><p>
- the driver name
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- the driver .dev_name name
- </p></dd><dt><span class="term"><em class="parameter"><code>module</code></em></span></dt><dd><p>
- the module name
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="tty.stp.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="tty.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tty-ioctl.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 11. TTY Tapset </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tty.ioctl</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tty.ioctl</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="tty.stp.html" title="Chapter 11. TTY Tapset"><link rel="prev" href="API-tty-init.html" title="probe::tty.init"><link rel="next" href="API-tty-open.html" title="probe::tty.open"></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>probe::tty.ioctl</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tty-init.html">Prev</a> </td><th width="60%" align="center">Chapter 11. TTY Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tty-open.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tty.ioctl"><a name="API-tty-ioctl"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tty.ioctl —
- called when a ioctl is request to the tty
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tty.ioctl </pre></div><div class="refsect1" title="Values"><a name="idp7304304"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>cmd</code></em></span></dt><dd><p>
- the ioctl command
- </p></dd><dt><span class="term"><em class="parameter"><code>arg</code></em></span></dt><dd><p>
- the ioctl argument
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- the file name
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tty-init.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="tty.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tty-open.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tty.init</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tty.open</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tty.open</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="tty.stp.html" title="Chapter 11. TTY Tapset"><link rel="prev" href="API-tty-ioctl.html" title="probe::tty.ioctl"><link rel="next" href="API-tty-poll.html" title="probe::tty.poll"></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>probe::tty.open</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tty-ioctl.html">Prev</a> </td><th width="60%" align="center">Chapter 11. TTY Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tty-poll.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tty.open"><a name="API-tty-open"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tty.open —
- Called when a tty is opened
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tty.open </pre></div><div class="refsect1" title="Values"><a name="idp7318128"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>inode_state</code></em></span></dt><dd><p>
- the inode state
- </p></dd><dt><span class="term"><em class="parameter"><code>file_name</code></em></span></dt><dd><p>
- the file name
- </p></dd><dt><span class="term"><em class="parameter"><code>file_mode</code></em></span></dt><dd><p>
- the file mode
- </p></dd><dt><span class="term"><em class="parameter"><code>file_flags</code></em></span></dt><dd><p>
- the file flags
- </p></dd><dt><span class="term"><em class="parameter"><code>inode_number</code></em></span></dt><dd><p>
- the inode number
- </p></dd><dt><span class="term"><em class="parameter"><code>inode_flags</code></em></span></dt><dd><p>
- the inode flags
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tty-ioctl.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="tty.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tty-poll.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tty.ioctl</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tty.poll</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tty.poll</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="tty.stp.html" title="Chapter 11. TTY Tapset"><link rel="prev" href="API-tty-open.html" title="probe::tty.open"><link rel="next" href="API-tty-read.html" title="probe::tty.read"></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>probe::tty.poll</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tty-open.html">Prev</a> </td><th width="60%" align="center">Chapter 11. TTY Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tty-read.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tty.poll"><a name="API-tty-poll"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tty.poll —
- Called when a tty device is being polled
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tty.poll </pre></div><div class="refsect1" title="Values"><a name="idp7338080"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>file_name</code></em></span></dt><dd><p>
- the tty file name
- </p></dd><dt><span class="term"><em class="parameter"><code>wait_key</code></em></span></dt><dd><p>
- the wait queue key
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tty-open.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="tty.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tty-read.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tty.open</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tty.read</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tty.read</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="tty.stp.html" title="Chapter 11. TTY Tapset"><link rel="prev" href="API-tty-poll.html" title="probe::tty.poll"><link rel="next" href="API-tty-receive.html" title="probe::tty.receive"></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>probe::tty.read</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tty-poll.html">Prev</a> </td><th width="60%" align="center">Chapter 11. TTY Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tty-receive.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tty.read"><a name="API-tty-read"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tty.read —
- called when a tty line will be read
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tty.read </pre></div><div class="refsect1" title="Values"><a name="idp7349968"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>driver_name</code></em></span></dt><dd><p>
- the driver name
- </p></dd><dt><span class="term"><em class="parameter"><code>buffer</code></em></span></dt><dd><p>
- the buffer that will receive the characters
- </p></dd><dt><span class="term"><em class="parameter"><code>file_name</code></em></span></dt><dd><p>
- the file name lreated to the tty
- </p></dd><dt><span class="term"><em class="parameter"><code>nr</code></em></span></dt><dd><p>
- The amount of characters to be read
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tty-poll.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="tty.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tty-receive.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tty.poll</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tty.receive</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tty.receive</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="tty.stp.html" title="Chapter 11. TTY Tapset"><link rel="prev" href="API-tty-read.html" title="probe::tty.read"><link rel="next" href="API-tty-register.html" title="probe::tty.register"></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>probe::tty.receive</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tty-read.html">Prev</a> </td><th width="60%" align="center">Chapter 11. TTY Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tty-register.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tty.receive"><a name="API-tty-receive"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tty.receive —
- called when a tty receives a message
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tty.receive </pre></div><div class="refsect1" title="Values"><a name="idp7365856"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>driver_name</code></em></span></dt><dd><p>
- the driver name
- </p></dd><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
- The amount of characters received
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- the name of the module file
- </p></dd><dt><span class="term"><em class="parameter"><code>fp</code></em></span></dt><dd><p>
- The flag buffer
- </p></dd><dt><span class="term"><em class="parameter"><code>cp</code></em></span></dt><dd><p>
- the buffer that was received
- </p></dd><dt><span class="term"><em class="parameter"><code>index</code></em></span></dt><dd><p>
- The tty Index
- </p></dd><dt><span class="term"><em class="parameter"><code>id</code></em></span></dt><dd><p>
- the tty id
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tty-read.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="tty.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tty-register.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tty.read</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tty.register</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tty.register</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="tty.stp.html" title="Chapter 11. TTY Tapset"><link rel="prev" href="API-tty-receive.html" title="probe::tty.receive"><link rel="next" href="API-tty-release.html" title="probe::tty.release"></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>probe::tty.register</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tty-receive.html">Prev</a> </td><th width="60%" align="center">Chapter 11. TTY Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tty-release.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tty.register"><a name="API-tty-register"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tty.register —
- Called when a tty device is registred
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tty.register </pre></div><div class="refsect1" title="Values"><a name="idp7387728"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>driver_name</code></em></span></dt><dd><p>
- the driver name
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- the driver .dev_name name
- </p></dd><dt><span class="term"><em class="parameter"><code>index</code></em></span></dt><dd><p>
- the tty index requested
- </p></dd><dt><span class="term"><em class="parameter"><code>module</code></em></span></dt><dd><p>
- the module name
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tty-receive.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="tty.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tty-release.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tty.receive</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tty.release</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tty.release</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="tty.stp.html" title="Chapter 11. TTY Tapset"><link rel="prev" href="API-tty-register.html" title="probe::tty.register"><link rel="next" href="API-tty-resize.html" title="probe::tty.resize"></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>probe::tty.release</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tty-register.html">Prev</a> </td><th width="60%" align="center">Chapter 11. TTY Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tty-resize.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tty.release"><a name="API-tty-release"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tty.release —
- Called when the tty is closed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tty.release </pre></div><div class="refsect1" title="Values"><a name="idp7403632"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>inode_state</code></em></span></dt><dd><p>
- the inode state
- </p></dd><dt><span class="term"><em class="parameter"><code>file_name</code></em></span></dt><dd><p>
- the file name
- </p></dd><dt><span class="term"><em class="parameter"><code>file_mode</code></em></span></dt><dd><p>
- the file mode
- </p></dd><dt><span class="term"><em class="parameter"><code>file_flags</code></em></span></dt><dd><p>
- the file flags
- </p></dd><dt><span class="term"><em class="parameter"><code>inode_number</code></em></span></dt><dd><p>
- the inode number
- </p></dd><dt><span class="term"><em class="parameter"><code>inode_flags</code></em></span></dt><dd><p>
- the inode flags
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tty-register.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="tty.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tty-resize.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tty.register</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tty.resize</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tty.resize</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="tty.stp.html" title="Chapter 11. TTY Tapset"><link rel="prev" href="API-tty-release.html" title="probe::tty.release"><link rel="next" href="API-tty-unregister.html" title="probe::tty.unregister"></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>probe::tty.resize</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tty-release.html">Prev</a> </td><th width="60%" align="center">Chapter 11. TTY Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tty-unregister.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tty.resize"><a name="API-tty-resize"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tty.resize —
- Called when a terminal resize happens
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tty.resize </pre></div><div class="refsect1" title="Values"><a name="idp7423600"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>new_ypixel</code></em></span></dt><dd><p>
- the new ypixel value
- </p></dd><dt><span class="term"><em class="parameter"><code>old_col</code></em></span></dt><dd><p>
- the old col value
- </p></dd><dt><span class="term"><em class="parameter"><code>old_xpixel</code></em></span></dt><dd><p>
- the old xpixel
- </p></dd><dt><span class="term"><em class="parameter"><code>old_ypixel</code></em></span></dt><dd><p>
- the old ypixel
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- the tty name
- </p></dd><dt><span class="term"><em class="parameter"><code>old_row</code></em></span></dt><dd><p>
- the old row value
- </p></dd><dt><span class="term"><em class="parameter"><code>new_row</code></em></span></dt><dd><p>
- the new row value
- </p></dd><dt><span class="term"><em class="parameter"><code>new_xpixel</code></em></span></dt><dd><p>
- the new xpixel value
- </p></dd><dt><span class="term"><em class="parameter"><code>new_col</code></em></span></dt><dd><p>
- the new col value
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tty-release.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="tty.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tty-unregister.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tty.release</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tty.unregister</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tty.unregister</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="tty.stp.html" title="Chapter 11. TTY Tapset"><link rel="prev" href="API-tty-resize.html" title="probe::tty.resize"><link rel="next" href="API-tty-write.html" title="probe::tty.write"></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>probe::tty.unregister</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tty-resize.html">Prev</a> </td><th width="60%" align="center">Chapter 11. TTY Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-tty-write.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tty.unregister"><a name="API-tty-unregister"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tty.unregister —
- Called when a tty device is being unregistered
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tty.unregister </pre></div><div class="refsect1" title="Values"><a name="idp7449648"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>driver_name</code></em></span></dt><dd><p>
- the driver name
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- the driver .dev_name name
- </p></dd><dt><span class="term"><em class="parameter"><code>index</code></em></span></dt><dd><p>
- the tty index requested
- </p></dd><dt><span class="term"><em class="parameter"><code>module</code></em></span></dt><dd><p>
- the module name
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tty-resize.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="tty.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tty-write.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tty.resize</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tty.write</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::tty.write</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="tty.stp.html" title="Chapter 11. TTY Tapset"><link rel="prev" href="API-tty-unregister.html" title="probe::tty.unregister"><link rel="next" href="irq.stp.html" title="Chapter 12. Interrupt Request (IRQ) Tapset"></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>probe::tty.write</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tty-unregister.html">Prev</a> </td><th width="60%" align="center">Chapter 11. TTY Tapset</th><td width="20%" align="right"> <a accesskey="n" href="irq.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::tty.write"><a name="API-tty-write"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::tty.write —
- write to the tty line
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">tty.write </pre></div><div class="refsect1" title="Values"><a name="idp7465504"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>driver_name</code></em></span></dt><dd><p>
- the driver name
- </p></dd><dt><span class="term"><em class="parameter"><code>buffer</code></em></span></dt><dd><p>
- the buffer that will be written
- </p></dd><dt><span class="term"><em class="parameter"><code>file_name</code></em></span></dt><dd><p>
- the file name lreated to the tty
- </p></dd><dt><span class="term"><em class="parameter"><code>nr</code></em></span></dt><dd><p>
- The amount of characters
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tty-unregister.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="tty.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="irq.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tty.unregister</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 12. Interrupt Request (IRQ) Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::tz_ctime</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ctime.stp.html" title="Chapter 4. Time utility functions"><link rel="prev" href="API-ctime.html" title="function::ctime"><link rel="next" href="API-tz-gmtoff.html" title="function::tz_gmtoff"></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::tz_ctime</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ctime.html">Prev</a> </td><th width="60%" align="center">Chapter 4. Time utility functions</th><td width="20%" align="right"> <a accesskey="n" href="API-tz-gmtoff.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::tz_ctime"><a name="API-tz-ctime"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::tz_ctime —
- Convert seconds since epoch into human readable date/time string, with local time zone
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- tz_ctime(epochsecs:)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5980160"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>epochsecs</code></em></span></dt><dd><p>
- number of seconds since epoch (as returned by <code class="function">gettimeofday_s</code>)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5983840"></a><h2>Description</h2><p>
- Takes an argument of seconds since the epoch as returned by
- <code class="function">gettimeofday_s</code>. Returns a string of the same form as <code class="function">ctime</code>, but
- offsets the epoch time for the local time zone, and appends the name of the
- local time zone. The string length may vary. The time zone information is
- passed by staprun at script startup only.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ctime.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ctime.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tz-gmtoff.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ctime</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::tz_gmtoff</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::tz_gmtoff</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ctime.stp.html" title="Chapter 4. Time utility functions"><link rel="prev" href="API-tz-ctime.html" title="function::tz_ctime"><link rel="next" href="API-tz-name.html" title="function::tz_name"></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::tz_gmtoff</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tz-ctime.html">Prev</a> </td><th width="60%" align="center">Chapter 4. Time utility functions</th><td width="20%" align="right"> <a accesskey="n" href="API-tz-name.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::tz_gmtoff"><a name="API-tz-gmtoff"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::tz_gmtoff —
- Return local time zone offset
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- tz_gmtoff()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5992640"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5993792"></a><h2>Description</h2><p>
- Returns the local time zone offset (seconds west of UTC), as
- passed by staprun at script startup only.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tz-ctime.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ctime.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-tz-name.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::tz_ctime</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::tz_name</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::tz_name</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="ctime.stp.html" title="Chapter 4. Time utility functions"><link rel="prev" href="API-tz-gmtoff.html" title="function::tz_gmtoff"><link rel="next" href="system.stp.html" title="Chapter 5. Shell command functions"></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::tz_name</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tz-gmtoff.html">Prev</a> </td><th width="60%" align="center">Chapter 4. Time utility functions</th><td width="20%" align="right"> <a accesskey="n" href="system.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::tz_name"><a name="API-tz-name"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::tz_name —
- Return local time zone name
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- tz_name()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6001168"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp6002320"></a><h2>Description</h2><p>
- Returns the local time zone name, as passed by staprun at
- script startup only.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tz-gmtoff.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ctime.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="system.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::tz_gmtoff</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 5. Shell command functions</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::u_register</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-u64-arg.html" title="function::u64_arg"><link rel="next" href="API-uaddr.html" title="function::uaddr"></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::u_register</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-u64-arg.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-uaddr.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::u_register"><a name="API-u-register"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::u_register —
- Return the unsigned value of the named CPU register
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- u_register:long(name:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5607424"></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="idp5610480"></a><h2>Description</h2><p>
- Same as register(name), except that if the register
- is 32 bits wide, it is zero-extended to 64 bits.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-u64-arg.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-uaddr.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::u64_arg</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::uaddr</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::u32_arg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-tid.html" title="function::tid"><link rel="next" href="API-u64-arg.html" title="function::u64_arg"></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::u32_arg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tid.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-u64-arg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::u32_arg"><a name="API-u32-arg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::u32_arg —
- Return function argument as unsigned 32-bit value
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- u32_arg:long(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5586464"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- index of argument to return
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5589520"></a><h2>Description</h2><p>
- Return the unsigned 32-bit value of argument n,
- same as uint_arg.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tid.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-u64-arg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::tid</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::u64_arg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::u64_arg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-u32-arg.html" title="function::u32_arg"><link rel="next" href="API-u-register.html" title="function::u_register"></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::u64_arg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-u32-arg.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-u-register.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::u64_arg"><a name="API-u64-arg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::u64_arg —
- Return function argument as unsigned 64-bit value
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- u64_arg:long(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5596944"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- index of argument to return
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5600000"></a><h2>Description</h2><p>
- Return the unsigned 64-bit value of argument n,
- same as ulonglong_arg.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-u32-arg.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-u-register.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::u32_arg</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::u_register</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::uaddr</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-u-register.html" title="function::u_register"><link rel="next" href="API-ubacktrace.html" title="function::ubacktrace"></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::uaddr</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-u-register.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-ubacktrace.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::uaddr"><a name="API-uaddr"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::uaddr —
- User space address of current running task
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- uaddr:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5617856"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5619008"></a><h2>Description</h2><p>
- Returns the address in userspace that the current
- task was at when the probe occurred. When the current running task
- isn't a user space thread, or the address cannot be found, zero
- is returned. Can be used to see where the current task is combined
- with <code class="function">usymname</code> or <code class="function">usymdata</code>. Often the task will be in the VDSO
- where it entered the kernel.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-u-register.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-ubacktrace.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::u_register</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::ubacktrace</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ubacktrace</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-uaddr.html" title="function::uaddr"><link rel="next" href="API-ucallers.html" title="function::ucallers"></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::ubacktrace</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-uaddr.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-ucallers.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ubacktrace"><a name="API-ubacktrace"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ubacktrace —
- Hex backtrace of current user-space task stack.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ubacktrace:string()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5627872"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5629024"></a><h2>Description</h2><p>
- </p><p>
-
- Return a string of hex addresses that are a backtrace of the
- stack of the current task. Output may be truncated as per maximum
- string length. Returns empty string when current probe point cannot
- determine user backtrace. See <code class="function">backtrace</code> for kernel traceback.
-</p></div><div class="refsect1" title="Note"><a name="idp5631312"></a><h2>Note</h2><p>
- To get (full) backtraces for user space applications and shared
- shared libraries not mentioned in the current script run stap with
- -d /path/to/exe-or-so and/or add --ldd to load all needed unwind data.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-uaddr.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-ucallers.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::uaddr</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::ucallers</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ucallers</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-ubacktrace.html" title="function::ubacktrace"><link rel="next" href="API-uid.html" title="function::uid"></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::ucallers</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ubacktrace.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-uid.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ucallers"><a name="API-ucallers"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ucallers —
- Return first n elements of user stack backtrace
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ucallers:string(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5638784"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- number of levels to descend in the stack (not counting the top
- level). If n is -1, print the entire stack.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5641984"></a><h2>Description</h2><p>
- This function returns a string of the first n hex
- addresses from the backtrace of the user stack. Output may be
- truncated as per maximum string length (MAXSTRINGLEN).
-</p></div><div class="refsect1" title="Note"><a name="idp5643328"></a><h2>Note</h2><p>
- To get (full) backtraces for user space applications and shared
- shared libraries not mentioned in the current script run stap with
- -d /path/to/exe-or-so and/or add --ldd to load all needed unwind data.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ubacktrace.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-uid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ubacktrace</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::uid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::udelay</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="guru-delay.stp.html" title="Chapter 26. Guru tapsets"><link rel="prev" href="API-panic.html" title="function::panic"><link rel="next" href="string.stp.html" title="Chapter 27. A collection of standard string functions"></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::udelay</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-panic.html">Prev</a> </td><th width="60%" align="center">Chapter 26. Guru tapsets</th><td width="20%" align="right"> <a accesskey="n" href="string.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::udelay"><a name="API-udelay"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::udelay —
- microsecond delay
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- udelay(us:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11969088"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>us</code></em></span></dt><dd><p>
- Number of microseconds to delay.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11972320"></a><h2>Description</h2><p>
- This function inserts a multi-microsecond busy-delay into a probe handler.
- It requires guru mode.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-panic.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="guru-delay.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="string.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::panic</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 27. A collection of standard string functions</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::udp.disconnect.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-udp-disconnect.html" title="probe::udp.disconnect"><link rel="next" href="API-udp-recvmsg.html" title="probe::udp.recvmsg"></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>probe::udp.disconnect.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-udp-disconnect.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-udp-recvmsg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::udp.disconnect.return"><a name="API-udp-disconnect-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::udp.disconnect.return —
- UDP has been disconnected successfully
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">udp.disconnect.return </pre></div><div class="refsect1" title="Values"><a name="idp9166976"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ret</code></em></span></dt><dd><p>
- Error code (0: no error)
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- The name of this probe
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9172160"></a><h2>Context</h2><p>
- The process which requested a UDP disconnection
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-udp-disconnect.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-udp-recvmsg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::udp.disconnect</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::udp.recvmsg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::udp.disconnect</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-tcp-setsockopt-return.html" title="probe::tcp.setsockopt.return"><link rel="next" href="API-udp-disconnect-return.html" title="probe::udp.disconnect.return"></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>probe::udp.disconnect</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcp-setsockopt-return.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-udp-disconnect-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::udp.disconnect"><a name="API-udp-disconnect"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::udp.disconnect —
- Fires when a process requests for a UDP disconnection
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">udp.disconnect </pre></div><div class="refsect1" title="Values"><a name="idp9151744"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>flags</code></em></span></dt><dd><p>
- Flags (e.g. FIN, etc)
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- The name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>sock</code></em></span></dt><dd><p>
- Network socket used by the process
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9158992"></a><h2>Context</h2><p>
- The process which requests a UDP disconnection
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcp-setsockopt-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-udp-disconnect-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcp.setsockopt.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::udp.disconnect.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::udp.recvmsg.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-udp-recvmsg.html" title="probe::udp.recvmsg"><link rel="next" href="API-udp-sendmsg.html" title="probe::udp.sendmsg"></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>probe::udp.recvmsg.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-udp-recvmsg.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-udp-sendmsg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::udp.recvmsg.return"><a name="API-udp-recvmsg-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::udp.recvmsg.return —
- Fires whenever an attempt to receive a UDP message received is completed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">udp.recvmsg.return </pre></div><div class="refsect1" title="Values"><a name="idp9195344"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- The name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Number of bytes received by the process
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9200576"></a><h2>Context</h2><p>
- The process which received a UDP message
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-udp-recvmsg.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-udp-sendmsg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::udp.recvmsg</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::udp.sendmsg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::udp.recvmsg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-udp-disconnect-return.html" title="probe::udp.disconnect.return"><link rel="next" href="API-udp-recvmsg-return.html" title="probe::udp.recvmsg.return"></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>probe::udp.recvmsg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-udp-disconnect-return.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-udp-recvmsg-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::udp.recvmsg"><a name="API-udp-recvmsg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::udp.recvmsg —
- Fires whenever a UDP message is received
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">udp.recvmsg </pre></div><div class="refsect1" title="Values"><a name="idp9180032"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- The name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Number of bytes received by the process
- </p></dd><dt><span class="term"><em class="parameter"><code>sock</code></em></span></dt><dd><p>
- Network socket used by the process
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9187296"></a><h2>Context</h2><p>
- The process which received a UDP message
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-udp-disconnect-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-udp-recvmsg-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::udp.disconnect.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::udp.recvmsg.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::udp.sendmsg.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-udp-sendmsg.html" title="probe::udp.sendmsg"><link rel="next" href="socket.stp.html" title="Chapter 14. Socket Tapset"></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>probe::udp.sendmsg.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-udp-sendmsg.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="socket.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::udp.sendmsg.return"><a name="API-udp-sendmsg-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::udp.sendmsg.return —
- Fires whenever an attempt to send a UDP message is completed
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">udp.sendmsg.return </pre></div><div class="refsect1" title="Values"><a name="idp9223792"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- The name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Number of bytes sent by the process
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9229024"></a><h2>Context</h2><p>
- The process which sent a UDP message
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-udp-sendmsg.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="socket.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::udp.sendmsg</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 14. Socket Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::udp.sendmsg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="networking.stp.html" title="Chapter 13. Networking Tapset"><link rel="prev" href="API-udp-recvmsg-return.html" title="probe::udp.recvmsg.return"><link rel="next" href="API-udp-sendmsg-return.html" title="probe::udp.sendmsg.return"></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>probe::udp.sendmsg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-udp-recvmsg-return.html">Prev</a> </td><th width="60%" align="center">Chapter 13. Networking Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-udp-sendmsg-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::udp.sendmsg"><a name="API-udp-sendmsg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::udp.sendmsg —
- Fires whenever a process sends a UDP message
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">udp.sendmsg </pre></div><div class="refsect1" title="Values"><a name="idp9208560"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- The name of this probe
- </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
- Number of bytes sent by the process
- </p></dd><dt><span class="term"><em class="parameter"><code>sock</code></em></span></dt><dd><p>
- Network socket used by the process
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp9215824"></a><h2>Context</h2><p>
- The process which sent a UDP message
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-udp-recvmsg-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="networking.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-udp-sendmsg-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::udp.recvmsg.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::udp.sendmsg.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::uid</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-ucallers.html" title="function::ucallers"><link rel="next" href="API-uint-arg.html" title="function::uint_arg"></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::uid</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ucallers.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-uint-arg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::uid"><a name="API-uid"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::uid —
- Returns the user ID of a target process
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- uid:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5650800"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5651952"></a><h2>Description</h2><p>
- This function returns the user ID of the target process.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ucallers.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-uint-arg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ucallers</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::uint_arg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::uint_arg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-uid.html" title="function::uid"><link rel="next" href="API-ulong-arg.html" title="function::ulong_arg"></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::uint_arg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-uid.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-ulong-arg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::uint_arg"><a name="API-uint-arg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::uint_arg —
- Return function argument as unsigned int
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- uint_arg:long(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5659280"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- index of argument to return
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5662336"></a><h2>Description</h2><p>
- Return the value of argument n as an unsigned int
- (i.e., a 32-bit integer zero-extended to 64 bits).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-uid.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-ulong-arg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::uid</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::ulong_arg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ulong_arg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-uint-arg.html" title="function::uint_arg"><link rel="next" href="API-ulonglong-arg.html" title="function::ulonglong_arg"></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::ulong_arg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-uint-arg.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-ulonglong-arg.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ulong_arg"><a name="API-ulong-arg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ulong_arg —
- Return function argument as unsigned long
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ulong_arg:long(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5669712"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- index of argument to return
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5672768"></a><h2>Description</h2><p>
- Return the value of argument n as an unsigned long.
- On architectures where a long is 32 bits, the value is zero-extended
- to 64 bits.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-uint-arg.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-ulonglong-arg.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::uint_arg</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::ulonglong_arg</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ulonglong_arg</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-ulong-arg.html" title="function::ulong_arg"><link rel="next" href="API-umodname.html" title="function::umodname"></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::ulonglong_arg</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ulong-arg.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-umodname.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ulonglong_arg"><a name="API-ulonglong-arg"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ulonglong_arg —
- Return function argument as 64-bit value
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ulonglong_arg:long(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5680176"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- index of argument to return
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5683232"></a><h2>Description</h2><p>
- Return the value of argument n as a 64-bit value.
- (Same as longlong_arg.)
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ulong-arg.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-umodname.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ulong_arg</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::umodname</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::umodname</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-ulonglong-arg.html" title="function::ulonglong_arg"><link rel="next" href="API-user-mode.html" title="function::user_mode"></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::umodname</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ulonglong-arg.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-user-mode.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::umodname"><a name="API-umodname"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::umodname —
- Returns the (short) name of the user module.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- umodname:string(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5690576"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- User-space address
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5693632"></a><h2>Description</h2><p>
- Returns the short name of the user space module for the current task that
- that the given address is part of. Returns <span class="quote">“<span class="quote"><unknown></span>”</span> when the address
- isn't in a (mapped in) module, or the module cannot be found for some reason.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ulonglong-arg.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-user-mode.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ulonglong_arg</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::user_mode</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_char_warn</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-char.html" title="function::user_char"><link rel="next" href="API-user-int.html" title="function::user_int"></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::user_char_warn</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-char.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-int.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_char_warn"><a name="API-user-char-warn"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_char_warn —
- Retrieves a char value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_char_warn:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11496512"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the char from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11499744"></a><h2>Description</h2><p>
- Returns the char value from a given user space address.
- Returns zero when user space and warns (but does not abort) about the
- failure.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-char.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-int.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_char</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::user_int</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_char</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-kernel-string-utf32.html" title="function::kernel_string_utf32"><link rel="next" href="API-user-char-warn.html" title="function::user_char_warn"></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::user_char</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kernel-string-utf32.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-char-warn.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_char"><a name="API-user-char"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_char —
- Retrieves a char value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_char:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11485184"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the char from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11488416"></a><h2>Description</h2><p>
- Returns the char value from a given user space address.
- Returns zero when user space data is not accessible.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kernel-string-utf32.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-char-warn.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::kernel_string_utf32</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::user_char_warn</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_int_warn</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-int8.html" title="function::user_int8"><link rel="next" href="API-user-long.html" title="function::user_long"></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::user_int_warn</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-int8.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-long.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_int_warn"><a name="API-user-int-warn"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_int_warn —
- Retrieves an int value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_int_warn:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11564192"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the int from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11567424"></a><h2>Description</h2><p>
- Returns the int value from a given user space address.
- Returns zero when user space and warns (but does not abort) about the
- failure.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-int8.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-long.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_int8</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::user_long</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_int</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-char-warn.html" title="function::user_char_warn"><link rel="next" href="API-user-int16.html" title="function::user_int16"></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::user_int</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-char-warn.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-int16.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_int"><a name="API-user-int"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_int —
- Retrieves an int value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_int:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11507840"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the int from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11511072"></a><h2>Description</h2><p>
- Returns the int value from a given user space address.
- Returns zero when user space data is not accessible.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-char-warn.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-int16.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_char_warn</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::user_int16</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_int16</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-int.html" title="function::user_int"><link rel="next" href="API-user-int32.html" title="function::user_int32"></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::user_int16</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-int.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-int32.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_int16"><a name="API-user-int16"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_int16 —
- Retrieves a 16-bit integer value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_int16:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11519104"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the 16-bit integer from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11522336"></a><h2>Description</h2><p>
- Returns the 16-bit integer value from a given user space
- address. Returns zero when user space data is not accessible.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-int.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-int32.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_int</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::user_int32</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_int32</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-int16.html" title="function::user_int16"><link rel="next" href="API-user-int64.html" title="function::user_int64"></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::user_int32</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-int16.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-int64.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_int32"><a name="API-user-int32"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_int32 —
- Retrieves a 32-bit integer value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_int32:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11530320"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the 32-bit integer from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11533552"></a><h2>Description</h2><p>
- Returns the 32-bit integer value from a given user space
- address. Returns zero when user space data is not accessible.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-int16.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-int64.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_int16</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::user_int64</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_int64</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-int32.html" title="function::user_int32"><link rel="next" href="API-user-int8.html" title="function::user_int8"></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::user_int64</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-int32.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-int8.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_int64"><a name="API-user-int64"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_int64 —
- Retrieves a 64-bit integer value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_int64:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11541600"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the 64-bit integer from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11544832"></a><h2>Description</h2><p>
- Returns the 64-bit integer value from a given user space
- address. Returns zero when user space data is not accessible.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-int32.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-int8.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_int32</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::user_int8</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_int8</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-int64.html" title="function::user_int64"><link rel="next" href="API-user-int-warn.html" title="function::user_int_warn"></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::user_int8</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-int64.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-int-warn.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_int8"><a name="API-user-int8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_int8 —
- Retrieves a 8-bit integer value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_int8:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11552928"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the 8-bit integer from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11556160"></a><h2>Description</h2><p>
- Returns the 8-bit integer value from a given user space
- address. Returns zero when user space data is not accessible.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-int64.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-int-warn.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_int64</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::user_int_warn</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_long_warn</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-long.html" title="function::user_long"><link rel="next" href="API-user-short.html" title="function::user_short"></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::user_long_warn</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-long.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-short.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_long_warn"><a name="API-user-long-warn"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_long_warn —
- Retrieves a long value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_long_warn:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11586976"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the long from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11590208"></a><h2>Description</h2><p>
- Returns the long value from a given user space address.
- Returns zero when user space and warns (but does not abort) about the
- failure. Note that the size of the long depends on the architecture
- of the current user space task (for those architectures that support
- both 64/32 bit compat tasks).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-long.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-short.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_long</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::user_short</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_long</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-int-warn.html" title="function::user_int_warn"><link rel="next" href="API-user-long-warn.html" title="function::user_long_warn"></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::user_long</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-int-warn.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-long-warn.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_long"><a name="API-user-long"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_long —
- Retrieves a long value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_long:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11575520"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the long from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11578752"></a><h2>Description</h2><p>
- Returns the long value from a given user space address.
- Returns zero when user space data is not accessible. Note that the
- size of the long depends on the architecture of the current user space
- task (for those architectures that support both 64/32 bit compat tasks).
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-int-warn.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-long-warn.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_int_warn</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::user_long_warn</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_mode</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-umodname.html" title="function::umodname"><link rel="next" href="API-ustack.html" title="function::ustack"></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::user_mode</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-umodname.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-ustack.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_mode"><a name="API-user-mode"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_mode —
- Determines if probe point occurs in user-mode
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_mode:long()
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5701520"></a><h2>Arguments</h2><p>
- None
- </p></div><div class="refsect1" title="Description"><a name="idp5702672"></a><h2>Description</h2><p>
- </p><p>
-
- Return 1 if the probe point occurred in user-mode.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-umodname.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-ustack.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::umodname</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::ustack</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_short_warn</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-short.html" title="function::user_short"><link rel="next" href="API-user-string.html" title="function::user_string"></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::user_short_warn</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-short.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-string.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_short_warn"><a name="API-user-short-warn"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_short_warn —
- Retrieves a short value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_short_warn:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11609792"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the short from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11613024"></a><h2>Description</h2><p>
- Returns the short value from a given user space address.
- Returns zero when user space and warns (but does not abort) about the
- failure.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-short.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-string.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_short</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::user_string</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_short</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-long-warn.html" title="function::user_long_warn"><link rel="next" href="API-user-short-warn.html" title="function::user_short_warn"></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::user_short</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-long-warn.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-short-warn.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_short"><a name="API-user-short"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_short —
- Retrieves a short value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_short:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11598464"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the short from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11601696"></a><h2>Description</h2><p>
- Returns the short value from a given user space address.
- Returns zero when user space data is not accessible.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-long-warn.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-short-warn.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_long_warn</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::user_short_warn</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_string_n_quoted</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-string-n2.html" title="function::user_string_n2"><link rel="next" href="API-user-string-n-warn.html" title="function::user_string_n_warn"></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::user_string_n_quoted</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-string-n2.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-string-n-warn.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_string_n_quoted"><a name="API-user-string-n-quoted"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_string_n_quoted —
- Retrieves and quotes string from user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_string_n_quoted:string(addr:long,n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11702752"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the string from
- </p></dd><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- the maximum length of the string (if not null terminated)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11708000"></a><h2>Description</h2><p>
- Returns up to n characters of a C string from the given
- user space memory address where any ASCII characters that are not
- printable are replaced by the corresponding escape sequence in the
- returned string. Reports <span class="quote">“<span class="quote">NULL</span>”</span> for address zero. Returns <span class="quote">“<span class="quote"><unknown></span>”</span>
- on the rare cases when userspace data is not accessible at the given
- address.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-string-n2.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-string-n-warn.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_string_n2</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::user_string_n_warn</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_string_n_warn</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-string-n-quoted.html" title="function::user_string_n_quoted"><link rel="next" href="API-user-string-quoted.html" title="function::user_string_quoted"></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::user_string_n_warn</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-string-n-quoted.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-string-quoted.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_string_n_warn"><a name="API-user-string-n-warn"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_string_n_warn —
- Retrieves string from user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_string_n_warn:string(addr:long,n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11717152"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the string from
- </p></dd><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- the maximum length of the string (if not null terminated)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11722400"></a><h2>Description</h2><p>
- Returns up to n characters of a C string from a given
- user space memory address. Reports <span class="quote">“<span class="quote"><unknown></span>”</span> on the rare cases
- when userspace data is not accessible and warns (but does not abort)
- about the failure.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-string-n-quoted.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-string-quoted.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_string_n_quoted</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::user_string_quoted</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_string_n</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-string2-utf32.html" title="function::user_string2_utf32"><link rel="next" href="API-user-string-n2.html" title="function::user_string_n2"></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::user_string_n</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-string2-utf32.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-string-n2.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_string_n"><a name="API-user-string-n"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_string_n —
- Retrieves string of given length from user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_string_n:string(addr:long,n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11673392"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the string from
- </p></dd><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- the maximum length of the string (if not null terminated)
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11678640"></a><h2>Description</h2><p>
- Returns the C string of a maximum given length from a
- given user space address. Returns <span class="quote">“<span class="quote"><unknown></span>”</span> on the rare cases
- when userspace data is not accessible at the given address.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-string2-utf32.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-string-n2.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_string2_utf32</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::user_string_n2</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_string_n2</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-string-n.html" title="function::user_string_n"><link rel="next" href="API-user-string-n-quoted.html" title="function::user_string_n_quoted"></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::user_string_n2</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-string-n.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-string-n-quoted.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_string_n2"><a name="API-user-string-n2"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_string_n2 —
- Retrieves string of given length from user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_string_n2:string(addr:long,n:long,err_msg:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11687216"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the string from
- </p></dd><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- the maximum length of the string (if not null terminated)
- </p></dd><dt><span class="term"><em class="parameter"><code>err_msg</code></em></span></dt><dd><p>
- the error message to return when data isn't available
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11694512"></a><h2>Description</h2><p>
- Returns the C string of a maximum given length from a
- given user space address. Returns the given error message string on
- the rare cases when userspace data is not accessible at the given
- address.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-string-n.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-string-n-quoted.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_string_n</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::user_string_n_quoted</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_string_quoted</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-string-n-warn.html" title="function::user_string_n_warn"><link rel="next" href="API-user-string-utf16.html" title="function::user_string_utf16"></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::user_string_quoted</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-string-n-warn.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-string-utf16.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_string_quoted"><a name="API-user-string-quoted"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_string_quoted —
- Retrieves and quotes string from user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_string_quoted:string(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11731040"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the string from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11734272"></a><h2>Description</h2><p>
- Returns the null terminated C string from a given user space
- memory address where any ASCII characters that are not printable are
- replaced by the corresponding escape sequence in the returned string.
- Reports <span class="quote">“<span class="quote">NULL</span>”</span> for address zero. Returns <span class="quote">“<span class="quote"><unknown></span>”</span> on the rare
- cases when userspace data is not accessible at the given address.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-string-n-warn.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-string-utf16.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_string_n_warn</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::user_string_utf16</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_string_utf16</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-string-quoted.html" title="function::user_string_quoted"><link rel="next" href="API-user-string-utf32.html" title="function::user_string_utf32"></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::user_string_utf16</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-string-quoted.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-string-utf32.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_string_utf16"><a name="API-user-string-utf16"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_string_utf16 —
- Retrieves UTF-16 string from user memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_string_utf16:string(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11743424"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The user address to retrieve the string from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11746640"></a><h2>Description</h2><p>
- This function returns a null terminated UTF-8 string converted
- from the UTF-16 string at a given user memory address. Reports an error on
- string copy fault or conversion error.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-string-quoted.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-string-utf32.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_string_quoted</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::user_string_utf32</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_string_utf32</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-string-utf16.html" title="function::user_string_utf16"><link rel="next" href="API-user-string-warn.html" title="function::user_string_warn"></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::user_string_utf32</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-string-utf16.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-string-warn.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_string_utf32"><a name="API-user-string-utf32"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_string_utf32 —
- Retrieves UTF-32 string from user memory
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_string_utf32:string(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11754832"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The user address to retrieve the string from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11758048"></a><h2>Description</h2><p>
- This function returns a null terminated UTF-8 string converted
- from the UTF-32 string at a given user memory address. Reports an error on
- string copy fault or conversion error.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-string-utf16.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-string-warn.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_string_utf16</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::user_string_warn</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_string_warn</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-string-utf32.html" title="function::user_string_utf32"><link rel="next" href="API-user-uint16.html" title="function::user_uint16"></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::user_string_warn</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-string-utf32.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-uint16.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_string_warn"><a name="API-user-string-warn"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_string_warn —
- Retrieves string from user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_string_warn:string(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11766192"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the string from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11769424"></a><h2>Description</h2><p>
- Returns the null terminated C string from a given user space
- memory address. Reports <span class="quote">“<span class="quote"><unknown></span>”</span> on the rare cases when userspace
- data is not accessible and warns (but does not abort) about the failure.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-string-utf32.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-uint16.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_string_utf32</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::user_uint16</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_string</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-short-warn.html" title="function::user_short_warn"><link rel="next" href="API-user-string2.html" title="function::user_string2"></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::user_string</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-short-warn.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-string2.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_string"><a name="API-user-string"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_string —
- Retrieves string from user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_string:string(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11621104"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the string from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11624336"></a><h2>Description</h2><p>
- Returns the null terminated C string from a given user space
- memory address. Reports <span class="quote">“<span class="quote"><unknown></span>”</span> on the rare cases when userspace
- data is not accessible.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-short-warn.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-string2.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_short_warn</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::user_string2</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_string2_utf16</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-string2.html" title="function::user_string2"><link rel="next" href="API-user-string2-utf32.html" title="function::user_string2_utf32"></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::user_string2_utf16</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-string2.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-string2-utf32.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_string2_utf16"><a name="API-user-string2-utf16"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_string2_utf16 —
- Retrieves UTF-16 string from user memory with alternative error string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_string2_utf16:string(addr:long,err_msg:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11646416"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The user address to retrieve the string from
- </p></dd><dt><span class="term"><em class="parameter"><code>err_msg</code></em></span></dt><dd><p>
- The error message to return when data isn't available
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11651680"></a><h2>Description</h2><p>
- This function returns a null terminated UTF-8 string converted
- from the UTF-16 string at a given user memory address. Reports the given
- error message on string copy fault or conversion error.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-string2.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-string2-utf32.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_string2</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::user_string2_utf32</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_string2_utf32</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-string2-utf16.html" title="function::user_string2_utf16"><link rel="next" href="API-user-string-n.html" title="function::user_string_n"></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::user_string2_utf32</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-string2-utf16.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-string-n.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_string2_utf32"><a name="API-user-string2-utf32"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_string2_utf32 —
- Retrieves UTF-32 string from user memory with alternative error string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_string2_utf32:string(addr:long,err_msg:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11659936"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The user address to retrieve the string from
- </p></dd><dt><span class="term"><em class="parameter"><code>err_msg</code></em></span></dt><dd><p>
- The error message to return when data isn't available
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11665200"></a><h2>Description</h2><p>
- This function returns a null terminated UTF-8 string converted
- from the UTF-32 string at a given user memory address. Reports the given
- error message on string copy fault or conversion error.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-string2-utf16.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-string-n.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_string2_utf16</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::user_string_n</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_string2</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-string.html" title="function::user_string"><link rel="next" href="API-user-string2-utf16.html" title="function::user_string2_utf16"></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::user_string2</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-string.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-string2-utf16.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_string2"><a name="API-user-string2"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_string2 —
- Retrieves string from user space with alternative error string
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_string2:string(addr:long,err_msg:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11632912"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the string from
- </p></dd><dt><span class="term"><em class="parameter"><code>err_msg</code></em></span></dt><dd><p>
- the error message to return when data isn't available
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11638192"></a><h2>Description</h2><p>
- Returns the null terminated C string from a given user space
- memory address. Reports the given error message on the rare cases when
- userspace data is not accessible.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-string.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-string2-utf16.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_string</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::user_string2_utf16</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_uint16</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-string-warn.html" title="function::user_string_warn"><link rel="next" href="API-user-uint32.html" title="function::user_uint32"></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::user_uint16</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-string-warn.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-uint32.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_uint16"><a name="API-user-uint16"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_uint16 —
- Retrieves an unsigned 16-bit integer value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_uint16:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11777920"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the unsigned 16-bit integer from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11781168"></a><h2>Description</h2><p>
- Returns the unsigned 16-bit integer value from a given user
- space address. Returns zero when user space data is not accessible.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-string-warn.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-uint32.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_string_warn</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::user_uint32</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_uint32</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-uint16.html" title="function::user_uint16"><link rel="next" href="API-user-uint64.html" title="function::user_uint64"></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::user_uint32</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-uint16.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-uint64.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_uint32"><a name="API-user-uint32"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_uint32 —
- Retrieves an unsigned 32-bit integer value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_uint32:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11789232"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the unsigned 32-bit integer from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11792480"></a><h2>Description</h2><p>
- Returns the unsigned 32-bit integer value from a given user
- space address. Returns zero when user space data is not accessible.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-uint16.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-uint64.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_uint16</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::user_uint64</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_uint64</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-uint32.html" title="function::user_uint32"><link rel="next" href="API-user-uint8.html" title="function::user_uint8"></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::user_uint64</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-uint32.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-uint8.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_uint64"><a name="API-user-uint64"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_uint64 —
- Retrieves an unsigned 64-bit integer value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_uint64:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11800592"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the unsigned 64-bit integer from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11803840"></a><h2>Description</h2><p>
- Returns the unsigned 64-bit integer value from a given user
- space address. Returns zero when user space data is not accessible.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-uint32.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-uint8.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_uint32</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::user_uint8</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_uint8</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-uint64.html" title="function::user_uint64"><link rel="next" href="API-user-ushort.html" title="function::user_ushort"></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::user_uint8</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-uint64.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-ushort.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_uint8"><a name="API-user-uint8"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_uint8 —
- Retrieves an unsigned 8-bit integer value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_uint8:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11811952"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the unsigned 8-bit integer from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11815200"></a><h2>Description</h2><p>
- Returns the unsigned 8-bit integer value from a given user
- space address. Returns zero when user space data is not accessible.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-uint64.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-ushort.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_uint64</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::user_ushort</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_ushort_warn</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-ushort.html" title="function::user_ushort"><link rel="next" href="conversions-guru.stp.html" title="Chapter 25. String and data writing functions Tapset"></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::user_ushort_warn</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-ushort.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="conversions-guru.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_ushort_warn"><a name="API-user-ushort-warn"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_ushort_warn —
- Retrieves an unsigned short value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_ushort_warn:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11834608"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the unsigned short from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11837840"></a><h2>Description</h2><p>
- Returns the unsigned short value from a given user
- space address. Returns zero when user space and warns (but does
- not abort) about the failure.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-ushort.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="conversions-guru.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_ushort</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 25. String and data writing functions Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::user_ushort</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="conversions.stp.html" title="Chapter 24. String and data retrieving functions Tapset"><link rel="prev" href="API-user-uint8.html" title="function::user_uint8"><link rel="next" href="API-user-ushort-warn.html" title="function::user_ushort_warn"></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::user_ushort</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-uint8.html">Prev</a> </td><th width="60%" align="center">Chapter 24. String and data retrieving functions Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-user-ushort-warn.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::user_ushort"><a name="API-user-ushort"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::user_ushort —
- Retrieves an unsigned short value stored in user space
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- user_ushort:long(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11823248"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- the user space address to retrieve the unsigned short from
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11826480"></a><h2>Description</h2><p>
- Returns the unsigned short value from a given user
- space address. Returns zero when user space data is not accessible.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-uint8.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="conversions.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-user-ushort-warn.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_uint8</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::user_ushort_warn</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::usrdev2kerndev</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="dev.stp.html" title="Chapter 19. Device Tapset"><link rel="prev" href="API-MKDEV.html" title="function::MKDEV"><link rel="next" href="dentry.stp.html" title="Chapter 20. Directory-entry (dentry) Tapset"></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::usrdev2kerndev</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-MKDEV.html">Prev</a> </td><th width="60%" align="center">Chapter 19. Device Tapset</th><td width="20%" align="right"> <a accesskey="n" href="dentry.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::usrdev2kerndev"><a name="API-usrdev2kerndev"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::usrdev2kerndev —
- Converts a user-space device number into the format used in the kernel
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- usrdev2kerndev:long(dev:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11010032"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
- Device number in user-space format.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-MKDEV.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="dev.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="dentry.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::MKDEV</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 20. Directory-entry (dentry) Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::ustack</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-user-mode.html" title="function::user_mode"><link rel="next" href="API-usymdata.html" title="function::usymdata"></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::ustack</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-mode.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-usymdata.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::ustack"><a name="API-ustack"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::ustack —
- Return address at given depth of user stack backtrace
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- ustack:long(n:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5710336"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>n</code></em></span></dt><dd><p>
- number of levels to descend in the stack.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5713392"></a><h2>Description</h2><p>
- Performs a simple (user space) backtrace, and returns the
- element at the specified position. The results of the backtrace itself
- are cached, so that the backtrace computation is performed at most once
- no matter how many times <code class="function">ustack</code> is called, or in what order.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-mode.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-usymdata.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_mode</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::usymdata</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::usymdata</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-ustack.html" title="function::ustack"><link rel="next" href="API-usymname.html" title="function::usymname"></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::usymdata</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ustack.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="API-usymname.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::usymdata"><a name="API-usymdata"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::usymdata —
- Return the symbol and module offset of an address.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- usymdata:string(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5721600"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The address to translate.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5724656"></a><h2>Description</h2><p>
- Returns the (function) symbol name associated with the
- given address in the current task if known, the offset from the
- start and the size of the symbol, plus the module name (between
- brackets). If symbol is unknown, but module is known, the offset
- inside the module, plus the size of the module is added. If any
- element is not known it will be omitted and if the symbol name is
- unknown it will return the hex string for the given address.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ustack.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-usymname.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::ustack</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::usymname</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::usymname</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><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-usymdata.html" title="function::usymdata"><link rel="next" href="timestamp_stp.html" title="Chapter 3. Timestamp Functions"></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::usymname</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-usymdata.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Context Functions</th><td width="20%" align="right"> <a accesskey="n" href="timestamp_stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::usymname"><a name="API-usymname"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::usymname —
- Return the symbol of an address in the current task.
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- usymname:string(addr:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp5732464"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>addr</code></em></span></dt><dd><p>
- The address to translate.
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp5735520"></a><h2>Description</h2><p>
- Returns the (function) symbol name associated with the
- given address if known. If not known it will return the hex string
- representation of addr.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-usymdata.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="timestamp_stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::usymdata</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 3. Timestamp Functions</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::vm.brk</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-vm-fault-contains.html" title="function::vm_fault_contains"><link rel="next" href="API-vm-kfree.html" title="probe::vm.kfree"></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>probe::vm.brk</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-vm-fault-contains.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-vm-kfree.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::vm.brk"><a name="API-vm-brk"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::vm.brk —
- Fires when a brk is requested (i.e. the heap will be resized)
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">vm.brk </pre></div><div class="refsect1" title="Values"><a name="idp6189728"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- the length of the memory segment
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>address</code></em></span></dt><dd><p>
- the requested address
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp6196592"></a><h2>Context</h2><p>
- The process calling brk.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-vm-fault-contains.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-vm-kfree.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::vm_fault_contains</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::vm.kfree</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::vm_fault_contains</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-proc-mem-txt-pid.html" title="function::proc_mem_txt_pid"><link rel="next" href="API-vm-brk.html" title="probe::vm.brk"></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::vm_fault_contains</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-proc-mem-txt-pid.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-vm-brk.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::vm_fault_contains"><a name="API-vm-fault-contains"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::vm_fault_contains —
- Test return value for page fault reason
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- vm_fault_contains:long(value:long,test:long)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp6178432"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>value</code></em></span></dt><dd><p>
- the fault_type returned by vm.page_fault.return
- </p></dd><dt><span class="term"><em class="parameter"><code>test</code></em></span></dt><dd><p>
- the type of fault to test for (VM_FAULT_OOM or similar)
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-proc-mem-txt-pid.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-vm-brk.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::proc_mem_txt_pid</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::vm.brk</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::vm.kfree</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-vm-brk.html" title="probe::vm.brk"><link rel="next" href="API-vm-kmalloc.html" title="probe::vm.kmalloc"></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>probe::vm.kfree</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-vm-brk.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-vm-kmalloc.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::vm.kfree"><a name="API-vm-kfree"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::vm.kfree —
- Fires when kfree is requested
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">vm.kfree </pre></div><div class="refsect1" title="Values"><a name="idp6203840"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ptr</code></em></span></dt><dd><p>
- pointer to the kmemory allocated which is returned by kmalloc
- </p></dd><dt><span class="term"><em class="parameter"><code>caller_function</code></em></span></dt><dd><p>
- name of the caller function.
- </p></dd><dt><span class="term"><em class="parameter"><code>call_site</code></em></span></dt><dd><p>
- address of the function calling this kmemory function
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-vm-brk.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-vm-kmalloc.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::vm.brk</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::vm.kmalloc</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::vm.kmalloc_node</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-vm-kmalloc.html" title="probe::vm.kmalloc"><link rel="next" href="API-vm-kmem-cache-alloc.html" title="probe::vm.kmem_cache_alloc"></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>probe::vm.kmalloc_node</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-vm-kmalloc.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-vm-kmem-cache-alloc.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::vm.kmalloc_node"><a name="API-vm-kmalloc-node"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::vm.kmalloc_node —
- Fires when kmalloc_node is requested
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">vm.kmalloc_node </pre></div><div class="refsect1" title="Values"><a name="idp6241440"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ptr</code></em></span></dt><dd><p>
- pointer to the kmemory allocated
- </p></dd><dt><span class="term"><em class="parameter"><code>caller_function</code></em></span></dt><dd><p>
- name of the caller function
- </p></dd><dt><span class="term"><em class="parameter"><code>call_site</code></em></span></dt><dd><p>
- address of the function caling this kmemory function
- </p></dd><dt><span class="term"><em class="parameter"><code>gfp_flag_name</code></em></span></dt><dd><p>
- type of kmemory to allocate(in string format)
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>bytes_req</code></em></span></dt><dd><p>
- requested Bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>bytes_alloc</code></em></span></dt><dd><p>
- allocated Bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>gfp_flags</code></em></span></dt><dd><p>
- type of kmemory to allocate
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-vm-kmalloc.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-vm-kmem-cache-alloc.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::vm.kmalloc</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::vm.kmem_cache_alloc</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::vm.kmalloc</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-vm-kfree.html" title="probe::vm.kfree"><link rel="next" href="API-vm-kmalloc-node.html" title="probe::vm.kmalloc_node"></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>probe::vm.kmalloc</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-vm-kfree.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-vm-kmalloc-node.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::vm.kmalloc"><a name="API-vm-kmalloc"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::vm.kmalloc —
- Fires when kmalloc is requested
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">vm.kmalloc </pre></div><div class="refsect1" title="Values"><a name="idp6218880"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ptr</code></em></span></dt><dd><p>
- pointer to the kmemory allocated
- </p></dd><dt><span class="term"><em class="parameter"><code>caller_function</code></em></span></dt><dd><p>
- name of the caller function
- </p></dd><dt><span class="term"><em class="parameter"><code>call_site</code></em></span></dt><dd><p>
- address of the kmemory function
- </p></dd><dt><span class="term"><em class="parameter"><code>gfp_flag_name</code></em></span></dt><dd><p>
- type of kmemory to allocate (in String format)
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>bytes_req</code></em></span></dt><dd><p>
- requested Bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>bytes_alloc</code></em></span></dt><dd><p>
- allocated Bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>gfp_flags</code></em></span></dt><dd><p>
- type of kmemory to allocate
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-vm-kfree.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-vm-kmalloc-node.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::vm.kfree</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::vm.kmalloc_node</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::vm.kmem_cache_alloc_node</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-vm-kmem-cache-alloc.html" title="probe::vm.kmem_cache_alloc"><link rel="next" href="API-vm-kmem-cache-free.html" title="probe::vm.kmem_cache_free"></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>probe::vm.kmem_cache_alloc_node</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-vm-kmem-cache-alloc.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-vm-kmem-cache-free.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::vm.kmem_cache_alloc_node"><a name="API-vm-kmem-cache-alloc-node"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::vm.kmem_cache_alloc_node —
- Fires when kmem_cache_alloc_node is requested
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">vm.kmem_cache_alloc_node </pre></div><div class="refsect1" title="Values"><a name="idp6286720"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ptr</code></em></span></dt><dd><p>
- pointer to the kmemory allocated
- </p></dd><dt><span class="term"><em class="parameter"><code>caller_function</code></em></span></dt><dd><p>
- name of the caller function
- </p></dd><dt><span class="term"><em class="parameter"><code>call_site</code></em></span></dt><dd><p>
- address of the function calling this kmemory function
- </p></dd><dt><span class="term"><em class="parameter"><code>gfp_flag_name</code></em></span></dt><dd><p>
- type of kmemory to allocate(in string format)
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>bytes_req</code></em></span></dt><dd><p>
- requested Bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>bytes_alloc</code></em></span></dt><dd><p>
- allocated Bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>gfp_flags</code></em></span></dt><dd><p>
- type of kmemory to allocate
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-vm-kmem-cache-alloc.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-vm-kmem-cache-free.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::vm.kmem_cache_alloc</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::vm.kmem_cache_free</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::vm.kmem_cache_alloc</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-vm-kmalloc-node.html" title="probe::vm.kmalloc_node"><link rel="next" href="API-vm-kmem-cache-alloc-node.html" title="probe::vm.kmem_cache_alloc_node"></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>probe::vm.kmem_cache_alloc</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-vm-kmalloc-node.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-vm-kmem-cache-alloc-node.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::vm.kmem_cache_alloc"><a name="API-vm-kmem-cache-alloc"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::vm.kmem_cache_alloc —
- Fires when kmem_cache_alloc is requested
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">vm.kmem_cache_alloc </pre></div><div class="refsect1" title="Values"><a name="idp6264080"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ptr</code></em></span></dt><dd><p>
- pointer to the kmemory allocated
- </p></dd><dt><span class="term"><em class="parameter"><code>caller_function</code></em></span></dt><dd><p>
- name of the caller function.
- </p></dd><dt><span class="term"><em class="parameter"><code>call_site</code></em></span></dt><dd><p>
- address of the function calling this kmemory function.
- </p></dd><dt><span class="term"><em class="parameter"><code>gfp_flag_name</code></em></span></dt><dd><p>
- type of kmemory to allocate(in string format)
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>bytes_req</code></em></span></dt><dd><p>
- requested Bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>bytes_alloc</code></em></span></dt><dd><p>
- allocated Bytes
- </p></dd><dt><span class="term"><em class="parameter"><code>gfp_flags</code></em></span></dt><dd><p>
- type of kmemory to allocate
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-vm-kmalloc-node.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-vm-kmem-cache-alloc-node.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::vm.kmalloc_node</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::vm.kmem_cache_alloc_node</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::vm.kmem_cache_free</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-vm-kmem-cache-alloc-node.html" title="probe::vm.kmem_cache_alloc_node"><link rel="next" href="API-vm-mmap.html" title="probe::vm.mmap"></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>probe::vm.kmem_cache_free</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-vm-kmem-cache-alloc-node.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-vm-mmap.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::vm.kmem_cache_free"><a name="API-vm-kmem-cache-free"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::vm.kmem_cache_free —
- Fires when kmem_cache_free is requested
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">vm.kmem_cache_free </pre></div><div class="refsect1" title="Values"><a name="idp6309360"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>ptr</code></em></span></dt><dd><p>
- Pointer to the kmemory allocated which is returned by kmem_cache
- </p></dd><dt><span class="term"><em class="parameter"><code>caller_function</code></em></span></dt><dd><p>
- Name of the caller function.
- </p></dd><dt><span class="term"><em class="parameter"><code>call_site</code></em></span></dt><dd><p>
- Address of the function calling this kmemory function
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-vm-kmem-cache-alloc-node.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-vm-mmap.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::vm.kmem_cache_alloc_node</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::vm.mmap</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::vm.mmap</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-vm-kmem-cache-free.html" title="probe::vm.kmem_cache_free"><link rel="next" href="API-vm-munmap.html" title="probe::vm.munmap"></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>probe::vm.mmap</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-vm-kmem-cache-free.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-vm-munmap.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::vm.mmap"><a name="API-vm-mmap"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::vm.mmap —
- Fires when an mmap is requested
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">vm.mmap </pre></div><div class="refsect1" title="Values"><a name="idp6324400"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- the length of the memory segment
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>address</code></em></span></dt><dd><p>
- the requested address
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp6331264"></a><h2>Context</h2><p>
- The process calling mmap.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-vm-kmem-cache-free.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-vm-munmap.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::vm.kmem_cache_free</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::vm.munmap</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::vm.munmap</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-vm-mmap.html" title="probe::vm.mmap"><link rel="next" href="API-vm-oom-kill.html" title="probe::vm.oom_kill"></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>probe::vm.munmap</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-vm-mmap.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-vm-oom-kill.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::vm.munmap"><a name="API-vm-munmap"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::vm.munmap —
- Fires when an munmap is requested
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">vm.munmap </pre></div><div class="refsect1" title="Values"><a name="idp6338512"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>length</code></em></span></dt><dd><p>
- the length of the memory segment
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>address</code></em></span></dt><dd><p>
- the requested address
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp6345600"></a><h2>Context</h2><p>
- The process calling munmap.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-vm-mmap.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-vm-oom-kill.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::vm.mmap</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::vm.oom_kill</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::vm.oom_kill</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-vm-munmap.html" title="probe::vm.munmap"><link rel="next" href="API-vm-pagefault.html" title="probe::vm.pagefault"></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>probe::vm.oom_kill</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-vm-munmap.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-vm-pagefault.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::vm.oom_kill"><a name="API-vm-oom-kill"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::vm.oom_kill —
- Fires when a thread is selected for termination by the OOM killer
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">vm.oom_kill </pre></div><div class="refsect1" title="Values"><a name="idp6353536"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>task</code></em></span></dt><dd><p>
- the task being killed
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp6358752"></a><h2>Context</h2><p>
- The process that tried to consume excessive memory, and thus
- triggered the OOM.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-vm-munmap.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-vm-pagefault.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::vm.munmap</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::vm.pagefault</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::vm.pagefault.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-vm-pagefault.html" title="probe::vm.pagefault"><link rel="next" href="API-vm-write-shared.html" title="probe::vm.write_shared"></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>probe::vm.pagefault.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-vm-pagefault.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-vm-write-shared.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::vm.pagefault.return"><a name="API-vm-pagefault-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::vm.pagefault.return —
- Indicates what type of fault occurred
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">vm.pagefault.return </pre></div><div class="refsect1" title="Values"><a name="idp6382032"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>fault_type</code></em></span></dt><dd><p>
- returns either
- 0 (VM_FAULT_OOM) for out of memory faults,
- 2 (VM_FAULT_MINOR) for minor faults, 3 (VM_FAULT_MAJOR) for
- major faults, or 1 (VM_FAULT_SIGBUS) if the fault was neither OOM, minor fault,
- nor major fault.
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-vm-pagefault.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-vm-write-shared.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::vm.pagefault</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::vm.write_shared</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::vm.pagefault</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-vm-oom-kill.html" title="probe::vm.oom_kill"><link rel="next" href="API-vm-pagefault-return.html" title="probe::vm.pagefault.return"></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>probe::vm.pagefault</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-vm-oom-kill.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-vm-pagefault-return.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::vm.pagefault"><a name="API-vm-pagefault"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::vm.pagefault —
- Records that a page fault occurred
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">vm.pagefault </pre></div><div class="refsect1" title="Values"><a name="idp6366704"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>write_access</code></em></span></dt><dd><p>
- indicates whether this was a write or read access; 1 indicates a write,
- while 0 indicates a read
- </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>address</code></em></span></dt><dd><p>
- the address of the faulting memory access; i.e. the address that caused the page fault
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp6374080"></a><h2>Context</h2><p>
- The process which triggered the fault
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-vm-oom-kill.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-vm-pagefault-return.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::vm.oom_kill</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::vm.pagefault.return</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::vm.write_shared_copy</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-vm-write-shared.html" title="probe::vm.write_shared"><link rel="next" href="task_time_stp.html" title="Chapter 7. Task Time Tapset"></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>probe::vm.write_shared_copy</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-vm-write-shared.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="task_time_stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::vm.write_shared_copy"><a name="API-vm-write-shared-copy"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::vm.write_shared_copy —
- Page copy for shared page write
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">vm.write_shared_copy </pre></div><div class="refsect1" title="Values"><a name="idp6408656"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- Name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>zero</code></em></span></dt><dd><p>
- boolean indicating whether it is a zero page
- (can do a clear instead of a copy)
- </p></dd><dt><span class="term"><em class="parameter"><code>address</code></em></span></dt><dd><p>
- The address of the shared write
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp6415968"></a><h2>Context</h2><p>
- The process attempting the write.
-</p></div><div class="refsect1" title="Description"><a name="idp6417200"></a><h2>Description</h2><p>
- Fires when a write to a shared page requires a page copy. This is
- always preceded by a vm.shared_write.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-vm-write-shared.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="task_time_stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::vm.write_shared</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 7. Task Time Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::vm.write_shared</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="memory_stp.html" title="Chapter 6. Memory Tapset"><link rel="prev" href="API-vm-pagefault-return.html" title="probe::vm.pagefault.return"><link rel="next" href="API-vm-write-shared-copy.html" title="probe::vm.write_shared_copy"></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>probe::vm.write_shared</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-vm-pagefault-return.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Memory Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-vm-write-shared-copy.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::vm.write_shared"><a name="API-vm-write-shared"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::vm.write_shared —
- Attempts at writing to a shared page
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">vm.write_shared </pre></div><div class="refsect1" title="Values"><a name="idp6394160"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
- name of the probe point
- </p></dd><dt><span class="term"><em class="parameter"><code>address</code></em></span></dt><dd><p>
- the address of the shared write
- </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="idp6399392"></a><h2>Context</h2><p>
- The context is the process attempting the write.
-</p></div><div class="refsect1" title="Description"><a name="idp6400640"></a><h2>Description</h2><p>
- Fires when a process attempts to write to a shared page.
- If a copy is necessary, this will be followed by a
- vm.write_shared_copy.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-vm-pagefault-return.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="memory_stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-vm-write-shared-copy.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::vm.pagefault.return</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::vm.write_shared_copy</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>function::warn</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="logging.stp.html" title="Chapter 21. Logging Tapset"><link rel="prev" href="API-printk.html" title="function::printk"><link rel="next" href="queue_stats.stp.html" title="Chapter 22. Queue Statistics Tapset"></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::warn</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-printk.html">Prev</a> </td><th width="60%" align="center">Chapter 21. Logging Tapset</th><td width="20%" align="right"> <a accesskey="n" href="queue_stats.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="function::warn"><a name="API-warn"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>function::warn —
- Send a line to the warning stream
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting">
- warn(msg:string)
-</pre></div><div class="refsect1" title="Arguments"><a name="idp11153840"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>msg</code></em></span></dt><dd><p>
- The formatted message string
- </p></dd></dl></div></div><div class="refsect1" title="Description"><a name="idp11157008"></a><h2>Description</h2><p>
- This function sends a warning message immediately to
- staprun. It is also sent over the bulk transport (relayfs) if it is
- being used. If the last characater is not a newline, the one is added.
-</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-printk.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="logging.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="queue_stats.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::printk</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 22. Queue Statistics Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::workqueue.create</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="irq.stp.html" title="Chapter 12. Interrupt Request (IRQ) Tapset"><link rel="prev" href="API-softirq-exit.html" title="probe::softirq.exit"><link rel="next" href="API-workqueue-destroy.html" title="probe::workqueue.destroy"></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>probe::workqueue.create</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-softirq-exit.html">Prev</a> </td><th width="60%" align="center">Chapter 12. Interrupt Request (IRQ) Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-workqueue-destroy.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::workqueue.create"><a name="API-workqueue-create"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::workqueue.create —
- Creating a new workqueue
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">workqueue.create </pre></div><div class="refsect1" title="Values"><a name="idp7581152"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>wq_thread</code></em></span></dt><dd><p>
- task_struct of the workqueue thread
- </p></dd><dt><span class="term"><em class="parameter"><code>cpu</code></em></span></dt><dd><p>
- cpu for which the worker thread is created
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-softirq-exit.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="irq.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-workqueue-destroy.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::softirq.exit</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::workqueue.destroy</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::workqueue.destroy</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="irq.stp.html" title="Chapter 12. Interrupt Request (IRQ) Tapset"><link rel="prev" href="API-workqueue-create.html" title="probe::workqueue.create"><link rel="next" href="API-workqueue-execute.html" title="probe::workqueue.execute"></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>probe::workqueue.destroy</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-workqueue-create.html">Prev</a> </td><th width="60%" align="center">Chapter 12. Interrupt Request (IRQ) Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-workqueue-execute.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::workqueue.destroy"><a name="API-workqueue-destroy"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::workqueue.destroy —
- Destroying workqueue
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">workqueue.destroy </pre></div><div class="refsect1" title="Values"><a name="idp7593120"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>wq_thread</code></em></span></dt><dd><p>
- task_struct of the workqueue thread
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-workqueue-create.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="irq.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-workqueue-execute.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::workqueue.create</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::workqueue.execute</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::workqueue.execute</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="irq.stp.html" title="Chapter 12. Interrupt Request (IRQ) Tapset"><link rel="prev" href="API-workqueue-destroy.html" title="probe::workqueue.destroy"><link rel="next" href="API-workqueue-insert.html" title="probe::workqueue.insert"></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>probe::workqueue.execute</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-workqueue-destroy.html">Prev</a> </td><th width="60%" align="center">Chapter 12. Interrupt Request (IRQ) Tapset</th><td width="20%" align="right"> <a accesskey="n" href="API-workqueue-insert.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::workqueue.execute"><a name="API-workqueue-execute"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::workqueue.execute —
- Executing deferred work
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">workqueue.execute </pre></div><div class="refsect1" title="Values"><a name="idp7603024"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>wq_thread</code></em></span></dt><dd><p>
- task_struct of the workqueue thread
- </p></dd><dt><span class="term"><em class="parameter"><code>work_func</code></em></span></dt><dd><p>
- pointer to handler function
- </p></dd><dt><span class="term"><em class="parameter"><code>work</code></em></span></dt><dd><p>
- work_struct* being executed
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-workqueue-destroy.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="irq.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="API-workqueue-insert.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::workqueue.destroy</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::workqueue.insert</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::workqueue.insert</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="irq.stp.html" title="Chapter 12. Interrupt Request (IRQ) Tapset"><link rel="prev" href="API-workqueue-execute.html" title="probe::workqueue.execute"><link rel="next" href="networking.stp.html" title="Chapter 13. Networking Tapset"></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>probe::workqueue.insert</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-workqueue-execute.html">Prev</a> </td><th width="60%" align="center">Chapter 12. Interrupt Request (IRQ) Tapset</th><td width="20%" align="right"> <a accesskey="n" href="networking.stp.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::workqueue.insert"><a name="API-workqueue-insert"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::workqueue.insert —
- Queuing work on a workqueue
- </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">workqueue.insert </pre></div><div class="refsect1" title="Values"><a name="idp7616992"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>wq_thread</code></em></span></dt><dd><p>
- task_struct of the workqueue thread
- </p></dd><dt><span class="term"><em class="parameter"><code>work_func</code></em></span></dt><dd><p>
- pointer to handler function
- </p></dd><dt><span class="term"><em class="parameter"><code>work</code></em></span></dt><dd><p>
- work_struct* being queued
- </p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-workqueue-execute.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="irq.stp.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="networking.stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::workqueue.execute</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 13. Networking Tapset</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 28. Utility functions for using ansi control chars in logs</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-tokenize.html" title="function::tokenize"><link rel="next" href="API-ansi-clear-screen.html" title="function::ansi_clear_screen"></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">Chapter 28. Utility functions for using ansi control chars in logs</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tokenize.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-ansi-clear-screen.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 28. Utility functions for using ansi control chars in logs"><div class="titlepage"><div><div><h2 class="title"><a name="ansi.stp"></a>Chapter 28. Utility functions for using ansi control chars in logs</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-ansi-clear-screen.html"><span>function::ansi_clear_screen</span></a></span><span class="refpurpose"> —
- Move cursor to top left and clear screen.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-cursor-hide.html"><span>function::ansi_cursor_hide</span></a></span><span class="refpurpose"> —
- Hides the cursor.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-cursor-move.html"><span>function::ansi_cursor_move</span></a></span><span class="refpurpose"> —
- Move cursor to new coordinates.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-cursor-restore.html"><span>function::ansi_cursor_restore</span></a></span><span class="refpurpose"> —
- Restores a previously saved cursor position.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-cursor-save.html"><span>function::ansi_cursor_save</span></a></span><span class="refpurpose"> —
- Saves the cursor position.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-cursor-show.html"><span>function::ansi_cursor_show</span></a></span><span class="refpurpose"> —
- Shows the cursor.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-new-line.html"><span>function::ansi_new_line</span></a></span><span class="refpurpose"> —
- Move cursor to new line.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-reset-color.html"><span>function::ansi_reset_color</span></a></span><span class="refpurpose"> —
- Resets Select Graphic Rendition mode.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-set-color.html"><span>function::ansi_set_color</span></a></span><span class="refpurpose"> —
- Set the ansi Select Graphic Rendition mode.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-set-color2.html"><span>function::ansi_set_color2</span></a></span><span class="refpurpose"> —
- Set the ansi Select Graphic Rendition mode.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-set-color3.html"><span>function::ansi_set_color3</span></a></span><span class="refpurpose"> —
- Set the ansi Select Graphic Rendition mode.
- </span></dt><dt><span class="refentrytitle"><a href="API-indent.html"><span>function::indent</span></a></span><span class="refpurpose"> —
- returns an amount of space to indent
- </span></dt><dt><span class="refentrytitle"><a href="API-thread-indent.html"><span>function::thread_indent</span></a></span><span class="refpurpose"> —
- returns an amount of space with the current task information
- </span></dt></dl></div><p>
- Utility functions for logging using ansi control characters. This
- lets you manipulate the cursor position and character color output
- and attributes of log messages.
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tokenize.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-ansi-clear-screen.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::tokenize</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::ansi_clear_screen</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 2. Context Functions</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="introduction.html" title="Chapter 1. Introduction"><link rel="next" href="API-addr.html" title="function::addr"></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">Chapter 2. Context Functions</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="introduction.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-addr.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 2. Context Functions"><div class="titlepage"><div><div><h2 class="title"><a name="context_stp"></a>Chapter 2. Context Functions</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-addr.html"><span>function::addr</span></a></span><span class="refpurpose"> —
- Address of the current probe point.
- </span></dt><dt><span class="refentrytitle"><a href="API-asmlinkage.html"><span>function::asmlinkage</span></a></span><span class="refpurpose"> —
- Mark function as declared asmlinkage
- </span></dt><dt><span class="refentrytitle"><a href="API-backtrace.html"><span>function::backtrace</span></a></span><span class="refpurpose"> —
- Hex backtrace of current kernel stack
- </span></dt><dt><span class="refentrytitle"><a href="API-caller.html"><span>function::caller</span></a></span><span class="refpurpose"> —
- Return name and address of calling function
- </span></dt><dt><span class="refentrytitle"><a href="API-caller-addr.html"><span>function::caller_addr</span></a></span><span class="refpurpose"> —
- Return caller address
- </span></dt><dt><span class="refentrytitle"><a href="API-callers.html"><span>function::callers</span></a></span><span class="refpurpose"> —
- Return first n elements of kernel stack backtrace
- </span></dt><dt><span class="refentrytitle"><a href="API-cmdline-arg.html"><span>function::cmdline_arg</span></a></span><span class="refpurpose"> —
- Fetch a command line argument
- </span></dt><dt><span class="refentrytitle"><a href="API-cmdline-args.html"><span>function::cmdline_args</span></a></span><span class="refpurpose"> —
- Fetch command line arguments from current process
- </span></dt><dt><span class="refentrytitle"><a href="API-cmdline-str.html"><span>function::cmdline_str</span></a></span><span class="refpurpose"> —
- Fetch all command line arguments from current process
- </span></dt><dt><span class="refentrytitle"><a href="API-cpu.html"><span>function::cpu</span></a></span><span class="refpurpose"> —
- Returns the current cpu number
- </span></dt><dt><span class="refentrytitle"><a href="API-cpuid.html"><span>function::cpuid</span></a></span><span class="refpurpose"> —
- Returns the current cpu number
- </span></dt><dt><span class="refentrytitle"><a href="API-egid.html"><span>function::egid</span></a></span><span class="refpurpose"> —
- Returns the effective gid of a target process
- </span></dt><dt><span class="refentrytitle"><a href="API-env-var.html"><span>function::env_var</span></a></span><span class="refpurpose"> —
- Fetch environment variable from current process
- </span></dt><dt><span class="refentrytitle"><a href="API-euid.html"><span>function::euid</span></a></span><span class="refpurpose"> —
- Return the effective uid of a target process
- </span></dt><dt><span class="refentrytitle"><a href="API-execname.html"><span>function::execname</span></a></span><span class="refpurpose"> —
- Returns the execname of a target process (or group of processes)
- </span></dt><dt><span class="refentrytitle"><a href="API-fastcall.html"><span>function::fastcall</span></a></span><span class="refpurpose"> —
- Mark function as declared fastcall
- </span></dt><dt><span class="refentrytitle"><a href="API-gid.html"><span>function::gid</span></a></span><span class="refpurpose"> —
- Returns the group ID of a target process
- </span></dt><dt><span class="refentrytitle"><a href="API-int-arg.html"><span>function::int_arg</span></a></span><span class="refpurpose"> —
- Return function argument as signed int
- </span></dt><dt><span class="refentrytitle"><a href="API-is-myproc.html"><span>function::is_myproc</span></a></span><span class="refpurpose"> —
- Determines if the current probe point has occurred in the user's own process
- </span></dt><dt><span class="refentrytitle"><a href="API-is-return.html"><span>function::is_return</span></a></span><span class="refpurpose"> —
- Whether the current probe context is a return probe
- </span></dt><dt><span class="refentrytitle"><a href="API-long-arg.html"><span>function::long_arg</span></a></span><span class="refpurpose"> —
- Return function argument as signed long
- </span></dt><dt><span class="refentrytitle"><a href="API-longlong-arg.html"><span>function::longlong_arg</span></a></span><span class="refpurpose"> —
- Return function argument as 64-bit value
- </span></dt><dt><span class="refentrytitle"><a href="API-modname.html"><span>function::modname</span></a></span><span class="refpurpose"> —
- Return the kernel module name loaded at the address
- </span></dt><dt><span class="refentrytitle"><a href="API-module-name.html"><span>function::module_name</span></a></span><span class="refpurpose"> —
- The module name of the current script
- </span></dt><dt><span class="refentrytitle"><a href="API-pexecname.html"><span>function::pexecname</span></a></span><span class="refpurpose"> —
- Returns the execname of a target process's parent process
- </span></dt><dt><span class="refentrytitle"><a href="API-pgrp.html"><span>function::pgrp</span></a></span><span class="refpurpose"> —
- Returns the process group ID of the current process
- </span></dt><dt><span class="refentrytitle"><a href="API-pid.html"><span>function::pid</span></a></span><span class="refpurpose"> —
- Returns the ID of a target process
- </span></dt><dt><span class="refentrytitle"><a href="API-pid2execname.html"><span>function::pid2execname</span></a></span><span class="refpurpose"> —
- The name of the given process identifier
- </span></dt><dt><span class="refentrytitle"><a href="API-pid2task.html"><span>function::pid2task</span></a></span><span class="refpurpose"> —
- The task_struct of the given process identifier
- </span></dt><dt><span class="refentrytitle"><a href="API-pn.html"><span>function::pn</span></a></span><span class="refpurpose"> —
- Returns the active probe name
- </span></dt><dt><span class="refentrytitle"><a href="API-pointer-arg.html"><span>function::pointer_arg</span></a></span><span class="refpurpose"> —
- Return function argument as pointer value
- </span></dt><dt><span class="refentrytitle"><a href="API-pp.html"><span>function::pp</span></a></span><span class="refpurpose"> —
- Returns the active probe point
- </span></dt><dt><span class="refentrytitle"><a href="API-ppfunc.html"><span>function::ppfunc</span></a></span><span class="refpurpose"> —
- Returns the function name parsed from <code class="function">pp</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-ppid.html"><span>function::ppid</span></a></span><span class="refpurpose"> —
- Returns the process ID of a target process's parent process
- </span></dt><dt><span class="refentrytitle"><a href="API-print-backtrace.html"><span>function::print_backtrace</span></a></span><span class="refpurpose"> —
- Print kernel stack back trace
- </span></dt><dt><span class="refentrytitle"><a href="API-print-regs.html"><span>function::print_regs</span></a></span><span class="refpurpose"> —
- Print a register dump
- </span></dt><dt><span class="refentrytitle"><a href="API-print-stack.html"><span>function::print_stack</span></a></span><span class="refpurpose"> —
- Print out kernel stack from string
- </span></dt><dt><span class="refentrytitle"><a href="API-print-syms.html"><span>function::print_syms</span></a></span><span class="refpurpose"> —
- Print out kernel stack from string
- </span></dt><dt><span class="refentrytitle"><a href="API-print-ubacktrace.html"><span>function::print_ubacktrace</span></a></span><span class="refpurpose"> —
- Print stack back trace for current user-space task.
- </span></dt><dt><span class="refentrytitle"><a href="API-print-ubacktrace-brief.html"><span>function::print_ubacktrace_brief</span></a></span><span class="refpurpose"> —
- Print stack back trace for current user-space task.
- </span></dt><dt><span class="refentrytitle"><a href="API-print-ustack.html"><span>function::print_ustack</span></a></span><span class="refpurpose"> —
- Print out stack for the current task from string.
- </span></dt><dt><span class="refentrytitle"><a href="API-print-usyms.html"><span>function::print_usyms</span></a></span><span class="refpurpose"> —
- Print out user stack from string
- </span></dt><dt><span class="refentrytitle"><a href="API-probe-type.html"><span>function::probe_type</span></a></span><span class="refpurpose"> —
- The low level probe handler type of the current probe.
- </span></dt><dt><span class="refentrytitle"><a href="API-probefunc.html"><span>function::probefunc</span></a></span><span class="refpurpose"> —
- Return the probe point's function name, if known
- </span></dt><dt><span class="refentrytitle"><a href="API-probemod.html"><span>function::probemod</span></a></span><span class="refpurpose"> —
- Return the probe point's kernel module name
- </span></dt><dt><span class="refentrytitle"><a href="API-pstrace.html"><span>function::pstrace</span></a></span><span class="refpurpose"> —
- Chain of processes and pids back to init(1)
- </span></dt><dt><span class="refentrytitle"><a href="API-register.html"><span>function::register</span></a></span><span class="refpurpose"> —
- Return the signed value of the named CPU register
- </span></dt><dt><span class="refentrytitle"><a href="API-registers-valid.html"><span>function::registers_valid</span></a></span><span class="refpurpose"> —
- Determines validity of <code class="function">register</code> and <code class="function">u_register</code> in current context
- </span></dt><dt><span class="refentrytitle"><a href="API-regparm.html"><span>function::regparm</span></a></span><span class="refpurpose"> —
- Specify regparm value used to compile function
- </span></dt><dt><span class="refentrytitle"><a href="API-remote-id.html"><span>function::remote_id</span></a></span><span class="refpurpose"> —
- The index of this instance in a remote execution.
- </span></dt><dt><span class="refentrytitle"><a href="API-remote-uri.html"><span>function::remote_uri</span></a></span><span class="refpurpose"> —
- The name of this instance in a remote execution.
- </span></dt><dt><span class="refentrytitle"><a href="API-s32-arg.html"><span>function::s32_arg</span></a></span><span class="refpurpose"> —
- Return function argument as signed 32-bit value
- </span></dt><dt><span class="refentrytitle"><a href="API-s64-arg.html"><span>function::s64_arg</span></a></span><span class="refpurpose"> —
- Return function argument as signed 64-bit value
- </span></dt><dt><span class="refentrytitle"><a href="API-sid.html"><span>function::sid</span></a></span><span class="refpurpose"> —
- Returns the session ID of the current process
- </span></dt><dt><span class="refentrytitle"><a href="API-sprint-backtrace.html"><span>function::sprint_backtrace</span></a></span><span class="refpurpose"> —
- Return stack back trace as string
- </span></dt><dt><span class="refentrytitle"><a href="API-sprint-stack.html"><span>function::sprint_stack</span></a></span><span class="refpurpose"> —
- Return stack for kernel addresses from string
- </span></dt><dt><span class="refentrytitle"><a href="API-sprint-syms.html"><span>function::sprint_syms</span></a></span><span class="refpurpose"> —
- Return stack for kernel addresses from string
- </span></dt><dt><span class="refentrytitle"><a href="API-sprint-ubacktrace.html"><span>function::sprint_ubacktrace</span></a></span><span class="refpurpose"> —
- Return stack back trace for current user-space task as string.
- </span></dt><dt><span class="refentrytitle"><a href="API-sprint-ustack.html"><span>function::sprint_ustack</span></a></span><span class="refpurpose"> —
- Return stack for the current task from string.
- </span></dt><dt><span class="refentrytitle"><a href="API-sprint-usyms.html"><span>function::sprint_usyms</span></a></span><span class="refpurpose"> —
- Return stack for user addresses from string
- </span></dt><dt><span class="refentrytitle"><a href="API-stack.html"><span>function::stack</span></a></span><span class="refpurpose"> —
- Return address at given depth of kernel stack backtrace
- </span></dt><dt><span class="refentrytitle"><a href="API-stack-size.html"><span>function::stack_size</span></a></span><span class="refpurpose"> —
- Return the size of the kernel stack
- </span></dt><dt><span class="refentrytitle"><a href="API-stack-unused.html"><span>function::stack_unused</span></a></span><span class="refpurpose"> —
- Returns the amount of kernel stack currently available
- </span></dt><dt><span class="refentrytitle"><a href="API-stack-used.html"><span>function::stack_used</span></a></span><span class="refpurpose"> —
- Returns the amount of kernel stack used
- </span></dt><dt><span class="refentrytitle"><a href="API-stp-pid.html"><span>function::stp_pid</span></a></span><span class="refpurpose"> —
- The process id of the stapio process
- </span></dt><dt><span class="refentrytitle"><a href="API-symdata.html"><span>function::symdata</span></a></span><span class="refpurpose"> —
- Return the kernel symbol and module offset for the address
- </span></dt><dt><span class="refentrytitle"><a href="API-symname.html"><span>function::symname</span></a></span><span class="refpurpose"> —
- Return the kernel symbol associated with the given address
- </span></dt><dt><span class="refentrytitle"><a href="API-target.html"><span>function::target</span></a></span><span class="refpurpose"> —
- Return the process ID of the target process
- </span></dt><dt><span class="refentrytitle"><a href="API-task-backtrace.html"><span>function::task_backtrace</span></a></span><span class="refpurpose"> —
- Hex backtrace of an arbitrary task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-cpu.html"><span>function::task_cpu</span></a></span><span class="refpurpose"> —
- The scheduled cpu of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-current.html"><span>function::task_current</span></a></span><span class="refpurpose"> —
- The current task_struct of the current task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-egid.html"><span>function::task_egid</span></a></span><span class="refpurpose"> —
- The effective group identifier of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-euid.html"><span>function::task_euid</span></a></span><span class="refpurpose"> —
- The effective user identifier of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-execname.html"><span>function::task_execname</span></a></span><span class="refpurpose"> —
- The name of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-gid.html"><span>function::task_gid</span></a></span><span class="refpurpose"> —
- The group identifier of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-max-file-handles.html"><span>function::task_max_file_handles</span></a></span><span class="refpurpose"> —
- The max number of open files for the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-nice.html"><span>function::task_nice</span></a></span><span class="refpurpose"> —
- The nice value of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-open-file-handles.html"><span>function::task_open_file_handles</span></a></span><span class="refpurpose"> —
- The number of open files of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-parent.html"><span>function::task_parent</span></a></span><span class="refpurpose"> —
- The task_struct of the parent task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-pid.html"><span>function::task_pid</span></a></span><span class="refpurpose"> —
- The process identifier of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-prio.html"><span>function::task_prio</span></a></span><span class="refpurpose"> —
- The priority value of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-state.html"><span>function::task_state</span></a></span><span class="refpurpose"> —
- The state of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-tid.html"><span>function::task_tid</span></a></span><span class="refpurpose"> —
- The thread identifier of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-uid.html"><span>function::task_uid</span></a></span><span class="refpurpose"> —
- The user identifier of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-tid.html"><span>function::tid</span></a></span><span class="refpurpose"> —
- Returns the thread ID of a target process
- </span></dt><dt><span class="refentrytitle"><a href="API-u32-arg.html"><span>function::u32_arg</span></a></span><span class="refpurpose"> —
- Return function argument as unsigned 32-bit value
- </span></dt><dt><span class="refentrytitle"><a href="API-u64-arg.html"><span>function::u64_arg</span></a></span><span class="refpurpose"> —
- Return function argument as unsigned 64-bit value
- </span></dt><dt><span class="refentrytitle"><a href="API-u-register.html"><span>function::u_register</span></a></span><span class="refpurpose"> —
- Return the unsigned value of the named CPU register
- </span></dt><dt><span class="refentrytitle"><a href="API-uaddr.html"><span>function::uaddr</span></a></span><span class="refpurpose"> —
- User space address of current running task
- </span></dt><dt><span class="refentrytitle"><a href="API-ubacktrace.html"><span>function::ubacktrace</span></a></span><span class="refpurpose"> —
- Hex backtrace of current user-space task stack.
- </span></dt><dt><span class="refentrytitle"><a href="API-ucallers.html"><span>function::ucallers</span></a></span><span class="refpurpose"> —
- Return first n elements of user stack backtrace
- </span></dt><dt><span class="refentrytitle"><a href="API-uid.html"><span>function::uid</span></a></span><span class="refpurpose"> —
- Returns the user ID of a target process
- </span></dt><dt><span class="refentrytitle"><a href="API-uint-arg.html"><span>function::uint_arg</span></a></span><span class="refpurpose"> —
- Return function argument as unsigned int
- </span></dt><dt><span class="refentrytitle"><a href="API-ulong-arg.html"><span>function::ulong_arg</span></a></span><span class="refpurpose"> —
- Return function argument as unsigned long
- </span></dt><dt><span class="refentrytitle"><a href="API-ulonglong-arg.html"><span>function::ulonglong_arg</span></a></span><span class="refpurpose"> —
- Return function argument as 64-bit value
- </span></dt><dt><span class="refentrytitle"><a href="API-umodname.html"><span>function::umodname</span></a></span><span class="refpurpose"> —
- Returns the (short) name of the user module.
- </span></dt><dt><span class="refentrytitle"><a href="API-user-mode.html"><span>function::user_mode</span></a></span><span class="refpurpose"> —
- Determines if probe point occurs in user-mode
- </span></dt><dt><span class="refentrytitle"><a href="API-ustack.html"><span>function::ustack</span></a></span><span class="refpurpose"> —
- Return address at given depth of user stack backtrace
- </span></dt><dt><span class="refentrytitle"><a href="API-usymdata.html"><span>function::usymdata</span></a></span><span class="refpurpose"> —
- Return the symbol and module offset of an address.
- </span></dt><dt><span class="refentrytitle"><a href="API-usymname.html"><span>function::usymname</span></a></span><span class="refpurpose"> —
- Return the symbol of an address in the current task.
- </span></dt></dl></div><p>
- The context functions provide additional information about where
- an event occurred.
- These functions can provide information such as a backtrace to
- where the event occurred
- and the current register values for the processor.
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="introduction.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-addr.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 1. Introduction </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>function::addr</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 25. String and data writing functions Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-user-ushort-warn.html" title="function::user_ushort_warn"><link rel="next" href="API-set-kernel-char.html" title="function::set_kernel_char"></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">Chapter 25. String and data writing functions Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-user-ushort-warn.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-set-kernel-char.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 25. String and data writing functions Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="conversions-guru.stp"></a>Chapter 25. String and data writing functions Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-set-kernel-char.html"><span>function::set_kernel_char</span></a></span><span class="refpurpose"> —
- Writes a char value to kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-set-kernel-int.html"><span>function::set_kernel_int</span></a></span><span class="refpurpose"> —
- Writes an int value to kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-set-kernel-long.html"><span>function::set_kernel_long</span></a></span><span class="refpurpose"> —
- Writes a long value to kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-set-kernel-pointer.html"><span>function::set_kernel_pointer</span></a></span><span class="refpurpose"> —
- Writes a pointer value to kernel memory.
- </span></dt><dt><span class="refentrytitle"><a href="API-set-kernel-short.html"><span>function::set_kernel_short</span></a></span><span class="refpurpose"> —
- Writes a short value to kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-set-kernel-string.html"><span>function::set_kernel_string</span></a></span><span class="refpurpose"> —
- Writes a string to kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-set-kernel-string-n.html"><span>function::set_kernel_string_n</span></a></span><span class="refpurpose"> —
- Writes a string of given length to kernel memory
- </span></dt></dl></div><p>
- The SystemTap guru mode can be used to test error handling
- in kernel code by simulating faults. The functions in the
- this tapset provide
- standard methods of writing to primitive types in the kernel's
- memory. All the functions in this tapset require the use of
- guru mode (<span class="command"><strong>-g</strong></span>).
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-user-ushort-warn.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-set-kernel-char.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::user_ushort_warn</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::set_kernel_char</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 24. String and data retrieving functions Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-randint.html" title="function::randint"><link rel="next" href="API-atomic-long-read.html" title="function::atomic_long_read"></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">Chapter 24. String and data retrieving functions Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-randint.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-atomic-long-read.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 24. String and data retrieving functions Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="conversions.stp"></a>Chapter 24. String and data retrieving functions Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-atomic-long-read.html"><span>function::atomic_long_read</span></a></span><span class="refpurpose"> —
- Retrieves an atomic long variable from kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-atomic-read.html"><span>function::atomic_read</span></a></span><span class="refpurpose"> —
- Retrieves an atomic variable from kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-char.html"><span>function::kernel_char</span></a></span><span class="refpurpose"> —
- Retrieves a char value stored in kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-int.html"><span>function::kernel_int</span></a></span><span class="refpurpose"> —
- Retrieves an int value stored in kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-long.html"><span>function::kernel_long</span></a></span><span class="refpurpose"> —
- Retrieves a long value stored in kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-pointer.html"><span>function::kernel_pointer</span></a></span><span class="refpurpose"> —
- Retrieves a pointer value stored in kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-short.html"><span>function::kernel_short</span></a></span><span class="refpurpose"> —
- Retrieves a short value stored in kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-string.html"><span>function::kernel_string</span></a></span><span class="refpurpose"> —
- Retrieves string from kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-string2.html"><span>function::kernel_string2</span></a></span><span class="refpurpose"> —
- Retrieves string from kernel memory with alternative error string
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-string2-utf16.html"><span>function::kernel_string2_utf16</span></a></span><span class="refpurpose"> —
- Retrieves UTF-16 string from kernel memory with alternative error string
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-string2-utf32.html"><span>function::kernel_string2_utf32</span></a></span><span class="refpurpose"> —
- Retrieves UTF-32 string from kernel memory with alternative error string
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-string-n.html"><span>function::kernel_string_n</span></a></span><span class="refpurpose"> —
- Retrieves string of given length from kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-string-utf16.html"><span>function::kernel_string_utf16</span></a></span><span class="refpurpose"> —
- Retrieves UTF-16 string from kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-string-utf32.html"><span>function::kernel_string_utf32</span></a></span><span class="refpurpose"> —
- Retrieves UTF-32 string from kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-user-char.html"><span>function::user_char</span></a></span><span class="refpurpose"> —
- Retrieves a char value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-char-warn.html"><span>function::user_char_warn</span></a></span><span class="refpurpose"> —
- Retrieves a char value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-int.html"><span>function::user_int</span></a></span><span class="refpurpose"> —
- Retrieves an int value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-int16.html"><span>function::user_int16</span></a></span><span class="refpurpose"> —
- Retrieves a 16-bit integer value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-int32.html"><span>function::user_int32</span></a></span><span class="refpurpose"> —
- Retrieves a 32-bit integer value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-int64.html"><span>function::user_int64</span></a></span><span class="refpurpose"> —
- Retrieves a 64-bit integer value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-int8.html"><span>function::user_int8</span></a></span><span class="refpurpose"> —
- Retrieves a 8-bit integer value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-int-warn.html"><span>function::user_int_warn</span></a></span><span class="refpurpose"> —
- Retrieves an int value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-long.html"><span>function::user_long</span></a></span><span class="refpurpose"> —
- Retrieves a long value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-long-warn.html"><span>function::user_long_warn</span></a></span><span class="refpurpose"> —
- Retrieves a long value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-short.html"><span>function::user_short</span></a></span><span class="refpurpose"> —
- Retrieves a short value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-short-warn.html"><span>function::user_short_warn</span></a></span><span class="refpurpose"> —
- Retrieves a short value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string.html"><span>function::user_string</span></a></span><span class="refpurpose"> —
- Retrieves string from user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string2.html"><span>function::user_string2</span></a></span><span class="refpurpose"> —
- Retrieves string from user space with alternative error string
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string2-utf16.html"><span>function::user_string2_utf16</span></a></span><span class="refpurpose"> —
- Retrieves UTF-16 string from user memory with alternative error string
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string2-utf32.html"><span>function::user_string2_utf32</span></a></span><span class="refpurpose"> —
- Retrieves UTF-32 string from user memory with alternative error string
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string-n.html"><span>function::user_string_n</span></a></span><span class="refpurpose"> —
- Retrieves string of given length from user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string-n2.html"><span>function::user_string_n2</span></a></span><span class="refpurpose"> —
- Retrieves string of given length from user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string-n-quoted.html"><span>function::user_string_n_quoted</span></a></span><span class="refpurpose"> —
- Retrieves and quotes string from user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string-n-warn.html"><span>function::user_string_n_warn</span></a></span><span class="refpurpose"> —
- Retrieves string from user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string-quoted.html"><span>function::user_string_quoted</span></a></span><span class="refpurpose"> —
- Retrieves and quotes string from user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string-utf16.html"><span>function::user_string_utf16</span></a></span><span class="refpurpose"> —
- Retrieves UTF-16 string from user memory
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string-utf32.html"><span>function::user_string_utf32</span></a></span><span class="refpurpose"> —
- Retrieves UTF-32 string from user memory
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string-warn.html"><span>function::user_string_warn</span></a></span><span class="refpurpose"> —
- Retrieves string from user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-uint16.html"><span>function::user_uint16</span></a></span><span class="refpurpose"> —
- Retrieves an unsigned 16-bit integer value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-uint32.html"><span>function::user_uint32</span></a></span><span class="refpurpose"> —
- Retrieves an unsigned 32-bit integer value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-uint64.html"><span>function::user_uint64</span></a></span><span class="refpurpose"> —
- Retrieves an unsigned 64-bit integer value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-uint8.html"><span>function::user_uint8</span></a></span><span class="refpurpose"> —
- Retrieves an unsigned 8-bit integer value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-ushort.html"><span>function::user_ushort</span></a></span><span class="refpurpose"> —
- Retrieves an unsigned short value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-ushort-warn.html"><span>function::user_ushort_warn</span></a></span><span class="refpurpose"> —
- Retrieves an unsigned short value stored in user space
- </span></dt></dl></div><p>
- Functions to retrieve strings and other primitive types from
- the kernel or a user space programs based on addresses. All
- strings are of a maximum length given by MAXSTRINGLEN.
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-randint.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-atomic-long-read.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::randint</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::atomic_long_read</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 4. Time utility functions</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-stop-stopwatch.html" title="function::stop_stopwatch"><link rel="next" href="API-ctime.html" title="function::ctime"></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">Chapter 4. Time utility functions</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-stop-stopwatch.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-ctime.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 4. Time utility functions"><div class="titlepage"><div><div><h2 class="title"><a name="ctime.stp"></a>Chapter 4. Time utility functions</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-ctime.html"><span>function::ctime</span></a></span><span class="refpurpose"> —
- Convert seconds since epoch into human readable date/time string
- </span></dt><dt><span class="refentrytitle"><a href="API-tz-ctime.html"><span>function::tz_ctime</span></a></span><span class="refpurpose"> —
- Convert seconds since epoch into human readable date/time string, with local time zone
- </span></dt><dt><span class="refentrytitle"><a href="API-tz-gmtoff.html"><span>function::tz_gmtoff</span></a></span><span class="refpurpose"> —
- Return local time zone offset
- </span></dt><dt><span class="refentrytitle"><a href="API-tz-name.html"><span>function::tz_name</span></a></span><span class="refpurpose"> —
- Return local time zone name
- </span></dt></dl></div><p>
- Utility functions to turn seconds since the epoch (as returned by
- the timestamp function gettimeofday_s()) into a human readable
- date/time strings.
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-stop-stopwatch.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-ctime.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::stop_stopwatch</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::ctime</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 20. Directory-entry (dentry) Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-usrdev2kerndev.html" title="function::usrdev2kerndev"><link rel="next" href="API-d-name.html" title="function::d_name"></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">Chapter 20. Directory-entry (dentry) Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-usrdev2kerndev.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-d-name.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 20. Directory-entry (dentry) Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="dentry.stp"></a>Chapter 20. Directory-entry (dentry) Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-d-name.html"><span>function::d_name</span></a></span><span class="refpurpose"> —
- get the dirent name
- </span></dt><dt><span class="refentrytitle"><a href="API-d-path.html"><span>function::d_path</span></a></span><span class="refpurpose"> —
- get the full nameidata path
- </span></dt><dt><span class="refentrytitle"><a href="API-inode-name.html"><span>function::inode_name</span></a></span><span class="refpurpose"> —
- get the inode name
- </span></dt><dt><span class="refentrytitle"><a href="API-real-mount.html"><span>function::real_mount</span></a></span><span class="refpurpose"> —
- get the 'struct mount' pointer
- </span></dt><dt><span class="refentrytitle"><a href="API-reverse-path-walk.html"><span>function::reverse_path_walk</span></a></span><span class="refpurpose"> —
- get the full dirent path
- </span></dt><dt><span class="refentrytitle"><a href="API-task-dentry-path.html"><span>function::task_dentry_path</span></a></span><span class="refpurpose"> —
- get the full dentry path
- </span></dt></dl></div><p>
- This family of functions is used to map kernel VFS
- directory entry pointers to file or full path names.
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-usrdev2kerndev.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-d-name.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::usrdev2kerndev</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::d_name</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 19. Device Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-returnval.html" title="function::returnval"><link rel="next" href="API-MAJOR.html" title="function::MAJOR"></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">Chapter 19. Device Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-returnval.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-MAJOR.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 19. Device Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="dev.stp"></a>Chapter 19. Device Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-MAJOR.html"><span>function::MAJOR</span></a></span><span class="refpurpose"> —
- Extract major device number from a kernel device number (kdev_t)
- </span></dt><dt><span class="refentrytitle"><a href="API-MINOR.html"><span>function::MINOR</span></a></span><span class="refpurpose"> —
- Extract minor device number from a kernel device number (kdev_t)
- </span></dt><dt><span class="refentrytitle"><a href="API-MKDEV.html"><span>function::MKDEV</span></a></span><span class="refpurpose"> —
- Creates a value that can be compared to a kernel device number (kdev_t)
- </span></dt><dt><span class="refentrytitle"><a href="API-usrdev2kerndev.html"><span>function::usrdev2kerndev</span></a></span><span class="refpurpose"> —
- Converts a user-space device number into the format used in the kernel
- </span></dt></dl></div><p>
- This set of functions is used to handle kernel and userspace device numbers.
- It contains the following functions:
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-returnval.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-MAJOR.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::returnval</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::MAJOR</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 18. Errno Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-signal-wakeup.html" title="probe::signal.wakeup"><link rel="next" href="API-errno-str.html" title="function::errno_str"></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">Chapter 18. Errno Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-wakeup.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-errno-str.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 18. Errno Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="errno.stp"></a>Chapter 18. Errno Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-errno-str.html"><span>function::errno_str</span></a></span><span class="refpurpose"> —
- Symbolic string associated with error code
- </span></dt><dt><span class="refentrytitle"><a href="API-return-str.html"><span>function::return_str</span></a></span><span class="refpurpose"> —
- Formats the return value as a string
- </span></dt><dt><span class="refentrytitle"><a href="API-returnstr.html"><span>function::returnstr</span></a></span><span class="refpurpose"> —
- Formats the return value as a string
- </span></dt><dt><span class="refentrytitle"><a href="API-returnval.html"><span>function::returnval</span></a></span><span class="refpurpose"> —
- Possible return value of probed function
- </span></dt></dl></div><p>
- This set of functions is used to handle errno number values.
- It contains the following functions:
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-wakeup.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-errno-str.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.wakeup</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::errno_str</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 26. Guru tapsets</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-set-kernel-string-n.html" title="function::set_kernel_string_n"><link rel="next" href="API-mdelay.html" title="function::mdelay"></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">Chapter 26. Guru tapsets</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-set-kernel-string-n.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-mdelay.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 26. Guru tapsets"><div class="titlepage"><div><div><h2 class="title"><a name="guru-delay.stp"></a>Chapter 26. Guru tapsets</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-mdelay.html"><span>function::mdelay</span></a></span><span class="refpurpose"> —
- millisecond delay
- </span></dt><dt><span class="refentrytitle"><a href="API-panic.html"><span>function::panic</span></a></span><span class="refpurpose"> —
- trigger a panic
- </span></dt><dt><span class="refentrytitle"><a href="API-udelay.html"><span>function::udelay</span></a></span><span class="refpurpose"> —
- microsecond delay
- </span></dt></dl></div><p>
- Functions to deliberately interfere with the system's behavior, in
- order to inject faults or improve observability.
- All the functions in this tapset require the use of
- guru mode (<span class="command"><strong>-g</strong></span>).
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-set-kernel-string-n.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-mdelay.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::set_kernel_string_n</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::mdelay</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>SystemTap Tapset Reference Manual</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="next" href="introduction.html" title="Chapter 1. Introduction"></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">SystemTap Tapset Reference Manual</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="introduction.html">Next</a></td></tr></table><hr></div><div class="book" title="SystemTap Tapset Reference Manual"><div class="titlepage"><div><div><h1 class="title"><a name="TapsetRef"></a>SystemTap Tapset Reference Manual</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="othername">SystemTap</span></h3><span class="contrib">Hackers</span> </div></div></div><div><p class="copyright">Copyright © 2008-2013 Red Hat, Inc. and others</p></div><div><div class="legalnotice" title="Legal Notice"><a name="idp224944"></a><p>
- This documentation is free software; you can redistribute
- it and/or modify it under the terms of the GNU General Public
- License version 2 as published by the Free Software Foundation.
- </p><p>
- This program is distributed in the hope that it will be
- useful, but WITHOUT ANY WARRANTY; without even the implied
- warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
- See the GNU General Public License for more details.
- </p><p>
- You should have received a copy of the GNU General Public
- License along with this program; if not, write to the Free
- Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
- Boston, MA 02110-1301 USA.
- </p><p>
- For more details see the file COPYING in the source
- distribution of Linux.
- </p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="introduction.html">1. Introduction</a></span></dt><dt><span class="chapter"><a href="context_stp.html">2. Context Functions</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-addr.html"><span>function::addr</span></a></span><span class="refpurpose"> —
- Address of the current probe point.
- </span></dt><dt><span class="refentrytitle"><a href="API-asmlinkage.html"><span>function::asmlinkage</span></a></span><span class="refpurpose"> —
- Mark function as declared asmlinkage
- </span></dt><dt><span class="refentrytitle"><a href="API-backtrace.html"><span>function::backtrace</span></a></span><span class="refpurpose"> —
- Hex backtrace of current kernel stack
- </span></dt><dt><span class="refentrytitle"><a href="API-caller.html"><span>function::caller</span></a></span><span class="refpurpose"> —
- Return name and address of calling function
- </span></dt><dt><span class="refentrytitle"><a href="API-caller-addr.html"><span>function::caller_addr</span></a></span><span class="refpurpose"> —
- Return caller address
- </span></dt><dt><span class="refentrytitle"><a href="API-callers.html"><span>function::callers</span></a></span><span class="refpurpose"> —
- Return first n elements of kernel stack backtrace
- </span></dt><dt><span class="refentrytitle"><a href="API-cmdline-arg.html"><span>function::cmdline_arg</span></a></span><span class="refpurpose"> —
- Fetch a command line argument
- </span></dt><dt><span class="refentrytitle"><a href="API-cmdline-args.html"><span>function::cmdline_args</span></a></span><span class="refpurpose"> —
- Fetch command line arguments from current process
- </span></dt><dt><span class="refentrytitle"><a href="API-cmdline-str.html"><span>function::cmdline_str</span></a></span><span class="refpurpose"> —
- Fetch all command line arguments from current process
- </span></dt><dt><span class="refentrytitle"><a href="API-cpu.html"><span>function::cpu</span></a></span><span class="refpurpose"> —
- Returns the current cpu number
- </span></dt><dt><span class="refentrytitle"><a href="API-cpuid.html"><span>function::cpuid</span></a></span><span class="refpurpose"> —
- Returns the current cpu number
- </span></dt><dt><span class="refentrytitle"><a href="API-egid.html"><span>function::egid</span></a></span><span class="refpurpose"> —
- Returns the effective gid of a target process
- </span></dt><dt><span class="refentrytitle"><a href="API-env-var.html"><span>function::env_var</span></a></span><span class="refpurpose"> —
- Fetch environment variable from current process
- </span></dt><dt><span class="refentrytitle"><a href="API-euid.html"><span>function::euid</span></a></span><span class="refpurpose"> —
- Return the effective uid of a target process
- </span></dt><dt><span class="refentrytitle"><a href="API-execname.html"><span>function::execname</span></a></span><span class="refpurpose"> —
- Returns the execname of a target process (or group of processes)
- </span></dt><dt><span class="refentrytitle"><a href="API-fastcall.html"><span>function::fastcall</span></a></span><span class="refpurpose"> —
- Mark function as declared fastcall
- </span></dt><dt><span class="refentrytitle"><a href="API-gid.html"><span>function::gid</span></a></span><span class="refpurpose"> —
- Returns the group ID of a target process
- </span></dt><dt><span class="refentrytitle"><a href="API-int-arg.html"><span>function::int_arg</span></a></span><span class="refpurpose"> —
- Return function argument as signed int
- </span></dt><dt><span class="refentrytitle"><a href="API-is-myproc.html"><span>function::is_myproc</span></a></span><span class="refpurpose"> —
- Determines if the current probe point has occurred in the user's own process
- </span></dt><dt><span class="refentrytitle"><a href="API-is-return.html"><span>function::is_return</span></a></span><span class="refpurpose"> —
- Whether the current probe context is a return probe
- </span></dt><dt><span class="refentrytitle"><a href="API-long-arg.html"><span>function::long_arg</span></a></span><span class="refpurpose"> —
- Return function argument as signed long
- </span></dt><dt><span class="refentrytitle"><a href="API-longlong-arg.html"><span>function::longlong_arg</span></a></span><span class="refpurpose"> —
- Return function argument as 64-bit value
- </span></dt><dt><span class="refentrytitle"><a href="API-modname.html"><span>function::modname</span></a></span><span class="refpurpose"> —
- Return the kernel module name loaded at the address
- </span></dt><dt><span class="refentrytitle"><a href="API-module-name.html"><span>function::module_name</span></a></span><span class="refpurpose"> —
- The module name of the current script
- </span></dt><dt><span class="refentrytitle"><a href="API-pexecname.html"><span>function::pexecname</span></a></span><span class="refpurpose"> —
- Returns the execname of a target process's parent process
- </span></dt><dt><span class="refentrytitle"><a href="API-pgrp.html"><span>function::pgrp</span></a></span><span class="refpurpose"> —
- Returns the process group ID of the current process
- </span></dt><dt><span class="refentrytitle"><a href="API-pid.html"><span>function::pid</span></a></span><span class="refpurpose"> —
- Returns the ID of a target process
- </span></dt><dt><span class="refentrytitle"><a href="API-pid2execname.html"><span>function::pid2execname</span></a></span><span class="refpurpose"> —
- The name of the given process identifier
- </span></dt><dt><span class="refentrytitle"><a href="API-pid2task.html"><span>function::pid2task</span></a></span><span class="refpurpose"> —
- The task_struct of the given process identifier
- </span></dt><dt><span class="refentrytitle"><a href="API-pn.html"><span>function::pn</span></a></span><span class="refpurpose"> —
- Returns the active probe name
- </span></dt><dt><span class="refentrytitle"><a href="API-pointer-arg.html"><span>function::pointer_arg</span></a></span><span class="refpurpose"> —
- Return function argument as pointer value
- </span></dt><dt><span class="refentrytitle"><a href="API-pp.html"><span>function::pp</span></a></span><span class="refpurpose"> —
- Returns the active probe point
- </span></dt><dt><span class="refentrytitle"><a href="API-ppfunc.html"><span>function::ppfunc</span></a></span><span class="refpurpose"> —
- Returns the function name parsed from <code class="function">pp</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-ppid.html"><span>function::ppid</span></a></span><span class="refpurpose"> —
- Returns the process ID of a target process's parent process
- </span></dt><dt><span class="refentrytitle"><a href="API-print-backtrace.html"><span>function::print_backtrace</span></a></span><span class="refpurpose"> —
- Print kernel stack back trace
- </span></dt><dt><span class="refentrytitle"><a href="API-print-regs.html"><span>function::print_regs</span></a></span><span class="refpurpose"> —
- Print a register dump
- </span></dt><dt><span class="refentrytitle"><a href="API-print-stack.html"><span>function::print_stack</span></a></span><span class="refpurpose"> —
- Print out kernel stack from string
- </span></dt><dt><span class="refentrytitle"><a href="API-print-syms.html"><span>function::print_syms</span></a></span><span class="refpurpose"> —
- Print out kernel stack from string
- </span></dt><dt><span class="refentrytitle"><a href="API-print-ubacktrace.html"><span>function::print_ubacktrace</span></a></span><span class="refpurpose"> —
- Print stack back trace for current user-space task.
- </span></dt><dt><span class="refentrytitle"><a href="API-print-ubacktrace-brief.html"><span>function::print_ubacktrace_brief</span></a></span><span class="refpurpose"> —
- Print stack back trace for current user-space task.
- </span></dt><dt><span class="refentrytitle"><a href="API-print-ustack.html"><span>function::print_ustack</span></a></span><span class="refpurpose"> —
- Print out stack for the current task from string.
- </span></dt><dt><span class="refentrytitle"><a href="API-print-usyms.html"><span>function::print_usyms</span></a></span><span class="refpurpose"> —
- Print out user stack from string
- </span></dt><dt><span class="refentrytitle"><a href="API-probe-type.html"><span>function::probe_type</span></a></span><span class="refpurpose"> —
- The low level probe handler type of the current probe.
- </span></dt><dt><span class="refentrytitle"><a href="API-probefunc.html"><span>function::probefunc</span></a></span><span class="refpurpose"> —
- Return the probe point's function name, if known
- </span></dt><dt><span class="refentrytitle"><a href="API-probemod.html"><span>function::probemod</span></a></span><span class="refpurpose"> —
- Return the probe point's kernel module name
- </span></dt><dt><span class="refentrytitle"><a href="API-pstrace.html"><span>function::pstrace</span></a></span><span class="refpurpose"> —
- Chain of processes and pids back to init(1)
- </span></dt><dt><span class="refentrytitle"><a href="API-register.html"><span>function::register</span></a></span><span class="refpurpose"> —
- Return the signed value of the named CPU register
- </span></dt><dt><span class="refentrytitle"><a href="API-registers-valid.html"><span>function::registers_valid</span></a></span><span class="refpurpose"> —
- Determines validity of <code class="function">register</code> and <code class="function">u_register</code> in current context
- </span></dt><dt><span class="refentrytitle"><a href="API-regparm.html"><span>function::regparm</span></a></span><span class="refpurpose"> —
- Specify regparm value used to compile function
- </span></dt><dt><span class="refentrytitle"><a href="API-remote-id.html"><span>function::remote_id</span></a></span><span class="refpurpose"> —
- The index of this instance in a remote execution.
- </span></dt><dt><span class="refentrytitle"><a href="API-remote-uri.html"><span>function::remote_uri</span></a></span><span class="refpurpose"> —
- The name of this instance in a remote execution.
- </span></dt><dt><span class="refentrytitle"><a href="API-s32-arg.html"><span>function::s32_arg</span></a></span><span class="refpurpose"> —
- Return function argument as signed 32-bit value
- </span></dt><dt><span class="refentrytitle"><a href="API-s64-arg.html"><span>function::s64_arg</span></a></span><span class="refpurpose"> —
- Return function argument as signed 64-bit value
- </span></dt><dt><span class="refentrytitle"><a href="API-sid.html"><span>function::sid</span></a></span><span class="refpurpose"> —
- Returns the session ID of the current process
- </span></dt><dt><span class="refentrytitle"><a href="API-sprint-backtrace.html"><span>function::sprint_backtrace</span></a></span><span class="refpurpose"> —
- Return stack back trace as string
- </span></dt><dt><span class="refentrytitle"><a href="API-sprint-stack.html"><span>function::sprint_stack</span></a></span><span class="refpurpose"> —
- Return stack for kernel addresses from string
- </span></dt><dt><span class="refentrytitle"><a href="API-sprint-syms.html"><span>function::sprint_syms</span></a></span><span class="refpurpose"> —
- Return stack for kernel addresses from string
- </span></dt><dt><span class="refentrytitle"><a href="API-sprint-ubacktrace.html"><span>function::sprint_ubacktrace</span></a></span><span class="refpurpose"> —
- Return stack back trace for current user-space task as string.
- </span></dt><dt><span class="refentrytitle"><a href="API-sprint-ustack.html"><span>function::sprint_ustack</span></a></span><span class="refpurpose"> —
- Return stack for the current task from string.
- </span></dt><dt><span class="refentrytitle"><a href="API-sprint-usyms.html"><span>function::sprint_usyms</span></a></span><span class="refpurpose"> —
- Return stack for user addresses from string
- </span></dt><dt><span class="refentrytitle"><a href="API-stack.html"><span>function::stack</span></a></span><span class="refpurpose"> —
- Return address at given depth of kernel stack backtrace
- </span></dt><dt><span class="refentrytitle"><a href="API-stack-size.html"><span>function::stack_size</span></a></span><span class="refpurpose"> —
- Return the size of the kernel stack
- </span></dt><dt><span class="refentrytitle"><a href="API-stack-unused.html"><span>function::stack_unused</span></a></span><span class="refpurpose"> —
- Returns the amount of kernel stack currently available
- </span></dt><dt><span class="refentrytitle"><a href="API-stack-used.html"><span>function::stack_used</span></a></span><span class="refpurpose"> —
- Returns the amount of kernel stack used
- </span></dt><dt><span class="refentrytitle"><a href="API-stp-pid.html"><span>function::stp_pid</span></a></span><span class="refpurpose"> —
- The process id of the stapio process
- </span></dt><dt><span class="refentrytitle"><a href="API-symdata.html"><span>function::symdata</span></a></span><span class="refpurpose"> —
- Return the kernel symbol and module offset for the address
- </span></dt><dt><span class="refentrytitle"><a href="API-symname.html"><span>function::symname</span></a></span><span class="refpurpose"> —
- Return the kernel symbol associated with the given address
- </span></dt><dt><span class="refentrytitle"><a href="API-target.html"><span>function::target</span></a></span><span class="refpurpose"> —
- Return the process ID of the target process
- </span></dt><dt><span class="refentrytitle"><a href="API-task-backtrace.html"><span>function::task_backtrace</span></a></span><span class="refpurpose"> —
- Hex backtrace of an arbitrary task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-cpu.html"><span>function::task_cpu</span></a></span><span class="refpurpose"> —
- The scheduled cpu of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-current.html"><span>function::task_current</span></a></span><span class="refpurpose"> —
- The current task_struct of the current task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-egid.html"><span>function::task_egid</span></a></span><span class="refpurpose"> —
- The effective group identifier of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-euid.html"><span>function::task_euid</span></a></span><span class="refpurpose"> —
- The effective user identifier of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-execname.html"><span>function::task_execname</span></a></span><span class="refpurpose"> —
- The name of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-gid.html"><span>function::task_gid</span></a></span><span class="refpurpose"> —
- The group identifier of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-max-file-handles.html"><span>function::task_max_file_handles</span></a></span><span class="refpurpose"> —
- The max number of open files for the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-nice.html"><span>function::task_nice</span></a></span><span class="refpurpose"> —
- The nice value of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-open-file-handles.html"><span>function::task_open_file_handles</span></a></span><span class="refpurpose"> —
- The number of open files of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-parent.html"><span>function::task_parent</span></a></span><span class="refpurpose"> —
- The task_struct of the parent task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-pid.html"><span>function::task_pid</span></a></span><span class="refpurpose"> —
- The process identifier of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-prio.html"><span>function::task_prio</span></a></span><span class="refpurpose"> —
- The priority value of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-state.html"><span>function::task_state</span></a></span><span class="refpurpose"> —
- The state of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-tid.html"><span>function::task_tid</span></a></span><span class="refpurpose"> —
- The thread identifier of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-uid.html"><span>function::task_uid</span></a></span><span class="refpurpose"> —
- The user identifier of the task
- </span></dt><dt><span class="refentrytitle"><a href="API-tid.html"><span>function::tid</span></a></span><span class="refpurpose"> —
- Returns the thread ID of a target process
- </span></dt><dt><span class="refentrytitle"><a href="API-u32-arg.html"><span>function::u32_arg</span></a></span><span class="refpurpose"> —
- Return function argument as unsigned 32-bit value
- </span></dt><dt><span class="refentrytitle"><a href="API-u64-arg.html"><span>function::u64_arg</span></a></span><span class="refpurpose"> —
- Return function argument as unsigned 64-bit value
- </span></dt><dt><span class="refentrytitle"><a href="API-u-register.html"><span>function::u_register</span></a></span><span class="refpurpose"> —
- Return the unsigned value of the named CPU register
- </span></dt><dt><span class="refentrytitle"><a href="API-uaddr.html"><span>function::uaddr</span></a></span><span class="refpurpose"> —
- User space address of current running task
- </span></dt><dt><span class="refentrytitle"><a href="API-ubacktrace.html"><span>function::ubacktrace</span></a></span><span class="refpurpose"> —
- Hex backtrace of current user-space task stack.
- </span></dt><dt><span class="refentrytitle"><a href="API-ucallers.html"><span>function::ucallers</span></a></span><span class="refpurpose"> —
- Return first n elements of user stack backtrace
- </span></dt><dt><span class="refentrytitle"><a href="API-uid.html"><span>function::uid</span></a></span><span class="refpurpose"> —
- Returns the user ID of a target process
- </span></dt><dt><span class="refentrytitle"><a href="API-uint-arg.html"><span>function::uint_arg</span></a></span><span class="refpurpose"> —
- Return function argument as unsigned int
- </span></dt><dt><span class="refentrytitle"><a href="API-ulong-arg.html"><span>function::ulong_arg</span></a></span><span class="refpurpose"> —
- Return function argument as unsigned long
- </span></dt><dt><span class="refentrytitle"><a href="API-ulonglong-arg.html"><span>function::ulonglong_arg</span></a></span><span class="refpurpose"> —
- Return function argument as 64-bit value
- </span></dt><dt><span class="refentrytitle"><a href="API-umodname.html"><span>function::umodname</span></a></span><span class="refpurpose"> —
- Returns the (short) name of the user module.
- </span></dt><dt><span class="refentrytitle"><a href="API-user-mode.html"><span>function::user_mode</span></a></span><span class="refpurpose"> —
- Determines if probe point occurs in user-mode
- </span></dt><dt><span class="refentrytitle"><a href="API-ustack.html"><span>function::ustack</span></a></span><span class="refpurpose"> —
- Return address at given depth of user stack backtrace
- </span></dt><dt><span class="refentrytitle"><a href="API-usymdata.html"><span>function::usymdata</span></a></span><span class="refpurpose"> —
- Return the symbol and module offset of an address.
- </span></dt><dt><span class="refentrytitle"><a href="API-usymname.html"><span>function::usymname</span></a></span><span class="refpurpose"> —
- Return the symbol of an address in the current task.
- </span></dt></dl></dd><dt><span class="chapter"><a href="timestamp_stp.html">3. Timestamp Functions</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-HZ.html"><span>function::HZ</span></a></span><span class="refpurpose"> —
- Kernel HZ
- </span></dt><dt><span class="refentrytitle"><a href="API-cpu-clock-ms.html"><span>function::cpu_clock_ms</span></a></span><span class="refpurpose"> —
- Number of milliseconds on the given cpu's clock
- </span></dt><dt><span class="refentrytitle"><a href="API-cpu-clock-ns.html"><span>function::cpu_clock_ns</span></a></span><span class="refpurpose"> —
- Number of nanoseconds on the given cpu's clock
- </span></dt><dt><span class="refentrytitle"><a href="API-cpu-clock-s.html"><span>function::cpu_clock_s</span></a></span><span class="refpurpose"> —
- Number of seconds on the given cpu's clock
- </span></dt><dt><span class="refentrytitle"><a href="API-cpu-clock-us.html"><span>function::cpu_clock_us</span></a></span><span class="refpurpose"> —
- Number of microseconds on the given cpu's clock
- </span></dt><dt><span class="refentrytitle"><a href="API-delete-stopwatch.html"><span>function::delete_stopwatch</span></a></span><span class="refpurpose"> —
- Remove an existing stopwatch
- </span></dt><dt><span class="refentrytitle"><a href="API-get-cycles.html"><span>function::get_cycles</span></a></span><span class="refpurpose"> —
- Processor cycle count
- </span></dt><dt><span class="refentrytitle"><a href="API-gettimeofday-ms.html"><span>function::gettimeofday_ms</span></a></span><span class="refpurpose"> —
- Number of milliseconds since UNIX epoch
- </span></dt><dt><span class="refentrytitle"><a href="API-gettimeofday-ns.html"><span>function::gettimeofday_ns</span></a></span><span class="refpurpose"> —
- Number of nanoseconds since UNIX epoch
- </span></dt><dt><span class="refentrytitle"><a href="API-gettimeofday-s.html"><span>function::gettimeofday_s</span></a></span><span class="refpurpose"> —
- Number of seconds since UNIX epoch
- </span></dt><dt><span class="refentrytitle"><a href="API-gettimeofday-us.html"><span>function::gettimeofday_us</span></a></span><span class="refpurpose"> —
- Number of microseconds since UNIX epoch
- </span></dt><dt><span class="refentrytitle"><a href="API-jiffies.html"><span>function::jiffies</span></a></span><span class="refpurpose"> —
- Kernel jiffies count
- </span></dt><dt><span class="refentrytitle"><a href="API-local-clock-ms.html"><span>function::local_clock_ms</span></a></span><span class="refpurpose"> —
- Number of milliseconds on the local cpu's clock
- </span></dt><dt><span class="refentrytitle"><a href="API-local-clock-ns.html"><span>function::local_clock_ns</span></a></span><span class="refpurpose"> —
- Number of nanoseconds on the local cpu's clock
- </span></dt><dt><span class="refentrytitle"><a href="API-local-clock-s.html"><span>function::local_clock_s</span></a></span><span class="refpurpose"> —
- Number of seconds on the local cpu's clock
- </span></dt><dt><span class="refentrytitle"><a href="API-local-clock-us.html"><span>function::local_clock_us</span></a></span><span class="refpurpose"> —
- Number of microseconds on the local cpu's clock
- </span></dt><dt><span class="refentrytitle"><a href="API-read-stopwatch-ms.html"><span>function::read_stopwatch_ms</span></a></span><span class="refpurpose"> —
- Reads the time in milliseconds for a stopwatch
- </span></dt><dt><span class="refentrytitle"><a href="API-read-stopwatch-ns.html"><span>function::read_stopwatch_ns</span></a></span><span class="refpurpose"> —
- Reads the time in nanoseconds for a stopwatch
- </span></dt><dt><span class="refentrytitle"><a href="API-read-stopwatch-s.html"><span>function::read_stopwatch_s</span></a></span><span class="refpurpose"> —
- Reads the time in seconds for a stopwatch
- </span></dt><dt><span class="refentrytitle"><a href="API-read-stopwatch-us.html"><span>function::read_stopwatch_us</span></a></span><span class="refpurpose"> —
- Reads the time in microseconds for a stopwatch
- </span></dt><dt><span class="refentrytitle"><a href="API-start-stopwatch.html"><span>function::start_stopwatch</span></a></span><span class="refpurpose"> —
- Start a stopwatch
- </span></dt><dt><span class="refentrytitle"><a href="API-stop-stopwatch.html"><span>function::stop_stopwatch</span></a></span><span class="refpurpose"> —
- Stop a stopwatch
- </span></dt></dl></dd><dt><span class="chapter"><a href="ctime.stp.html">4. Time utility functions</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-ctime.html"><span>function::ctime</span></a></span><span class="refpurpose"> —
- Convert seconds since epoch into human readable date/time string
- </span></dt><dt><span class="refentrytitle"><a href="API-tz-ctime.html"><span>function::tz_ctime</span></a></span><span class="refpurpose"> —
- Convert seconds since epoch into human readable date/time string, with local time zone
- </span></dt><dt><span class="refentrytitle"><a href="API-tz-gmtoff.html"><span>function::tz_gmtoff</span></a></span><span class="refpurpose"> —
- Return local time zone offset
- </span></dt><dt><span class="refentrytitle"><a href="API-tz-name.html"><span>function::tz_name</span></a></span><span class="refpurpose"> —
- Return local time zone name
- </span></dt></dl></dd><dt><span class="chapter"><a href="system.stp.html">5. Shell command functions</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-system.html"><span>function::system</span></a></span><span class="refpurpose"> —
- Issue a command to the system
- </span></dt></dl></dd><dt><span class="chapter"><a href="memory_stp.html">6. Memory Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-addr-to-node.html"><span>function::addr_to_node</span></a></span><span class="refpurpose"> —
- Returns which node a given address belongs to within a NUMA system
- </span></dt><dt><span class="refentrytitle"><a href="API-bytes-to-string.html"><span>function::bytes_to_string</span></a></span><span class="refpurpose"> —
- Human readable string for given bytes
- </span></dt><dt><span class="refentrytitle"><a href="API-mem-page-size.html"><span>function::mem_page_size</span></a></span><span class="refpurpose"> —
- Number of bytes in a page for this architecture
- </span></dt><dt><span class="refentrytitle"><a href="API-pages-to-string.html"><span>function::pages_to_string</span></a></span><span class="refpurpose"> —
- Turns pages into a human readable string
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-data.html"><span>function::proc_mem_data</span></a></span><span class="refpurpose"> —
- Program data size (data + stack) in pages
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-data-pid.html"><span>function::proc_mem_data_pid</span></a></span><span class="refpurpose"> —
- Program data size (data + stack) in pages
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-rss.html"><span>function::proc_mem_rss</span></a></span><span class="refpurpose"> —
- Program resident set size in pages
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-rss-pid.html"><span>function::proc_mem_rss_pid</span></a></span><span class="refpurpose"> —
- Program resident set size in pages
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-shr.html"><span>function::proc_mem_shr</span></a></span><span class="refpurpose"> —
- Program shared pages (from shared mappings)
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-shr-pid.html"><span>function::proc_mem_shr_pid</span></a></span><span class="refpurpose"> —
- Program shared pages (from shared mappings)
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-size.html"><span>function::proc_mem_size</span></a></span><span class="refpurpose"> —
- Total program virtual memory size in pages
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-size-pid.html"><span>function::proc_mem_size_pid</span></a></span><span class="refpurpose"> —
- Total program virtual memory size in pages
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-string.html"><span>function::proc_mem_string</span></a></span><span class="refpurpose"> —
- Human readable string of current proc memory usage
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-string-pid.html"><span>function::proc_mem_string_pid</span></a></span><span class="refpurpose"> —
- Human readable string of process memory usage
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-txt.html"><span>function::proc_mem_txt</span></a></span><span class="refpurpose"> —
- Program text (code) size in pages
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-txt-pid.html"><span>function::proc_mem_txt_pid</span></a></span><span class="refpurpose"> —
- Program text (code) size in pages
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-fault-contains.html"><span>function::vm_fault_contains</span></a></span><span class="refpurpose"> —
- Test return value for page fault reason
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-brk.html"><span>probe::vm.brk</span></a></span><span class="refpurpose"> —
- Fires when a brk is requested (i.e. the heap will be resized)
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-kfree.html"><span>probe::vm.kfree</span></a></span><span class="refpurpose"> —
- Fires when kfree is requested
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-kmalloc.html"><span>probe::vm.kmalloc</span></a></span><span class="refpurpose"> —
- Fires when kmalloc is requested
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-kmalloc-node.html"><span>probe::vm.kmalloc_node</span></a></span><span class="refpurpose"> —
- Fires when kmalloc_node is requested
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-kmem-cache-alloc.html"><span>probe::vm.kmem_cache_alloc</span></a></span><span class="refpurpose"> —
- Fires when kmem_cache_alloc is requested
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-kmem-cache-alloc-node.html"><span>probe::vm.kmem_cache_alloc_node</span></a></span><span class="refpurpose"> —
- Fires when kmem_cache_alloc_node is requested
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-kmem-cache-free.html"><span>probe::vm.kmem_cache_free</span></a></span><span class="refpurpose"> —
- Fires when kmem_cache_free is requested
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-mmap.html"><span>probe::vm.mmap</span></a></span><span class="refpurpose"> —
- Fires when an mmap is requested
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-munmap.html"><span>probe::vm.munmap</span></a></span><span class="refpurpose"> —
- Fires when an munmap is requested
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-oom-kill.html"><span>probe::vm.oom_kill</span></a></span><span class="refpurpose"> —
- Fires when a thread is selected for termination by the OOM killer
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-pagefault.html"><span>probe::vm.pagefault</span></a></span><span class="refpurpose"> —
- Records that a page fault occurred
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-pagefault-return.html"><span>probe::vm.pagefault.return</span></a></span><span class="refpurpose"> —
- Indicates what type of fault occurred
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-write-shared.html"><span>probe::vm.write_shared</span></a></span><span class="refpurpose"> —
- Attempts at writing to a shared page
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-write-shared-copy.html"><span>probe::vm.write_shared_copy</span></a></span><span class="refpurpose"> —
- Page copy for shared page write
- </span></dt></dl></dd><dt><span class="chapter"><a href="task_time_stp.html">7. Task Time Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-cputime-to-msecs.html"><span>function::cputime_to_msecs</span></a></span><span class="refpurpose"> —
- Translates the given cputime into milliseconds
- </span></dt><dt><span class="refentrytitle"><a href="API-cputime-to-string.html"><span>function::cputime_to_string</span></a></span><span class="refpurpose"> —
- Human readable string for given cputime
- </span></dt><dt><span class="refentrytitle"><a href="API-msecs-to-string.html"><span>function::msecs_to_string</span></a></span><span class="refpurpose"> —
- Human readable string for given milliseconds
- </span></dt><dt><span class="refentrytitle"><a href="API-task-stime.html"><span>function::task_stime</span></a></span><span class="refpurpose"> —
- System time of the current task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-stime-tid.html"><span>function::task_stime_tid</span></a></span><span class="refpurpose"> —
- System time of the given task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-time-string.html"><span>function::task_time_string</span></a></span><span class="refpurpose"> —
- Human readable string of task time usage
- </span></dt><dt><span class="refentrytitle"><a href="API-task-time-string-tid.html"><span>function::task_time_string_tid</span></a></span><span class="refpurpose"> —
- Human readable string of task time usage
- </span></dt><dt><span class="refentrytitle"><a href="API-task-utime.html"><span>function::task_utime</span></a></span><span class="refpurpose"> —
- User time of the current task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-utime-tid.html"><span>function::task_utime_tid</span></a></span><span class="refpurpose"> —
- User time of the given task
- </span></dt></dl></dd><dt><span class="chapter"><a href="sched.stp.html">8. Scheduler Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-scheduler-balance.html"><span>probe::scheduler.balance</span></a></span><span class="refpurpose"> —
- A cpu attempting to find more work.
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-cpu-off.html"><span>probe::scheduler.cpu_off</span></a></span><span class="refpurpose"> —
- Process is about to stop running on a cpu
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-cpu-on.html"><span>probe::scheduler.cpu_on</span></a></span><span class="refpurpose"> —
- Process is beginning execution on a cpu
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-ctxswitch.html"><span>probe::scheduler.ctxswitch</span></a></span><span class="refpurpose"> —
- A context switch is occuring.
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-kthread-stop.html"><span>probe::scheduler.kthread_stop</span></a></span><span class="refpurpose"> —
- A thread created by kthread_create is being stopped
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-kthread-stop-return.html"><span>probe::scheduler.kthread_stop.return</span></a></span><span class="refpurpose"> —
- A kthread is stopped and gets the return value
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-migrate.html"><span>probe::scheduler.migrate</span></a></span><span class="refpurpose"> —
- Task migrating across cpus
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-process-exit.html"><span>probe::scheduler.process_exit</span></a></span><span class="refpurpose"> —
- Process exiting
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-process-fork.html"><span>probe::scheduler.process_fork</span></a></span><span class="refpurpose"> —
- Process forked
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-process-free.html"><span>probe::scheduler.process_free</span></a></span><span class="refpurpose"> —
- Scheduler freeing a data structure for a process
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-process-wait.html"><span>probe::scheduler.process_wait</span></a></span><span class="refpurpose"> —
- Scheduler starting to wait on a process
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-signal-send.html"><span>probe::scheduler.signal_send</span></a></span><span class="refpurpose"> —
- Sending a signal
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-tick.html"><span>probe::scheduler.tick</span></a></span><span class="refpurpose"> —
- Schedulers internal tick, a processes timeslice accounting is updated
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-wait-task.html"><span>probe::scheduler.wait_task</span></a></span><span class="refpurpose"> —
- Waiting on a task to unschedule (become inactive)
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-wakeup.html"><span>probe::scheduler.wakeup</span></a></span><span class="refpurpose"> —
- Task is woken up
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-wakeup-new.html"><span>probe::scheduler.wakeup_new</span></a></span><span class="refpurpose"> —
- Newly created task is woken up for the first time
- </span></dt></dl></dd><dt><span class="chapter"><a href="iosched.stp.html">9. IO Scheduler and block IO Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-ioblock-end.html"><span>probe::ioblock.end</span></a></span><span class="refpurpose"> —
- Fires whenever a block I/O transfer is complete.
- </span></dt><dt><span class="refentrytitle"><a href="API-ioblock-request.html"><span>probe::ioblock.request</span></a></span><span class="refpurpose"> —
- Fires whenever making a generic block I/O request.
- </span></dt><dt><span class="refentrytitle"><a href="API-ioblock-trace-bounce.html"><span>probe::ioblock_trace.bounce</span></a></span><span class="refpurpose"> —
- Fires whenever a buffer bounce is needed for at least one page of a block IO request.
- </span></dt><dt><span class="refentrytitle"><a href="API-ioblock-trace-end.html"><span>probe::ioblock_trace.end</span></a></span><span class="refpurpose"> —
- Fires whenever a block I/O transfer is complete.
- </span></dt><dt><span class="refentrytitle"><a href="API-ioblock-trace-request.html"><span>probe::ioblock_trace.request</span></a></span><span class="refpurpose"> —
- Fires just as a generic block I/O request is created for a bio.
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-elv-add-request.html"><span>probe::ioscheduler.elv_add_request</span></a></span><span class="refpurpose"> —
- probe to indicate request is added to the request queue.
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-elv-add-request-kp.html"><span>probe::ioscheduler.elv_add_request.kp</span></a></span><span class="refpurpose"> —
- kprobe based probe to indicate that a request was added to the request queue
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-elv-add-request-tp.html"><span>probe::ioscheduler.elv_add_request.tp</span></a></span><span class="refpurpose"> —
- tracepoint based probe to indicate a request is added to the request queue.
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-elv-completed-request.html"><span>probe::ioscheduler.elv_completed_request</span></a></span><span class="refpurpose"> —
- Fires when a request is completed
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-elv-next-request.html"><span>probe::ioscheduler.elv_next_request</span></a></span><span class="refpurpose"> —
- Fires when a request is retrieved from the request queue
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-elv-next-request-return.html"><span>probe::ioscheduler.elv_next_request.return</span></a></span><span class="refpurpose"> —
- Fires when a request retrieval issues a return signal
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-trace-elv-abort-request.html"><span>probe::ioscheduler_trace.elv_abort_request</span></a></span><span class="refpurpose"> —
- Fires when a request is aborted.
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-trace-elv-completed-request.html"><span>probe::ioscheduler_trace.elv_completed_request</span></a></span><span class="refpurpose"> —
- Fires when a request is
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-trace-elv-issue-request.html"><span>probe::ioscheduler_trace.elv_issue_request</span></a></span><span class="refpurpose"> —
- Fires when a request is
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-trace-elv-requeue-request.html"><span>probe::ioscheduler_trace.elv_requeue_request</span></a></span><span class="refpurpose"> —
- Fires when a request is
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-trace-plug.html"><span>probe::ioscheduler_trace.plug</span></a></span><span class="refpurpose"> —
- Fires when a request queue is plugged;
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-trace-unplug-io.html"><span>probe::ioscheduler_trace.unplug_io</span></a></span><span class="refpurpose"> —
- Fires when a request queue is unplugged;
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-trace-unplug-timer.html"><span>probe::ioscheduler_trace.unplug_timer</span></a></span><span class="refpurpose"> —
- Fires when unplug timer associated
- </span></dt></dl></dd><dt><span class="chapter"><a href="scsi.stp.html">10. SCSI Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-scsi-iocompleted.html"><span>probe::scsi.iocompleted</span></a></span><span class="refpurpose"> —
- SCSI mid-layer running the completion processing for block device I/O requests
- </span></dt><dt><span class="refentrytitle"><a href="API-scsi-iodispatching.html"><span>probe::scsi.iodispatching</span></a></span><span class="refpurpose"> —
- SCSI mid-layer dispatched low-level SCSI command
- </span></dt><dt><span class="refentrytitle"><a href="API-scsi-iodone.html"><span>probe::scsi.iodone</span></a></span><span class="refpurpose"> —
- SCSI command completed by low level driver and enqueued into the done queue.
- </span></dt><dt><span class="refentrytitle"><a href="API-scsi-ioentry.html"><span>probe::scsi.ioentry</span></a></span><span class="refpurpose"> —
- Prepares a SCSI mid-layer request
- </span></dt><dt><span class="refentrytitle"><a href="API-scsi-ioexecute.html"><span>probe::scsi.ioexecute</span></a></span><span class="refpurpose"> —
- Create mid-layer SCSI request and wait for the result
- </span></dt><dt><span class="refentrytitle"><a href="API-scsi-set-state.html"><span>probe::scsi.set_state</span></a></span><span class="refpurpose"> —
- Order SCSI device state change
- </span></dt></dl></dd><dt><span class="chapter"><a href="tty.stp.html">11. TTY Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-tty-init.html"><span>probe::tty.init</span></a></span><span class="refpurpose"> —
- Called when a tty is being initalized
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-ioctl.html"><span>probe::tty.ioctl</span></a></span><span class="refpurpose"> —
- called when a ioctl is request to the tty
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-open.html"><span>probe::tty.open</span></a></span><span class="refpurpose"> —
- Called when a tty is opened
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-poll.html"><span>probe::tty.poll</span></a></span><span class="refpurpose"> —
- Called when a tty device is being polled
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-read.html"><span>probe::tty.read</span></a></span><span class="refpurpose"> —
- called when a tty line will be read
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-receive.html"><span>probe::tty.receive</span></a></span><span class="refpurpose"> —
- called when a tty receives a message
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-register.html"><span>probe::tty.register</span></a></span><span class="refpurpose"> —
- Called when a tty device is registred
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-release.html"><span>probe::tty.release</span></a></span><span class="refpurpose"> —
- Called when the tty is closed
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-resize.html"><span>probe::tty.resize</span></a></span><span class="refpurpose"> —
- Called when a terminal resize happens
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-unregister.html"><span>probe::tty.unregister</span></a></span><span class="refpurpose"> —
- Called when a tty device is being unregistered
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-write.html"><span>probe::tty.write</span></a></span><span class="refpurpose"> —
- write to the tty line
- </span></dt></dl></dd><dt><span class="chapter"><a href="irq.stp.html">12. Interrupt Request (IRQ) Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-irq-handler-entry.html"><span>probe::irq_handler.entry</span></a></span><span class="refpurpose"> —
- Execution of interrupt handler starting
- </span></dt><dt><span class="refentrytitle"><a href="API-irq-handler-exit.html"><span>probe::irq_handler.exit</span></a></span><span class="refpurpose"> —
- Execution of interrupt handler completed
- </span></dt><dt><span class="refentrytitle"><a href="API-softirq-entry.html"><span>probe::softirq.entry</span></a></span><span class="refpurpose"> —
- Execution of handler for a pending softirq starting
- </span></dt><dt><span class="refentrytitle"><a href="API-softirq-exit.html"><span>probe::softirq.exit</span></a></span><span class="refpurpose"> —
- Execution of handler for a pending softirq completed
- </span></dt><dt><span class="refentrytitle"><a href="API-workqueue-create.html"><span>probe::workqueue.create</span></a></span><span class="refpurpose"> —
- Creating a new workqueue
- </span></dt><dt><span class="refentrytitle"><a href="API-workqueue-destroy.html"><span>probe::workqueue.destroy</span></a></span><span class="refpurpose"> —
- Destroying workqueue
- </span></dt><dt><span class="refentrytitle"><a href="API-workqueue-execute.html"><span>probe::workqueue.execute</span></a></span><span class="refpurpose"> —
- Executing deferred work
- </span></dt><dt><span class="refentrytitle"><a href="API-workqueue-insert.html"><span>probe::workqueue.insert</span></a></span><span class="refpurpose"> —
- Queuing work on a workqueue
- </span></dt></dl></dd><dt><span class="chapter"><a href="networking.stp.html">13. Networking Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-format-ipaddr.html"><span>function::format_ipaddr</span></a></span><span class="refpurpose"> —
- Returns a string representation for an IP address
- </span></dt><dt><span class="refentrytitle"><a href="API-htonl.html"><span>function::htonl</span></a></span><span class="refpurpose"> —
- Convert 32-bit long from host to network order
- </span></dt><dt><span class="refentrytitle"><a href="API-htonll.html"><span>function::htonll</span></a></span><span class="refpurpose"> —
- Convert 64-bit long long from host to network order
- </span></dt><dt><span class="refentrytitle"><a href="API-htons.html"><span>function::htons</span></a></span><span class="refpurpose"> —
- Convert 16-bit short from host to network order
- </span></dt><dt><span class="refentrytitle"><a href="API-ip-ntop.html"><span>function::ip_ntop</span></a></span><span class="refpurpose"> —
- Returns a string representation for an IPv4 address
- </span></dt><dt><span class="refentrytitle"><a href="API-ntohl.html"><span>function::ntohl</span></a></span><span class="refpurpose"> —
- Convert 32-bit long from network to host order
- </span></dt><dt><span class="refentrytitle"><a href="API-ntohll.html"><span>function::ntohll</span></a></span><span class="refpurpose"> —
- Convert 64-bit long long from network to host order
- </span></dt><dt><span class="refentrytitle"><a href="API-ntohs.html"><span>function::ntohs</span></a></span><span class="refpurpose"> —
- Convert 16-bit short from network to host order
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-change-mac.html"><span>probe::netdev.change_mac</span></a></span><span class="refpurpose"> —
- Called when the netdev_name has the MAC changed
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-change-mtu.html"><span>probe::netdev.change_mtu</span></a></span><span class="refpurpose"> —
- Called when the netdev MTU is changed
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-change-rx-flag.html"><span>probe::netdev.change_rx_flag</span></a></span><span class="refpurpose"> —
- Called when the device RX flag will be changed
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-close.html"><span>probe::netdev.close</span></a></span><span class="refpurpose"> —
- Called when the device is closed
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-get-stats.html"><span>probe::netdev.get_stats</span></a></span><span class="refpurpose"> —
- Called when someone asks the device statistics
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-hard-transmit.html"><span>probe::netdev.hard_transmit</span></a></span><span class="refpurpose"> —
- Called when the devices is going to TX (hard)
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-ioctl.html"><span>probe::netdev.ioctl</span></a></span><span class="refpurpose"> —
- Called when the device suffers an IOCTL
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-open.html"><span>probe::netdev.open</span></a></span><span class="refpurpose"> —
- Called when the device is opened
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-receive.html"><span>probe::netdev.receive</span></a></span><span class="refpurpose"> —
- Data received from network device.
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-register.html"><span>probe::netdev.register</span></a></span><span class="refpurpose"> —
- Called when the device is registered
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-rx.html"><span>probe::netdev.rx</span></a></span><span class="refpurpose"> —
- Called when the device is going to receive a packet
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-set-promiscuity.html"><span>probe::netdev.set_promiscuity</span></a></span><span class="refpurpose"> —
- Called when the device enters/leaves promiscuity
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-transmit.html"><span>probe::netdev.transmit</span></a></span><span class="refpurpose"> —
- Network device transmitting buffer
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-unregister.html"><span>probe::netdev.unregister</span></a></span><span class="refpurpose"> —
- Called when the device is being unregistered
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-arp-forward.html"><span>probe::netfilter.arp.forward</span></a></span><span class="refpurpose"> —
- - Called for each ARP packet to be forwarded
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-arp-in.html"><span>probe::netfilter.arp.in</span></a></span><span class="refpurpose"> —
- - Called for each incoming ARP packet
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-arp-out.html"><span>probe::netfilter.arp.out</span></a></span><span class="refpurpose"> —
- - Called for each outgoing ARP packet
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-bridge-forward.html"><span>probe::netfilter.bridge.forward</span></a></span><span class="refpurpose"> —
- Called on an incoming bridging packet destined for some other computer
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-bridge-local-in.html"><span>probe::netfilter.bridge.local_in</span></a></span><span class="refpurpose"> —
- Called on a bridging packet destined for the local computer
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-bridge-local-out.html"><span>probe::netfilter.bridge.local_out</span></a></span><span class="refpurpose"> —
- Called on a bridging packet coming from a local process
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-bridge-post-routing.html"><span>probe::netfilter.bridge.post_routing</span></a></span><span class="refpurpose"> —
- - Called before a bridging packet hits the wire
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-bridge-pre-routing.html"><span>probe::netfilter.bridge.pre_routing</span></a></span><span class="refpurpose"> —
- - Called before a bridging packet is routed
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-ip-forward.html"><span>probe::netfilter.ip.forward</span></a></span><span class="refpurpose"> —
- Called on an incoming IP packet addressed to some other computer
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-ip-local-in.html"><span>probe::netfilter.ip.local_in</span></a></span><span class="refpurpose"> —
- Called on an incoming IP packet addressed to the local computer
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-ip-local-out.html"><span>probe::netfilter.ip.local_out</span></a></span><span class="refpurpose"> —
- Called on an outgoing IP packet
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-ip-post-routing.html"><span>probe::netfilter.ip.post_routing</span></a></span><span class="refpurpose"> —
- Called immediately before an outgoing IP packet leaves the computer
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-ip-pre-routing.html"><span>probe::netfilter.ip.pre_routing</span></a></span><span class="refpurpose"> —
- Called before an IP packet is routed
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-clnt-bind-new-program.html"><span>probe::sunrpc.clnt.bind_new_program</span></a></span><span class="refpurpose"> —
- Bind a new RPC program to an existing client
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-clnt-call-async.html"><span>probe::sunrpc.clnt.call_async</span></a></span><span class="refpurpose"> —
- Make an asynchronous RPC call
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-clnt-call-sync.html"><span>probe::sunrpc.clnt.call_sync</span></a></span><span class="refpurpose"> —
- Make a synchronous RPC call
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-clnt-clone-client.html"><span>probe::sunrpc.clnt.clone_client</span></a></span><span class="refpurpose"> —
- Clone an RPC client structure
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-clnt-create-client.html"><span>probe::sunrpc.clnt.create_client</span></a></span><span class="refpurpose"> —
- Create an RPC client
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-clnt-restart-call.html"><span>probe::sunrpc.clnt.restart_call</span></a></span><span class="refpurpose"> —
- Restart an asynchronous RPC call
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-clnt-shutdown-client.html"><span>probe::sunrpc.clnt.shutdown_client</span></a></span><span class="refpurpose"> —
- Shutdown an RPC client
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-sched-delay.html"><span>probe::sunrpc.sched.delay</span></a></span><span class="refpurpose"> —
- Delay an RPC task
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-sched-execute.html"><span>probe::sunrpc.sched.execute</span></a></span><span class="refpurpose"> —
- Execute the RPC `scheduler'
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-sched-new-task.html"><span>probe::sunrpc.sched.new_task</span></a></span><span class="refpurpose"> —
- Create new task for the specified client
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-sched-release-task.html"><span>probe::sunrpc.sched.release_task</span></a></span><span class="refpurpose"> —
- Release all resources associated with a task
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-svc-create.html"><span>probe::sunrpc.svc.create</span></a></span><span class="refpurpose"> —
- Create an RPC service
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-svc-destroy.html"><span>probe::sunrpc.svc.destroy</span></a></span><span class="refpurpose"> —
- Destroy an RPC service
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-svc-drop.html"><span>probe::sunrpc.svc.drop</span></a></span><span class="refpurpose"> —
- Drop RPC request
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-svc-process.html"><span>probe::sunrpc.svc.process</span></a></span><span class="refpurpose"> —
- Process an RPC request
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-svc-recv.html"><span>probe::sunrpc.svc.recv</span></a></span><span class="refpurpose"> —
- Listen for the next RPC request on any socket
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-svc-register.html"><span>probe::sunrpc.svc.register</span></a></span><span class="refpurpose"> —
- Register an RPC service with the local portmapper
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-svc-send.html"><span>probe::sunrpc.svc.send</span></a></span><span class="refpurpose"> —
- Return reply to RPC client
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-disconnect.html"><span>probe::tcp.disconnect</span></a></span><span class="refpurpose"> —
- TCP socket disconnection
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-disconnect-return.html"><span>probe::tcp.disconnect.return</span></a></span><span class="refpurpose"> —
- TCP socket disconnection complete
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-receive.html"><span>probe::tcp.receive</span></a></span><span class="refpurpose"> —
- Called when a TCP packet is received
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-recvmsg.html"><span>probe::tcp.recvmsg</span></a></span><span class="refpurpose"> —
- Receiving TCP message
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-recvmsg-return.html"><span>probe::tcp.recvmsg.return</span></a></span><span class="refpurpose"> —
- Receiving TCP message complete
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-sendmsg.html"><span>probe::tcp.sendmsg</span></a></span><span class="refpurpose"> —
- Sending a tcp message
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-sendmsg-return.html"><span>probe::tcp.sendmsg.return</span></a></span><span class="refpurpose"> —
- Sending TCP message is done
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-setsockopt.html"><span>probe::tcp.setsockopt</span></a></span><span class="refpurpose"> —
- Call to <code class="function">setsockopt</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-setsockopt-return.html"><span>probe::tcp.setsockopt.return</span></a></span><span class="refpurpose"> —
- Return from <code class="function">setsockopt</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-udp-disconnect.html"><span>probe::udp.disconnect</span></a></span><span class="refpurpose"> —
- Fires when a process requests for a UDP disconnection
- </span></dt><dt><span class="refentrytitle"><a href="API-udp-disconnect-return.html"><span>probe::udp.disconnect.return</span></a></span><span class="refpurpose"> —
- UDP has been disconnected successfully
- </span></dt><dt><span class="refentrytitle"><a href="API-udp-recvmsg.html"><span>probe::udp.recvmsg</span></a></span><span class="refpurpose"> —
- Fires whenever a UDP message is received
- </span></dt><dt><span class="refentrytitle"><a href="API-udp-recvmsg-return.html"><span>probe::udp.recvmsg.return</span></a></span><span class="refpurpose"> —
- Fires whenever an attempt to receive a UDP message received is completed
- </span></dt><dt><span class="refentrytitle"><a href="API-udp-sendmsg.html"><span>probe::udp.sendmsg</span></a></span><span class="refpurpose"> —
- Fires whenever a process sends a UDP message
- </span></dt><dt><span class="refentrytitle"><a href="API-udp-sendmsg-return.html"><span>probe::udp.sendmsg.return</span></a></span><span class="refpurpose"> —
- Fires whenever an attempt to send a UDP message is completed
- </span></dt></dl></dd><dt><span class="chapter"><a href="socket.stp.html">14. Socket Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-inet-get-ip-source.html"><span>function::inet_get_ip_source</span></a></span><span class="refpurpose"> —
- Provide IP source address string for a kernel socket
- </span></dt><dt><span class="refentrytitle"><a href="API-inet-get-local-port.html"><span>function::inet_get_local_port</span></a></span><span class="refpurpose"> —
- Provide local port number for a kernel socket
- </span></dt><dt><span class="refentrytitle"><a href="API-sock-fam-num2str.html"><span>function::sock_fam_num2str</span></a></span><span class="refpurpose"> —
- Given a protocol family number, return a string representation
- </span></dt><dt><span class="refentrytitle"><a href="API-sock-fam-str2num.html"><span>function::sock_fam_str2num</span></a></span><span class="refpurpose"> —
- Given a protocol family name (string), return the corresponding protocol family number
- </span></dt><dt><span class="refentrytitle"><a href="API-sock-prot-num2str.html"><span>function::sock_prot_num2str</span></a></span><span class="refpurpose"> —
- Given a protocol number, return a string representation
- </span></dt><dt><span class="refentrytitle"><a href="API-sock-prot-str2num.html"><span>function::sock_prot_str2num</span></a></span><span class="refpurpose"> —
- Given a protocol name (string), return the corresponding protocol number
- </span></dt><dt><span class="refentrytitle"><a href="API-sock-state-num2str.html"><span>function::sock_state_num2str</span></a></span><span class="refpurpose"> —
- Given a socket state number, return a string representation
- </span></dt><dt><span class="refentrytitle"><a href="API-sock-state-str2num.html"><span>function::sock_state_str2num</span></a></span><span class="refpurpose"> —
- Given a socket state string, return the corresponding state number
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-aio-read.html"><span>probe::socket.aio_read</span></a></span><span class="refpurpose"> —
- Receiving message via <code class="function">sock_aio_read</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-aio-read-return.html"><span>probe::socket.aio_read.return</span></a></span><span class="refpurpose"> —
- Conclusion of message received via <code class="function">sock_aio_read</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-aio-write.html"><span>probe::socket.aio_write</span></a></span><span class="refpurpose"> —
- Message send via <code class="function">sock_aio_write</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-aio-write-return.html"><span>probe::socket.aio_write.return</span></a></span><span class="refpurpose"> —
- Conclusion of message send via <code class="function">sock_aio_write</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-close.html"><span>probe::socket.close</span></a></span><span class="refpurpose"> —
- Close a socket
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-close-return.html"><span>probe::socket.close.return</span></a></span><span class="refpurpose"> —
- Return from closing a socket
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-create.html"><span>probe::socket.create</span></a></span><span class="refpurpose"> —
- Creation of a socket
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-create-return.html"><span>probe::socket.create.return</span></a></span><span class="refpurpose"> —
- Return from Creation of a socket
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-readv.html"><span>probe::socket.readv</span></a></span><span class="refpurpose"> —
- Receiving a message via <code class="function">sock_readv</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-readv-return.html"><span>probe::socket.readv.return</span></a></span><span class="refpurpose"> —
- Conclusion of receiving a message via <code class="function">sock_readv</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-receive.html"><span>probe::socket.receive</span></a></span><span class="refpurpose"> —
- Message received on a socket.
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-recvmsg.html"><span>probe::socket.recvmsg</span></a></span><span class="refpurpose"> —
- Message being received on socket
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-recvmsg-return.html"><span>probe::socket.recvmsg.return</span></a></span><span class="refpurpose"> —
- Return from Message being received on socket
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-send.html"><span>probe::socket.send</span></a></span><span class="refpurpose"> —
- Message sent on a socket.
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-sendmsg.html"><span>probe::socket.sendmsg</span></a></span><span class="refpurpose"> —
- Message is currently being sent on a socket.
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-sendmsg-return.html"><span>probe::socket.sendmsg.return</span></a></span><span class="refpurpose"> —
- Return from socket.sendmsg.
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-writev.html"><span>probe::socket.writev</span></a></span><span class="refpurpose"> —
- Message sent via <code class="function">socket_writev</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-writev-return.html"><span>probe::socket.writev.return</span></a></span><span class="refpurpose"> —
- Conclusion of message sent via <code class="function">socket_writev</code>
- </span></dt></dl></dd><dt><span class="chapter"><a href="snmp.stp.html">15. SNMP Information Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-ipmib-filter-key.html"><span>function::ipmib_filter_key</span></a></span><span class="refpurpose"> —
- Default filter function for ipmib.* probes
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-get-proto.html"><span>function::ipmib_get_proto</span></a></span><span class="refpurpose"> —
- Get the protocol value
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-local-addr.html"><span>function::ipmib_local_addr</span></a></span><span class="refpurpose"> —
- Get the local ip address
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-remote-addr.html"><span>function::ipmib_remote_addr</span></a></span><span class="refpurpose"> —
- Get the remote ip address
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-tcp-local-port.html"><span>function::ipmib_tcp_local_port</span></a></span><span class="refpurpose"> —
- Get the local tcp port
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-tcp-remote-port.html"><span>function::ipmib_tcp_remote_port</span></a></span><span class="refpurpose"> —
- Get the remote tcp port
- </span></dt><dt><span class="refentrytitle"><a href="API-linuxmib-filter-key.html"><span>function::linuxmib_filter_key</span></a></span><span class="refpurpose"> —
- Default filter function for linuxmib.* probes
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-filter-key.html"><span>function::tcpmib_filter_key</span></a></span><span class="refpurpose"> —
- Default filter function for tcpmib.* probes
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-get-state.html"><span>function::tcpmib_get_state</span></a></span><span class="refpurpose"> —
- Get a socket's state
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-local-addr.html"><span>function::tcpmib_local_addr</span></a></span><span class="refpurpose"> —
- Get the source address
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-local-port.html"><span>function::tcpmib_local_port</span></a></span><span class="refpurpose"> —
- Get the local port
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-remote-addr.html"><span>function::tcpmib_remote_addr</span></a></span><span class="refpurpose"> —
- Get the remote address
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-remote-port.html"><span>function::tcpmib_remote_port</span></a></span><span class="refpurpose"> —
- Get the remote port
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-ForwDatagrams.html"><span>probe::ipmib.ForwDatagrams</span></a></span><span class="refpurpose"> —
- Count forwarded packet
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-FragFails.html"><span>probe::ipmib.FragFails</span></a></span><span class="refpurpose"> —
- Count datagram fragmented unsuccessfully
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-FragOKs.html"><span>probe::ipmib.FragOKs</span></a></span><span class="refpurpose"> —
- Count datagram fragmented successfully
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-InAddrErrors.html"><span>probe::ipmib.InAddrErrors</span></a></span><span class="refpurpose"> —
- Count arriving packets with an incorrect address
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-InDiscards.html"><span>probe::ipmib.InDiscards</span></a></span><span class="refpurpose"> —
- Count discarded inbound packets
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-InNoRoutes.html"><span>probe::ipmib.InNoRoutes</span></a></span><span class="refpurpose"> —
- Count an arriving packet with no matching socket
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-InReceives.html"><span>probe::ipmib.InReceives</span></a></span><span class="refpurpose"> —
- Count an arriving packet
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-InUnknownProtos.html"><span>probe::ipmib.InUnknownProtos</span></a></span><span class="refpurpose"> —
- Count arriving packets with an unbound proto
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-OutRequests.html"><span>probe::ipmib.OutRequests</span></a></span><span class="refpurpose"> —
- Count a request to send a packet
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-ReasmReqds.html"><span>probe::ipmib.ReasmReqds</span></a></span><span class="refpurpose"> —
- Count number of packet fragments reassembly requests
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-ReasmTimeout.html"><span>probe::ipmib.ReasmTimeout</span></a></span><span class="refpurpose"> —
- Count Reassembly Timeouts
- </span></dt><dt><span class="refentrytitle"><a href="API-linuxmib-DelayedACKs.html"><span>probe::linuxmib.DelayedACKs</span></a></span><span class="refpurpose"> —
- Count of delayed acks
- </span></dt><dt><span class="refentrytitle"><a href="API-linuxmib-ListenDrops.html"><span>probe::linuxmib.ListenDrops</span></a></span><span class="refpurpose"> —
- Count of times conn request that were dropped
- </span></dt><dt><span class="refentrytitle"><a href="API-linuxmib-ListenOverflows.html"><span>probe::linuxmib.ListenOverflows</span></a></span><span class="refpurpose"> —
- Count of times a listen queue overflowed
- </span></dt><dt><span class="refentrytitle"><a href="API-linuxmib-TCPMemoryPressures.html"><span>probe::linuxmib.TCPMemoryPressures</span></a></span><span class="refpurpose"> —
- Count of times memory pressure was used
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-ActiveOpens.html"><span>probe::tcpmib.ActiveOpens</span></a></span><span class="refpurpose"> —
- Count an active opening of a socket
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-AttemptFails.html"><span>probe::tcpmib.AttemptFails</span></a></span><span class="refpurpose"> —
- Count a failed attempt to open a socket
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-CurrEstab.html"><span>probe::tcpmib.CurrEstab</span></a></span><span class="refpurpose"> —
- Update the count of open sockets
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-EstabResets.html"><span>probe::tcpmib.EstabResets</span></a></span><span class="refpurpose"> —
- Count the reset of a socket
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-InSegs.html"><span>probe::tcpmib.InSegs</span></a></span><span class="refpurpose"> —
- Count an incoming tcp segment
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-OutRsts.html"><span>probe::tcpmib.OutRsts</span></a></span><span class="refpurpose"> —
- Count the sending of a reset packet
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-OutSegs.html"><span>probe::tcpmib.OutSegs</span></a></span><span class="refpurpose"> —
- Count the sending of a TCP segment
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-PassiveOpens.html"><span>probe::tcpmib.PassiveOpens</span></a></span><span class="refpurpose"> —
- Count the passive creation of a socket
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-RetransSegs.html"><span>probe::tcpmib.RetransSegs</span></a></span><span class="refpurpose"> —
- Count the retransmission of a TCP segment
- </span></dt></dl></dd><dt><span class="chapter"><a href="kprocess.stp.html">16. Kernel Process Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-target-set-pid.html"><span>function::target_set_pid</span></a></span><span class="refpurpose"> —
- Does pid descend from target process?
- </span></dt><dt><span class="refentrytitle"><a href="API-target-set-report.html"><span>function::target_set_report</span></a></span><span class="refpurpose"> —
- Print a report about the target set
- </span></dt><dt><span class="refentrytitle"><a href="API-kprocess-create.html"><span>probe::kprocess.create</span></a></span><span class="refpurpose"> —
- Fires whenever a new process or thread is successfully created
- </span></dt><dt><span class="refentrytitle"><a href="API-kprocess-exec.html"><span>probe::kprocess.exec</span></a></span><span class="refpurpose"> —
- Attempt to exec to a new program
- </span></dt><dt><span class="refentrytitle"><a href="API-kprocess-exec-complete.html"><span>probe::kprocess.exec_complete</span></a></span><span class="refpurpose"> —
- Return from exec to a new program
- </span></dt><dt><span class="refentrytitle"><a href="API-kprocess-exit.html"><span>probe::kprocess.exit</span></a></span><span class="refpurpose"> —
- Exit from process
- </span></dt><dt><span class="refentrytitle"><a href="API-kprocess-release.html"><span>probe::kprocess.release</span></a></span><span class="refpurpose"> —
- Process released
- </span></dt><dt><span class="refentrytitle"><a href="API-kprocess-start.html"><span>probe::kprocess.start</span></a></span><span class="refpurpose"> —
- Starting new process
- </span></dt></dl></dd><dt><span class="chapter"><a href="signal.stp.html">17. Signal Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-get-sa-flags.html"><span>function::get_sa_flags</span></a></span><span class="refpurpose"> —
- Returns the numeric value of sa_flags
- </span></dt><dt><span class="refentrytitle"><a href="API-get-sa-handler.html"><span>function::get_sa_handler</span></a></span><span class="refpurpose"> —
- Returns the numeric value of sa_handler
- </span></dt><dt><span class="refentrytitle"><a href="API-is-sig-blocked.html"><span>function::is_sig_blocked</span></a></span><span class="refpurpose"> —
- Returns 1 if the signal is currently blocked, or 0 if it is not
- </span></dt><dt><span class="refentrytitle"><a href="API-sa-flags-str.html"><span>function::sa_flags_str</span></a></span><span class="refpurpose"> —
- Returns the string representation of sa_flags
- </span></dt><dt><span class="refentrytitle"><a href="API-sa-handler-str.html"><span>function::sa_handler_str</span></a></span><span class="refpurpose"> —
- Returns the string representation of an sa_handler
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-str.html"><span>function::signal_str</span></a></span><span class="refpurpose"> —
- Returns the string representation of a signal number
- </span></dt><dt><span class="refentrytitle"><a href="API-sigset-mask-str.html"><span>function::sigset_mask_str</span></a></span><span class="refpurpose"> —
- Returns the string representation of a sigset
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-check-ignored.html"><span>probe::signal.check_ignored</span></a></span><span class="refpurpose"> —
- Checking to see signal is ignored
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-check-ignored-return.html"><span>probe::signal.check_ignored.return</span></a></span><span class="refpurpose"> —
- Check to see signal is ignored completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-checkperm.html"><span>probe::signal.checkperm</span></a></span><span class="refpurpose"> —
- Check being performed on a sent signal
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-checkperm-return.html"><span>probe::signal.checkperm.return</span></a></span><span class="refpurpose"> —
- Check performed on a sent signal completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-do-action.html"><span>probe::signal.do_action</span></a></span><span class="refpurpose"> —
- Examining or changing a signal action
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-do-action-return.html"><span>probe::signal.do_action.return</span></a></span><span class="refpurpose"> —
- Examining or changing a signal action completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-flush.html"><span>probe::signal.flush</span></a></span><span class="refpurpose"> —
- Flushing all pending signals for a task
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-force-segv.html"><span>probe::signal.force_segv</span></a></span><span class="refpurpose"> —
- Forcing send of SIGSEGV
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-force-segv-return.html"><span>probe::signal.force_segv.return</span></a></span><span class="refpurpose"> —
- Forcing send of SIGSEGV complete
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-handle.html"><span>probe::signal.handle</span></a></span><span class="refpurpose"> —
- Signal handler being invoked
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-handle-return.html"><span>probe::signal.handle.return</span></a></span><span class="refpurpose"> —
- Signal handler invocation completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-pending.html"><span>probe::signal.pending</span></a></span><span class="refpurpose"> —
- Examining pending signal
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-pending-return.html"><span>probe::signal.pending.return</span></a></span><span class="refpurpose"> —
- Examination of pending signal completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-procmask.html"><span>probe::signal.procmask</span></a></span><span class="refpurpose"> —
- Examining or changing blocked signals
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-procmask-return.html"><span>probe::signal.procmask.return</span></a></span><span class="refpurpose"> —
- Examining or changing blocked signals completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-send.html"><span>probe::signal.send</span></a></span><span class="refpurpose"> —
- Signal being sent to a process
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-send-return.html"><span>probe::signal.send.return</span></a></span><span class="refpurpose"> —
- Signal being sent to a process completed (deprecated in SystemTap 2.1)
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-send-sig-queue.html"><span>probe::signal.send_sig_queue</span></a></span><span class="refpurpose"> —
- Queuing a signal to a process
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-send-sig-queue-return.html"><span>probe::signal.send_sig_queue.return</span></a></span><span class="refpurpose"> —
- Queuing a signal to a process completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-sys-tgkill.html"><span>probe::signal.sys_tgkill</span></a></span><span class="refpurpose"> —
- Sending kill signal to a thread group
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-sys-tgkill-return.html"><span>probe::signal.sys_tgkill.return</span></a></span><span class="refpurpose"> —
- Sending kill signal to a thread group completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-sys-tkill.html"><span>probe::signal.sys_tkill</span></a></span><span class="refpurpose"> —
- Sending a kill signal to a thread
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-syskill.html"><span>probe::signal.syskill</span></a></span><span class="refpurpose"> —
- Sending kill signal to a process
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-syskill-return.html"><span>probe::signal.syskill.return</span></a></span><span class="refpurpose"> —
- Sending kill signal completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-systkill-return.html"><span>probe::signal.systkill.return</span></a></span><span class="refpurpose"> —
- Sending kill signal to a thread completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-wakeup.html"><span>probe::signal.wakeup</span></a></span><span class="refpurpose"> —
- Sleeping process being wakened for signal
- </span></dt></dl></dd><dt><span class="chapter"><a href="errno.stp.html">18. Errno Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-errno-str.html"><span>function::errno_str</span></a></span><span class="refpurpose"> —
- Symbolic string associated with error code
- </span></dt><dt><span class="refentrytitle"><a href="API-return-str.html"><span>function::return_str</span></a></span><span class="refpurpose"> —
- Formats the return value as a string
- </span></dt><dt><span class="refentrytitle"><a href="API-returnstr.html"><span>function::returnstr</span></a></span><span class="refpurpose"> —
- Formats the return value as a string
- </span></dt><dt><span class="refentrytitle"><a href="API-returnval.html"><span>function::returnval</span></a></span><span class="refpurpose"> —
- Possible return value of probed function
- </span></dt></dl></dd><dt><span class="chapter"><a href="dev.stp.html">19. Device Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-MAJOR.html"><span>function::MAJOR</span></a></span><span class="refpurpose"> —
- Extract major device number from a kernel device number (kdev_t)
- </span></dt><dt><span class="refentrytitle"><a href="API-MINOR.html"><span>function::MINOR</span></a></span><span class="refpurpose"> —
- Extract minor device number from a kernel device number (kdev_t)
- </span></dt><dt><span class="refentrytitle"><a href="API-MKDEV.html"><span>function::MKDEV</span></a></span><span class="refpurpose"> —
- Creates a value that can be compared to a kernel device number (kdev_t)
- </span></dt><dt><span class="refentrytitle"><a href="API-usrdev2kerndev.html"><span>function::usrdev2kerndev</span></a></span><span class="refpurpose"> —
- Converts a user-space device number into the format used in the kernel
- </span></dt></dl></dd><dt><span class="chapter"><a href="dentry.stp.html">20. Directory-entry (dentry) Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-d-name.html"><span>function::d_name</span></a></span><span class="refpurpose"> —
- get the dirent name
- </span></dt><dt><span class="refentrytitle"><a href="API-d-path.html"><span>function::d_path</span></a></span><span class="refpurpose"> —
- get the full nameidata path
- </span></dt><dt><span class="refentrytitle"><a href="API-inode-name.html"><span>function::inode_name</span></a></span><span class="refpurpose"> —
- get the inode name
- </span></dt><dt><span class="refentrytitle"><a href="API-real-mount.html"><span>function::real_mount</span></a></span><span class="refpurpose"> —
- get the 'struct mount' pointer
- </span></dt><dt><span class="refentrytitle"><a href="API-reverse-path-walk.html"><span>function::reverse_path_walk</span></a></span><span class="refpurpose"> —
- get the full dirent path
- </span></dt><dt><span class="refentrytitle"><a href="API-task-dentry-path.html"><span>function::task_dentry_path</span></a></span><span class="refpurpose"> —
- get the full dentry path
- </span></dt></dl></dd><dt><span class="chapter"><a href="logging.stp.html">21. Logging Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-error.html"><span>function::error</span></a></span><span class="refpurpose"> —
- Send an error message
- </span></dt><dt><span class="refentrytitle"><a href="API-exit.html"><span>function::exit</span></a></span><span class="refpurpose"> —
- Start shutting down probing script.
- </span></dt><dt><span class="refentrytitle"><a href="API-ftrace.html"><span>function::ftrace</span></a></span><span class="refpurpose"> —
- Send a message to the ftrace ring-buffer
- </span></dt><dt><span class="refentrytitle"><a href="API-log.html"><span>function::log</span></a></span><span class="refpurpose"> —
- Send a line to the common trace buffer
- </span></dt><dt><span class="refentrytitle"><a href="API-printk.html"><span>function::printk</span></a></span><span class="refpurpose"> —
- Send a message to the kernel trace buffer
- </span></dt><dt><span class="refentrytitle"><a href="API-warn.html"><span>function::warn</span></a></span><span class="refpurpose"> —
- Send a line to the warning stream
- </span></dt></dl></dd><dt><span class="chapter"><a href="queue_stats.stp.html">22. Queue Statistics Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-qs-done.html"><span>function::qs_done</span></a></span><span class="refpurpose"> —
- Function to record finishing request
- </span></dt><dt><span class="refentrytitle"><a href="API-qs-run.html"><span>function::qs_run</span></a></span><span class="refpurpose"> —
- Function to record being moved from wait queue to being serviced
- </span></dt><dt><span class="refentrytitle"><a href="API-qs-wait.html"><span>function::qs_wait</span></a></span><span class="refpurpose"> —
- Function to record enqueue requests
- </span></dt><dt><span class="refentrytitle"><a href="API-qsq-blocked.html"><span>function::qsq_blocked</span></a></span><span class="refpurpose"> —
- Returns the time reqest was on the wait queue
- </span></dt><dt><span class="refentrytitle"><a href="API-qsq-print.html"><span>function::qsq_print</span></a></span><span class="refpurpose"> —
- Prints a line of statistics for the given queue
- </span></dt><dt><span class="refentrytitle"><a href="API-qsq-service-time.html"><span>function::qsq_service_time</span></a></span><span class="refpurpose"> —
- Amount of time per request service
- </span></dt><dt><span class="refentrytitle"><a href="API-qsq-start.html"><span>function::qsq_start</span></a></span><span class="refpurpose"> —
- Function to reset the stats for a queue
- </span></dt><dt><span class="refentrytitle"><a href="API-qsq-throughput.html"><span>function::qsq_throughput</span></a></span><span class="refpurpose"> —
- Number of requests served per unit time
- </span></dt><dt><span class="refentrytitle"><a href="API-qsq-utilization.html"><span>function::qsq_utilization</span></a></span><span class="refpurpose"> —
- Fraction of time that any request was being serviced
- </span></dt><dt><span class="refentrytitle"><a href="API-qsq-wait-queue-length.html"><span>function::qsq_wait_queue_length</span></a></span><span class="refpurpose"> —
- length of wait queue
- </span></dt><dt><span class="refentrytitle"><a href="API-qsq-wait-time.html"><span>function::qsq_wait_time</span></a></span><span class="refpurpose"> —
- Amount of time in queue + service per request
- </span></dt></dl></dd><dt><span class="chapter"><a href="random.stp.html">23. Random functions Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-randint.html"><span>function::randint</span></a></span><span class="refpurpose"> —
- Return a random number between [0,n)
- </span></dt></dl></dd><dt><span class="chapter"><a href="conversions.stp.html">24. String and data retrieving functions Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-atomic-long-read.html"><span>function::atomic_long_read</span></a></span><span class="refpurpose"> —
- Retrieves an atomic long variable from kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-atomic-read.html"><span>function::atomic_read</span></a></span><span class="refpurpose"> —
- Retrieves an atomic variable from kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-char.html"><span>function::kernel_char</span></a></span><span class="refpurpose"> —
- Retrieves a char value stored in kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-int.html"><span>function::kernel_int</span></a></span><span class="refpurpose"> —
- Retrieves an int value stored in kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-long.html"><span>function::kernel_long</span></a></span><span class="refpurpose"> —
- Retrieves a long value stored in kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-pointer.html"><span>function::kernel_pointer</span></a></span><span class="refpurpose"> —
- Retrieves a pointer value stored in kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-short.html"><span>function::kernel_short</span></a></span><span class="refpurpose"> —
- Retrieves a short value stored in kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-string.html"><span>function::kernel_string</span></a></span><span class="refpurpose"> —
- Retrieves string from kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-string2.html"><span>function::kernel_string2</span></a></span><span class="refpurpose"> —
- Retrieves string from kernel memory with alternative error string
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-string2-utf16.html"><span>function::kernel_string2_utf16</span></a></span><span class="refpurpose"> —
- Retrieves UTF-16 string from kernel memory with alternative error string
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-string2-utf32.html"><span>function::kernel_string2_utf32</span></a></span><span class="refpurpose"> —
- Retrieves UTF-32 string from kernel memory with alternative error string
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-string-n.html"><span>function::kernel_string_n</span></a></span><span class="refpurpose"> —
- Retrieves string of given length from kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-string-utf16.html"><span>function::kernel_string_utf16</span></a></span><span class="refpurpose"> —
- Retrieves UTF-16 string from kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-kernel-string-utf32.html"><span>function::kernel_string_utf32</span></a></span><span class="refpurpose"> —
- Retrieves UTF-32 string from kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-user-char.html"><span>function::user_char</span></a></span><span class="refpurpose"> —
- Retrieves a char value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-char-warn.html"><span>function::user_char_warn</span></a></span><span class="refpurpose"> —
- Retrieves a char value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-int.html"><span>function::user_int</span></a></span><span class="refpurpose"> —
- Retrieves an int value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-int16.html"><span>function::user_int16</span></a></span><span class="refpurpose"> —
- Retrieves a 16-bit integer value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-int32.html"><span>function::user_int32</span></a></span><span class="refpurpose"> —
- Retrieves a 32-bit integer value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-int64.html"><span>function::user_int64</span></a></span><span class="refpurpose"> —
- Retrieves a 64-bit integer value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-int8.html"><span>function::user_int8</span></a></span><span class="refpurpose"> —
- Retrieves a 8-bit integer value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-int-warn.html"><span>function::user_int_warn</span></a></span><span class="refpurpose"> —
- Retrieves an int value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-long.html"><span>function::user_long</span></a></span><span class="refpurpose"> —
- Retrieves a long value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-long-warn.html"><span>function::user_long_warn</span></a></span><span class="refpurpose"> —
- Retrieves a long value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-short.html"><span>function::user_short</span></a></span><span class="refpurpose"> —
- Retrieves a short value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-short-warn.html"><span>function::user_short_warn</span></a></span><span class="refpurpose"> —
- Retrieves a short value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string.html"><span>function::user_string</span></a></span><span class="refpurpose"> —
- Retrieves string from user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string2.html"><span>function::user_string2</span></a></span><span class="refpurpose"> —
- Retrieves string from user space with alternative error string
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string2-utf16.html"><span>function::user_string2_utf16</span></a></span><span class="refpurpose"> —
- Retrieves UTF-16 string from user memory with alternative error string
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string2-utf32.html"><span>function::user_string2_utf32</span></a></span><span class="refpurpose"> —
- Retrieves UTF-32 string from user memory with alternative error string
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string-n.html"><span>function::user_string_n</span></a></span><span class="refpurpose"> —
- Retrieves string of given length from user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string-n2.html"><span>function::user_string_n2</span></a></span><span class="refpurpose"> —
- Retrieves string of given length from user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string-n-quoted.html"><span>function::user_string_n_quoted</span></a></span><span class="refpurpose"> —
- Retrieves and quotes string from user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string-n-warn.html"><span>function::user_string_n_warn</span></a></span><span class="refpurpose"> —
- Retrieves string from user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string-quoted.html"><span>function::user_string_quoted</span></a></span><span class="refpurpose"> —
- Retrieves and quotes string from user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string-utf16.html"><span>function::user_string_utf16</span></a></span><span class="refpurpose"> —
- Retrieves UTF-16 string from user memory
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string-utf32.html"><span>function::user_string_utf32</span></a></span><span class="refpurpose"> —
- Retrieves UTF-32 string from user memory
- </span></dt><dt><span class="refentrytitle"><a href="API-user-string-warn.html"><span>function::user_string_warn</span></a></span><span class="refpurpose"> —
- Retrieves string from user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-uint16.html"><span>function::user_uint16</span></a></span><span class="refpurpose"> —
- Retrieves an unsigned 16-bit integer value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-uint32.html"><span>function::user_uint32</span></a></span><span class="refpurpose"> —
- Retrieves an unsigned 32-bit integer value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-uint64.html"><span>function::user_uint64</span></a></span><span class="refpurpose"> —
- Retrieves an unsigned 64-bit integer value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-uint8.html"><span>function::user_uint8</span></a></span><span class="refpurpose"> —
- Retrieves an unsigned 8-bit integer value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-ushort.html"><span>function::user_ushort</span></a></span><span class="refpurpose"> —
- Retrieves an unsigned short value stored in user space
- </span></dt><dt><span class="refentrytitle"><a href="API-user-ushort-warn.html"><span>function::user_ushort_warn</span></a></span><span class="refpurpose"> —
- Retrieves an unsigned short value stored in user space
- </span></dt></dl></dd><dt><span class="chapter"><a href="conversions-guru.stp.html">25. String and data writing functions Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-set-kernel-char.html"><span>function::set_kernel_char</span></a></span><span class="refpurpose"> —
- Writes a char value to kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-set-kernel-int.html"><span>function::set_kernel_int</span></a></span><span class="refpurpose"> —
- Writes an int value to kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-set-kernel-long.html"><span>function::set_kernel_long</span></a></span><span class="refpurpose"> —
- Writes a long value to kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-set-kernel-pointer.html"><span>function::set_kernel_pointer</span></a></span><span class="refpurpose"> —
- Writes a pointer value to kernel memory.
- </span></dt><dt><span class="refentrytitle"><a href="API-set-kernel-short.html"><span>function::set_kernel_short</span></a></span><span class="refpurpose"> —
- Writes a short value to kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-set-kernel-string.html"><span>function::set_kernel_string</span></a></span><span class="refpurpose"> —
- Writes a string to kernel memory
- </span></dt><dt><span class="refentrytitle"><a href="API-set-kernel-string-n.html"><span>function::set_kernel_string_n</span></a></span><span class="refpurpose"> —
- Writes a string of given length to kernel memory
- </span></dt></dl></dd><dt><span class="chapter"><a href="guru-delay.stp.html">26. Guru tapsets</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-mdelay.html"><span>function::mdelay</span></a></span><span class="refpurpose"> —
- millisecond delay
- </span></dt><dt><span class="refentrytitle"><a href="API-panic.html"><span>function::panic</span></a></span><span class="refpurpose"> —
- trigger a panic
- </span></dt><dt><span class="refentrytitle"><a href="API-udelay.html"><span>function::udelay</span></a></span><span class="refpurpose"> —
- microsecond delay
- </span></dt></dl></dd><dt><span class="chapter"><a href="string.stp.html">27. A collection of standard string functions</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-isdigit.html"><span>function::isdigit</span></a></span><span class="refpurpose"> —
- Checks for a digit
- </span></dt><dt><span class="refentrytitle"><a href="API-isinstr.html"><span>function::isinstr</span></a></span><span class="refpurpose"> —
- Returns whether a string is a substring of another string
- </span></dt><dt><span class="refentrytitle"><a href="API-str-replace.html"><span>function::str_replace</span></a></span><span class="refpurpose"> —
- str_replace Replaces all instances of a substring with another
- </span></dt><dt><span class="refentrytitle"><a href="API-stringat.html"><span>function::stringat</span></a></span><span class="refpurpose"> —
- Returns the char at a given position in the string
- </span></dt><dt><span class="refentrytitle"><a href="API-strlen.html"><span>function::strlen</span></a></span><span class="refpurpose"> —
- Returns the length of a string
- </span></dt><dt><span class="refentrytitle"><a href="API-strtol.html"><span>function::strtol</span></a></span><span class="refpurpose"> —
- strtol - Convert a string to a long
- </span></dt><dt><span class="refentrytitle"><a href="API-substr.html"><span>function::substr</span></a></span><span class="refpurpose"> —
- Returns a substring
- </span></dt><dt><span class="refentrytitle"><a href="API-text-str.html"><span>function::text_str</span></a></span><span class="refpurpose"> —
- Escape any non-printable chars in a string
- </span></dt><dt><span class="refentrytitle"><a href="API-text-strn.html"><span>function::text_strn</span></a></span><span class="refpurpose"> —
- Escape any non-printable chars in a string
- </span></dt><dt><span class="refentrytitle"><a href="API-tokenize.html"><span>function::tokenize</span></a></span><span class="refpurpose"> —
- Return the next non-empty token in a string
- </span></dt></dl></dd><dt><span class="chapter"><a href="ansi.stp.html">28. Utility functions for using ansi control chars in logs</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-ansi-clear-screen.html"><span>function::ansi_clear_screen</span></a></span><span class="refpurpose"> —
- Move cursor to top left and clear screen.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-cursor-hide.html"><span>function::ansi_cursor_hide</span></a></span><span class="refpurpose"> —
- Hides the cursor.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-cursor-move.html"><span>function::ansi_cursor_move</span></a></span><span class="refpurpose"> —
- Move cursor to new coordinates.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-cursor-restore.html"><span>function::ansi_cursor_restore</span></a></span><span class="refpurpose"> —
- Restores a previously saved cursor position.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-cursor-save.html"><span>function::ansi_cursor_save</span></a></span><span class="refpurpose"> —
- Saves the cursor position.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-cursor-show.html"><span>function::ansi_cursor_show</span></a></span><span class="refpurpose"> —
- Shows the cursor.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-new-line.html"><span>function::ansi_new_line</span></a></span><span class="refpurpose"> —
- Move cursor to new line.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-reset-color.html"><span>function::ansi_reset_color</span></a></span><span class="refpurpose"> —
- Resets Select Graphic Rendition mode.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-set-color.html"><span>function::ansi_set_color</span></a></span><span class="refpurpose"> —
- Set the ansi Select Graphic Rendition mode.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-set-color2.html"><span>function::ansi_set_color2</span></a></span><span class="refpurpose"> —
- Set the ansi Select Graphic Rendition mode.
- </span></dt><dt><span class="refentrytitle"><a href="API-ansi-set-color3.html"><span>function::ansi_set_color3</span></a></span><span class="refpurpose"> —
- Set the ansi Select Graphic Rendition mode.
- </span></dt><dt><span class="refentrytitle"><a href="API-indent.html"><span>function::indent</span></a></span><span class="refpurpose"> —
- returns an amount of space to indent
- </span></dt><dt><span class="refentrytitle"><a href="API-thread-indent.html"><span>function::thread_indent</span></a></span><span class="refpurpose"> —
- returns an amount of space with the current task information
- </span></dt></dl></dd><dt><span class="chapter"><a href="stap_staticmarkers.stp.html">29. SystemTap Translator Tapset</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-stap-cache-add-mod.html"><span>probe::stap.cache_add_mod</span></a></span><span class="refpurpose"> —
- Adding kernel instrumentation module to cache
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-cache-add-nss.html"><span>probe::stap.cache_add_nss</span></a></span><span class="refpurpose"> —
- Add NSS (Network Security Services) information to cache
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-cache-add-src.html"><span>probe::stap.cache_add_src</span></a></span><span class="refpurpose"> —
- Adding C code translation to cache
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-cache-clean.html"><span>probe::stap.cache_clean</span></a></span><span class="refpurpose"> —
- Removing file from stap cache
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-cache-get.html"><span>probe::stap.cache_get</span></a></span><span class="refpurpose"> —
- Found item in stap cache
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass0.html"><span>probe::stap.pass0</span></a></span><span class="refpurpose"> —
- Starting stap pass0 (parsing command line arguments)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass0-end.html"><span>probe::stap.pass0.end</span></a></span><span class="refpurpose"> —
- Finished stap pass0 (parsing command line arguments)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass1-end.html"><span>probe::stap.pass1.end</span></a></span><span class="refpurpose"> —
- Finished stap pass1 (parsing scripts)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass1a.html"><span>probe::stap.pass1a</span></a></span><span class="refpurpose"> —
- Starting stap pass1 (parsing user script)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass1b.html"><span>probe::stap.pass1b</span></a></span><span class="refpurpose"> —
- Starting stap pass1 (parsing library scripts)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass2.html"><span>probe::stap.pass2</span></a></span><span class="refpurpose"> —
- Starting stap pass2 (elaboration)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass2-end.html"><span>probe::stap.pass2.end</span></a></span><span class="refpurpose"> —
- Finished stap pass2 (elaboration)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass3.html"><span>probe::stap.pass3</span></a></span><span class="refpurpose"> —
- Starting stap pass3 (translation to C)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass3-end.html"><span>probe::stap.pass3.end</span></a></span><span class="refpurpose"> —
- Finished stap pass3 (translation to C)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass4.html"><span>probe::stap.pass4</span></a></span><span class="refpurpose"> —
- Starting stap pass4 (compile C code into kernel module)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass4-end.html"><span>probe::stap.pass4.end</span></a></span><span class="refpurpose"> —
- Finished stap pass4 (compile C code into kernel module)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass5.html"><span>probe::stap.pass5</span></a></span><span class="refpurpose"> —
- Starting stap pass5 (running the instrumentation)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass5-end.html"><span>probe::stap.pass5.end</span></a></span><span class="refpurpose"> —
- Finished stap pass5 (running the instrumentation)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass6.html"><span>probe::stap.pass6</span></a></span><span class="refpurpose"> —
- Starting stap pass6 (cleanup)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass6-end.html"><span>probe::stap.pass6.end</span></a></span><span class="refpurpose"> —
- Finished stap pass6 (cleanup)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-system.html"><span>probe::stap.system</span></a></span><span class="refpurpose"> —
- Starting a command from stap
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-system-return.html"><span>probe::stap.system.return</span></a></span><span class="refpurpose"> —
- Finished a command from stap
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-system-spawn.html"><span>probe::stap.system.spawn</span></a></span><span class="refpurpose"> —
- stap spawned new process
- </span></dt><dt><span class="refentrytitle"><a href="API-stapio-receive-control-message.html"><span>probe::stapio.receive_control_message</span></a></span><span class="refpurpose"> —
- Received a control message
- </span></dt><dt><span class="refentrytitle"><a href="API-staprun-insert-module.html"><span>probe::staprun.insert_module</span></a></span><span class="refpurpose"> —
- Inserting SystemTap instrumentation module
- </span></dt><dt><span class="refentrytitle"><a href="API-staprun-remove-module.html"><span>probe::staprun.remove_module</span></a></span><span class="refpurpose"> —
- Removing SystemTap instrumentation module
- </span></dt><dt><span class="refentrytitle"><a href="API-staprun-send-control-message.html"><span>probe::staprun.send_control_message</span></a></span><span class="refpurpose"> —
- Sending a control message
- </span></dt></dl></dd><dt><span class="chapter"><a href="nfsd.stp.html">30. Network File Storage Tapsets</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-nfsderror.html"><span>function::nfsderror</span></a></span><span class="refpurpose"> —
- Convert nfsd error number into string
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-aop-readpage.html"><span>probe::nfs.aop.readpage</span></a></span><span class="refpurpose"> —
- NFS client synchronously reading a page
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-aop-readpages.html"><span>probe::nfs.aop.readpages</span></a></span><span class="refpurpose"> —
- NFS client reading multiple pages
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-aop-release-page.html"><span>probe::nfs.aop.release_page</span></a></span><span class="refpurpose"> —
- NFS client releasing page
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-aop-set-page-dirty.html"><span>probe::nfs.aop.set_page_dirty</span></a></span><span class="refpurpose"> —
- NFS client marking page as dirty
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-aop-write-begin.html"><span>probe::nfs.aop.write_begin</span></a></span><span class="refpurpose"> —
- NFS client begin to write data
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-aop-write-end.html"><span>probe::nfs.aop.write_end</span></a></span><span class="refpurpose"> —
- NFS client complete writing data
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-aop-writepage.html"><span>probe::nfs.aop.writepage</span></a></span><span class="refpurpose"> —
- NFS client writing a mapped page to the NFS server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-aop-writepages.html"><span>probe::nfs.aop.writepages</span></a></span><span class="refpurpose"> —
- NFS client writing several dirty pages to the NFS server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-aio-read.html"><span>probe::nfs.fop.aio_read</span></a></span><span class="refpurpose"> —
- NFS client aio_read file operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-aio-write.html"><span>probe::nfs.fop.aio_write</span></a></span><span class="refpurpose"> —
- NFS client aio_write file operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-check-flags.html"><span>probe::nfs.fop.check_flags</span></a></span><span class="refpurpose"> —
- NFS client checking flag operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-flush.html"><span>probe::nfs.fop.flush</span></a></span><span class="refpurpose"> —
- NFS client flush file operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-fsync.html"><span>probe::nfs.fop.fsync</span></a></span><span class="refpurpose"> —
- NFS client fsync operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-llseek.html"><span>probe::nfs.fop.llseek</span></a></span><span class="refpurpose"> —
- NFS client llseek operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-lock.html"><span>probe::nfs.fop.lock</span></a></span><span class="refpurpose"> —
- NFS client file lock operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-mmap.html"><span>probe::nfs.fop.mmap</span></a></span><span class="refpurpose"> —
- NFS client mmap operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-open.html"><span>probe::nfs.fop.open</span></a></span><span class="refpurpose"> —
- NFS client file open operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-read.html"><span>probe::nfs.fop.read</span></a></span><span class="refpurpose"> —
- NFS client read operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-release.html"><span>probe::nfs.fop.release</span></a></span><span class="refpurpose"> —
- NFS client release page operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-sendfile.html"><span>probe::nfs.fop.sendfile</span></a></span><span class="refpurpose"> —
- NFS client send file operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-write.html"><span>probe::nfs.fop.write</span></a></span><span class="refpurpose"> —
- NFS client write operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-commit.html"><span>probe::nfs.proc.commit</span></a></span><span class="refpurpose"> —
- NFS client committing data on server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-commit-done.html"><span>probe::nfs.proc.commit_done</span></a></span><span class="refpurpose"> —
- NFS client response to a commit RPC task
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-commit-setup.html"><span>probe::nfs.proc.commit_setup</span></a></span><span class="refpurpose"> —
- NFS client setting up a commit RPC task
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-create.html"><span>probe::nfs.proc.create</span></a></span><span class="refpurpose"> —
- NFS client creating file on server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-handle-exception.html"><span>probe::nfs.proc.handle_exception</span></a></span><span class="refpurpose"> —
- NFS client handling an NFSv4 exception
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-lookup.html"><span>probe::nfs.proc.lookup</span></a></span><span class="refpurpose"> —
- NFS client opens/searches a file on server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-open.html"><span>probe::nfs.proc.open</span></a></span><span class="refpurpose"> —
- NFS client allocates file read/write context information
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-read.html"><span>probe::nfs.proc.read</span></a></span><span class="refpurpose"> —
- NFS client synchronously reads file from server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-read-done.html"><span>probe::nfs.proc.read_done</span></a></span><span class="refpurpose"> —
- NFS client response to a read RPC task
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-read-setup.html"><span>probe::nfs.proc.read_setup</span></a></span><span class="refpurpose"> —
- NFS client setting up a read RPC task
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-release.html"><span>probe::nfs.proc.release</span></a></span><span class="refpurpose"> —
- NFS client releases file read/write context information
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-remove.html"><span>probe::nfs.proc.remove</span></a></span><span class="refpurpose"> —
- NFS client removes a file on server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-rename.html"><span>probe::nfs.proc.rename</span></a></span><span class="refpurpose"> —
- NFS client renames a file on server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-write.html"><span>probe::nfs.proc.write</span></a></span><span class="refpurpose"> —
- NFS client synchronously writes file to server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-write-done.html"><span>probe::nfs.proc.write_done</span></a></span><span class="refpurpose"> —
- NFS client response to a write RPC task
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-write-setup.html"><span>probe::nfs.proc.write_setup</span></a></span><span class="refpurpose"> —
- NFS client setting up a write RPC task
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-close.html"><span>probe::nfsd.close</span></a></span><span class="refpurpose"> —
- NFS server closing a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-commit.html"><span>probe::nfsd.commit</span></a></span><span class="refpurpose"> —
- NFS server committing all pending writes to stable storage
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-create.html"><span>probe::nfsd.create</span></a></span><span class="refpurpose"> —
- NFS server creating a file(regular,dir,device,fifo) for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-createv3.html"><span>probe::nfsd.createv3</span></a></span><span class="refpurpose"> —
- NFS server creating a regular file or set file attributes for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-dispatch.html"><span>probe::nfsd.dispatch</span></a></span><span class="refpurpose"> —
- NFS server receives an operation from client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-lookup.html"><span>probe::nfsd.lookup</span></a></span><span class="refpurpose"> —
- NFS server opening or searching file for a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-open.html"><span>probe::nfsd.open</span></a></span><span class="refpurpose"> —
- NFS server opening a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-proc-commit.html"><span>probe::nfsd.proc.commit</span></a></span><span class="refpurpose"> —
- NFS server performing a commit operation for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-proc-create.html"><span>probe::nfsd.proc.create</span></a></span><span class="refpurpose"> —
- NFS server creating a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-proc-lookup.html"><span>probe::nfsd.proc.lookup</span></a></span><span class="refpurpose"> —
- NFS server opening or searching for a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-proc-read.html"><span>probe::nfsd.proc.read</span></a></span><span class="refpurpose"> —
- NFS server reading file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-proc-remove.html"><span>probe::nfsd.proc.remove</span></a></span><span class="refpurpose"> —
- NFS server removing a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-proc-rename.html"><span>probe::nfsd.proc.rename</span></a></span><span class="refpurpose"> —
- NFS Server renaming a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-proc-write.html"><span>probe::nfsd.proc.write</span></a></span><span class="refpurpose"> —
- NFS server writing data to file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-read.html"><span>probe::nfsd.read</span></a></span><span class="refpurpose"> —
- NFS server reading data from a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-rename.html"><span>probe::nfsd.rename</span></a></span><span class="refpurpose"> —
- NFS server renaming a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-unlink.html"><span>probe::nfsd.unlink</span></a></span><span class="refpurpose"> —
- NFS server removing a file or a directory for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-write.html"><span>probe::nfsd.write</span></a></span><span class="refpurpose"> —
- NFS server writing data to a file for client
- </span></dt></dl></dd><dt><span class="chapter"><a href="speculation.stp.html">31. Speculation</a></span></dt><dd><dl><dt><span class="refentrytitle"><a href="API-commit.html"><span>function::commit</span></a></span><span class="refpurpose"> —
- Write out all output related to a speculation buffer
- </span></dt><dt><span class="refentrytitle"><a href="API-discard.html"><span>function::discard</span></a></span><span class="refpurpose"> —
- Discard all output related to a speculation buffer
- </span></dt><dt><span class="refentrytitle"><a href="API-speculate.html"><span>function::speculate</span></a></span><span class="refpurpose"> —
- Store a string for possible output later
- </span></dt><dt><span class="refentrytitle"><a href="API-speculation.html"><span>function::speculation</span></a></span><span class="refpurpose"> —
- Allocate a new id for speculative output
- </span></dt></dl></dd></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="introduction.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Chapter 1. Introduction</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 1. Introduction</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="next" href="context_stp.html" title="Chapter 2. Context Functions"></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">Chapter 1. Introduction</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="context_stp.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 1. Introduction"><div class="titlepage"><div><div><h2 class="title"><a name="introduction"></a>Chapter 1. Introduction</h2></div></div></div><p>
- SystemTap provides free software (GPL) infrastructure to simplify the
- gathering of information about the running Linux system. This assists
- diagnosis of a performance or functional problem. SystemTap eliminates the
- need for the developer to go through the tedious and disruptive instrument,
- recompile, install, and reboot sequence that may be otherwise required to
- collect data.
- </p><p>
- SystemTap provides a simple command line interface and scripting language
- for writing instrumentation for a live running kernel. The instrumentation
- makes extensive use of the probe points and functions provided in the
- <em class="firstterm">tapset</em> library. This document describes the various
- probe points and functions.
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="context_stp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">SystemTap Tapset Reference Manual </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 2. Context Functions</td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 9. IO Scheduler and block IO Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-scheduler-wakeup-new.html" title="probe::scheduler.wakeup_new"><link rel="next" href="API-ioblock-end.html" title="probe::ioblock.end"></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">Chapter 9. IO Scheduler and block IO Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scheduler-wakeup-new.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-ioblock-end.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 9. IO Scheduler and block IO Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="iosched.stp"></a>Chapter 9. IO Scheduler and block IO Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-ioblock-end.html"><span>probe::ioblock.end</span></a></span><span class="refpurpose"> —
- Fires whenever a block I/O transfer is complete.
- </span></dt><dt><span class="refentrytitle"><a href="API-ioblock-request.html"><span>probe::ioblock.request</span></a></span><span class="refpurpose"> —
- Fires whenever making a generic block I/O request.
- </span></dt><dt><span class="refentrytitle"><a href="API-ioblock-trace-bounce.html"><span>probe::ioblock_trace.bounce</span></a></span><span class="refpurpose"> —
- Fires whenever a buffer bounce is needed for at least one page of a block IO request.
- </span></dt><dt><span class="refentrytitle"><a href="API-ioblock-trace-end.html"><span>probe::ioblock_trace.end</span></a></span><span class="refpurpose"> —
- Fires whenever a block I/O transfer is complete.
- </span></dt><dt><span class="refentrytitle"><a href="API-ioblock-trace-request.html"><span>probe::ioblock_trace.request</span></a></span><span class="refpurpose"> —
- Fires just as a generic block I/O request is created for a bio.
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-elv-add-request.html"><span>probe::ioscheduler.elv_add_request</span></a></span><span class="refpurpose"> —
- probe to indicate request is added to the request queue.
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-elv-add-request-kp.html"><span>probe::ioscheduler.elv_add_request.kp</span></a></span><span class="refpurpose"> —
- kprobe based probe to indicate that a request was added to the request queue
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-elv-add-request-tp.html"><span>probe::ioscheduler.elv_add_request.tp</span></a></span><span class="refpurpose"> —
- tracepoint based probe to indicate a request is added to the request queue.
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-elv-completed-request.html"><span>probe::ioscheduler.elv_completed_request</span></a></span><span class="refpurpose"> —
- Fires when a request is completed
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-elv-next-request.html"><span>probe::ioscheduler.elv_next_request</span></a></span><span class="refpurpose"> —
- Fires when a request is retrieved from the request queue
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-elv-next-request-return.html"><span>probe::ioscheduler.elv_next_request.return</span></a></span><span class="refpurpose"> —
- Fires when a request retrieval issues a return signal
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-trace-elv-abort-request.html"><span>probe::ioscheduler_trace.elv_abort_request</span></a></span><span class="refpurpose"> —
- Fires when a request is aborted.
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-trace-elv-completed-request.html"><span>probe::ioscheduler_trace.elv_completed_request</span></a></span><span class="refpurpose"> —
- Fires when a request is
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-trace-elv-issue-request.html"><span>probe::ioscheduler_trace.elv_issue_request</span></a></span><span class="refpurpose"> —
- Fires when a request is
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-trace-elv-requeue-request.html"><span>probe::ioscheduler_trace.elv_requeue_request</span></a></span><span class="refpurpose"> —
- Fires when a request is
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-trace-plug.html"><span>probe::ioscheduler_trace.plug</span></a></span><span class="refpurpose"> —
- Fires when a request queue is plugged;
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-trace-unplug-io.html"><span>probe::ioscheduler_trace.unplug_io</span></a></span><span class="refpurpose"> —
- Fires when a request queue is unplugged;
- </span></dt><dt><span class="refentrytitle"><a href="API-ioscheduler-trace-unplug-timer.html"><span>probe::ioscheduler_trace.unplug_timer</span></a></span><span class="refpurpose"> —
- Fires when unplug timer associated
- </span></dt></dl></div><p>
- This family of probe points is used to probe block IO layer and IO scheduler activities.
- It contains the following probe points:
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scheduler-wakeup-new.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-ioblock-end.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scheduler.wakeup_new</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::ioblock.end</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 12. Interrupt Request (IRQ) Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-tty-write.html" title="probe::tty.write"><link rel="next" href="API-irq-handler-entry.html" title="probe::irq_handler.entry"></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">Chapter 12. Interrupt Request (IRQ) Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tty-write.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-irq-handler-entry.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 12. Interrupt Request (IRQ) Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="irq.stp"></a>Chapter 12. Interrupt Request (IRQ) Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-irq-handler-entry.html"><span>probe::irq_handler.entry</span></a></span><span class="refpurpose"> —
- Execution of interrupt handler starting
- </span></dt><dt><span class="refentrytitle"><a href="API-irq-handler-exit.html"><span>probe::irq_handler.exit</span></a></span><span class="refpurpose"> —
- Execution of interrupt handler completed
- </span></dt><dt><span class="refentrytitle"><a href="API-softirq-entry.html"><span>probe::softirq.entry</span></a></span><span class="refpurpose"> —
- Execution of handler for a pending softirq starting
- </span></dt><dt><span class="refentrytitle"><a href="API-softirq-exit.html"><span>probe::softirq.exit</span></a></span><span class="refpurpose"> —
- Execution of handler for a pending softirq completed
- </span></dt><dt><span class="refentrytitle"><a href="API-workqueue-create.html"><span>probe::workqueue.create</span></a></span><span class="refpurpose"> —
- Creating a new workqueue
- </span></dt><dt><span class="refentrytitle"><a href="API-workqueue-destroy.html"><span>probe::workqueue.destroy</span></a></span><span class="refpurpose"> —
- Destroying workqueue
- </span></dt><dt><span class="refentrytitle"><a href="API-workqueue-execute.html"><span>probe::workqueue.execute</span></a></span><span class="refpurpose"> —
- Executing deferred work
- </span></dt><dt><span class="refentrytitle"><a href="API-workqueue-insert.html"><span>probe::workqueue.insert</span></a></span><span class="refpurpose"> —
- Queuing work on a workqueue
- </span></dt></dl></div><p>
- This family of probe points is used to probe interrupt request
- (IRQ) activities.
- It contains the following probe points:
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tty-write.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-irq-handler-entry.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tty.write</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::irq_handler.entry</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 16. Kernel Process Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-tcpmib-RetransSegs.html" title="probe::tcpmib.RetransSegs"><link rel="next" href="API-target-set-pid.html" title="function::target_set_pid"></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">Chapter 16. Kernel Process Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tcpmib-RetransSegs.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-target-set-pid.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 16. Kernel Process Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="kprocess.stp"></a>Chapter 16. Kernel Process Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-target-set-pid.html"><span>function::target_set_pid</span></a></span><span class="refpurpose"> —
- Does pid descend from target process?
- </span></dt><dt><span class="refentrytitle"><a href="API-target-set-report.html"><span>function::target_set_report</span></a></span><span class="refpurpose"> —
- Print a report about the target set
- </span></dt><dt><span class="refentrytitle"><a href="API-kprocess-create.html"><span>probe::kprocess.create</span></a></span><span class="refpurpose"> —
- Fires whenever a new process or thread is successfully created
- </span></dt><dt><span class="refentrytitle"><a href="API-kprocess-exec.html"><span>probe::kprocess.exec</span></a></span><span class="refpurpose"> —
- Attempt to exec to a new program
- </span></dt><dt><span class="refentrytitle"><a href="API-kprocess-exec-complete.html"><span>probe::kprocess.exec_complete</span></a></span><span class="refpurpose"> —
- Return from exec to a new program
- </span></dt><dt><span class="refentrytitle"><a href="API-kprocess-exit.html"><span>probe::kprocess.exit</span></a></span><span class="refpurpose"> —
- Exit from process
- </span></dt><dt><span class="refentrytitle"><a href="API-kprocess-release.html"><span>probe::kprocess.release</span></a></span><span class="refpurpose"> —
- Process released
- </span></dt><dt><span class="refentrytitle"><a href="API-kprocess-start.html"><span>probe::kprocess.start</span></a></span><span class="refpurpose"> —
- Starting new process
- </span></dt></dl></div><p>
- This family of probe points is used to probe process-related activities.
- It contains the following probe points:
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tcpmib-RetransSegs.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-target-set-pid.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::tcpmib.RetransSegs</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::target_set_pid</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 21. Logging Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-task-dentry-path.html" title="function::task_dentry_path"><link rel="next" href="API-error.html" title="function::error"></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">Chapter 21. Logging Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-dentry-path.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-error.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 21. Logging Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="logging.stp"></a>Chapter 21. Logging Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-error.html"><span>function::error</span></a></span><span class="refpurpose"> —
- Send an error message
- </span></dt><dt><span class="refentrytitle"><a href="API-exit.html"><span>function::exit</span></a></span><span class="refpurpose"> —
- Start shutting down probing script.
- </span></dt><dt><span class="refentrytitle"><a href="API-ftrace.html"><span>function::ftrace</span></a></span><span class="refpurpose"> —
- Send a message to the ftrace ring-buffer
- </span></dt><dt><span class="refentrytitle"><a href="API-log.html"><span>function::log</span></a></span><span class="refpurpose"> —
- Send a line to the common trace buffer
- </span></dt><dt><span class="refentrytitle"><a href="API-printk.html"><span>function::printk</span></a></span><span class="refpurpose"> —
- Send a message to the kernel trace buffer
- </span></dt><dt><span class="refentrytitle"><a href="API-warn.html"><span>function::warn</span></a></span><span class="refpurpose"> —
- Send a line to the warning stream
- </span></dt></dl></div><p>
- This family of functions is used to send simple
- message strings to various destinations.
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-dentry-path.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-error.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_dentry_path</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::error</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 6. Memory Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-system.html" title="function::system"><link rel="next" href="API-addr-to-node.html" title="function::addr_to_node"></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">Chapter 6. Memory Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-system.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-addr-to-node.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 6. Memory Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="memory_stp"></a>Chapter 6. Memory Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-addr-to-node.html"><span>function::addr_to_node</span></a></span><span class="refpurpose"> —
- Returns which node a given address belongs to within a NUMA system
- </span></dt><dt><span class="refentrytitle"><a href="API-bytes-to-string.html"><span>function::bytes_to_string</span></a></span><span class="refpurpose"> —
- Human readable string for given bytes
- </span></dt><dt><span class="refentrytitle"><a href="API-mem-page-size.html"><span>function::mem_page_size</span></a></span><span class="refpurpose"> —
- Number of bytes in a page for this architecture
- </span></dt><dt><span class="refentrytitle"><a href="API-pages-to-string.html"><span>function::pages_to_string</span></a></span><span class="refpurpose"> —
- Turns pages into a human readable string
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-data.html"><span>function::proc_mem_data</span></a></span><span class="refpurpose"> —
- Program data size (data + stack) in pages
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-data-pid.html"><span>function::proc_mem_data_pid</span></a></span><span class="refpurpose"> —
- Program data size (data + stack) in pages
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-rss.html"><span>function::proc_mem_rss</span></a></span><span class="refpurpose"> —
- Program resident set size in pages
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-rss-pid.html"><span>function::proc_mem_rss_pid</span></a></span><span class="refpurpose"> —
- Program resident set size in pages
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-shr.html"><span>function::proc_mem_shr</span></a></span><span class="refpurpose"> —
- Program shared pages (from shared mappings)
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-shr-pid.html"><span>function::proc_mem_shr_pid</span></a></span><span class="refpurpose"> —
- Program shared pages (from shared mappings)
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-size.html"><span>function::proc_mem_size</span></a></span><span class="refpurpose"> —
- Total program virtual memory size in pages
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-size-pid.html"><span>function::proc_mem_size_pid</span></a></span><span class="refpurpose"> —
- Total program virtual memory size in pages
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-string.html"><span>function::proc_mem_string</span></a></span><span class="refpurpose"> —
- Human readable string of current proc memory usage
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-string-pid.html"><span>function::proc_mem_string_pid</span></a></span><span class="refpurpose"> —
- Human readable string of process memory usage
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-txt.html"><span>function::proc_mem_txt</span></a></span><span class="refpurpose"> —
- Program text (code) size in pages
- </span></dt><dt><span class="refentrytitle"><a href="API-proc-mem-txt-pid.html"><span>function::proc_mem_txt_pid</span></a></span><span class="refpurpose"> —
- Program text (code) size in pages
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-fault-contains.html"><span>function::vm_fault_contains</span></a></span><span class="refpurpose"> —
- Test return value for page fault reason
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-brk.html"><span>probe::vm.brk</span></a></span><span class="refpurpose"> —
- Fires when a brk is requested (i.e. the heap will be resized)
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-kfree.html"><span>probe::vm.kfree</span></a></span><span class="refpurpose"> —
- Fires when kfree is requested
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-kmalloc.html"><span>probe::vm.kmalloc</span></a></span><span class="refpurpose"> —
- Fires when kmalloc is requested
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-kmalloc-node.html"><span>probe::vm.kmalloc_node</span></a></span><span class="refpurpose"> —
- Fires when kmalloc_node is requested
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-kmem-cache-alloc.html"><span>probe::vm.kmem_cache_alloc</span></a></span><span class="refpurpose"> —
- Fires when kmem_cache_alloc is requested
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-kmem-cache-alloc-node.html"><span>probe::vm.kmem_cache_alloc_node</span></a></span><span class="refpurpose"> —
- Fires when kmem_cache_alloc_node is requested
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-kmem-cache-free.html"><span>probe::vm.kmem_cache_free</span></a></span><span class="refpurpose"> —
- Fires when kmem_cache_free is requested
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-mmap.html"><span>probe::vm.mmap</span></a></span><span class="refpurpose"> —
- Fires when an mmap is requested
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-munmap.html"><span>probe::vm.munmap</span></a></span><span class="refpurpose"> —
- Fires when an munmap is requested
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-oom-kill.html"><span>probe::vm.oom_kill</span></a></span><span class="refpurpose"> —
- Fires when a thread is selected for termination by the OOM killer
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-pagefault.html"><span>probe::vm.pagefault</span></a></span><span class="refpurpose"> —
- Records that a page fault occurred
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-pagefault-return.html"><span>probe::vm.pagefault.return</span></a></span><span class="refpurpose"> —
- Indicates what type of fault occurred
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-write-shared.html"><span>probe::vm.write_shared</span></a></span><span class="refpurpose"> —
- Attempts at writing to a shared page
- </span></dt><dt><span class="refentrytitle"><a href="API-vm-write-shared-copy.html"><span>probe::vm.write_shared_copy</span></a></span><span class="refpurpose"> —
- Page copy for shared page write
- </span></dt></dl></div><p>
- This family of probe points is used to probe memory-related events
- or query the memory usage of the current process.
- It contains the following probe points:
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-system.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-addr-to-node.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::system</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::addr_to_node</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 13. Networking Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-workqueue-insert.html" title="probe::workqueue.insert"><link rel="next" href="API-format-ipaddr.html" title="function::format_ipaddr"></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">Chapter 13. Networking Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-workqueue-insert.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-format-ipaddr.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 13. Networking Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="networking.stp"></a>Chapter 13. Networking Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-format-ipaddr.html"><span>function::format_ipaddr</span></a></span><span class="refpurpose"> —
- Returns a string representation for an IP address
- </span></dt><dt><span class="refentrytitle"><a href="API-htonl.html"><span>function::htonl</span></a></span><span class="refpurpose"> —
- Convert 32-bit long from host to network order
- </span></dt><dt><span class="refentrytitle"><a href="API-htonll.html"><span>function::htonll</span></a></span><span class="refpurpose"> —
- Convert 64-bit long long from host to network order
- </span></dt><dt><span class="refentrytitle"><a href="API-htons.html"><span>function::htons</span></a></span><span class="refpurpose"> —
- Convert 16-bit short from host to network order
- </span></dt><dt><span class="refentrytitle"><a href="API-ip-ntop.html"><span>function::ip_ntop</span></a></span><span class="refpurpose"> —
- Returns a string representation for an IPv4 address
- </span></dt><dt><span class="refentrytitle"><a href="API-ntohl.html"><span>function::ntohl</span></a></span><span class="refpurpose"> —
- Convert 32-bit long from network to host order
- </span></dt><dt><span class="refentrytitle"><a href="API-ntohll.html"><span>function::ntohll</span></a></span><span class="refpurpose"> —
- Convert 64-bit long long from network to host order
- </span></dt><dt><span class="refentrytitle"><a href="API-ntohs.html"><span>function::ntohs</span></a></span><span class="refpurpose"> —
- Convert 16-bit short from network to host order
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-change-mac.html"><span>probe::netdev.change_mac</span></a></span><span class="refpurpose"> —
- Called when the netdev_name has the MAC changed
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-change-mtu.html"><span>probe::netdev.change_mtu</span></a></span><span class="refpurpose"> —
- Called when the netdev MTU is changed
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-change-rx-flag.html"><span>probe::netdev.change_rx_flag</span></a></span><span class="refpurpose"> —
- Called when the device RX flag will be changed
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-close.html"><span>probe::netdev.close</span></a></span><span class="refpurpose"> —
- Called when the device is closed
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-get-stats.html"><span>probe::netdev.get_stats</span></a></span><span class="refpurpose"> —
- Called when someone asks the device statistics
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-hard-transmit.html"><span>probe::netdev.hard_transmit</span></a></span><span class="refpurpose"> —
- Called when the devices is going to TX (hard)
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-ioctl.html"><span>probe::netdev.ioctl</span></a></span><span class="refpurpose"> —
- Called when the device suffers an IOCTL
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-open.html"><span>probe::netdev.open</span></a></span><span class="refpurpose"> —
- Called when the device is opened
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-receive.html"><span>probe::netdev.receive</span></a></span><span class="refpurpose"> —
- Data received from network device.
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-register.html"><span>probe::netdev.register</span></a></span><span class="refpurpose"> —
- Called when the device is registered
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-rx.html"><span>probe::netdev.rx</span></a></span><span class="refpurpose"> —
- Called when the device is going to receive a packet
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-set-promiscuity.html"><span>probe::netdev.set_promiscuity</span></a></span><span class="refpurpose"> —
- Called when the device enters/leaves promiscuity
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-transmit.html"><span>probe::netdev.transmit</span></a></span><span class="refpurpose"> —
- Network device transmitting buffer
- </span></dt><dt><span class="refentrytitle"><a href="API-netdev-unregister.html"><span>probe::netdev.unregister</span></a></span><span class="refpurpose"> —
- Called when the device is being unregistered
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-arp-forward.html"><span>probe::netfilter.arp.forward</span></a></span><span class="refpurpose"> —
- - Called for each ARP packet to be forwarded
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-arp-in.html"><span>probe::netfilter.arp.in</span></a></span><span class="refpurpose"> —
- - Called for each incoming ARP packet
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-arp-out.html"><span>probe::netfilter.arp.out</span></a></span><span class="refpurpose"> —
- - Called for each outgoing ARP packet
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-bridge-forward.html"><span>probe::netfilter.bridge.forward</span></a></span><span class="refpurpose"> —
- Called on an incoming bridging packet destined for some other computer
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-bridge-local-in.html"><span>probe::netfilter.bridge.local_in</span></a></span><span class="refpurpose"> —
- Called on a bridging packet destined for the local computer
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-bridge-local-out.html"><span>probe::netfilter.bridge.local_out</span></a></span><span class="refpurpose"> —
- Called on a bridging packet coming from a local process
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-bridge-post-routing.html"><span>probe::netfilter.bridge.post_routing</span></a></span><span class="refpurpose"> —
- - Called before a bridging packet hits the wire
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-bridge-pre-routing.html"><span>probe::netfilter.bridge.pre_routing</span></a></span><span class="refpurpose"> —
- - Called before a bridging packet is routed
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-ip-forward.html"><span>probe::netfilter.ip.forward</span></a></span><span class="refpurpose"> —
- Called on an incoming IP packet addressed to some other computer
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-ip-local-in.html"><span>probe::netfilter.ip.local_in</span></a></span><span class="refpurpose"> —
- Called on an incoming IP packet addressed to the local computer
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-ip-local-out.html"><span>probe::netfilter.ip.local_out</span></a></span><span class="refpurpose"> —
- Called on an outgoing IP packet
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-ip-post-routing.html"><span>probe::netfilter.ip.post_routing</span></a></span><span class="refpurpose"> —
- Called immediately before an outgoing IP packet leaves the computer
- </span></dt><dt><span class="refentrytitle"><a href="API-netfilter-ip-pre-routing.html"><span>probe::netfilter.ip.pre_routing</span></a></span><span class="refpurpose"> —
- Called before an IP packet is routed
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-clnt-bind-new-program.html"><span>probe::sunrpc.clnt.bind_new_program</span></a></span><span class="refpurpose"> —
- Bind a new RPC program to an existing client
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-clnt-call-async.html"><span>probe::sunrpc.clnt.call_async</span></a></span><span class="refpurpose"> —
- Make an asynchronous RPC call
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-clnt-call-sync.html"><span>probe::sunrpc.clnt.call_sync</span></a></span><span class="refpurpose"> —
- Make a synchronous RPC call
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-clnt-clone-client.html"><span>probe::sunrpc.clnt.clone_client</span></a></span><span class="refpurpose"> —
- Clone an RPC client structure
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-clnt-create-client.html"><span>probe::sunrpc.clnt.create_client</span></a></span><span class="refpurpose"> —
- Create an RPC client
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-clnt-restart-call.html"><span>probe::sunrpc.clnt.restart_call</span></a></span><span class="refpurpose"> —
- Restart an asynchronous RPC call
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-clnt-shutdown-client.html"><span>probe::sunrpc.clnt.shutdown_client</span></a></span><span class="refpurpose"> —
- Shutdown an RPC client
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-sched-delay.html"><span>probe::sunrpc.sched.delay</span></a></span><span class="refpurpose"> —
- Delay an RPC task
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-sched-execute.html"><span>probe::sunrpc.sched.execute</span></a></span><span class="refpurpose"> —
- Execute the RPC `scheduler'
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-sched-new-task.html"><span>probe::sunrpc.sched.new_task</span></a></span><span class="refpurpose"> —
- Create new task for the specified client
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-sched-release-task.html"><span>probe::sunrpc.sched.release_task</span></a></span><span class="refpurpose"> —
- Release all resources associated with a task
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-svc-create.html"><span>probe::sunrpc.svc.create</span></a></span><span class="refpurpose"> —
- Create an RPC service
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-svc-destroy.html"><span>probe::sunrpc.svc.destroy</span></a></span><span class="refpurpose"> —
- Destroy an RPC service
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-svc-drop.html"><span>probe::sunrpc.svc.drop</span></a></span><span class="refpurpose"> —
- Drop RPC request
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-svc-process.html"><span>probe::sunrpc.svc.process</span></a></span><span class="refpurpose"> —
- Process an RPC request
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-svc-recv.html"><span>probe::sunrpc.svc.recv</span></a></span><span class="refpurpose"> —
- Listen for the next RPC request on any socket
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-svc-register.html"><span>probe::sunrpc.svc.register</span></a></span><span class="refpurpose"> —
- Register an RPC service with the local portmapper
- </span></dt><dt><span class="refentrytitle"><a href="API-sunrpc-svc-send.html"><span>probe::sunrpc.svc.send</span></a></span><span class="refpurpose"> —
- Return reply to RPC client
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-disconnect.html"><span>probe::tcp.disconnect</span></a></span><span class="refpurpose"> —
- TCP socket disconnection
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-disconnect-return.html"><span>probe::tcp.disconnect.return</span></a></span><span class="refpurpose"> —
- TCP socket disconnection complete
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-receive.html"><span>probe::tcp.receive</span></a></span><span class="refpurpose"> —
- Called when a TCP packet is received
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-recvmsg.html"><span>probe::tcp.recvmsg</span></a></span><span class="refpurpose"> —
- Receiving TCP message
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-recvmsg-return.html"><span>probe::tcp.recvmsg.return</span></a></span><span class="refpurpose"> —
- Receiving TCP message complete
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-sendmsg.html"><span>probe::tcp.sendmsg</span></a></span><span class="refpurpose"> —
- Sending a tcp message
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-sendmsg-return.html"><span>probe::tcp.sendmsg.return</span></a></span><span class="refpurpose"> —
- Sending TCP message is done
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-setsockopt.html"><span>probe::tcp.setsockopt</span></a></span><span class="refpurpose"> —
- Call to <code class="function">setsockopt</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-tcp-setsockopt-return.html"><span>probe::tcp.setsockopt.return</span></a></span><span class="refpurpose"> —
- Return from <code class="function">setsockopt</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-udp-disconnect.html"><span>probe::udp.disconnect</span></a></span><span class="refpurpose"> —
- Fires when a process requests for a UDP disconnection
- </span></dt><dt><span class="refentrytitle"><a href="API-udp-disconnect-return.html"><span>probe::udp.disconnect.return</span></a></span><span class="refpurpose"> —
- UDP has been disconnected successfully
- </span></dt><dt><span class="refentrytitle"><a href="API-udp-recvmsg.html"><span>probe::udp.recvmsg</span></a></span><span class="refpurpose"> —
- Fires whenever a UDP message is received
- </span></dt><dt><span class="refentrytitle"><a href="API-udp-recvmsg-return.html"><span>probe::udp.recvmsg.return</span></a></span><span class="refpurpose"> —
- Fires whenever an attempt to receive a UDP message received is completed
- </span></dt><dt><span class="refentrytitle"><a href="API-udp-sendmsg.html"><span>probe::udp.sendmsg</span></a></span><span class="refpurpose"> —
- Fires whenever a process sends a UDP message
- </span></dt><dt><span class="refentrytitle"><a href="API-udp-sendmsg-return.html"><span>probe::udp.sendmsg.return</span></a></span><span class="refpurpose"> —
- Fires whenever an attempt to send a UDP message is completed
- </span></dt></dl></div><p>
- This family of probe points is used to probe the activities of
- the network device and protocol layers.
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-workqueue-insert.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-format-ipaddr.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::workqueue.insert</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::format_ipaddr</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 30. Network File Storage Tapsets</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-staprun-send-control-message.html" title="probe::staprun.send_control_message"><link rel="next" href="API-nfsderror.html" title="function::nfsderror"></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">Chapter 30. Network File Storage Tapsets</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-staprun-send-control-message.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-nfsderror.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 30. Network File Storage Tapsets"><div class="titlepage"><div><div><h2 class="title"><a name="nfsd.stp"></a>Chapter 30. Network File Storage Tapsets</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-nfsderror.html"><span>function::nfsderror</span></a></span><span class="refpurpose"> —
- Convert nfsd error number into string
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-aop-readpage.html"><span>probe::nfs.aop.readpage</span></a></span><span class="refpurpose"> —
- NFS client synchronously reading a page
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-aop-readpages.html"><span>probe::nfs.aop.readpages</span></a></span><span class="refpurpose"> —
- NFS client reading multiple pages
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-aop-release-page.html"><span>probe::nfs.aop.release_page</span></a></span><span class="refpurpose"> —
- NFS client releasing page
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-aop-set-page-dirty.html"><span>probe::nfs.aop.set_page_dirty</span></a></span><span class="refpurpose"> —
- NFS client marking page as dirty
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-aop-write-begin.html"><span>probe::nfs.aop.write_begin</span></a></span><span class="refpurpose"> —
- NFS client begin to write data
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-aop-write-end.html"><span>probe::nfs.aop.write_end</span></a></span><span class="refpurpose"> —
- NFS client complete writing data
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-aop-writepage.html"><span>probe::nfs.aop.writepage</span></a></span><span class="refpurpose"> —
- NFS client writing a mapped page to the NFS server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-aop-writepages.html"><span>probe::nfs.aop.writepages</span></a></span><span class="refpurpose"> —
- NFS client writing several dirty pages to the NFS server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-aio-read.html"><span>probe::nfs.fop.aio_read</span></a></span><span class="refpurpose"> —
- NFS client aio_read file operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-aio-write.html"><span>probe::nfs.fop.aio_write</span></a></span><span class="refpurpose"> —
- NFS client aio_write file operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-check-flags.html"><span>probe::nfs.fop.check_flags</span></a></span><span class="refpurpose"> —
- NFS client checking flag operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-flush.html"><span>probe::nfs.fop.flush</span></a></span><span class="refpurpose"> —
- NFS client flush file operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-fsync.html"><span>probe::nfs.fop.fsync</span></a></span><span class="refpurpose"> —
- NFS client fsync operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-llseek.html"><span>probe::nfs.fop.llseek</span></a></span><span class="refpurpose"> —
- NFS client llseek operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-lock.html"><span>probe::nfs.fop.lock</span></a></span><span class="refpurpose"> —
- NFS client file lock operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-mmap.html"><span>probe::nfs.fop.mmap</span></a></span><span class="refpurpose"> —
- NFS client mmap operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-open.html"><span>probe::nfs.fop.open</span></a></span><span class="refpurpose"> —
- NFS client file open operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-read.html"><span>probe::nfs.fop.read</span></a></span><span class="refpurpose"> —
- NFS client read operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-release.html"><span>probe::nfs.fop.release</span></a></span><span class="refpurpose"> —
- NFS client release page operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-sendfile.html"><span>probe::nfs.fop.sendfile</span></a></span><span class="refpurpose"> —
- NFS client send file operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-fop-write.html"><span>probe::nfs.fop.write</span></a></span><span class="refpurpose"> —
- NFS client write operation
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-commit.html"><span>probe::nfs.proc.commit</span></a></span><span class="refpurpose"> —
- NFS client committing data on server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-commit-done.html"><span>probe::nfs.proc.commit_done</span></a></span><span class="refpurpose"> —
- NFS client response to a commit RPC task
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-commit-setup.html"><span>probe::nfs.proc.commit_setup</span></a></span><span class="refpurpose"> —
- NFS client setting up a commit RPC task
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-create.html"><span>probe::nfs.proc.create</span></a></span><span class="refpurpose"> —
- NFS client creating file on server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-handle-exception.html"><span>probe::nfs.proc.handle_exception</span></a></span><span class="refpurpose"> —
- NFS client handling an NFSv4 exception
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-lookup.html"><span>probe::nfs.proc.lookup</span></a></span><span class="refpurpose"> —
- NFS client opens/searches a file on server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-open.html"><span>probe::nfs.proc.open</span></a></span><span class="refpurpose"> —
- NFS client allocates file read/write context information
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-read.html"><span>probe::nfs.proc.read</span></a></span><span class="refpurpose"> —
- NFS client synchronously reads file from server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-read-done.html"><span>probe::nfs.proc.read_done</span></a></span><span class="refpurpose"> —
- NFS client response to a read RPC task
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-read-setup.html"><span>probe::nfs.proc.read_setup</span></a></span><span class="refpurpose"> —
- NFS client setting up a read RPC task
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-release.html"><span>probe::nfs.proc.release</span></a></span><span class="refpurpose"> —
- NFS client releases file read/write context information
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-remove.html"><span>probe::nfs.proc.remove</span></a></span><span class="refpurpose"> —
- NFS client removes a file on server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-rename.html"><span>probe::nfs.proc.rename</span></a></span><span class="refpurpose"> —
- NFS client renames a file on server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-write.html"><span>probe::nfs.proc.write</span></a></span><span class="refpurpose"> —
- NFS client synchronously writes file to server
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-write-done.html"><span>probe::nfs.proc.write_done</span></a></span><span class="refpurpose"> —
- NFS client response to a write RPC task
- </span></dt><dt><span class="refentrytitle"><a href="API-nfs-proc-write-setup.html"><span>probe::nfs.proc.write_setup</span></a></span><span class="refpurpose"> —
- NFS client setting up a write RPC task
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-close.html"><span>probe::nfsd.close</span></a></span><span class="refpurpose"> —
- NFS server closing a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-commit.html"><span>probe::nfsd.commit</span></a></span><span class="refpurpose"> —
- NFS server committing all pending writes to stable storage
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-create.html"><span>probe::nfsd.create</span></a></span><span class="refpurpose"> —
- NFS server creating a file(regular,dir,device,fifo) for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-createv3.html"><span>probe::nfsd.createv3</span></a></span><span class="refpurpose"> —
- NFS server creating a regular file or set file attributes for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-dispatch.html"><span>probe::nfsd.dispatch</span></a></span><span class="refpurpose"> —
- NFS server receives an operation from client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-lookup.html"><span>probe::nfsd.lookup</span></a></span><span class="refpurpose"> —
- NFS server opening or searching file for a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-open.html"><span>probe::nfsd.open</span></a></span><span class="refpurpose"> —
- NFS server opening a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-proc-commit.html"><span>probe::nfsd.proc.commit</span></a></span><span class="refpurpose"> —
- NFS server performing a commit operation for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-proc-create.html"><span>probe::nfsd.proc.create</span></a></span><span class="refpurpose"> —
- NFS server creating a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-proc-lookup.html"><span>probe::nfsd.proc.lookup</span></a></span><span class="refpurpose"> —
- NFS server opening or searching for a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-proc-read.html"><span>probe::nfsd.proc.read</span></a></span><span class="refpurpose"> —
- NFS server reading file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-proc-remove.html"><span>probe::nfsd.proc.remove</span></a></span><span class="refpurpose"> —
- NFS server removing a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-proc-rename.html"><span>probe::nfsd.proc.rename</span></a></span><span class="refpurpose"> —
- NFS Server renaming a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-proc-write.html"><span>probe::nfsd.proc.write</span></a></span><span class="refpurpose"> —
- NFS server writing data to file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-read.html"><span>probe::nfsd.read</span></a></span><span class="refpurpose"> —
- NFS server reading data from a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-rename.html"><span>probe::nfsd.rename</span></a></span><span class="refpurpose"> —
- NFS server renaming a file for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-unlink.html"><span>probe::nfsd.unlink</span></a></span><span class="refpurpose"> —
- NFS server removing a file or a directory for client
- </span></dt><dt><span class="refentrytitle"><a href="API-nfsd-write.html"><span>probe::nfsd.write</span></a></span><span class="refpurpose"> —
- NFS server writing data to a file for client
- </span></dt></dl></div><p>
- This family of probe points is used to probe network file storage
- functions and operations.
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-staprun-send-control-message.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-nfsderror.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::staprun.send_control_message</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::nfsderror</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 22. Queue Statistics Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-warn.html" title="function::warn"><link rel="next" href="API-qs-done.html" title="function::qs_done"></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">Chapter 22. Queue Statistics Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-warn.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-qs-done.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 22. Queue Statistics Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="queue_stats.stp"></a>Chapter 22. Queue Statistics Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-qs-done.html"><span>function::qs_done</span></a></span><span class="refpurpose"> —
- Function to record finishing request
- </span></dt><dt><span class="refentrytitle"><a href="API-qs-run.html"><span>function::qs_run</span></a></span><span class="refpurpose"> —
- Function to record being moved from wait queue to being serviced
- </span></dt><dt><span class="refentrytitle"><a href="API-qs-wait.html"><span>function::qs_wait</span></a></span><span class="refpurpose"> —
- Function to record enqueue requests
- </span></dt><dt><span class="refentrytitle"><a href="API-qsq-blocked.html"><span>function::qsq_blocked</span></a></span><span class="refpurpose"> —
- Returns the time reqest was on the wait queue
- </span></dt><dt><span class="refentrytitle"><a href="API-qsq-print.html"><span>function::qsq_print</span></a></span><span class="refpurpose"> —
- Prints a line of statistics for the given queue
- </span></dt><dt><span class="refentrytitle"><a href="API-qsq-service-time.html"><span>function::qsq_service_time</span></a></span><span class="refpurpose"> —
- Amount of time per request service
- </span></dt><dt><span class="refentrytitle"><a href="API-qsq-start.html"><span>function::qsq_start</span></a></span><span class="refpurpose"> —
- Function to reset the stats for a queue
- </span></dt><dt><span class="refentrytitle"><a href="API-qsq-throughput.html"><span>function::qsq_throughput</span></a></span><span class="refpurpose"> —
- Number of requests served per unit time
- </span></dt><dt><span class="refentrytitle"><a href="API-qsq-utilization.html"><span>function::qsq_utilization</span></a></span><span class="refpurpose"> —
- Fraction of time that any request was being serviced
- </span></dt><dt><span class="refentrytitle"><a href="API-qsq-wait-queue-length.html"><span>function::qsq_wait_queue_length</span></a></span><span class="refpurpose"> —
- length of wait queue
- </span></dt><dt><span class="refentrytitle"><a href="API-qsq-wait-time.html"><span>function::qsq_wait_time</span></a></span><span class="refpurpose"> —
- Amount of time in queue + service per request
- </span></dt></dl></div><p>
- This family of functions is used to track performance of queuing systems.
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-warn.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-qs-done.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::warn</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::qs_done</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 23. Random functions Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-qsq-wait-time.html" title="function::qsq_wait_time"><link rel="next" href="API-randint.html" title="function::randint"></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">Chapter 23. Random functions Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-qsq-wait-time.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-randint.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 23. Random functions Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="random.stp"></a>Chapter 23. Random functions Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-randint.html"><span>function::randint</span></a></span><span class="refpurpose"> —
- Return a random number between [0,n)
- </span></dt></dl></div><p>
- These functions deal with random number generation.
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-qsq-wait-time.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-randint.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::qsq_wait_time</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::randint</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 8. Scheduler Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-task-utime-tid.html" title="function::task_utime_tid"><link rel="next" href="API-scheduler-balance.html" title="probe::scheduler.balance"></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">Chapter 8. Scheduler Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-task-utime-tid.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-scheduler-balance.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 8. Scheduler Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="sched.stp"></a>Chapter 8. Scheduler Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-scheduler-balance.html"><span>probe::scheduler.balance</span></a></span><span class="refpurpose"> —
- A cpu attempting to find more work.
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-cpu-off.html"><span>probe::scheduler.cpu_off</span></a></span><span class="refpurpose"> —
- Process is about to stop running on a cpu
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-cpu-on.html"><span>probe::scheduler.cpu_on</span></a></span><span class="refpurpose"> —
- Process is beginning execution on a cpu
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-ctxswitch.html"><span>probe::scheduler.ctxswitch</span></a></span><span class="refpurpose"> —
- A context switch is occuring.
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-kthread-stop.html"><span>probe::scheduler.kthread_stop</span></a></span><span class="refpurpose"> —
- A thread created by kthread_create is being stopped
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-kthread-stop-return.html"><span>probe::scheduler.kthread_stop.return</span></a></span><span class="refpurpose"> —
- A kthread is stopped and gets the return value
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-migrate.html"><span>probe::scheduler.migrate</span></a></span><span class="refpurpose"> —
- Task migrating across cpus
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-process-exit.html"><span>probe::scheduler.process_exit</span></a></span><span class="refpurpose"> —
- Process exiting
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-process-fork.html"><span>probe::scheduler.process_fork</span></a></span><span class="refpurpose"> —
- Process forked
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-process-free.html"><span>probe::scheduler.process_free</span></a></span><span class="refpurpose"> —
- Scheduler freeing a data structure for a process
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-process-wait.html"><span>probe::scheduler.process_wait</span></a></span><span class="refpurpose"> —
- Scheduler starting to wait on a process
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-signal-send.html"><span>probe::scheduler.signal_send</span></a></span><span class="refpurpose"> —
- Sending a signal
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-tick.html"><span>probe::scheduler.tick</span></a></span><span class="refpurpose"> —
- Schedulers internal tick, a processes timeslice accounting is updated
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-wait-task.html"><span>probe::scheduler.wait_task</span></a></span><span class="refpurpose"> —
- Waiting on a task to unschedule (become inactive)
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-wakeup.html"><span>probe::scheduler.wakeup</span></a></span><span class="refpurpose"> —
- Task is woken up
- </span></dt><dt><span class="refentrytitle"><a href="API-scheduler-wakeup-new.html"><span>probe::scheduler.wakeup_new</span></a></span><span class="refpurpose"> —
- Newly created task is woken up for the first time
- </span></dt></dl></div><p>
- This family of probe points is used to probe the task scheduler activities.
- It contains the following probe points:
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-task-utime-tid.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-scheduler-balance.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::task_utime_tid</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scheduler.balance</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 10. SCSI Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-ioscheduler-trace-unplug-timer.html" title="probe::ioscheduler_trace.unplug_timer"><link rel="next" href="API-scsi-iocompleted.html" title="probe::scsi.iocompleted"></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">Chapter 10. SCSI Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ioscheduler-trace-unplug-timer.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-scsi-iocompleted.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 10. SCSI Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="scsi.stp"></a>Chapter 10. SCSI Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-scsi-iocompleted.html"><span>probe::scsi.iocompleted</span></a></span><span class="refpurpose"> —
- SCSI mid-layer running the completion processing for block device I/O requests
- </span></dt><dt><span class="refentrytitle"><a href="API-scsi-iodispatching.html"><span>probe::scsi.iodispatching</span></a></span><span class="refpurpose"> —
- SCSI mid-layer dispatched low-level SCSI command
- </span></dt><dt><span class="refentrytitle"><a href="API-scsi-iodone.html"><span>probe::scsi.iodone</span></a></span><span class="refpurpose"> —
- SCSI command completed by low level driver and enqueued into the done queue.
- </span></dt><dt><span class="refentrytitle"><a href="API-scsi-ioentry.html"><span>probe::scsi.ioentry</span></a></span><span class="refpurpose"> —
- Prepares a SCSI mid-layer request
- </span></dt><dt><span class="refentrytitle"><a href="API-scsi-ioexecute.html"><span>probe::scsi.ioexecute</span></a></span><span class="refpurpose"> —
- Create mid-layer SCSI request and wait for the result
- </span></dt><dt><span class="refentrytitle"><a href="API-scsi-set-state.html"><span>probe::scsi.set_state</span></a></span><span class="refpurpose"> —
- Order SCSI device state change
- </span></dt></dl></div><p>
- This family of probe points is used to probe SCSI activities.
- It contains the following probe points:
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ioscheduler-trace-unplug-timer.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-scsi-iocompleted.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::ioscheduler_trace.unplug_timer</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::scsi.iocompleted</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 17. Signal Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-kprocess-start.html" title="probe::kprocess.start"><link rel="next" href="API-get-sa-flags.html" title="function::get_sa_flags"></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">Chapter 17. Signal Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-kprocess-start.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-get-sa-flags.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 17. Signal Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="signal.stp"></a>Chapter 17. Signal Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-get-sa-flags.html"><span>function::get_sa_flags</span></a></span><span class="refpurpose"> —
- Returns the numeric value of sa_flags
- </span></dt><dt><span class="refentrytitle"><a href="API-get-sa-handler.html"><span>function::get_sa_handler</span></a></span><span class="refpurpose"> —
- Returns the numeric value of sa_handler
- </span></dt><dt><span class="refentrytitle"><a href="API-is-sig-blocked.html"><span>function::is_sig_blocked</span></a></span><span class="refpurpose"> —
- Returns 1 if the signal is currently blocked, or 0 if it is not
- </span></dt><dt><span class="refentrytitle"><a href="API-sa-flags-str.html"><span>function::sa_flags_str</span></a></span><span class="refpurpose"> —
- Returns the string representation of sa_flags
- </span></dt><dt><span class="refentrytitle"><a href="API-sa-handler-str.html"><span>function::sa_handler_str</span></a></span><span class="refpurpose"> —
- Returns the string representation of an sa_handler
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-str.html"><span>function::signal_str</span></a></span><span class="refpurpose"> —
- Returns the string representation of a signal number
- </span></dt><dt><span class="refentrytitle"><a href="API-sigset-mask-str.html"><span>function::sigset_mask_str</span></a></span><span class="refpurpose"> —
- Returns the string representation of a sigset
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-check-ignored.html"><span>probe::signal.check_ignored</span></a></span><span class="refpurpose"> —
- Checking to see signal is ignored
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-check-ignored-return.html"><span>probe::signal.check_ignored.return</span></a></span><span class="refpurpose"> —
- Check to see signal is ignored completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-checkperm.html"><span>probe::signal.checkperm</span></a></span><span class="refpurpose"> —
- Check being performed on a sent signal
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-checkperm-return.html"><span>probe::signal.checkperm.return</span></a></span><span class="refpurpose"> —
- Check performed on a sent signal completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-do-action.html"><span>probe::signal.do_action</span></a></span><span class="refpurpose"> —
- Examining or changing a signal action
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-do-action-return.html"><span>probe::signal.do_action.return</span></a></span><span class="refpurpose"> —
- Examining or changing a signal action completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-flush.html"><span>probe::signal.flush</span></a></span><span class="refpurpose"> —
- Flushing all pending signals for a task
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-force-segv.html"><span>probe::signal.force_segv</span></a></span><span class="refpurpose"> —
- Forcing send of SIGSEGV
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-force-segv-return.html"><span>probe::signal.force_segv.return</span></a></span><span class="refpurpose"> —
- Forcing send of SIGSEGV complete
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-handle.html"><span>probe::signal.handle</span></a></span><span class="refpurpose"> —
- Signal handler being invoked
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-handle-return.html"><span>probe::signal.handle.return</span></a></span><span class="refpurpose"> —
- Signal handler invocation completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-pending.html"><span>probe::signal.pending</span></a></span><span class="refpurpose"> —
- Examining pending signal
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-pending-return.html"><span>probe::signal.pending.return</span></a></span><span class="refpurpose"> —
- Examination of pending signal completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-procmask.html"><span>probe::signal.procmask</span></a></span><span class="refpurpose"> —
- Examining or changing blocked signals
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-procmask-return.html"><span>probe::signal.procmask.return</span></a></span><span class="refpurpose"> —
- Examining or changing blocked signals completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-send.html"><span>probe::signal.send</span></a></span><span class="refpurpose"> —
- Signal being sent to a process
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-send-return.html"><span>probe::signal.send.return</span></a></span><span class="refpurpose"> —
- Signal being sent to a process completed (deprecated in SystemTap 2.1)
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-send-sig-queue.html"><span>probe::signal.send_sig_queue</span></a></span><span class="refpurpose"> —
- Queuing a signal to a process
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-send-sig-queue-return.html"><span>probe::signal.send_sig_queue.return</span></a></span><span class="refpurpose"> —
- Queuing a signal to a process completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-sys-tgkill.html"><span>probe::signal.sys_tgkill</span></a></span><span class="refpurpose"> —
- Sending kill signal to a thread group
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-sys-tgkill-return.html"><span>probe::signal.sys_tgkill.return</span></a></span><span class="refpurpose"> —
- Sending kill signal to a thread group completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-sys-tkill.html"><span>probe::signal.sys_tkill</span></a></span><span class="refpurpose"> —
- Sending a kill signal to a thread
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-syskill.html"><span>probe::signal.syskill</span></a></span><span class="refpurpose"> —
- Sending kill signal to a process
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-syskill-return.html"><span>probe::signal.syskill.return</span></a></span><span class="refpurpose"> —
- Sending kill signal completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-systkill-return.html"><span>probe::signal.systkill.return</span></a></span><span class="refpurpose"> —
- Sending kill signal to a thread completed
- </span></dt><dt><span class="refentrytitle"><a href="API-signal-wakeup.html"><span>probe::signal.wakeup</span></a></span><span class="refpurpose"> —
- Sleeping process being wakened for signal
- </span></dt></dl></div><p>
- This family of probe points is used to probe signal activities.
- It contains the following probe points:
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-kprocess-start.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-get-sa-flags.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::kprocess.start</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::get_sa_flags</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 15. SNMP Information Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-socket-writev-return.html" title="probe::socket.writev.return"><link rel="next" href="API-ipmib-filter-key.html" title="function::ipmib_filter_key"></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">Chapter 15. SNMP Information Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-socket-writev-return.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-ipmib-filter-key.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 15. SNMP Information Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="snmp.stp"></a>Chapter 15. SNMP Information Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-ipmib-filter-key.html"><span>function::ipmib_filter_key</span></a></span><span class="refpurpose"> —
- Default filter function for ipmib.* probes
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-get-proto.html"><span>function::ipmib_get_proto</span></a></span><span class="refpurpose"> —
- Get the protocol value
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-local-addr.html"><span>function::ipmib_local_addr</span></a></span><span class="refpurpose"> —
- Get the local ip address
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-remote-addr.html"><span>function::ipmib_remote_addr</span></a></span><span class="refpurpose"> —
- Get the remote ip address
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-tcp-local-port.html"><span>function::ipmib_tcp_local_port</span></a></span><span class="refpurpose"> —
- Get the local tcp port
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-tcp-remote-port.html"><span>function::ipmib_tcp_remote_port</span></a></span><span class="refpurpose"> —
- Get the remote tcp port
- </span></dt><dt><span class="refentrytitle"><a href="API-linuxmib-filter-key.html"><span>function::linuxmib_filter_key</span></a></span><span class="refpurpose"> —
- Default filter function for linuxmib.* probes
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-filter-key.html"><span>function::tcpmib_filter_key</span></a></span><span class="refpurpose"> —
- Default filter function for tcpmib.* probes
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-get-state.html"><span>function::tcpmib_get_state</span></a></span><span class="refpurpose"> —
- Get a socket's state
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-local-addr.html"><span>function::tcpmib_local_addr</span></a></span><span class="refpurpose"> —
- Get the source address
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-local-port.html"><span>function::tcpmib_local_port</span></a></span><span class="refpurpose"> —
- Get the local port
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-remote-addr.html"><span>function::tcpmib_remote_addr</span></a></span><span class="refpurpose"> —
- Get the remote address
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-remote-port.html"><span>function::tcpmib_remote_port</span></a></span><span class="refpurpose"> —
- Get the remote port
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-ForwDatagrams.html"><span>probe::ipmib.ForwDatagrams</span></a></span><span class="refpurpose"> —
- Count forwarded packet
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-FragFails.html"><span>probe::ipmib.FragFails</span></a></span><span class="refpurpose"> —
- Count datagram fragmented unsuccessfully
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-FragOKs.html"><span>probe::ipmib.FragOKs</span></a></span><span class="refpurpose"> —
- Count datagram fragmented successfully
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-InAddrErrors.html"><span>probe::ipmib.InAddrErrors</span></a></span><span class="refpurpose"> —
- Count arriving packets with an incorrect address
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-InDiscards.html"><span>probe::ipmib.InDiscards</span></a></span><span class="refpurpose"> —
- Count discarded inbound packets
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-InNoRoutes.html"><span>probe::ipmib.InNoRoutes</span></a></span><span class="refpurpose"> —
- Count an arriving packet with no matching socket
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-InReceives.html"><span>probe::ipmib.InReceives</span></a></span><span class="refpurpose"> —
- Count an arriving packet
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-InUnknownProtos.html"><span>probe::ipmib.InUnknownProtos</span></a></span><span class="refpurpose"> —
- Count arriving packets with an unbound proto
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-OutRequests.html"><span>probe::ipmib.OutRequests</span></a></span><span class="refpurpose"> —
- Count a request to send a packet
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-ReasmReqds.html"><span>probe::ipmib.ReasmReqds</span></a></span><span class="refpurpose"> —
- Count number of packet fragments reassembly requests
- </span></dt><dt><span class="refentrytitle"><a href="API-ipmib-ReasmTimeout.html"><span>probe::ipmib.ReasmTimeout</span></a></span><span class="refpurpose"> —
- Count Reassembly Timeouts
- </span></dt><dt><span class="refentrytitle"><a href="API-linuxmib-DelayedACKs.html"><span>probe::linuxmib.DelayedACKs</span></a></span><span class="refpurpose"> —
- Count of delayed acks
- </span></dt><dt><span class="refentrytitle"><a href="API-linuxmib-ListenDrops.html"><span>probe::linuxmib.ListenDrops</span></a></span><span class="refpurpose"> —
- Count of times conn request that were dropped
- </span></dt><dt><span class="refentrytitle"><a href="API-linuxmib-ListenOverflows.html"><span>probe::linuxmib.ListenOverflows</span></a></span><span class="refpurpose"> —
- Count of times a listen queue overflowed
- </span></dt><dt><span class="refentrytitle"><a href="API-linuxmib-TCPMemoryPressures.html"><span>probe::linuxmib.TCPMemoryPressures</span></a></span><span class="refpurpose"> —
- Count of times memory pressure was used
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-ActiveOpens.html"><span>probe::tcpmib.ActiveOpens</span></a></span><span class="refpurpose"> —
- Count an active opening of a socket
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-AttemptFails.html"><span>probe::tcpmib.AttemptFails</span></a></span><span class="refpurpose"> —
- Count a failed attempt to open a socket
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-CurrEstab.html"><span>probe::tcpmib.CurrEstab</span></a></span><span class="refpurpose"> —
- Update the count of open sockets
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-EstabResets.html"><span>probe::tcpmib.EstabResets</span></a></span><span class="refpurpose"> —
- Count the reset of a socket
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-InSegs.html"><span>probe::tcpmib.InSegs</span></a></span><span class="refpurpose"> —
- Count an incoming tcp segment
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-OutRsts.html"><span>probe::tcpmib.OutRsts</span></a></span><span class="refpurpose"> —
- Count the sending of a reset packet
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-OutSegs.html"><span>probe::tcpmib.OutSegs</span></a></span><span class="refpurpose"> —
- Count the sending of a TCP segment
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-PassiveOpens.html"><span>probe::tcpmib.PassiveOpens</span></a></span><span class="refpurpose"> —
- Count the passive creation of a socket
- </span></dt><dt><span class="refentrytitle"><a href="API-tcpmib-RetransSegs.html"><span>probe::tcpmib.RetransSegs</span></a></span><span class="refpurpose"> —
- Count the retransmission of a TCP segment
- </span></dt></dl></div><p>
- This family of probe points is used to probe socket activities to
- provide SNMP type information. It contains the following functions
- and probe points:
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-socket-writev-return.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-ipmib-filter-key.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::socket.writev.return</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::ipmib_filter_key</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 14. Socket Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-udp-sendmsg-return.html" title="probe::udp.sendmsg.return"><link rel="next" href="API-inet-get-ip-source.html" title="function::inet_get_ip_source"></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">Chapter 14. Socket Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-udp-sendmsg-return.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-inet-get-ip-source.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 14. Socket Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="socket.stp"></a>Chapter 14. Socket Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-inet-get-ip-source.html"><span>function::inet_get_ip_source</span></a></span><span class="refpurpose"> —
- Provide IP source address string for a kernel socket
- </span></dt><dt><span class="refentrytitle"><a href="API-inet-get-local-port.html"><span>function::inet_get_local_port</span></a></span><span class="refpurpose"> —
- Provide local port number for a kernel socket
- </span></dt><dt><span class="refentrytitle"><a href="API-sock-fam-num2str.html"><span>function::sock_fam_num2str</span></a></span><span class="refpurpose"> —
- Given a protocol family number, return a string representation
- </span></dt><dt><span class="refentrytitle"><a href="API-sock-fam-str2num.html"><span>function::sock_fam_str2num</span></a></span><span class="refpurpose"> —
- Given a protocol family name (string), return the corresponding protocol family number
- </span></dt><dt><span class="refentrytitle"><a href="API-sock-prot-num2str.html"><span>function::sock_prot_num2str</span></a></span><span class="refpurpose"> —
- Given a protocol number, return a string representation
- </span></dt><dt><span class="refentrytitle"><a href="API-sock-prot-str2num.html"><span>function::sock_prot_str2num</span></a></span><span class="refpurpose"> —
- Given a protocol name (string), return the corresponding protocol number
- </span></dt><dt><span class="refentrytitle"><a href="API-sock-state-num2str.html"><span>function::sock_state_num2str</span></a></span><span class="refpurpose"> —
- Given a socket state number, return a string representation
- </span></dt><dt><span class="refentrytitle"><a href="API-sock-state-str2num.html"><span>function::sock_state_str2num</span></a></span><span class="refpurpose"> —
- Given a socket state string, return the corresponding state number
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-aio-read.html"><span>probe::socket.aio_read</span></a></span><span class="refpurpose"> —
- Receiving message via <code class="function">sock_aio_read</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-aio-read-return.html"><span>probe::socket.aio_read.return</span></a></span><span class="refpurpose"> —
- Conclusion of message received via <code class="function">sock_aio_read</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-aio-write.html"><span>probe::socket.aio_write</span></a></span><span class="refpurpose"> —
- Message send via <code class="function">sock_aio_write</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-aio-write-return.html"><span>probe::socket.aio_write.return</span></a></span><span class="refpurpose"> —
- Conclusion of message send via <code class="function">sock_aio_write</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-close.html"><span>probe::socket.close</span></a></span><span class="refpurpose"> —
- Close a socket
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-close-return.html"><span>probe::socket.close.return</span></a></span><span class="refpurpose"> —
- Return from closing a socket
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-create.html"><span>probe::socket.create</span></a></span><span class="refpurpose"> —
- Creation of a socket
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-create-return.html"><span>probe::socket.create.return</span></a></span><span class="refpurpose"> —
- Return from Creation of a socket
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-readv.html"><span>probe::socket.readv</span></a></span><span class="refpurpose"> —
- Receiving a message via <code class="function">sock_readv</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-readv-return.html"><span>probe::socket.readv.return</span></a></span><span class="refpurpose"> —
- Conclusion of receiving a message via <code class="function">sock_readv</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-receive.html"><span>probe::socket.receive</span></a></span><span class="refpurpose"> —
- Message received on a socket.
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-recvmsg.html"><span>probe::socket.recvmsg</span></a></span><span class="refpurpose"> —
- Message being received on socket
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-recvmsg-return.html"><span>probe::socket.recvmsg.return</span></a></span><span class="refpurpose"> —
- Return from Message being received on socket
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-send.html"><span>probe::socket.send</span></a></span><span class="refpurpose"> —
- Message sent on a socket.
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-sendmsg.html"><span>probe::socket.sendmsg</span></a></span><span class="refpurpose"> —
- Message is currently being sent on a socket.
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-sendmsg-return.html"><span>probe::socket.sendmsg.return</span></a></span><span class="refpurpose"> —
- Return from socket.sendmsg.
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-writev.html"><span>probe::socket.writev</span></a></span><span class="refpurpose"> —
- Message sent via <code class="function">socket_writev</code>
- </span></dt><dt><span class="refentrytitle"><a href="API-socket-writev-return.html"><span>probe::socket.writev.return</span></a></span><span class="refpurpose"> —
- Conclusion of message sent via <code class="function">socket_writev</code>
- </span></dt></dl></div><p>
- This family of probe points is used to probe socket activities.
- It contains the following probe points:
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-udp-sendmsg-return.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-inet-get-ip-source.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::udp.sendmsg.return</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::inet_get_ip_source</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 31. Speculation</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-nfsd-write.html" title="probe::nfsd.write"><link rel="next" href="API-commit.html" title="function::commit"></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">Chapter 31. Speculation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-nfsd-write.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-commit.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 31. Speculation"><div class="titlepage"><div><div><h2 class="title"><a name="speculation.stp"></a>Chapter 31. Speculation</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-commit.html"><span>function::commit</span></a></span><span class="refpurpose"> —
- Write out all output related to a speculation buffer
- </span></dt><dt><span class="refentrytitle"><a href="API-discard.html"><span>function::discard</span></a></span><span class="refpurpose"> —
- Discard all output related to a speculation buffer
- </span></dt><dt><span class="refentrytitle"><a href="API-speculate.html"><span>function::speculate</span></a></span><span class="refpurpose"> —
- Store a string for possible output later
- </span></dt><dt><span class="refentrytitle"><a href="API-speculation.html"><span>function::speculation</span></a></span><span class="refpurpose"> —
- Allocate a new id for speculative output
- </span></dt></dl></div><p>
- This family of functions provides the ability to speculative record
- information and then at a later point in the SystemTap script either
- commit the information or discard it.
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-nfsd-write.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-commit.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::nfsd.write</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::commit</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 29. SystemTap Translator Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-thread-indent.html" title="function::thread_indent"><link rel="next" href="API-stap-cache-add-mod.html" title="probe::stap.cache_add_mod"></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">Chapter 29. SystemTap Translator Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-thread-indent.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-stap-cache-add-mod.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 29. SystemTap Translator Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="stap_staticmarkers.stp"></a>Chapter 29. SystemTap Translator Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-stap-cache-add-mod.html"><span>probe::stap.cache_add_mod</span></a></span><span class="refpurpose"> —
- Adding kernel instrumentation module to cache
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-cache-add-nss.html"><span>probe::stap.cache_add_nss</span></a></span><span class="refpurpose"> —
- Add NSS (Network Security Services) information to cache
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-cache-add-src.html"><span>probe::stap.cache_add_src</span></a></span><span class="refpurpose"> —
- Adding C code translation to cache
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-cache-clean.html"><span>probe::stap.cache_clean</span></a></span><span class="refpurpose"> —
- Removing file from stap cache
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-cache-get.html"><span>probe::stap.cache_get</span></a></span><span class="refpurpose"> —
- Found item in stap cache
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass0.html"><span>probe::stap.pass0</span></a></span><span class="refpurpose"> —
- Starting stap pass0 (parsing command line arguments)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass0-end.html"><span>probe::stap.pass0.end</span></a></span><span class="refpurpose"> —
- Finished stap pass0 (parsing command line arguments)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass1-end.html"><span>probe::stap.pass1.end</span></a></span><span class="refpurpose"> —
- Finished stap pass1 (parsing scripts)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass1a.html"><span>probe::stap.pass1a</span></a></span><span class="refpurpose"> —
- Starting stap pass1 (parsing user script)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass1b.html"><span>probe::stap.pass1b</span></a></span><span class="refpurpose"> —
- Starting stap pass1 (parsing library scripts)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass2.html"><span>probe::stap.pass2</span></a></span><span class="refpurpose"> —
- Starting stap pass2 (elaboration)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass2-end.html"><span>probe::stap.pass2.end</span></a></span><span class="refpurpose"> —
- Finished stap pass2 (elaboration)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass3.html"><span>probe::stap.pass3</span></a></span><span class="refpurpose"> —
- Starting stap pass3 (translation to C)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass3-end.html"><span>probe::stap.pass3.end</span></a></span><span class="refpurpose"> —
- Finished stap pass3 (translation to C)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass4.html"><span>probe::stap.pass4</span></a></span><span class="refpurpose"> —
- Starting stap pass4 (compile C code into kernel module)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass4-end.html"><span>probe::stap.pass4.end</span></a></span><span class="refpurpose"> —
- Finished stap pass4 (compile C code into kernel module)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass5.html"><span>probe::stap.pass5</span></a></span><span class="refpurpose"> —
- Starting stap pass5 (running the instrumentation)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass5-end.html"><span>probe::stap.pass5.end</span></a></span><span class="refpurpose"> —
- Finished stap pass5 (running the instrumentation)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass6.html"><span>probe::stap.pass6</span></a></span><span class="refpurpose"> —
- Starting stap pass6 (cleanup)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-pass6-end.html"><span>probe::stap.pass6.end</span></a></span><span class="refpurpose"> —
- Finished stap pass6 (cleanup)
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-system.html"><span>probe::stap.system</span></a></span><span class="refpurpose"> —
- Starting a command from stap
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-system-return.html"><span>probe::stap.system.return</span></a></span><span class="refpurpose"> —
- Finished a command from stap
- </span></dt><dt><span class="refentrytitle"><a href="API-stap-system-spawn.html"><span>probe::stap.system.spawn</span></a></span><span class="refpurpose"> —
- stap spawned new process
- </span></dt><dt><span class="refentrytitle"><a href="API-stapio-receive-control-message.html"><span>probe::stapio.receive_control_message</span></a></span><span class="refpurpose"> —
- Received a control message
- </span></dt><dt><span class="refentrytitle"><a href="API-staprun-insert-module.html"><span>probe::staprun.insert_module</span></a></span><span class="refpurpose"> —
- Inserting SystemTap instrumentation module
- </span></dt><dt><span class="refentrytitle"><a href="API-staprun-remove-module.html"><span>probe::staprun.remove_module</span></a></span><span class="refpurpose"> —
- Removing SystemTap instrumentation module
- </span></dt><dt><span class="refentrytitle"><a href="API-staprun-send-control-message.html"><span>probe::staprun.send_control_message</span></a></span><span class="refpurpose"> —
- Sending a control message
- </span></dt></dl></div><p>
- This family of user-space probe points is used to probe the operation of
- the SystemTap translator (<span class="command"><strong>stap</strong></span>) and run command
- (<span class="command"><strong>staprun</strong></span>).
- The tapset includes probes to watch the various phases of SystemTap
- and SystemTap's management of instrumentation cache.
- It contains the following probe points:
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-thread-indent.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-stap-cache-add-mod.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::thread_indent</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::stap.cache_add_mod</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 27. A collection of standard string functions</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-udelay.html" title="function::udelay"><link rel="next" href="API-isdigit.html" title="function::isdigit"></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">Chapter 27. A collection of standard string functions</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-udelay.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-isdigit.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 27. A collection of standard string functions"><div class="titlepage"><div><div><h2 class="title"><a name="string.stp"></a>Chapter 27. A collection of standard string functions</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-isdigit.html"><span>function::isdigit</span></a></span><span class="refpurpose"> —
- Checks for a digit
- </span></dt><dt><span class="refentrytitle"><a href="API-isinstr.html"><span>function::isinstr</span></a></span><span class="refpurpose"> —
- Returns whether a string is a substring of another string
- </span></dt><dt><span class="refentrytitle"><a href="API-str-replace.html"><span>function::str_replace</span></a></span><span class="refpurpose"> —
- str_replace Replaces all instances of a substring with another
- </span></dt><dt><span class="refentrytitle"><a href="API-stringat.html"><span>function::stringat</span></a></span><span class="refpurpose"> —
- Returns the char at a given position in the string
- </span></dt><dt><span class="refentrytitle"><a href="API-strlen.html"><span>function::strlen</span></a></span><span class="refpurpose"> —
- Returns the length of a string
- </span></dt><dt><span class="refentrytitle"><a href="API-strtol.html"><span>function::strtol</span></a></span><span class="refpurpose"> —
- strtol - Convert a string to a long
- </span></dt><dt><span class="refentrytitle"><a href="API-substr.html"><span>function::substr</span></a></span><span class="refpurpose"> —
- Returns a substring
- </span></dt><dt><span class="refentrytitle"><a href="API-text-str.html"><span>function::text_str</span></a></span><span class="refpurpose"> —
- Escape any non-printable chars in a string
- </span></dt><dt><span class="refentrytitle"><a href="API-text-strn.html"><span>function::text_strn</span></a></span><span class="refpurpose"> —
- Escape any non-printable chars in a string
- </span></dt><dt><span class="refentrytitle"><a href="API-tokenize.html"><span>function::tokenize</span></a></span><span class="refpurpose"> —
- Return the next non-empty token in a string
- </span></dt></dl></div><p>
- Functions to get the length, a substring, getting at individual
- characters, string seaching, escaping, tokenizing, and converting
- strings to longs.
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-udelay.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-isdigit.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::udelay</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::isdigit</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 5. Shell command functions</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-tz-name.html" title="function::tz_name"><link rel="next" href="API-system.html" title="function::system"></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">Chapter 5. Shell command functions</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-tz-name.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-system.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 5. Shell command functions"><div class="titlepage"><div><div><h2 class="title"><a name="system.stp"></a>Chapter 5. Shell command functions</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-system.html"><span>function::system</span></a></span><span class="refpurpose"> —
- Issue a command to the system
- </span></dt></dl></div><p>
- Utility functions to enqueue shell commands.
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-tz-name.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-system.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::tz_name</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::system</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 7. Task Time Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-vm-write-shared-copy.html" title="probe::vm.write_shared_copy"><link rel="next" href="API-cputime-to-msecs.html" title="function::cputime_to_msecs"></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">Chapter 7. Task Time Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-vm-write-shared-copy.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-cputime-to-msecs.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 7. Task Time Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="task_time_stp"></a>Chapter 7. Task Time Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-cputime-to-msecs.html"><span>function::cputime_to_msecs</span></a></span><span class="refpurpose"> —
- Translates the given cputime into milliseconds
- </span></dt><dt><span class="refentrytitle"><a href="API-cputime-to-string.html"><span>function::cputime_to_string</span></a></span><span class="refpurpose"> —
- Human readable string for given cputime
- </span></dt><dt><span class="refentrytitle"><a href="API-msecs-to-string.html"><span>function::msecs_to_string</span></a></span><span class="refpurpose"> —
- Human readable string for given milliseconds
- </span></dt><dt><span class="refentrytitle"><a href="API-task-stime.html"><span>function::task_stime</span></a></span><span class="refpurpose"> —
- System time of the current task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-stime-tid.html"><span>function::task_stime_tid</span></a></span><span class="refpurpose"> —
- System time of the given task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-time-string.html"><span>function::task_time_string</span></a></span><span class="refpurpose"> —
- Human readable string of task time usage
- </span></dt><dt><span class="refentrytitle"><a href="API-task-time-string-tid.html"><span>function::task_time_string_tid</span></a></span><span class="refpurpose"> —
- Human readable string of task time usage
- </span></dt><dt><span class="refentrytitle"><a href="API-task-utime.html"><span>function::task_utime</span></a></span><span class="refpurpose"> —
- User time of the current task
- </span></dt><dt><span class="refentrytitle"><a href="API-task-utime-tid.html"><span>function::task_utime_tid</span></a></span><span class="refpurpose"> —
- User time of the given task
- </span></dt></dl></div><p>
- This tapset defines utility functions to query time related
- properties of the current tasks, translate those in miliseconds
- and human readable strings.
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-vm-write-shared-copy.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-cputime-to-msecs.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::vm.write_shared_copy</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::cputime_to_msecs</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 3. Timestamp Functions</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-usymname.html" title="function::usymname"><link rel="next" href="API-HZ.html" title="function::HZ"></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">Chapter 3. Timestamp Functions</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-usymname.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-HZ.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 3. Timestamp Functions"><div class="titlepage"><div><div><h2 class="title"><a name="timestamp_stp"></a>Chapter 3. Timestamp Functions</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-HZ.html"><span>function::HZ</span></a></span><span class="refpurpose"> —
- Kernel HZ
- </span></dt><dt><span class="refentrytitle"><a href="API-cpu-clock-ms.html"><span>function::cpu_clock_ms</span></a></span><span class="refpurpose"> —
- Number of milliseconds on the given cpu's clock
- </span></dt><dt><span class="refentrytitle"><a href="API-cpu-clock-ns.html"><span>function::cpu_clock_ns</span></a></span><span class="refpurpose"> —
- Number of nanoseconds on the given cpu's clock
- </span></dt><dt><span class="refentrytitle"><a href="API-cpu-clock-s.html"><span>function::cpu_clock_s</span></a></span><span class="refpurpose"> —
- Number of seconds on the given cpu's clock
- </span></dt><dt><span class="refentrytitle"><a href="API-cpu-clock-us.html"><span>function::cpu_clock_us</span></a></span><span class="refpurpose"> —
- Number of microseconds on the given cpu's clock
- </span></dt><dt><span class="refentrytitle"><a href="API-delete-stopwatch.html"><span>function::delete_stopwatch</span></a></span><span class="refpurpose"> —
- Remove an existing stopwatch
- </span></dt><dt><span class="refentrytitle"><a href="API-get-cycles.html"><span>function::get_cycles</span></a></span><span class="refpurpose"> —
- Processor cycle count
- </span></dt><dt><span class="refentrytitle"><a href="API-gettimeofday-ms.html"><span>function::gettimeofday_ms</span></a></span><span class="refpurpose"> —
- Number of milliseconds since UNIX epoch
- </span></dt><dt><span class="refentrytitle"><a href="API-gettimeofday-ns.html"><span>function::gettimeofday_ns</span></a></span><span class="refpurpose"> —
- Number of nanoseconds since UNIX epoch
- </span></dt><dt><span class="refentrytitle"><a href="API-gettimeofday-s.html"><span>function::gettimeofday_s</span></a></span><span class="refpurpose"> —
- Number of seconds since UNIX epoch
- </span></dt><dt><span class="refentrytitle"><a href="API-gettimeofday-us.html"><span>function::gettimeofday_us</span></a></span><span class="refpurpose"> —
- Number of microseconds since UNIX epoch
- </span></dt><dt><span class="refentrytitle"><a href="API-jiffies.html"><span>function::jiffies</span></a></span><span class="refpurpose"> —
- Kernel jiffies count
- </span></dt><dt><span class="refentrytitle"><a href="API-local-clock-ms.html"><span>function::local_clock_ms</span></a></span><span class="refpurpose"> —
- Number of milliseconds on the local cpu's clock
- </span></dt><dt><span class="refentrytitle"><a href="API-local-clock-ns.html"><span>function::local_clock_ns</span></a></span><span class="refpurpose"> —
- Number of nanoseconds on the local cpu's clock
- </span></dt><dt><span class="refentrytitle"><a href="API-local-clock-s.html"><span>function::local_clock_s</span></a></span><span class="refpurpose"> —
- Number of seconds on the local cpu's clock
- </span></dt><dt><span class="refentrytitle"><a href="API-local-clock-us.html"><span>function::local_clock_us</span></a></span><span class="refpurpose"> —
- Number of microseconds on the local cpu's clock
- </span></dt><dt><span class="refentrytitle"><a href="API-read-stopwatch-ms.html"><span>function::read_stopwatch_ms</span></a></span><span class="refpurpose"> —
- Reads the time in milliseconds for a stopwatch
- </span></dt><dt><span class="refentrytitle"><a href="API-read-stopwatch-ns.html"><span>function::read_stopwatch_ns</span></a></span><span class="refpurpose"> —
- Reads the time in nanoseconds for a stopwatch
- </span></dt><dt><span class="refentrytitle"><a href="API-read-stopwatch-s.html"><span>function::read_stopwatch_s</span></a></span><span class="refpurpose"> —
- Reads the time in seconds for a stopwatch
- </span></dt><dt><span class="refentrytitle"><a href="API-read-stopwatch-us.html"><span>function::read_stopwatch_us</span></a></span><span class="refpurpose"> —
- Reads the time in microseconds for a stopwatch
- </span></dt><dt><span class="refentrytitle"><a href="API-start-stopwatch.html"><span>function::start_stopwatch</span></a></span><span class="refpurpose"> —
- Start a stopwatch
- </span></dt><dt><span class="refentrytitle"><a href="API-stop-stopwatch.html"><span>function::stop_stopwatch</span></a></span><span class="refpurpose"> —
- Stop a stopwatch
- </span></dt></dl></div><p>
- Each timestamp function returns a value to indicate when
- a function is executed.
- These returned values can then be used to indicate
- when an event occurred, provide an ordering for events, or compute
- the amount of time elapsed between two time stamps.
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-usymname.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-HZ.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>function::usymname</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::HZ</span></td></tr></table></div></body></html>
+++ /dev/null
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>Chapter 11. TTY Tapset</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="prev" href="API-scsi-set-state.html" title="probe::scsi.set_state"><link rel="next" href="API-tty-init.html" title="probe::tty.init"></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">Chapter 11. TTY Tapset</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-scsi-set-state.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="API-tty-init.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 11. TTY Tapset"><div class="titlepage"><div><div><h2 class="title"><a name="tty.stp"></a>Chapter 11. TTY Tapset</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="refentrytitle"><a href="API-tty-init.html"><span>probe::tty.init</span></a></span><span class="refpurpose"> —
- Called when a tty is being initalized
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-ioctl.html"><span>probe::tty.ioctl</span></a></span><span class="refpurpose"> —
- called when a ioctl is request to the tty
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-open.html"><span>probe::tty.open</span></a></span><span class="refpurpose"> —
- Called when a tty is opened
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-poll.html"><span>probe::tty.poll</span></a></span><span class="refpurpose"> —
- Called when a tty device is being polled
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-read.html"><span>probe::tty.read</span></a></span><span class="refpurpose"> —
- called when a tty line will be read
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-receive.html"><span>probe::tty.receive</span></a></span><span class="refpurpose"> —
- called when a tty receives a message
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-register.html"><span>probe::tty.register</span></a></span><span class="refpurpose"> —
- Called when a tty device is registred
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-release.html"><span>probe::tty.release</span></a></span><span class="refpurpose"> —
- Called when the tty is closed
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-resize.html"><span>probe::tty.resize</span></a></span><span class="refpurpose"> —
- Called when a terminal resize happens
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-unregister.html"><span>probe::tty.unregister</span></a></span><span class="refpurpose"> —
- Called when a tty device is being unregistered
- </span></dt><dt><span class="refentrytitle"><a href="API-tty-write.html"><span>probe::tty.write</span></a></span><span class="refpurpose"> —
- write to the tty line
- </span></dt></dl></div><p>
- This family of probe points is used to probe TTY (Teletype) activities.
- It contains the following probe points:
- </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-scsi-set-state.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="API-tty-init.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::scsi.set_state</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>probe::tty.init</span></td></tr></table></div></body></html>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
-<!--Converted with LaTeX2HTML 2008 (1.71)
+<!--Converted with LaTeX2HTML 2012 (1.2)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
-<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META NAME="Generator" CONTENT="LaTeX2HTML v2012">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="tutorial.css">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
-<!--Converted with LaTeX2HTML 2008 (1.71)
+<!--Converted with LaTeX2HTML 2012 (1.2)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
-<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META NAME="Generator" CONTENT="LaTeX2HTML v2012">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="tutorial.css">
</H1>
<P>
This document was generated using the
-<A HREF="http://www.latex2html.org/"><STRONG>LaTeX</STRONG>2<tt>HTML</tt></A> translator Version 2008 (1.71)
+<A HREF="http://www.latex2html.org/"><STRONG>LaTeX</STRONG>2<tt>HTML</tt></A> translator Version 2012 (1.2)
<P>
Copyright © 1993, 1994, 1995, 1996,
<A HREF="http://cbl.leeds.ac.uk/nikos/personal.html">Nikos Drakos</A>,
Mathematics Department, Macquarie University, Sydney.
<P>
The command line arguments were: <BR>
- <STRONG>latex2html</STRONG> <TT>-noaddress -show_section_numbers -custom_titles -local_icons -split 4 tutorial.tex -dir /tmp/stapdocsUio/htdocs/tutorial/</TT>
+ <STRONG>latex2html</STRONG> <TT>-noaddress -show_section_numbers -custom_titles -local_icons -split 4 tutorial.tex -dir /tmp/stapdocsjJY/htdocs/tutorial/</TT>
<P>
-The translation was initiated by lberk on 2013-03-14
+The translation was initiated by mcermak on 2014-05-16
<BR><HR>
</BODY>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
-<!--Converted with LaTeX2HTML 2008 (1.71)
+<!--Converted with LaTeX2HTML 2012 (1.2)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
-<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META NAME="Generator" CONTENT="LaTeX2HTML v2012">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="tutorial.css">
Two functions, <code>user_string</code> and <code>kernel_string</code>, can copy
<code>char *</code> target variables into systemtap strings.
Figure <A HREF="#fig:inode-watch"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A> demonstrates one way to monitor a
-particular file (identifed by device number and inode number).
+particular file (identified by device number and inode number).
The script selects the appropriate variants of <code>dev_nr</code>
and<code>inode_nr</code> based on the kernel version.
This example also demonstrates passing numeric command-line arguments
and so on. Systemtap offers associative arrays for this purpose.
These arrays are implemented as hash tables with a maximum size that
is fixed at startup. Because they are too large to be created
-dynamically for inidividual probes handler runs, they must be declared
+dynamically for individual probes handler runs, they must be declared
as global.
<P>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
-<!--Converted with LaTeX2HTML 2008 (1.71)
+<!--Converted with LaTeX2HTML 2012 (1.2)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
-<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META NAME="Generator" CONTENT="LaTeX2HTML v2012">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="tutorial.css">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
-<!--Converted with LaTeX2HTML 2008 (1.71)
+<!--Converted with LaTeX2HTML 2012 (1.2)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
-<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META NAME="Generator" CONTENT="LaTeX2HTML v2012">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="tutorial.css">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
-<!--Converted with LaTeX2HTML 2008 (1.71)
+<!--Converted with LaTeX2HTML 2012 (1.2)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
-<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META NAME="Generator" CONTENT="LaTeX2HTML v2012">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="tutorial.css">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
-<!--Converted with LaTeX2HTML 2008 (1.71)
+<!--Converted with LaTeX2HTML 2012 (1.2)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
-<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META NAME="Generator" CONTENT="LaTeX2HTML v2012">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="tutorial.css">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
-<!--Converted with LaTeX2HTML 2008 (1.71)
+<!--Converted with LaTeX2HTML 2012 (1.2)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
-<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META NAME="Generator" CONTENT="LaTeX2HTML v2012">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="tutorial.css">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
-<!--Converted with LaTeX2HTML 2008 (1.71)
+<!--Converted with LaTeX2HTML 2012 (1.2)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
-<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META NAME="Generator" CONTENT="LaTeX2HTML v2012">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="tutorial.css">
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
-<!--Converted with LaTeX2HTML 2008 (1.71)
+<!--Converted with LaTeX2HTML 2012 (1.2)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
-<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META NAME="Generator" CONTENT="LaTeX2HTML v2012">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="tutorial.css">
return now don't match anymore. This is because now the first probe
will match both normal function entry and inlined functions. Try
putting the <code>.call</code> modifier back and add another probe just for
- <code>probe kernel.function("*@net/socket.c").return</code>
+ <code>probe kernel.function("*@net/socket.c").inline</code>
What <code>printf</code> statement can you come up with in the probe handler
to show the inlined function entries nicely in between the <code>.call</code>
and <code>.return</code> thread indented output?
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
-<!--Converted with LaTeX2HTML 2008 (1.71)
+<!--Converted with LaTeX2HTML 2012 (1.2)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
-<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META NAME="Generator" CONTENT="LaTeX2HTML v2012">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="tutorial.css">
-# LaTeX2HTML 2008 (1.71)
+# LaTeX2HTML 2012 (1.2)
# Associate images original text with physical files.
ALT="\begin{center}\begin{Sbox}\begin{minipage}{4.5in}
\begin{verbatim}...">|;
-$key = q/{makeimage}center{Sbox{minipage{{4.5in}preform{<verbatim_mark>verbatim38#preform{minipage{Sbox{{fbox{TheSbox}{center{{makeimage};MSF=1.6;AAT/;
+$key = q/{makeimage}center{Sbox{minipage{{4.5in}preform{<verbatim_mark>verbatim41#preform{minipage{Sbox{{fbox{TheSbox}{center{{makeimage};MSF=1.6;AAT/;
$cached_env_img{$key} = q|<IMG
- WIDTH="529" HEIGHT="423" ALIGN="BOTTOM" BORDER="0"
- SRC="|."$dir".q|img2.png"
+ WIDTH="529" HEIGHT="327" ALIGN="BOTTOM" BORDER="0"
+ SRC="|."$dir".q|img4.png"
ALT="\begin{center}\begin{Sbox}\begin{minipage}{4.5in}
\begin{verbatim}...">|;
-$key = q/{makeimage}center{Sbox{minipage{{4.5in}preform{<verbatim_mark>verbatim48#preform{minipage{Sbox{{fbox{TheSbox}{center{{makeimage};MSF=1.6;AAT/;
+$key = q/{makeimage}center{Sbox{minipage{{4.5in}preform{<verbatim_mark>verbatim40#preform{minipage{Sbox{{fbox{TheSbox}{center{{makeimage};MSF=1.6;AAT/;
$cached_env_img{$key} = q|<IMG
- WIDTH="529" HEIGHT="554" ALIGN="BOTTOM" BORDER="0"
- SRC="|."$dir".q|img12.png"
+ WIDTH="529" HEIGHT="612" ALIGN="BOTTOM" BORDER="0"
+ SRC="|."$dir".q|img3.png"
+ ALT="\begin{center}\begin{Sbox}\begin{minipage}{4.5in}
+\begin{verbatim}...">|;
+
+$key = q/{makeimage}center{Sbox{minipage{{4.5in}preform{<verbatim_mark>verbatim47#preform{minipage{Sbox{{fbox{TheSbox}{center{{makeimage};MSF=1.6;AAT/;
+$cached_env_img{$key} = q|<IMG
+ WIDTH="529" HEIGHT="728" ALIGN="BOTTOM" BORDER="0"
+ SRC="|."$dir".q|img11.png"
ALT="\begin{center}\begin{Sbox}\begin{minipage}{4.5in}
\begin{verbatim}...">|;
SRC="|."$dir".q|img7.png"
ALT="$0 \ldots 100$">|;
-$key = q/{makeimage}center{Sbox{minipage{{6in}preform{<verbatim_mark>verbatim45#preform{minipage{Sbox{{fbox{TheSbox}{center{{makeimage};MSF=1.6;AAT/;
+$key = q/{makeimage}center{Sbox{minipage{{4.5in}preform{<verbatim_mark>verbatim38#preform{minipage{Sbox{{fbox{TheSbox}{center{{makeimage};MSF=1.6;AAT/;
$cached_env_img{$key} = q|<IMG
- WIDTH="702" HEIGHT="251" ALIGN="BOTTOM" BORDER="0"
- SRC="|."$dir".q|img9.png"
- ALT="\begin{center}\begin{Sbox}\begin{minipage}{6in}
+ WIDTH="529" HEIGHT="423" ALIGN="BOTTOM" BORDER="0"
+ SRC="|."$dir".q|img2.png"
+ ALT="\begin{center}\begin{Sbox}\begin{minipage}{4.5in}
+\begin{verbatim}...">|;
+
+$key = q/{makeimage}center{Sbox{minipage{{4.5in}preform{<verbatim_mark>verbatim43#preform{minipage{Sbox{{fbox{TheSbox}{center{{makeimage};MSF=1.6;AAT/;
+$cached_env_img{$key} = q|<IMG
+ WIDTH="529" HEIGHT="402" ALIGN="BOTTOM" BORDER="0"
+ SRC="|."$dir".q|img6.png"
+ ALT="\begin{center}\begin{Sbox}\begin{minipage}{4.5in}
\begin{verbatim}...">|;
$key = q/{makeimage}center{Sbox{minipage{{4.5in}preform{<verbatim_mark>verbatim42#preform{minipage{Sbox{{fbox{TheSbox}{center{{makeimage};MSF=1.6;AAT/;
SRC="|."$dir".q|img13.png"
ALT="$\ldots$">|;
-$key = q/{makeimage}center{Sbox{minipage{{4.5in}preform{<verbatim_mark>verbatim41#preform{minipage{Sbox{{fbox{TheSbox}{center{{makeimage};MSF=1.6;AAT/;
+$key = q/{makeimage}center{Sbox{minipage{{6in}preform{<verbatim_mark>verbatim45#preform{minipage{Sbox{{fbox{TheSbox}{center{{makeimage};MSF=1.6;AAT/;
$cached_env_img{$key} = q|<IMG
- WIDTH="529" HEIGHT="327" ALIGN="BOTTOM" BORDER="0"
- SRC="|."$dir".q|img4.png"
- ALT="\begin{center}\begin{Sbox}\begin{minipage}{4.5in}
+ WIDTH="702" HEIGHT="251" ALIGN="BOTTOM" BORDER="0"
+ SRC="|."$dir".q|img9.png"
+ ALT="\begin{center}\begin{Sbox}\begin{minipage}{6in}
\begin{verbatim}...">|;
-$key = q/10;MSF=1.6;AAT/;
+$key = q/{makeimage}center{Sbox{minipage{{4.5in}preform{<verbatim_mark>verbatim48#preform{minipage{Sbox{{fbox{TheSbox}{center{{makeimage};MSF=1.6;AAT/;
$cached_env_img{$key} = q|<IMG
- WIDTH="20" HEIGHT="18" ALIGN="BOTTOM" BORDER="0"
- SRC="|."$dir".q|img8.png"
- ALT="$10$">|;
+ WIDTH="529" HEIGHT="554" ALIGN="BOTTOM" BORDER="0"
+ SRC="|."$dir".q|img12.png"
+ ALT="\begin{center}\begin{Sbox}\begin{minipage}{4.5in}
+\begin{verbatim}...">|;
$key = q/{makeimage}center{Sbox{minipage{{6in}preform{<verbatim_mark>verbatim46#preform{minipage{Sbox{{fbox{TheSbox}{center{{makeimage};MSF=1.6;AAT/;
$cached_env_img{$key} = q|<IMG
ALT="\begin{center}\begin{Sbox}\begin{minipage}{6in}
\begin{verbatim}...">|;
-$key = q/{makeimage}center{Sbox{minipage{{4.5in}preform{<verbatim_mark>verbatim43#preform{minipage{Sbox{{fbox{TheSbox}{center{{makeimage};MSF=1.6;AAT/;
-$cached_env_img{$key} = q|<IMG
- WIDTH="529" HEIGHT="402" ALIGN="BOTTOM" BORDER="0"
- SRC="|."$dir".q|img6.png"
- ALT="\begin{center}\begin{Sbox}\begin{minipage}{4.5in}
-\begin{verbatim}...">|;
-
-$key = q/{makeimage}center{Sbox{minipage{{4.5in}preform{<verbatim_mark>verbatim40#preform{minipage{Sbox{{fbox{TheSbox}{center{{makeimage};MSF=1.6;AAT/;
-$cached_env_img{$key} = q|<IMG
- WIDTH="529" HEIGHT="612" ALIGN="BOTTOM" BORDER="0"
- SRC="|."$dir".q|img3.png"
- ALT="\begin{center}\begin{Sbox}\begin{minipage}{4.5in}
-\begin{verbatim}...">|;
-
-$key = q/{makeimage}center{Sbox{minipage{{4.5in}preform{<verbatim_mark>verbatim47#preform{minipage{Sbox{{fbox{TheSbox}{center{{makeimage};MSF=1.6;AAT/;
+$key = q/10;MSF=1.6;AAT/;
$cached_env_img{$key} = q|<IMG
- WIDTH="529" HEIGHT="728" ALIGN="BOTTOM" BORDER="0"
- SRC="|."$dir".q|img11.png"
- ALT="\begin{center}\begin{Sbox}\begin{minipage}{4.5in}
-\begin{verbatim}...">|;
+ WIDTH="20" HEIGHT="18" ALIGN="BOTTOM" BORDER="0"
+ SRC="|."$dir".q|img8.png"
+ ALT="$10$">|;
1;
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
-<!--Converted with LaTeX2HTML 2008 (1.71)
+<!--Converted with LaTeX2HTML 2012 (1.2)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
-<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META NAME="Generator" CONTENT="LaTeX2HTML v2012">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="tutorial.css">
<TR><TD>
Frank Ch. Eigler <TT><FONT SIZE="-1"><fche@redhat.com></FONT></TT>
<BR>
-March 14, 2013
+May 16, 2014
</TD></TR>
</TABLE>
-# LaTeX2HTML 2008 (1.71)
+# LaTeX2HTML 2012 (1.2)
# Associate labels original text with physical files.
-$key = q/fig:strace-open/;
-$external_labels{$key} = "$URL/" . q|Introduction.html|;
+$key = q/fig:embedded-C/;
+$external_labels{$key} = "$URL/" . q|Tapsets.html|;
+$noresave{$key} = "$nosave";
+
+$key = q/embedded-c/;
+$external_labels{$key} = "$URL/" . q|Tapsets.html|;
+$noresave{$key} = "$nosave";
+
+$key = q/fig:functions/;
+$external_labels{$key} = "$URL/" . q|Analysis.html|;
$noresave{$key} = "$nosave";
$key = q/fig:hello-world/;
$external_labels{$key} = "$URL/" . q|Introduction.html|;
$noresave{$key} = "$nosave";
-$key = q/fig:probe-alias/;
-$external_labels{$key} = "$URL/" . q|Tapsets.html|;
+$key = q/fig:strace-open/;
+$external_labels{$key} = "$URL/" . q|Introduction.html|;
$noresave{$key} = "$nosave";
-$key = q/embedded-c/;
+$key = q/fig:probe-alias/;
$external_labels{$key} = "$URL/" . q|Tapsets.html|;
$noresave{$key} = "$nosave";
-$key = q/fig:embedded-C/;
-$external_labels{$key} = "$URL/" . q|Tapsets.html|;
+$key = q/fig:inode-watch/;
+$external_labels{$key} = "$URL/" . q|Analysis.html|;
$noresave{$key} = "$nosave";
-$key = q/fig:timer-jiffies/;
+$key = q/sec:safety/;
$external_labels{$key} = "$URL/" . q|Analysis.html|;
$noresave{$key} = "$nosave";
-$key = q/fig:functions/;
+$key = q/fig:timer-jiffies/;
$external_labels{$key} = "$URL/" . q|Analysis.html|;
$noresave{$key} = "$nosave";
$external_labels{$key} = "$URL/" . q|Tracing.html|;
$noresave{$key} = "$nosave";
-$key = q/sec:safety/;
-$external_labels{$key} = "$URL/" . q|Analysis.html|;
-$noresave{$key} = "$nosave";
-
-$key = q/fig:tapset-search/;
+$key = q/fig:tapset-default/;
$external_labels{$key} = "$URL/" . q|Tapsets.html|;
$noresave{$key} = "$nosave";
-$key = q/fig:inode-watch/;
-$external_labels{$key} = "$URL/" . q|Analysis.html|;
-$noresave{$key} = "$nosave";
-
-$key = q/fig:tapset-default/;
+$key = q/fig:tapset-search/;
$external_labels{$key} = "$URL/" . q|Tapsets.html|;
$noresave{$key} = "$nosave";
1;
-# LaTeX2HTML 2008 (1.71)
+# LaTeX2HTML 2012 (1.2)
# labels from external_latex_labels array.
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
-<!--Converted with LaTeX2HTML 2008 (1.71)
+<!--Converted with LaTeX2HTML 2012 (1.2)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
-<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
+<META NAME="Generator" CONTENT="LaTeX2HTML v2012">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="tutorial.css">
<TR><TD>
Frank Ch. Eigler <TT><FONT SIZE="-1"><fche@redhat.com></FONT></TT>
<BR>
-March 14, 2013
+May 16, 2014
</TD></TR>
</TABLE>
git://sourceware.org / systemtap-htdocs.git / commitdiff
