Debian Codegraph @

doc/SystemTap_Tapset_Reference/man3/probe::ioblock_trace.bounce.3stap

raw
1 '\" t
2 .\" Title: probe::ioblock_trace.bounce
3 .\" Author:
4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
5 .\" Date: October 2025
6 .\" Manual: IO Scheduler and block IO Tapset
7 .\" Source: SystemTap Tapset Reference
8 .\" Language: English
9 .\"
10 .TH "PROBE::IOBLOCK_TRACE" "3stap" "October 2025" "SystemTap Tapset Reference" "IO Scheduler and block IO Taps"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAME"
31 probe::ioblock_trace.bounce \- Fires whenever a buffer bounce is needed for at least one page of a block IO request\&.
32 .SH "SYNOPSIS"
33 .sp
34 .nf
35 ioblock_trace\&.bounce
36 .fi
37 .SH "VALUES"
38 .PP
39 \fIbdev\fR
40 .RS 4
41 target block device
42 .RE
43 .PP
44 \fIq\fR
45 .RS 4
46 request queue on which this bio was queued\&.
47 .RE
48 .PP
49 \fIopf\fR
50 .RS 4
51 operations and flags
52 .RE
53 .PP
54 \fIp_start_sect\fR
55 .RS 4
56 points to the start sector of the partition structure of the device
57 .RE
58 .PP
59 \fIname\fR
60 .RS 4
61 name of the probe point
62 .RE
63 .PP
64 \fIflags\fR
65 .RS 4
66 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\*(Aqt own data BIO_BOUNCED 5 bio is a bounce bio BIO_USER_MAPPED 6 contains user pages BIO_EOPNOTSUPP 7 not supported
67 .RE
68 .PP
69 \fIino\fR
70 .RS 4
71 i\-node number of the mapped file
72 .RE
73 .PP
74 \fIbdev_contains\fR
75 .RS 4
76 points to the device object which contains the partition (when bio structure represents a partition)
77 .RE
78 .PP
79 \fIvcnt\fR
80 .RS 4
81 bio vector count which represents number of array element (page, offset, length) which makes up this I/O request
82 .RE
83 .PP
84 \fIsize\fR
85 .RS 4
86 total size in bytes
87 .RE
88 .PP
89 \fIrw\fR
90 .RS 4
91 binary trace for read/write request
92 .RE
93 .PP
94 \fIdevname\fR
95 .RS 4
96 device for which a buffer bounce was needed\&.
97 .RE
98 .PP
99 \fIbytes_done\fR
100 .RS 4
101 number of bytes transferred
102 .RE
103 .PP
104 \fIsector\fR
105 .RS 4
106 beginning sector for the entire bio
107 .RE
108 .PP
109 \fIidx\fR
110 .RS 4
111 offset into the bio vector array
112 \fIphys_segments\fR
113 \- number of segments in this bio after physical address coalescing is performed\&.
114 .RE
115 .SH "CONTEXT"
116 .PP
117 The process creating a block IO request\&.
118 .SH SEE ALSO\n
119 .IR tapset::ioblock (3stap)