function::abort — \n Immediately shutting down probing script.\n
Synopsis
\n abort()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This is similar to exit but immediately aborts\n the current probe handler instead of waiting for its\n completion. Probe handlers already running on *other* CPU cores,\n however, will still continue to their completion. Unlike error,\n this function call cannot be caught by 'try ... catch'.\n
function::ansi_set_color — \n Set the ansi Select Graphic Rendition mode.\n-
Synopsis
1) ansi_set_color(fg:long)
2) ansi_set_color(fg:long,bg:long)
3) ansi_set_color(fg:long,bg:long,attr:long)
Arguments
fg
\n+
Synopsis
1) ansi_set_color(fg:long)
2) ansi_set_color(fg:long,bg:long)
3) ansi_set_color(fg:long,bg:long,attr:long)
Arguments
fg
\n Foreground color to set.\n
bg
\n Background color to set.\n
attr
\n Color attribute to set.\n-
Description
1) Sends ansi code for Select Graphic Rendition mode for the\n+
Description
1) Sends ansi code for Select Graphic Rendition mode for the\n given forground color. Black (30), Blue (34), Green (32), Cyan (36),\n Red (31), Purple (35), Brown (33), Light Gray (37).
2) Sends ansi code for Select Graphic Rendition mode for the\n given forground color, Black (30), Blue (34), Green (32), Cyan (36),\n Red (31), Purple (35), Brown (33), Light Gray (37) and the given\n background color, Black (40), Red (41), Green (42), Yellow (43),\n Blue (44), Magenta (45), Cyan (46), White (47).
3) Sends ansi code for Select Graphic Rendition mode for the\n given forground color, Black (30), Blue (34), Green (32), Cyan (36),\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-assert.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-assert.html", "unified_diff": "@@ -1,14 +1,14 @@\n
1) This function checks the expression and aborts the\n+
Description
1) This function checks the expression and aborts the\n current running probe if expression evaluates to zero. Useserror\n and may be caught by try{} catch{}. A default message will be\n displayed.\n
2) This function checks the expression and aborts the\n current running probe if expression evaluates to zero. Useserror\n and may be caught by try{} catch{}. The specified message will be\n displayed.\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-atomic-long-read.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-atomic-long-read.html", "unified_diff": "@@ -1,10 +1,10 @@\n
function::bytes_to_string — \n Human readable string for given bytes\n
Synopsis
\n bytes_to_string:string(bytes:long)\n-
Arguments
bytes
\n+
Arguments
bytes
\n Number of bytes to translate.\n-
Description
\n+
Description
\n Returns a string representing the number of bytes (up\n to 1024 bytes), the number of kilobytes (when less than 1024K)\n postfixed by 'K', the number of megabytes (when less than 1024M)\n postfixed by 'M' or the number of gigabytes postfixed by 'G'. If\n representing K, M or G, and the number is amount is less than 100,\n it includes a '.' plus the remainer. The returned string will be 5\n characters wide (padding with whitespace at the front) unless\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-caller-addr.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-caller-addr.html", "unified_diff": "@@ -1,9 +1,9 @@\n
\n This function returns the address and name of the \n calling function. This is equivalent to calling:\n- sprintf(\"s 0xx\", symname(caller_addr), caller_addr)\n+ sprintf(“s 0xx”, symname(caller_addr), caller_addr)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -5,11 +5,11 @@\n function::caller \u2014 Return name and address of calling function\n ***** Synopsis *****\n caller:string()\n ***** Arguments *****\n None\n ***** Description *****\n This function returns the address and name of the calling function. This is\n-equivalent to calling: sprintf(\"s 0xx\", symname(caller_addr), caller_addr)\n+equivalent to calling: sprintf(\u201cs 0xx\u201d, symname(caller_addr), caller_addr)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n function::backtrace\u00a0Home \u00a0function::caller_addr\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-callers.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-callers.html", "unified_diff": "@@ -1,12 +1,12 @@\n function::callers
function::callers — \n Return first n elements of kernel stack backtrace\n
Synopsis
\n callers:string(n:long)\n-
Arguments
n
\n+
Arguments
n
\n number of levels to descend in the stack (not counting the top\n level). If n is -1, print the entire stack.\n-
Description
\n+
Description
\n This function returns a string of the first n hex\n addresses from the backtrace of the kernel stack. Output may be\n truncated as per maximum string length (MAXSTRINGLEN).\n
function::cmdline_arg — \n Fetch a command line argument\n
Synopsis
\n cmdline_arg:string(n:long)\n-
Arguments
n
\n+
Arguments
n
\n Argument to get (zero is the program itself)\n-
Description
\n+
Description
\n Returns argument the requested argument from the\n current process or the empty string when there are not that many\n arguments or there is a problem retrieving the argument. Argument\n zero is traditionally the command itself.\n
\n First argument to get (zero is normally the program itself)\n
m
\n Last argument to get (or minus one for all arguments after n)\n
delim
\n String to use to separate arguments when more than one.\n-
Description
\n+
Description
\n Returns arguments from the current process starting\n with argument number n, up to argument m. If there are less than n\n arguments, or the arguments cannot be retrieved from the current\n process, the empty string is returned. If m is smaller than n then\n all arguments starting from argument n are returned. Argument zero\n is traditionally the command itself.\n
function::cpu_clock_ms — \n Number of milliseconds on the given cpu's clock\n
Synopsis
\n cpu_clock_ms:long(cpu:long)\n-
Arguments
cpu
\n+
Arguments
cpu
\n Which processor's clock to read\n-
Description
\n+
Description
\n This function returns the number of milliseconds on the given\n cpu's clock. This is always monotonic comparing on the same cpu, but may\n have some drift between cpus (within about a jiffy).\n
function::cpu_clock_ns — \n Number of nanoseconds on the given cpu's clock\n
Synopsis
\n cpu_clock_ns:long(cpu:long)\n-
Arguments
cpu
\n+
Arguments
cpu
\n Which processor's clock to read\n-
Description
\n+
Description
\n This function returns the number of nanoseconds on the given\n cpu's clock. This is always monotonic comparing on the same cpu, but may\n have some drift between cpus (within about a jiffy).\n
function::cpu_clock_s — \n Number of seconds on the given cpu's clock\n
Synopsis
\n cpu_clock_s:long(cpu:long)\n-
Arguments
cpu
\n+
Arguments
cpu
\n Which processor's clock to read\n-
Description
\n+
Description
\n This function returns the number of seconds on the given cpu's\n clock. This is always monotonic comparing on the same cpu, but may have\n some drift between cpus (within about a jiffy).\n
function::cpu_clock_us — \n Number of microseconds on the given cpu's clock\n
Synopsis
\n cpu_clock_us:long(cpu:long)\n-
Arguments
cpu
\n+
Arguments
cpu
\n Which processor's clock to read\n-
Description
\n+
Description
\n This function returns the number of microseconds on the given\n cpu's clock. This is always monotonic comparing on the same cpu, but may\n have some drift between cpus (within about a jiffy).\n
function::ctime — \n Convert seconds since epoch into human readable date/time string\n-
Synopsis
1) ctime:string(epochsecs:long)
2) ctime:string()
Arguments
epochsecs
\n+
Synopsis
1) ctime:string(epochsecs:long)
2) ctime:string()
Arguments
epochsecs
\n Number of seconds since epoch (as returned by gettimeofday_s)\n-
Description
1) Takes an argument of seconds since the epoch as returned bygettimeofday_s. Returns a string of the form\n+
Description
1) Takes an argument of seconds since the epoch as returned bygettimeofday_s. Returns a string of the form\n
2) “Wed Jun 30 21:49:08 1993”\n
\n \n The string will always be exactly 24 characters. If the time would\n be unreasonable far in the past (before what can be represented\n with a 32 bit offset in seconds from the epoch) an error will occur\n (which can be avoided with try/catch). If the time would be\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-current-exe-file.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-current-exe-file.html", "unified_diff": "@@ -1,13 +1,13 @@\n
function::current_exe_file — \n get the file struct pointer for the current task's executable file\n
Synopsis
\n current_exe_file:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function returns the file struct pointer for the\n current task's executable file. Note that the file struct pointer\n isn't locked on return. The return value of this function can be\n passed to fullpath_struct_file to get the path from the file\n struct.\n
function::cve_tmpdisable — \n Disable the cve livepatch\n
Synopsis
\n cve_tmpdisable(duration:long)\n-
Arguments
duration
\n+
Arguments
duration
\n The number of seconds to disable\n-
Description
\n+
Description
\n This function temporarily disables the\n conditionals which use cve_enabled_p for duration seconds.\n If duration is -1, disable the livepatch until reenabled.\n
function::dump_stack — \n Send the kernel backtrace to the kernel trace buffer\n
Synopsis
\n dump_stack()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n Print the current kernel backtrace to the kernel trace buffer.\n not be safely called from all kernel probe contexts, so\n is restricted to guru mode only. Under the hood, it calls the kernel C API\n function dump_stack directly.\n
function::errno_str — \n Symbolic string associated with error code\n
Synopsis
\n errno_str:string(err:long)\n-
Arguments
err
\n+
Arguments
err
\n The error number received\n-
Description
\n+
Description
\n This function returns the symbolic string associated\n with the giver error code, such as ENOENT for the number 2, or\n E#3333 for an out-of-range value such as 3333.\n
\n An implicit end-of-line is added. staprun prepends\n the string “ERROR:”. Sending an error message aborts the currently\n running probe. Depending on the MAXERRORS parameter, it may\n trigger an exit.\n
function::exit — \n Start shutting down probing script.\n
Synopsis
\n exit()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This only enqueues a request to start\n shutting down the script. New probes will not fire\n (except “end” probes), but all currently \n running ones may complete their work.\n
\n through 0-6, which are round to nearest even, minMag, \n min, max, near maxMag and round to odd\n
exact
\n the boolean value, if exact is 1 than raising inexact \n exception, otherwise ignore the exception.\n-
Description
\n+
Description
\n Given a 64 bit floating point, which is stored in long,\n use the long value to initiate self-defined float64_t type, then \n apply the f64_to_i64 function to get the string representation. \n
\n Given a 64 bit floating point, which is stored in long,\n use the long value to initiate self-defined float64_t type, then\n apply the f64_to_i64 function to get the string representation.\n
function::ftrace — \n Send a message to the ftrace ring-buffer\n
Synopsis
\n ftrace(msg:string)\n-
Arguments
msg
\n+
Arguments
msg
\n The formatted message string\n-
Description
\n+
Description
\n If the ftrace ring-buffer is configured & available,\n see /debugfs/tracing/trace for the message. Otherwise, the\n message may be quietly dropped. An implicit end-of-line is added.\n
\n This function returns the processor cycle counter value\n if available, else it returns zero. The cycle counter is free running\n and unsynchronized on each processor. Thus, the order of events cannot\n determined by comparing the results of the get_cycles function on \n different processors.\n
function::get_loadavg_index — \n Get the load average for a specified interval\n
Synopsis
\n get_loadavg_index:long(indx:long)\n-
Arguments
indx
\n+
Arguments
indx
\n The load average interval to capture.\n-
Description
\n+
Description
\n This function returns the load average at a specified interval.\n The three load average values 1, 5 and 15 minute average corresponds to\n indexes 0, 1 and 2 of the avenrun array - see linux/sched.h.\n Please note that the truncated-integer portion of the load average is returned.\n If the specified index is out-of-bounds, then an error message and exception is\n thrown.\n
function::indent_depth — \n returns the global nested-depth\n
Synopsis
\n indent_depth:long(delta:long)\n-
Arguments
delta
\n+
Arguments
delta
\n the amount of depth added/removed for each call\n-
Description
\n+
Description
\n This function returns a number for appropriate indentation,\n similar to indent. Call it with a small positive or matching negative\n delta. Unlike the thread_indent_depth function, the indent does not track\n individual indent values on a per thread basis.\n
function::indent — \n returns an amount of space to indent\n
Synopsis
\n indent:string(delta:long)\n-
Arguments
delta
\n+
Arguments
delta
\n the amount of space added/removed for each call\n-
Description
\n+
Description
\n This function returns a string with appropriate\n indentation. Call it with a small positive or matching negative\n delta. Unlike the thread_indent function, the indent does not\n track individual indent values on a per thread basis.\n
probe::ioblock.end — \n Fires whenever a block I/O transfer is complete.\n-
Synopsis
ioblock.end
Values
rw
\n- binary trace for read/write request\n+
Synopsis
ioblock.end
Values
hw_segments
\n+ number of segments after physical and DMA remapping hardware coalescing is performed\n+
sector
\n+ beginning sector for the entire bio\n
phys_segments
\n number of segments in this bio after physical address coalescing is performed.\n-
idx
\n- offset into the bio vector array\n-
error
\n- 0 on success\n
devname
\n block device name\n-
opf
\n- operations and flags\n-
size
\n- total size in bytes\n-
vcnt
\n- bio vector count which represents number of array element (page, offset, length) which makes up this I/O request\n-
hw_segments
\n- number of segments after physical and DMA remapping hardware coalescing is performed\n
flags
\n see below\n BIO_UPTODATE 0 ok after I/O completion\n BIO_RW_BLOCK 1 RW_AHEAD set, and read/write would block\n BIO_EOF 2 out-out-bounds error\n BIO_SEG_VALID 3 nr_hw_seg valid\n BIO_CLONED 4 doesn't own data\n BIO_BOUNCED 5 bio is a bounce bio\n BIO_USER_MAPPED 6 contains user pages\n BIO_EOPNOTSUPP 7 not supported\n+
idx
\n+ offset into the bio vector array\n
ino
\n i-node number of the mapped file\n-
bytes_done
\n- number of bytes transferred\n-
sector
\n- beginning sector for the entire bio\n+
opf
\n+ operations and flags\n
name
\n name of the probe point\n-
Context
\n+
rw
\n+ binary trace for read/write request\n+
size
\n+ total size in bytes\n+
vcnt
\n+ bio vector count which represents number of array element (page, offset, length) which makes up this I/O request\n+
error
\n+ 0 on success\n+
bytes_done
\n+ number of bytes transferred\n+
Context
\n The process signals the transfer is done.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,47 +2,47 @@\n Prev\u00a0Chapter\u00a09.\u00a0IO Scheduler and block IO Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::ioblock.end \u2014 Fires whenever a block I/O transfer is complete.\n ***** Synopsis *****\n ioblock.end\n ***** Values *****\n- rw\n- binary trace for read/write request\n+ hw_segments\n+ number of segments after physical and DMA remapping hardware coalescing\n+ is performed\n+ sector\n+ beginning sector for the entire bio\n phys_segments\n number of segments in this bio after physical address coalescing is\n performed.\n- idx\n- offset into the bio vector array\n- error\n- 0 on success\n devname\n block device name\n- opf\n- operations and flags\n- size\n- total size in bytes\n- vcnt\n- bio vector count which represents number of array element (page, offset,\n- length) which makes up this I/O request\n- hw_segments\n- number of segments after physical and DMA remapping hardware coalescing\n- is performed\n flags\n see below BIO_UPTODATE 0 ok after I/O completion BIO_RW_BLOCK 1 RW_AHEAD\n set, and read/write would block BIO_EOF 2 out-out-bounds error\n BIO_SEG_VALID 3 nr_hw_seg valid BIO_CLONED 4 doesn't own data BIO_BOUNCED\n 5 bio is a bounce bio BIO_USER_MAPPED 6 contains user pages\n BIO_EOPNOTSUPP 7 not supported\n+ idx\n+ offset into the bio vector array\n ino\n i-node number of the mapped file\n- bytes_done\n- number of bytes transferred\n- sector\n- beginning sector for the entire bio\n+ opf\n+ operations and flags\n name\n name of the probe point\n+ rw\n+ binary trace for read/write request\n+ size\n+ total size in bytes\n+ vcnt\n+ bio vector count which represents number of array element (page, offset,\n+ length) which makes up this I/O request\n+ error\n+ 0 on success\n+ bytes_done\n+ number of bytes transferred\n ***** Context *****\n The process signals the transfer is done.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n Chapter\u00a09.\u00a0IO Scheduler and block IO TapsetHome \u00a0probe::ioblock.request\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ioblock-request.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ioblock-request.html", "unified_diff": "@@ -1,43 +1,43 @@\n probe::ioblock.request
probe::ioblock.request — \n Fires whenever making a generic block I/O request.\n-
Synopsis
ioblock.request
Values
sector
\n+
Synopsis
ioblock.request
Values
sector
\n beginning sector for the entire bio\n+
hw_segments
\n+ number of segments after physical and DMA remapping hardware coalescing is performed\n+
p_start_sect
\n+ points to the start sector of the partition structure of the device\n+
devname
\n+ block device name\n+
bdev
\n+ target block device\n+
phys_segments
\n+ number of segments in this bio after physical address coalescing is performed\n
name
\n name of the probe point\n+
opf
\n+ operations and flags\n
ino
\n i-node number of the mapped file\n
flags
\n see below\n BIO_UPTODATE 0 ok after I/O completion\n BIO_RW_BLOCK 1 RW_AHEAD set, and read/write would block\n BIO_EOF 2 out-out-bounds error\n BIO_SEG_VALID 3 nr_hw_seg valid \n BIO_CLONED 4 doesn't own data\n BIO_BOUNCED 5 bio is a bounce bio\n BIO_USER_MAPPED 6 contains user pages\n BIO_EOPNOTSUPP 7 not supported\n-
vcnt
\n- bio vector count which represents number of array element (page, offset, length) which make up this I/O request\n-
hw_segments
\n- number of segments after physical and DMA remapping hardware coalescing is performed\n-
size
\n- total size in bytes\n-
bdev
\n- target block device\n-
opf
\n- operations and flags\n-
p_start_sect
\n- points to the start sector of the partition structure of the device\n-
bdev_contains
\n- points to the device object which contains the partition (when bio structure represents a partition)\n
idx
\n offset into the bio vector array\n-
devname
\n- block device name\n+
bdev_contains
\n+ points to the device object which contains the partition (when bio structure represents a partition)\n
rw
\n binary trace for read/write request\n-
phys_segments
\n- number of segments in this bio after physical address coalescing is performed\n-
Context
\n+
size
\n+ total size in bytes\n+
vcnt
\n+ bio vector count which represents number of array element (page, offset, length) which make up this I/O request\n+
Context
\n The process makes block I/O request\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,48 +4,48 @@\n ***** Name *****\n probe::ioblock.request \u2014 Fires whenever making a generic block I/O request.\n ***** Synopsis *****\n ioblock.request\n ***** Values *****\n sector\n beginning sector for the entire bio\n+ hw_segments\n+ number of segments after physical and DMA remapping hardware coalescing\n+ is performed\n+ p_start_sect\n+ points to the start sector of the partition structure of the device\n+ devname\n+ block device name\n+ bdev\n+ target block device\n+ phys_segments\n+ number of segments in this bio after physical address coalescing is\n+ performed\n name\n name of the probe point\n+ opf\n+ operations and flags\n ino\n i-node number of the mapped file\n flags\n see below BIO_UPTODATE 0 ok after I/O completion BIO_RW_BLOCK 1 RW_AHEAD\n set, and read/write would block BIO_EOF 2 out-out-bounds error\n BIO_SEG_VALID 3 nr_hw_seg valid BIO_CLONED 4 doesn't own data BIO_BOUNCED\n 5 bio is a bounce bio BIO_USER_MAPPED 6 contains user pages\n BIO_EOPNOTSUPP 7 not supported\n- vcnt\n- bio vector count which represents number of array element (page, offset,\n- length) which make up this I/O request\n- hw_segments\n- number of segments after physical and DMA remapping hardware coalescing\n- is performed\n- size\n- total size in bytes\n- bdev\n- target block device\n- opf\n- operations and flags\n- p_start_sect\n- points to the start sector of the partition structure of the device\n+ idx\n+ offset into the bio vector array\n bdev_contains\n points to the device object which contains the partition (when bio\n structure represents a partition)\n- idx\n- offset into the bio vector array\n- devname\n- block device name\n rw\n binary trace for read/write request\n- phys_segments\n- number of segments in this bio after physical address coalescing is\n- performed\n+ size\n+ total size in bytes\n+ vcnt\n+ bio vector count which represents number of array element (page, offset,\n+ length) which make up this I/O request\n ***** Context *****\n The process makes block I/O request\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::ioblock.end\u00a0Home \u00a0probe::ioblock_trace.bounce\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ioblock-trace-bounce.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ioblock-trace-bounce.html", "unified_diff": "@@ -1,44 +1,44 @@\n probe::ioblock_trace.bounce
probe::ioblock_trace.bounce — \n Fires whenever a buffer bounce is needed for at least one page of a block IO request.\n-
Synopsis
ioblock_trace.bounce
Values
p_start_sect
\n- points to the start sector of the partition structure of the device\n-
bdev
\n- target block device\n-
opf
\n- operations and flags\n-
rw
\n- binary trace for read/write request\n-
devname
\n- device for which a buffer bounce was needed.\n-
bdev_contains
\n- points to the device object which contains the partition (when bio structure represents a partition)\n-
idx
\n- offset into the bio vector array\n- phys_segments - number of segments in this bio after physical address coalescing is performed.\n-
flags
\n+
Synopsis
ioblock_trace.bounce
Values
flags
\n see below\n BIO_UPTODATE 0 ok after I/O completion\n BIO_RW_BLOCK 1 RW_AHEAD set, and read/write would block\n BIO_EOF 2 out-out-bounds error\n BIO_SEG_VALID 3 nr_hw_seg valid\n BIO_CLONED 4 doesn't own data\n BIO_BOUNCED 5 bio is a bounce bio\n BIO_USER_MAPPED 6 contains user pages\n BIO_EOPNOTSUPP 7 not supported\n+
idx
\n+ offset into the bio vector array\n+ phys_segments - number of segments in this bio after physical address coalescing is performed.\n
ino
\n i-node number of the mapped file\n-
sector
\n- beginning sector for the entire bio\n+
opf
\n+ operations and flags\n
name
\n name of the probe point\n-
bytes_done
\n- number of bytes transferred\n+
rw
\n+ binary trace for read/write request\n
size
\n total size in bytes\n-
q
\n- request queue on which this bio was queued.\n
vcnt
\n bio vector count which represents number of array element (page, offset, length) which makes up this I/O request\n-
Context
\n+
bdev_contains
\n+ points to the device object which contains the partition (when bio structure represents a partition)\n+
bytes_done
\n+ number of bytes transferred\n+
p_start_sect
\n+ points to the start sector of the partition structure of the device\n+
sector
\n+ beginning sector for the entire bio\n+
q
\n+ request queue on which this bio was queued.\n+
bdev
\n+ target block device\n+
devname
\n+ device for which a buffer bounce was needed.\n+
Context
\n The process creating a block IO request.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,49 +3,49 @@\n ===============================================================================\n ***** Name *****\n probe::ioblock_trace.bounce \u2014 Fires whenever a buffer bounce is needed for at\n least one page of a block IO request.\n ***** Synopsis *****\n ioblock_trace.bounce\n ***** Values *****\n- p_start_sect\n- points to the start sector of the partition structure of the device\n- bdev\n- target block device\n- opf\n- operations and flags\n- rw\n- binary trace for read/write request\n- devname\n- device for which a buffer bounce was needed.\n- bdev_contains\n- points to the device object which contains the partition (when bio\n- structure represents a partition)\n- idx\n- offset into the bio vector array phys_segments - number of segments in\n- this bio after physical address coalescing is performed.\n flags\n see below BIO_UPTODATE 0 ok after I/O completion BIO_RW_BLOCK 1 RW_AHEAD\n set, and read/write would block BIO_EOF 2 out-out-bounds error\n BIO_SEG_VALID 3 nr_hw_seg valid BIO_CLONED 4 doesn't own data BIO_BOUNCED\n 5 bio is a bounce bio BIO_USER_MAPPED 6 contains user pages\n BIO_EOPNOTSUPP 7 not supported\n+ idx\n+ offset into the bio vector array phys_segments - number of segments in\n+ this bio after physical address coalescing is performed.\n ino\n i-node number of the mapped file\n- sector\n- beginning sector for the entire bio\n+ opf\n+ operations and flags\n name\n name of the probe point\n- bytes_done\n- number of bytes transferred\n+ rw\n+ binary trace for read/write request\n size\n total size in bytes\n- q\n- request queue on which this bio was queued.\n vcnt\n bio vector count which represents number of array element (page, offset,\n length) which makes up this I/O request\n+ bdev_contains\n+ points to the device object which contains the partition (when bio\n+ structure represents a partition)\n+ bytes_done\n+ number of bytes transferred\n+ p_start_sect\n+ points to the start sector of the partition structure of the device\n+ sector\n+ beginning sector for the entire bio\n+ q\n+ request queue on which this bio was queued.\n+ bdev\n+ target block device\n+ devname\n+ device for which a buffer bounce was needed.\n ***** Context *****\n The process creating a block IO request.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::ioblock.request\u00a0Home \u00a0probe::ioblock_trace.end\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ioblock-trace-end.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ioblock-trace-end.html", "unified_diff": "@@ -1,44 +1,44 @@\n probe::ioblock_trace.end
probe::ioblock_trace.end — \n Fires whenever a block I/O transfer is complete.\n-
Synopsis
ioblock_trace.end
Values
rw
\n+
Synopsis
ioblock_trace.end
Values
vcnt
\n+ bio vector count which represents number of array element (page, offset, length) which makes up this I/O request\n+
size
\n+ total size in bytes\n+
rw
\n binary trace for read/write request\n+
bytes_done
\n+ number of bytes transferred\n
bdev_contains
\n points to the device object which contains the partition (when bio structure represents a partition)\n-
idx
\n- offset into the bio vector array\n- phys_segments - number of segments in this bio after physical address coalescing is performed.\n-
devname
\n- block device name\n-
p_start_sect
\n- points to the start sector of the partition structure of the device\n-
opf
\n- operations and flags\n-
bdev
\n- target block device\n-
size
\n- total size in bytes\n-
q
\n- request queue on which this bio was queued.\n-
vcnt
\n- bio vector count which represents number of array element (page, offset, length) which makes up this I/O request\n
ino
\n i-node number of the mapped file\n
flags
\n see below\n BIO_UPTODATE 0 ok after I/O completion\n BIO_RW_BLOCK 1 RW_AHEAD set, and read/write would block\n BIO_EOF 2 out-out-bounds error\n BIO_SEG_VALID 3 nr_hw_seg valid\n BIO_CLONED 4 doesn't own data\n BIO_BOUNCED 5 bio is a bounce bio\n BIO_USER_MAPPED 6 contains user pages\n BIO_EOPNOTSUPP 7 not supported\n-
bytes_done
\n- number of bytes transferred\n-
sector
\n- beginning sector for the entire bio\n+
idx
\n+ offset into the bio vector array\n+ phys_segments - number of segments in this bio after physical address coalescing is performed.\n
name
\n name of the probe point\n-
Context
\n+
opf
\n+ operations and flags\n+
bdev
\n+ target block device\n+
devname
\n+ block device name\n+
p_start_sect
\n+ points to the start sector of the partition structure of the device\n+
sector
\n+ beginning sector for the entire bio\n+
q
\n+ request queue on which this bio was queued.\n+
Context
\n The process signals the transfer is done.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,49 +2,49 @@\n Prev\u00a0Chapter\u00a09.\u00a0IO Scheduler and block IO Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::ioblock_trace.end \u2014 Fires whenever a block I/O transfer is complete.\n ***** Synopsis *****\n ioblock_trace.end\n ***** Values *****\n+ vcnt\n+ bio vector count which represents number of array element (page, offset,\n+ length) which makes up this I/O request\n+ size\n+ total size in bytes\n rw\n binary trace for read/write request\n+ bytes_done\n+ number of bytes transferred\n bdev_contains\n points to the device object which contains the partition (when bio\n structure represents a partition)\n- idx\n- offset into the bio vector array phys_segments - number of segments in\n- this bio after physical address coalescing is performed.\n- devname\n- block device name\n- p_start_sect\n- points to the start sector of the partition structure of the device\n- opf\n- operations and flags\n- bdev\n- target block device\n- size\n- total size in bytes\n- q\n- request queue on which this bio was queued.\n- vcnt\n- bio vector count which represents number of array element (page, offset,\n- length) which makes up this I/O request\n ino\n i-node number of the mapped file\n flags\n see below BIO_UPTODATE 0 ok after I/O completion BIO_RW_BLOCK 1 RW_AHEAD\n set, and read/write would block BIO_EOF 2 out-out-bounds error\n BIO_SEG_VALID 3 nr_hw_seg valid BIO_CLONED 4 doesn't own data BIO_BOUNCED\n 5 bio is a bounce bio BIO_USER_MAPPED 6 contains user pages\n BIO_EOPNOTSUPP 7 not supported\n- bytes_done\n- number of bytes transferred\n- sector\n- beginning sector for the entire bio\n+ idx\n+ offset into the bio vector array phys_segments - number of segments in\n+ this bio after physical address coalescing is performed.\n name\n name of the probe point\n+ opf\n+ operations and flags\n+ bdev\n+ target block device\n+ devname\n+ block device name\n+ p_start_sect\n+ points to the start sector of the partition structure of the device\n+ sector\n+ beginning sector for the entire bio\n+ q\n+ request queue on which this bio was queued.\n ***** Context *****\n The process signals the transfer is done.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::ioblock_trace.bounce\u00a0Home \u00a0probe::ioblock_trace.request\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ioblock-trace-request.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ioblock-trace-request.html", "unified_diff": "@@ -1,44 +1,44 @@\n probe::ioblock_trace.request
probe::ioblock_trace.request — \n Fires just as a generic block I/O request is created for a bio.\n-
Synopsis
ioblock_trace.request
Values
q
\n+
Synopsis
ioblock_trace.request
Values
bdev
\n+ target block device\n+
devname
\n+ block device name\n+
p_start_sect
\n+ points to the start sector of the partition structure of the device\n+
sector
\n+ beginning sector for the entire bio\n+
q
\n request queue on which this bio was queued.\n-
vcnt
\n- bio vector count which represents number of array element (page, offset, length) which make up this I/O request\n
size
\n total size in bytes\n+
rw
\n+ binary trace for read/write request\n+
vcnt
\n+ bio vector count which represents number of array element (page, offset, length) which make up this I/O request\n
bytes_done
\n number of bytes transferred\n-
name
\n- name of the probe point\n-
sector
\n- beginning sector for the entire bio\n+
bdev_contains
\n+ points to the device object which contains the partition (when bio structure represents a partition)\n
ino
\n i-node number of the mapped file\n+
idx
\n+ offset into the bio vector array\n+ phys_segments - number of segments in this bio after physical address coalescing is performed.\n
flags
\n see below\n BIO_UPTODATE 0 ok after I/O completion\n BIO_RW_BLOCK 1 RW_AHEAD set, and read/write would block\n BIO_EOF 2 out-out-bounds error\n BIO_SEG_VALID 3 nr_hw_seg valid\n BIO_CLONED 4 doesn't own data\n BIO_BOUNCED 5 bio is a bounce bio\n BIO_USER_MAPPED 6 contains user pages\n BIO_EOPNOTSUPP 7 not supported\n-
idx
\n- offset into the bio vector array\n- phys_segments - number of segments in this bio after physical address coalescing is performed.\n-
bdev_contains
\n- points to the device object which contains the partition (when bio structure represents a partition)\n-
devname
\n- block device name\n-
rw
\n- binary trace for read/write request\n+
name
\n+ name of the probe point\n
opf
\n operations and flags\n-
bdev
\n- target block device\n-
p_start_sect
\n- points to the start sector of the partition structure of the device\n-
Context
\n+
Context
\n The process makes block I/O request\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,49 +3,49 @@\n ===============================================================================\n ***** Name *****\n probe::ioblock_trace.request \u2014 Fires just as a generic block I/O request is\n created for a bio.\n ***** Synopsis *****\n ioblock_trace.request\n ***** Values *****\n+ bdev\n+ target block device\n+ devname\n+ block device name\n+ p_start_sect\n+ points to the start sector of the partition structure of the device\n+ sector\n+ beginning sector for the entire bio\n q\n request queue on which this bio was queued.\n+ size\n+ total size in bytes\n+ rw\n+ binary trace for read/write request\n vcnt\n bio vector count which represents number of array element (page, offset,\n length) which make up this I/O request\n- size\n- total size in bytes\n bytes_done\n number of bytes transferred\n- name\n- name of the probe point\n- sector\n- beginning sector for the entire bio\n+ bdev_contains\n+ points to the device object which contains the partition (when bio\n+ structure represents a partition)\n ino\n i-node number of the mapped file\n+ idx\n+ offset into the bio vector array phys_segments - number of segments in\n+ this bio after physical address coalescing is performed.\n flags\n see below BIO_UPTODATE 0 ok after I/O completion BIO_RW_BLOCK 1 RW_AHEAD\n set, and read/write would block BIO_EOF 2 out-out-bounds error\n BIO_SEG_VALID 3 nr_hw_seg valid BIO_CLONED 4 doesn't own data BIO_BOUNCED\n 5 bio is a bounce bio BIO_USER_MAPPED 6 contains user pages\n BIO_EOPNOTSUPP 7 not supported\n- idx\n- offset into the bio vector array phys_segments - number of segments in\n- this bio after physical address coalescing is performed.\n- bdev_contains\n- points to the device object which contains the partition (when bio\n- structure represents a partition)\n- devname\n- block device name\n- rw\n- binary trace for read/write request\n+ name\n+ name of the probe point\n opf\n operations and flags\n- bdev\n- target block device\n- p_start_sect\n- points to the start sector of the partition structure of the device\n ***** Context *****\n The process makes block I/O request\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::ioblock_trace.end\u00a0Home \u00a0probe::ioscheduler.elv_add_request\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-elv-add-request-kp.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-elv-add-request-kp.html", "unified_diff": "@@ -1,17 +1,17 @@\n probe::ioscheduler.elv_add_request.kp
probe::ioscheduler.elv_add_request.kp — \n kprobe based probe to indicate that a request was added to the request queue\n-
Synopsis
ioscheduler.elv_add_request.kp
Values
name
\n- Name of the probe point\n+
Synopsis
ioscheduler.elv_add_request.kp
Values
rq_flags
\n+ Request flags\n+
rq
\n+ Address of the request\n+
q
\n+ pointer to request queue\n
disk_major
\n Disk major number of the request\n
disk_minor
\n Disk minor number of the request\n-
q
\n- pointer to request queue\n
elevator_name
\n The type of I/O elevator currently enabled\n-
rq
\n- Address of the request\n-
rq_flags
\n- Request flags\n+
name
\n+ Name of the probe point\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,24 +3,24 @@\n ===============================================================================\n ***** Name *****\n probe::ioscheduler.elv_add_request.kp \u2014 kprobe based probe to indicate that a\n request was added to the request queue\n ***** Synopsis *****\n ioscheduler.elv_add_request.kp\n ***** Values *****\n- name\n- Name of the probe point\n+ rq_flags\n+ Request flags\n+ rq\n+ Address of the request\n+ q\n+ pointer to request queue\n disk_major\n Disk major number of the request\n disk_minor\n Disk minor number of the request\n- q\n- pointer to request queue\n elevator_name\n The type of I/O elevator currently enabled\n- rq\n- Address of the request\n- rq_flags\n- Request flags\n+ name\n+ Name of the probe point\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::ioscheduler.elv_add_request\u00a0Home \u00a0probe::ioscheduler.elv_add_request.tp\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-elv-add-request-tp.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-elv-add-request-tp.html", "unified_diff": "@@ -1,17 +1,17 @@\n probe::ioscheduler.elv_add_request.tp
probe::ioscheduler.elv_add_request.tp — \n tracepoint based probe to indicate a request is added to the request queue.\n-
Synopsis
ioscheduler.elv_add_request.tp
Values
q
\n- Pointer to request queue.\n-
rq
\n- Address of request.\n-
elevator_name
\n- The type of I/O elevator currently enabled.\n-
rq_flags
\n- Request flags.\n-
name
\n+
Synopsis
ioscheduler.elv_add_request.tp
Values
name
\n Name of the probe point\n
disk_minor
\n Disk minor number of request.\n+
elevator_name
\n+ The type of I/O elevator currently enabled.\n
disk_major
\n Disk major no of request.\n+
q
\n+ Pointer to request queue.\n+
rq
\n+ Address of request.\n+
rq_flags
\n+ Request flags.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,25 +3,25 @@\n ===============================================================================\n ***** Name *****\n probe::ioscheduler.elv_add_request.tp \u2014 tracepoint based probe to indicate a\n request is added to the request queue.\n ***** Synopsis *****\n ioscheduler.elv_add_request.tp\n ***** Values *****\n- q\n- Pointer to request queue.\n- rq\n- Address of request.\n- elevator_name\n- The type of I/O elevator currently enabled.\n- rq_flags\n- Request flags.\n name\n Name of the probe point\n disk_minor\n Disk minor number of request.\n+ elevator_name\n+ The type of I/O elevator currently enabled.\n disk_major\n Disk major no of request.\n+ q\n+ Pointer to request queue.\n+ rq\n+ Address of request.\n+ rq_flags\n+ Request flags.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::ioscheduler.elv_add_request.kp\u00a0Home \u00a0probe::\n ioscheduler.elv_completed_request\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-elv-add-request.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-elv-add-request.html", "unified_diff": "@@ -1,15 +1,15 @@\n probe::ioscheduler.elv_add_request
probe::ioscheduler.elv_add_request — \n probe to indicate request is added to the request queue.\n-
Synopsis
ioscheduler.elv_add_request
Values
disk_minor
\n- Disk minor number of request.\n-
disk_major
\n- Disk major no of request.\n-
rq
\n+
Synopsis
ioscheduler.elv_add_request
Values
rq
\n Address of request.\n-
elevator_name
\n- The type of I/O elevator currently enabled.\n
rq_flags
\n Request flags.\n+
disk_minor
\n+ Disk minor number of request.\n+
elevator_name
\n+ The type of I/O elevator currently enabled.\n+
disk_major
\n+ Disk major no of request.\n
q
\n Pointer to request queue.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,22 +3,22 @@\n ===============================================================================\n ***** Name *****\n probe::ioscheduler.elv_add_request \u2014 probe to indicate request is added to the\n request queue.\n ***** Synopsis *****\n ioscheduler.elv_add_request\n ***** Values *****\n- disk_minor\n- Disk minor number of request.\n- disk_major\n- Disk major no of request.\n rq\n Address of request.\n- elevator_name\n- The type of I/O elevator currently enabled.\n rq_flags\n Request flags.\n+ disk_minor\n+ Disk minor number of request.\n+ elevator_name\n+ The type of I/O elevator currently enabled.\n+ disk_major\n+ Disk major no of request.\n q\n Pointer to request queue.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::ioblock_trace.request\u00a0Home \u00a0probe::ioscheduler.elv_add_request.kp\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-elv-completed-request.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-elv-completed-request.html", "unified_diff": "@@ -1,15 +1,15 @@\n probe::ioscheduler.elv_completed_request
probe::ioscheduler.elv_completed_request — \n Fires when a request is completed\n-
Synopsis
ioscheduler.elv_completed_request
Values
rq_flags
\n- Request flags\n-
rq
\n+
Synopsis
ioscheduler.elv_completed_request
Values
rq
\n Address of the request\n+
rq_flags
\n+ Request flags\n+
disk_major
\n+ Disk major number of the request\n
elevator_name
\n The type of I/O elevator currently enabled\n
disk_minor
\n Disk minor number of the request\n-
disk_major
\n- Disk major number of the request\n
name
\n Name of the probe point\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,23 +2,23 @@\n Prev\u00a0Chapter\u00a09.\u00a0IO Scheduler and block IO Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::ioscheduler.elv_completed_request \u2014 Fires when a request is completed\n ***** Synopsis *****\n ioscheduler.elv_completed_request\n ***** Values *****\n- rq_flags\n- Request flags\n rq\n Address of the request\n+ rq_flags\n+ Request flags\n+ disk_major\n+ Disk major number of the request\n elevator_name\n The type of I/O elevator currently enabled\n disk_minor\n Disk minor number of the request\n- disk_major\n- Disk major number of the request\n name\n Name of the probe point\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe:: Home \u00a0probe::ioscheduler.elv_next_request\n ioscheduler.elv_add_request.tp\u00a0\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-elv-next-request-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-elv-next-request-return.html", "unified_diff": "@@ -1,13 +1,13 @@\n probe::ioscheduler.elv_next_request.return
probe::ioscheduler.elv_next_request.return — \n Fires when a request retrieval issues a return signal\n-
Synopsis
ioscheduler.elv_next_request.return
Values
name
\n- Name of the probe point\n-
disk_major
\n+
Synopsis
ioscheduler.elv_next_request.return
Values
disk_major
\n Disk major number of the request\n-
rq
\n- Address of the request\n-
disk_minor
\n- Disk minor number of the request\n
rq_flags
\n Request flags\n+
disk_minor
\n+ Disk minor number of the request\n+
name
\n+ Name of the probe point\n+
rq
\n+ Address of the request\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,21 +3,21 @@\n ===============================================================================\n ***** Name *****\n probe::ioscheduler.elv_next_request.return \u2014 Fires when a request retrieval\n issues a return signal\n ***** Synopsis *****\n ioscheduler.elv_next_request.return\n ***** Values *****\n- name\n- Name of the probe point\n disk_major\n Disk major number of the request\n- rq\n- Address of the request\n- disk_minor\n- Disk minor number of the request\n rq_flags\n Request flags\n+ disk_minor\n+ Disk minor number of the request\n+ name\n+ Name of the probe point\n+ rq\n+ Address of the request\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::ioscheduler.elv_next_request\u00a0Home \u00a0probe::\n ioscheduler_trace.elv_abort_request\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-elv-next-request.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-elv-next-request.html", "unified_diff": "@@ -1,7 +1,7 @@\n probe::ioscheduler.elv_next_request
probe::ioscheduler.elv_next_request — \n Fires when a request is retrieved from the request queue\n-
Synopsis
ioscheduler.elv_next_request
Values
name
\n- Name of the probe point\n-
elevator_name
\n+
Synopsis
ioscheduler.elv_next_request
Values
elevator_name
\n The type of I/O elevator currently enabled\n+
name
\n+ Name of the probe point\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,15 +3,15 @@\n ===============================================================================\n ***** Name *****\n probe::ioscheduler.elv_next_request \u2014 Fires when a request is retrieved from\n the request queue\n ***** Synopsis *****\n ioscheduler.elv_next_request\n ***** Values *****\n- name\n- Name of the probe point\n elevator_name\n The type of I/O elevator currently enabled\n+ name\n+ Name of the probe point\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe:: Home \u00a0probe::\n ioscheduler.elv_completed_request\u00a0 ioscheduler.elv_next_request.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-trace-elv-abort-request.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-trace-elv-abort-request.html", "unified_diff": "@@ -1,15 +1,15 @@\n probe::ioscheduler_trace.elv_abort_request
probe::ioscheduler_trace.elv_abort_request — \n Fires when a request is aborted.\n-
Synopsis
ioscheduler_trace.elv_abort_request
Values
disk_major
\n+
Synopsis
ioscheduler_trace.elv_abort_request
Values
rq_flags
\n+ Request flags.\n+
rq
\n+ Address of request.\n+
disk_major
\n Disk major no of request.\n
disk_minor
\n Disk minor number of request.\n-
name
\n- Name of the probe point\n-
rq_flags
\n- Request flags.\n
elevator_name
\n The type of I/O elevator currently enabled.\n-
rq
\n- Address of request.\n+
name
\n+ Name of the probe point\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,23 +2,23 @@\n Prev\u00a0Chapter\u00a09.\u00a0IO Scheduler and block IO Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::ioscheduler_trace.elv_abort_request \u2014 Fires when a request is aborted.\n ***** Synopsis *****\n ioscheduler_trace.elv_abort_request\n ***** Values *****\n+ rq_flags\n+ Request flags.\n+ rq\n+ Address of request.\n disk_major\n Disk major no of request.\n disk_minor\n Disk minor number of request.\n- name\n- Name of the probe point\n- rq_flags\n- Request flags.\n elevator_name\n The type of I/O elevator currently enabled.\n- rq\n- Address of request.\n+ name\n+ Name of the probe point\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe:: Home \u00a0probe::\n ioscheduler.elv_next_request.return\u00a0 ioscheduler_trace.elv_completed_request\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-trace-elv-completed-request.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-trace-elv-completed-request.html", "unified_diff": "@@ -1,17 +1,17 @@\n probe::ioscheduler_trace.elv_completed_request
probe::ioscheduler_trace.elv_completed_request — \n Fires when a request is\n-
Synopsis
ioscheduler_trace.elv_completed_request
Values
disk_major
\n+
Synopsis
ioscheduler_trace.elv_completed_request
Values
rq_flags
\n+ Request flags.\n+
rq
\n+ Address of request.\n+
disk_major
\n Disk major no of request.\n
disk_minor
\n Disk minor number of request.\n
name
\n Name of the probe point\n-
rq_flags
\n- Request flags.\n
elevator_name
\n The type of I/O elevator currently enabled.\n-
rq
\n- Address of request.\n-
Description
\n+
Description
\n completed.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,25 +2,25 @@\n Prev\u00a0Chapter\u00a09.\u00a0IO Scheduler and block IO Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::ioscheduler_trace.elv_completed_request \u2014 Fires when a request is\n ***** Synopsis *****\n ioscheduler_trace.elv_completed_request\n ***** Values *****\n+ rq_flags\n+ Request flags.\n+ rq\n+ Address of request.\n disk_major\n Disk major no of request.\n disk_minor\n Disk minor number of request.\n name\n Name of the probe point\n- rq_flags\n- Request flags.\n elevator_name\n The type of I/O elevator currently enabled.\n- rq\n- Address of request.\n ***** Description *****\n completed.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe:: Home \u00a0probe::\n ioscheduler_trace.elv_abort_request\u00a0 ioscheduler_trace.elv_issue_request\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-trace-elv-issue-request.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-trace-elv-issue-request.html", "unified_diff": "@@ -1,17 +1,17 @@\n probe::ioscheduler_trace.elv_issue_request
probe::ioscheduler_trace.elv_issue_request — \n Fires when a request is\n-
Synopsis
ioscheduler_trace.elv_issue_request
Values
disk_minor
\n- Disk minor number of request.\n-
disk_major
\n- Disk major no of request.\n-
name
\n- Name of the probe point\n+
Synopsis
ioscheduler_trace.elv_issue_request
Values
rq
\n+ Address of request.\n
rq_flags
\n Request flags.\n-
rq
\n- Address of request.\n+
disk_major
\n+ Disk major no of request.\n+
disk_minor
\n+ Disk minor number of request.\n
elevator_name
\n The type of I/O elevator currently enabled.\n-
Description
\n+
name
\n+ Name of the probe point\n+
Description
\n scheduled.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,25 +2,25 @@\n Prev\u00a0Chapter\u00a09.\u00a0IO Scheduler and block IO Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::ioscheduler_trace.elv_issue_request \u2014 Fires when a request is\n ***** Synopsis *****\n ioscheduler_trace.elv_issue_request\n ***** Values *****\n- disk_minor\n- Disk minor number of request.\n- disk_major\n- Disk major no of request.\n- name\n- Name of the probe point\n- rq_flags\n- Request flags.\n rq\n Address of request.\n+ rq_flags\n+ Request flags.\n+ disk_major\n+ Disk major no of request.\n+ disk_minor\n+ Disk minor number of request.\n elevator_name\n The type of I/O elevator currently enabled.\n+ name\n+ Name of the probe point\n ***** Description *****\n scheduled.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe:: Home \u00a0probe::\n ioscheduler_trace.elv_completed_request\u00a0 ioscheduler_trace.elv_requeue_request\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-trace-elv-requeue-request.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-trace-elv-requeue-request.html", "unified_diff": "@@ -1,17 +1,17 @@\n probe::ioscheduler_trace.elv_requeue_request
probe::ioscheduler_trace.elv_requeue_request — \n Fires when a request is\n-
Synopsis
ioscheduler_trace.elv_requeue_request
Values
elevator_name
\n+
Synopsis
ioscheduler_trace.elv_requeue_request
Values
disk_major
\n+ Disk major no of request.\n+
name
\n+ Name of the probe point\n+
disk_minor
\n+ Disk minor number of request.\n+
elevator_name
\n The type of I/O elevator currently enabled.\n
rq
\n Address of request.\n
rq_flags
\n Request flags.\n-
disk_major
\n- Disk major no of request.\n-
disk_minor
\n- Disk minor number of request.\n-
name
\n- Name of the probe point\n-
Description
\n+
Description
\n put back on the queue, when the hadware cannot accept more requests.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,24 +2,24 @@\n Prev\u00a0Chapter\u00a09.\u00a0IO Scheduler and block IO Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::ioscheduler_trace.elv_requeue_request \u2014 Fires when a request is\n ***** Synopsis *****\n ioscheduler_trace.elv_requeue_request\n ***** Values *****\n+ disk_major\n+ Disk major no of request.\n+ name\n+ Name of the probe point\n+ disk_minor\n+ Disk minor number of request.\n elevator_name\n The type of I/O elevator currently enabled.\n rq\n Address of request.\n rq_flags\n Request flags.\n- disk_major\n- Disk major no of request.\n- disk_minor\n- Disk minor number of request.\n- name\n- Name of the probe point\n ***** Description *****\n put back on the queue, when the hadware cannot accept more requests.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::ioscheduler_trace.elv_issue_request\u00a0Home \u00a0probe::ioscheduler_trace.plug\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-trace-plug.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ioscheduler-trace-plug.html", "unified_diff": "@@ -1,9 +1,9 @@\n probe::ioscheduler_trace.plug
\n value to be added to the counter (default value of 1)\n
skb
\n pointer to the struct sk_buff being acted on\n-
Description
\n+
Description
\n The packet pointed to by skb is filtered by the function\n ipmib_filter_key. If the packet passes the filter is is\n counted in the global ForwDatagrams (equivalent to SNMP's MIB\n IPSTATS_MIB_OUTFORWDATAGRAMS)\n
\n- pointer to the struct sk_buff being acted on\n-
op
\n+
Synopsis
ipmib.FragFails
Values
op
\n Value to be added to the counter (default value of 1)\n-
Description
\n+
skb
\n+ pointer to the struct sk_buff being acted on\n+
Description
\n The packet pointed to by skb is filtered by the function\n ipmib_filter_key. If the packet passes the filter is is\n counted in the global FragFails (equivalent to SNMP's MIB\n IPSTATS_MIB_FRAGFAILS)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a015.\u00a0SNMP Information Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::ipmib.FragFails \u2014 Count datagram fragmented unsuccessfully\n ***** Synopsis *****\n ipmib.FragFails\n ***** Values *****\n- skb\n- pointer to the struct sk_buff being acted on\n op\n Value to be added to the counter (default value of 1)\n+ skb\n+ pointer to the struct sk_buff being acted on\n ***** Description *****\n The packet pointed to by skb is filtered by the function ipmib_filter_key. If\n the packet passes the filter is is counted in the global FragFails (equivalent\n to SNMP's MIB IPSTATS_MIB_FRAGFAILS)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::ipmib.ForwDatagrams\u00a0Home \u00a0probe::ipmib.FragOKs\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ipmib-FragOKs.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ipmib-FragOKs.html", "unified_diff": "@@ -1,12 +1,12 @@\n probe::ipmib.FragOKs
\n- pointer to the struct sk_buff being acted on\n-
op
\n+
Synopsis
ipmib.FragOKs
Values
op
\n value to be added to the counter (default value of 1)\n-
Description
\n+
skb
\n+ pointer to the struct sk_buff being acted on\n+
Description
\n The packet pointed to by skb is filtered by the function\n ipmib_filter_key. If the packet passes the filter is is\n counted in the global FragOKs (equivalent to SNMP's MIB\n IPSTATS_MIB_FRAGOKS)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a015.\u00a0SNMP Information Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::ipmib.FragOKs \u2014 Count datagram fragmented successfully\n ***** Synopsis *****\n ipmib.FragOKs\n ***** Values *****\n- skb\n- pointer to the struct sk_buff being acted on\n op\n value to be added to the counter (default value of 1)\n+ skb\n+ pointer to the struct sk_buff being acted on\n ***** Description *****\n The packet pointed to by skb is filtered by the function ipmib_filter_key. If\n the packet passes the filter is is counted in the global FragOKs (equivalent to\n SNMP's MIB IPSTATS_MIB_FRAGOKS)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::ipmib.FragFails\u00a0Home \u00a0probe::ipmib.InAddrErrors\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ipmib-InAddrErrors.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ipmib-InAddrErrors.html", "unified_diff": "@@ -1,12 +1,12 @@\n probe::ipmib.InAddrErrors
probe::ipmib.InAddrErrors — \n Count arriving packets with an incorrect address\n-
Synopsis
ipmib.InAddrErrors
Values
op
\n- value to be added to the counter (default value of 1)\n-
skb
\n+
Synopsis
ipmib.InAddrErrors
Values
skb
\n pointer to the struct sk_buff being acted on\n-
Description
\n+
op
\n+ value to be added to the counter (default value of 1)\n+
Description
\n The packet pointed to by skb is filtered by the function\n ipmib_filter_key. If the packet passes the filter is is\n counted in the global InAddrErrors (equivalent to SNMP's MIB\n IPSTATS_MIB_INADDRERRORS)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a015.\u00a0SNMP Information Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::ipmib.InAddrErrors \u2014 Count arriving packets with an incorrect address\n ***** Synopsis *****\n ipmib.InAddrErrors\n ***** Values *****\n- op\n- value to be added to the counter (default value of 1)\n skb\n pointer to the struct sk_buff being acted on\n+ op\n+ value to be added to the counter (default value of 1)\n ***** Description *****\n The packet pointed to by skb is filtered by the function ipmib_filter_key. If\n the packet passes the filter is is counted in the global InAddrErrors\n (equivalent to SNMP's MIB IPSTATS_MIB_INADDRERRORS)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::ipmib.FragOKs\u00a0Home \u00a0probe::ipmib.InDiscards\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ipmib-InDiscards.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ipmib-InDiscards.html", "unified_diff": "@@ -1,12 +1,12 @@\n probe::ipmib.InDiscards
\n- value to be added to the counter (default value of 1)\n-
skb
\n+
Synopsis
ipmib.InDiscards
Values
skb
\n pointer to the struct sk_buff being acted on\n-
Description
\n+
op
\n+ value to be added to the counter (default value of 1)\n+
Description
\n The packet pointed to by skb is filtered by the function\n ipmib_filter_key. If the packet passes the filter is is\n counted in the global InDiscards (equivalent to SNMP's MIB\n STATS_MIB_INDISCARDS)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a015.\u00a0SNMP Information Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::ipmib.InDiscards \u2014 Count discarded inbound packets\n ***** Synopsis *****\n ipmib.InDiscards\n ***** Values *****\n- op\n- value to be added to the counter (default value of 1)\n skb\n pointer to the struct sk_buff being acted on\n+ op\n+ value to be added to the counter (default value of 1)\n ***** Description *****\n The packet pointed to by skb is filtered by the function ipmib_filter_key. If\n the packet passes the filter is is counted in the global InDiscards (equivalent\n to SNMP's MIB STATS_MIB_INDISCARDS)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::ipmib.InAddrErrors\u00a0Home \u00a0probe::ipmib.InNoRoutes\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ipmib-InNoRoutes.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ipmib-InNoRoutes.html", "unified_diff": "@@ -1,12 +1,12 @@\n probe::ipmib.InNoRoutes
probe::ipmib.InNoRoutes — \n Count an arriving packet with no matching socket\n-
Synopsis
ipmib.InNoRoutes
Values
skb
\n+
Synopsis
ipmib.InNoRoutes
Values
skb
\n pointer to the struct sk_buff being acted on\n
op
\n value to be added to the counter (default value of 1)\n-
Description
\n+
Description
\n The packet pointed to by skb is filtered by the function\n ipmib_filter_key. If the packet passes the filter is is\n counted in the global InNoRoutes (equivalent to SNMP's MIB\n IPSTATS_MIB_INNOROUTES)\n
probe::ipmib.InReceives — \n Count an arriving packet\n-
Synopsis
ipmib.InReceives
Values
op
\n+
Synopsis
ipmib.InReceives
Values
op
\n value to be added to the counter (default value of 1)\n
skb
\n pointer to the struct sk_buff being acted on\n-
Description
\n+
Description
\n The packet pointed to by skb is filtered by the function\n ipmib_filter_key. If the packet passes the filter is is\n counted in the global InReceives (equivalent to SNMP's MIB\n IPSTATS_MIB_INRECEIVES)\n
probe::ipmib.InUnknownProtos — \n Count arriving packets with an unbound proto\n-
Synopsis
ipmib.InUnknownProtos
Values
skb
\n- pointer to the struct sk_buff being acted on\n-
op
\n+
Synopsis
ipmib.InUnknownProtos
Values
op
\n value to be added to the counter (default value of 1)\n-
Description
\n+
skb
\n+ pointer to the struct sk_buff being acted on\n+
Description
\n The packet pointed to by skb is filtered by the function\n ipmib_filter_key. If the packet passes the filter is is\n counted in the global InUnknownProtos (equivalent to SNMP's MIB\n IPSTATS_MIB_INUNKNOWNPROTOS)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a015.\u00a0SNMP Information Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::ipmib.InUnknownProtos \u2014 Count arriving packets with an unbound proto\n ***** Synopsis *****\n ipmib.InUnknownProtos\n ***** Values *****\n- skb\n- pointer to the struct sk_buff being acted on\n op\n value to be added to the counter (default value of 1)\n+ skb\n+ pointer to the struct sk_buff being acted on\n ***** Description *****\n The packet pointed to by skb is filtered by the function ipmib_filter_key. If\n the packet passes the filter is is counted in the global InUnknownProtos\n (equivalent to SNMP's MIB IPSTATS_MIB_INUNKNOWNPROTOS)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::ipmib.InReceives\u00a0Home \u00a0probe::ipmib.OutRequests\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ipmib-OutRequests.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ipmib-OutRequests.html", "unified_diff": "@@ -1,12 +1,12 @@\n probe::ipmib.OutRequests
probe::ipmib.OutRequests — \n Count a request to send a packet\n-
Synopsis
ipmib.OutRequests
Values
op
\n+
Synopsis
ipmib.OutRequests
Values
op
\n value to be added to the counter (default value of 1)\n
skb
\n pointer to the struct sk_buff being acted on\n-
Description
\n+
Description
\n The packet pointed to by skb is filtered by the function\n ipmib_filter_key. If the packet passes the filter is is\n counted in the global OutRequests (equivalent to SNMP's MIB\n IPSTATS_MIB_OUTREQUESTS)\n
probe::ipmib.ReasmReqds — \n Count number of packet fragments reassembly requests\n-
Synopsis
ipmib.ReasmReqds
Values
op
\n+
Synopsis
ipmib.ReasmReqds
Values
op
\n value to be added to the counter (default value of 1)\n
skb
\n pointer to the struct sk_buff being acted on\n-
Description
\n+
Description
\n The packet pointed to by skb is filtered by the function\n ipmib_filter_key. If the packet passes the filter is is\n counted in the global ReasmReqds (equivalent to SNMP's MIB\n IPSTATS_MIB_REASMREQDS)\n
\n value to be added to the counter (default value of 1)\n
skb
\n pointer to the struct sk_buff being acted on\n-
Description
\n+
Description
\n The packet pointed to by skb is filtered by the function\n ipmib_filter_key. If the packet passes the filter is is\n counted in the global ReasmTimeout (equivalent to SNMP's MIB\n IPSTATS_MIB_REASMTIMEOUT)\n
\n 1 is local operation and 0 is non-local operation\n-
Description
\n+
Description
\n This function is a default filter function.\n The user can replace this function with their own.\n The user-supplied filter function returns an index key based on the values\n in skb.\n A return value of 0 means this particular skb should be not be counted.\n
probe::irq_handler.exit — \n Execution of interrupt handler completed\n-
Synopsis
irq_handler.exit
Values
flags_str
\n+
Synopsis
irq_handler.exit
Values
thread
\n+ thread pointer for threaded interrupts\n+
thread_fn
\n+ interrupt handler function for threaded interrupts\n+
flags_str
\n symbolic string representation of IRQ flags\n+
dir
\n+ pointer to the proc/irq/NN/name entry\n+
ret
\n+ return value of the handler\n+
dev_name
\n+ name of device\n
thread_flags
\n Flags related to thread\n
irq
\n interrupt number\n-
dev_id
\n- Cookie to identify device\n-
ret
\n- return value of the handler\n-
handler
\n- interrupt handler function that was executed\n
flags
\n flags for IRQ handler\n-
thread_fn
\n- interrupt handler function for threaded interrupts\n-
next_irqaction
\n- pointer to next irqaction for shared interrupts\n-
thread
\n- thread pointer for threaded interrupts\n-
dev_name
\n- name of device\n-
dir
\n- pointer to the proc/irq/NN/name entry\n
action
\n struct irqaction*\n+
handler
\n+ interrupt handler function that was executed\n+
next_irqaction
\n+ pointer to next irqaction for shared interrupts\n+
dev_id
\n+ Cookie to identify device\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,36 +2,36 @@\n Prev\u00a0Chapter\u00a012.\u00a0Interrupt Request (IRQ) Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::irq_handler.exit \u2014 Execution of interrupt handler completed\n ***** Synopsis *****\n irq_handler.exit\n ***** Values *****\n+ thread\n+ thread pointer for threaded interrupts\n+ thread_fn\n+ interrupt handler function for threaded interrupts\n flags_str\n symbolic string representation of IRQ flags\n+ dir\n+ pointer to the proc/irq/NN/name entry\n+ ret\n+ return value of the handler\n+ dev_name\n+ name of device\n thread_flags\n Flags related to thread\n irq\n interrupt number\n- dev_id\n- Cookie to identify device\n- ret\n- return value of the handler\n- handler\n- interrupt handler function that was executed\n flags\n flags for IRQ handler\n- thread_fn\n- interrupt handler function for threaded interrupts\n- next_irqaction\n- pointer to next irqaction for shared interrupts\n- thread\n- thread pointer for threaded interrupts\n- dev_name\n- name of device\n- dir\n- pointer to the proc/irq/NN/name entry\n action\n struct irqaction*\n+ handler\n+ interrupt handler function that was executed\n+ next_irqaction\n+ pointer to next irqaction for shared interrupts\n+ dev_id\n+ Cookie to identify device\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::irq_handler.entry\u00a0Home \u00a0probe::softirq.entry\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-is-myproc.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-is-myproc.html", "unified_diff": "@@ -1,10 +1,10 @@\n function::is_myproc
\n This function returns the value of the kernel jiffies\n variable. This value is incremented periodically by timer interrupts,\n and may wrap around a 32-bit or 64-bit boundary. See HZ.\n
\n Array description. An empty string can be used.\n-
Description
\n+
Description
\n This function adds a array, setting up everything\n needed. Arrays contain other metrics, added with\n json_add_array_numeric_metric or json_add_array_string_metric.\n
probe::json_data — \n Fires whenever JSON data is wanted by a reader.\n-
Synopsis
json_data
Values
\n+
Synopsis
json_data
Values
\n None\n-
Context
\n+
Context
\n This probe fires when the JSON data is about to be read. This\n probe must gather up data and then call the following macros to\n output the data in JSON format. First, json_output_data_start()\n must be called. That call is followed by one or more of the\n following (one call for each data item):\n json_output_string_value(), json_output_numeric_value(),\n json_output_array_string_value(), and\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-json-output-array-numeric-value.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-json-output-array-numeric-value.html", "unified_diff": "@@ -1,18 +1,18 @@\n
\n The array index (as a string) indicating where to store the numeric value.\n
metric_name
\n The name of the numeric metric.\n
value
\n The numeric value to output.\n-
Description
\n+
Description
\n The json_output_array_numeric_value macro is designed\n to be called from the 'json_data' probe in the user's script to\n output a metric's numeric value that is in an array. This metric\n should have been added with json_add_array_numeric_metric.\n
\n The array index (as a string) indicating where to store the string value.\n
metric_name
\n The name of the string metric.\n
value
\n The string value to output.\n-
Description
\n+
Description
\n The json_output_array_string_value macro is designed\n to be called from the 'json_data' probe in the user's script to\n output a metric's string value that is in an array. This metric\n should have been added with json_add_array_string_metric.\n
macro::json_output_data_end — \n End the json output.\n
Synopsis
\n @json_output_data_end()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n The json_output_data_end macro is designed to be\n called from the 'json_data' probe from the user's script. It marks\n the end of the JSON output.\n
macro::json_output_data_start — \n Start the json output.\n
Synopsis
\n @json_output_data_start()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n The json_output_data_start macro is designed to be\n called from the 'json_data' probe from the user's script. It marks\n the start of the JSON output.\n
macro::json_output_numeric_value — \n Output a numeric value.\n
Synopsis
\n @json_output_numeric_value(name,value)\n-
Arguments
name
\n+
Arguments
name
\n The name of the numeric metric.\n
value
\n The numeric value to output.\n-
Description
\n+
Description
\n The json_output_numeric_value macro is designed to be\n called from the 'json_data' probe in the user's script to output a\n metric's numeric value. This metric should have been added with\n json_add_numeric_metric.\n
macro::json_output_string_value — \n Output a string value.\n
Synopsis
\n @json_output_string_value(name,value)\n-
Arguments
name
\n+
Arguments
name
\n The name of the string metric.\n
value
\n The string value to output.\n-
Description
\n+
Description
\n The json_output_string_value macro is designed to be\n called from the 'json_data' probe in the user's script to output a\n metric's string value. This metric should have been added with\n json_add_string_metric.\n
function::json_set_prefix — \n Set the metric prefix.\n
Synopsis
\n json_set_prefix:long(prefix:string)\n-
Arguments
prefix
\n+
Arguments
prefix
\n The prefix name to be used.\n-
Description
\n+
Description
\n This function sets the “prefix”, which is the name\n of the base of the metric hierarchy. Calling this function is\n optional, by default the name of the systemtap module is used.\n
\n the kernel space address to retrieve the buffer from\n
inlen
\n the exact length of the buffer to read\n
outlen
\n the maximum length of the output string\n-
Description
\n+
Description
\n Reads inlen characters of a buffer from the given kernel space\n memory address, and returns up to outlen characters, where any ASCII\n characters that are not printable are replaced by the corresponding escape\n sequence in the returned string. Note that the string will be surrounded by\n double quotes. On the rare cases when kernel space data is not accessible at\n the given address, an error is thrown.\n
\n the kernel space address to retrieve the buffer from\n
inlen
\n the exact length of the buffer to read\n
outlen
\n the maximum length of the output string\n-
Description
1) Reads inlen characters of a buffer from the given kernel space\n+
Description
1) Reads inlen characters of a buffer from the given kernel space\n memory address, and returns up to MAXSTRINGLEN characters, where any ASCII\n characters that are not printable are replaced by the corresponding escape\n sequence in the returned string. Note that the string will be surrounded by\n double quotes. On the rare cases when kernel space data is not accessible at\n the given address, the address itself is returned as a string, without\n double quotes.
2) Reads inlen characters of a buffer from the given kernel space\n memory address, and returns up to outlen characters, where any ASCII\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-kernel-char.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-kernel-char.html", "unified_diff": "@@ -1,10 +1,10 @@\n
function::kernel_string_quoted — \n Retrieves and quotes string from kernel memory\n
Synopsis
\n kernel_string_quoted:string(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n the kernel memory address to retrieve the string from\n-
Description
\n+
Description
\n Returns the null terminated C string from a given kernel\n memory address where any ASCII characters that are not printable are\n replaced by the corresponding escape sequence in the returned string. Note\n that the string will be surrounded by double quotes. If the kernel memory\n data is not accessible at the given address, the address itself is returned\n as a string, without double quotes.\n
\n The kernel address to retrieve the string from\n
err_msg
\n The error message to return when data isn't available\n-
Description
1) This function returns a null terminated UTF-8 string converted\n+
Description
1) This function returns a null terminated UTF-8 string converted\n from the UTF-16 string at a given kernel memory address. Reports an error on\n string copy fault or conversion error.
2) This function returns a null terminated UTF-8 string converted\n from the UTF-16 string at a given kernel memory address. Reports the given\n error message on string copy fault or conversion error.
\n The kernel address to retrieve the string from\n
err_msg
\n The error message to return when data isn't available\n-
Description
1) This function returns a null terminated UTF-8 string converted\n+
Description
1) This function returns a null terminated UTF-8 string converted\n from the UTF-32 string at a given kernel memory address. Reports an error on\n string copy fault or conversion error.
2) This function returns a null terminated UTF-8 string converted\n from the UTF-32 string at a given kernel memory address. Reports the given\n error message on string copy fault or conversion error.
probe::kprocess.exec_complete — \n Return from exec to a new program\n-
Synopsis
kprocess.exec_complete
Values
errno
\n+
Synopsis
kprocess.exec_complete
Values
errno
\n The error number resulting from the exec\n-
name
\n- Name of the system call (“execve”) (SystemTap v2.5+)\n-
success
\n- A boolean indicating whether the exec was successful\n
retstr
\n A string representation of errno (SystemTap v2.5+)\n-
Context
\n+
success
\n+ A boolean indicating whether the exec was successful\n+
name
\n+ Name of the system call (“execve”) (SystemTap v2.5+)\n+
Context
\n On success, the context of the new executable.\n On failure, remains in the context of the caller.\n-
Description
\n+
Description
\n Fires at the completion of an exec call. Aliased to the\n syscall.execve.return probe in SystemTap v2.5+.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,20 +4,20 @@\n ***** Name *****\n probe::kprocess.exec_complete \u2014 Return from exec to a new program\n ***** Synopsis *****\n kprocess.exec_complete\n ***** Values *****\n errno\n The error number resulting from the exec\n- name\n- Name of the system call (\u201cexecve\u201d) (SystemTap v2.5+)\n- success\n- A boolean indicating whether the exec was successful\n retstr\n A string representation of errno (SystemTap v2.5+)\n+ success\n+ A boolean indicating whether the exec was successful\n+ name\n+ Name of the system call (\u201cexecve\u201d) (SystemTap v2.5+)\n ***** Context *****\n On success, the context of the new executable. On failure, remains in the\n context of the caller.\n ***** Description *****\n Fires at the completion of an exec call. Aliased to the syscall.execve.return\n probe in SystemTap v2.5+.\n ===============================================================================\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-kprocess-exec.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-kprocess-exec.html", "unified_diff": "@@ -1,18 +1,18 @@\n probe::kprocess.exec
probe::kprocess.exec — \n Attempt to exec to a new program\n-
Synopsis
kprocess.exec
Values
name
\n+
Synopsis
kprocess.exec
Values
argstr
\n+ A string containing the filename followed by the\n+ arguments to pass, excluding 0th arg (SystemTap v2.5+)\n+
name
\n Name of the system call (“execve”) (SystemTap v2.5+)\n
args
\n The arguments to pass to the new executable, including\n the 0th arg (SystemTap v2.5+)\n-
argstr
\n- A string containing the filename followed by the\n- arguments to pass, excluding 0th arg (SystemTap v2.5+)\n
filename
\n The path to the new executable\n-
Context
\n+
Context
\n The caller of exec.\n-
Description
\n+
Description
\n Fires whenever a process attempts to exec to a new program. Aliased\n to the syscall.execve probe in SystemTap v2.5+.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,22 +2,22 @@\n Prev\u00a0Chapter\u00a016.\u00a0Kernel Process Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::kprocess.exec \u2014 Attempt to exec to a new program\n ***** Synopsis *****\n kprocess.exec\n ***** Values *****\n+ argstr\n+ A string containing the filename followed by the arguments to pass,\n+ excluding 0th arg (SystemTap v2.5+)\n name\n Name of the system call (\u201cexecve\u201d) (SystemTap v2.5+)\n args\n The arguments to pass to the new executable, including the 0th arg\n (SystemTap v2.5+)\n- argstr\n- A string containing the filename followed by the arguments to pass,\n- excluding 0th arg (SystemTap v2.5+)\n filename\n The path to the new executable\n ***** Context *****\n The caller of exec.\n ***** Description *****\n Fires whenever a process attempts to exec to a new program. Aliased to the\n syscall.execve probe in SystemTap v2.5+.\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-kprocess-exit.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-kprocess-exit.html", "unified_diff": "@@ -1,11 +1,11 @@\n probe::kprocess.exit
\n Fires when a process terminates. This will always be followed by a\n kprocess.release, though the latter may be delayed if the process waits in a\n zombie state.\n
\n Same as released_pid for compatibility (deprecated)\n-
released_tid
\n- TID of the task being released\n
released_pid
\n PID of the process being released\n+
released_tid
\n+ TID of the task being released\n
task
\n A task handle to the process being released\n-
Context
\n+
Context
\n The context of the parent, if it wanted notification of this process'\n termination, else the context of the process itself.\n-
Description
\n+
Description
\n Fires when a process is released from the kernel. This always follows a\n kprocess.exit, though it may be delayed somewhat if the process waits in a\n zombie state.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,18 +4,18 @@\n ***** Name *****\n probe::kprocess.release \u2014 Process released\n ***** Synopsis *****\n kprocess.release\n ***** Values *****\n pid\n Same as released_pid for compatibility (deprecated)\n- released_tid\n- TID of the task being released\n released_pid\n PID of the process being released\n+ released_tid\n+ TID of the task being released\n task\n A task handle to the process being released\n ***** Context *****\n The context of the parent, if it wanted notification of this process'\n termination, else the context of the process itself.\n ***** Description *****\n Fires when a process is released from the kernel. This always follows a\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-kprocess-start.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-kprocess-start.html", "unified_diff": "@@ -1,9 +1,9 @@\n probe::kprocess.start
probe::linuxmib.DelayedACKs — \n Count of delayed acks\n-
Synopsis
linuxmib.DelayedACKs
Values
op
\n- Value to be added to the counter (default value of 1)\n-
sk
\n+
Synopsis
linuxmib.DelayedACKs
Values
sk
\n Pointer to the struct sock being acted on\n-
Description
\n+
op
\n+ Value to be added to the counter (default value of 1)\n+
Description
\n The packet pointed to by skb is filtered by the function\n linuxmib_filter_key. If the packet passes the filter is is\n counted in the global DelayedACKs (equivalent to SNMP's MIB\n LINUX_MIB_DELAYEDACKS)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a015.\u00a0SNMP Information Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::linuxmib.DelayedACKs \u2014 Count of delayed acks\n ***** Synopsis *****\n linuxmib.DelayedACKs\n ***** Values *****\n- op\n- Value to be added to the counter (default value of 1)\n sk\n Pointer to the struct sock being acted on\n+ op\n+ Value to be added to the counter (default value of 1)\n ***** Description *****\n The packet pointed to by skb is filtered by the function linuxmib_filter_key.\n If the packet passes the filter is is counted in the global DelayedACKs\n (equivalent to SNMP's MIB LINUX_MIB_DELAYEDACKS)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::ipmib.ReasmTimeout\u00a0Home \u00a0probe::linuxmib.ListenDrops\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-linuxmib-ListenDrops.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-linuxmib-ListenDrops.html", "unified_diff": "@@ -1,12 +1,12 @@\n probe::linuxmib.ListenDrops
probe::linuxmib.ListenDrops — \n Count of times conn request that were dropped\n-
Synopsis
linuxmib.ListenDrops
Values
sk
\n+
Synopsis
linuxmib.ListenDrops
Values
sk
\n Pointer to the struct sock being acted on\n
op
\n Value to be added to the counter (default value of 1)\n-
Description
\n+
Description
\n The packet pointed to by skb is filtered by the function\n linuxmib_filter_key. If the packet passes the filter is is\n counted in the global ListenDrops (equivalent to SNMP's MIB\n LINUX_MIB_LISTENDROPS)\n
probe::linuxmib.ListenOverflows — \n Count of times a listen queue overflowed\n-
Synopsis
linuxmib.ListenOverflows
Values
op
\n+
Synopsis
linuxmib.ListenOverflows
Values
op
\n Value to be added to the counter (default value of 1)\n
sk
\n Pointer to the struct sock being acted on\n-
Description
\n+
Description
\n The packet pointed to by skb is filtered by the function\n linuxmib_filter_key. If the packet passes the filter is is\n counted in the global ListenOverflows (equivalent to SNMP's MIB\n LINUX_MIB_LISTENOVERFLOWS)\n
probe::linuxmib.TCPMemoryPressures — \n Count of times memory pressure was used\n-
Synopsis
linuxmib.TCPMemoryPressures
Values
op
\n- Value to be added to the counter (default value of 1)\n-
sk
\n+
Synopsis
linuxmib.TCPMemoryPressures
Values
sk
\n Pointer to the struct sock being acted on\n-
Description
\n+
op
\n+ Value to be added to the counter (default value of 1)\n+
Description
\n The packet pointed to by skb is filtered by the function\n linuxmib_filter_key. If the packet passes the filter is is\n counted in the global TCPMemoryPressures (equivalent to SNMP's MIB\n LINUX_MIB_TCPMEMORYPRESSURES)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a015.\u00a0SNMP Information Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::linuxmib.TCPMemoryPressures \u2014 Count of times memory pressure was used\n ***** Synopsis *****\n linuxmib.TCPMemoryPressures\n ***** Values *****\n- op\n- Value to be added to the counter (default value of 1)\n sk\n Pointer to the struct sock being acted on\n+ op\n+ Value to be added to the counter (default value of 1)\n ***** Description *****\n The packet pointed to by skb is filtered by the function linuxmib_filter_key.\n If the packet passes the filter is is counted in the global TCPMemoryPressures\n (equivalent to SNMP's MIB LINUX_MIB_TCPMEMORYPRESSURES)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::linuxmib.ListenOverflows\u00a0Home \u00a0probe::tcpmib.ActiveOpens\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-linuxmib-filter-key.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-linuxmib-filter-key.html", "unified_diff": "@@ -1,15 +1,15 @@\n function::linuxmib_filter_key
function::linuxmib_filter_key — \n Default filter function for linuxmib.* probes\n
Synopsis
\n linuxmib_filter_key:long(sk:long,op:long)\n-
Arguments
sk
\n+
Arguments
sk
\n pointer to the struct sock\n
op
\n value to be counted if sk passes the filter\n-
Description
\n+
Description
\n This function is a default filter function.\n The user can replace this function with their own.\n The user-supplied filter function returns an index key based on the values\n in sk.\n A return value of 0 means this particular sk should be not be counted.\n
function::local_clock_ms — \n Number of milliseconds on the local cpu's clock\n
Synopsis
\n local_clock_ms:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function returns the number of milliseconds on the local\n cpu's clock. This is always monotonic comparing on the same cpu, but may\n have some drift between cpus (within about a jiffy).\n
function::local_clock_ns — \n Number of nanoseconds on the local cpu's clock\n
Synopsis
\n local_clock_ns:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function returns the number of nanoseconds on the local\n cpu's clock. This is always monotonic comparing on the same cpu, but may\n have some drift between cpus (within about a jiffy).\n
function::local_clock_s — \n Number of seconds on the local cpu's clock\n
Synopsis
\n local_clock_s:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function returns the number of seconds on the local cpu's\n clock. This is always monotonic comparing on the same cpu, but may have\n some drift between cpus (within about a jiffy).\n
function::local_clock_us — \n Number of microseconds on the local cpu's clock\n
Synopsis
\n local_clock_us:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function returns the number of microseconds on the local\n cpu's clock. This is always monotonic comparing on the same cpu, but may\n have some drift between cpus (within about a jiffy).\n
function::log — \n Send a line to the common trace buffer\n
Synopsis
\n log(msg:string)\n-
Arguments
msg
\n+
Arguments
msg
\n The formatted message string\n-
Description
\n+
Description
\n This function logs data. log sends the\n message immediately to staprun and to the bulk transport\n (relayfs) if it is being used. If the last character given\n is not a newline, then one is added. This function is not \n as efficient as printf and should be used only for urgent\n messages. \n
function::matched_str — \n Return the last matched string.\n
Synopsis
\n matched_str:string()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n returns the string matched by the last successful\n use of the =~ regexp matching operator. Returns an error if the\n last use of =~ led to a failed match.\n
function::matched — \n Return a given matched subexpression.\n
Synopsis
\n matched:string(n:long)\n-
Arguments
n
\n+
Arguments
n
\n index to the subexpression to return. 0 corresponds to the\n entire regular expression.\n-
Description
\n+
Description
\n returns the content of the n'th subexpression of the\n last successful use of the =~ regex matching operator. Returns an\n empty string if the n'th subexpression was not matched (e.g. due to\n alternation). Throws an error if the last use of =~ was a failed\n match, or if fewer than n subexpressions are present in the\n original regexp.\n
function::modname — \n Return the kernel module name loaded at the address\n
Synopsis
\n modname:string(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The address to map to a kernel module name\n-
Description
\n+
Description
\n Returns the module name associated with the given\n address if known. If not known it will raise an error. If the\n address was not in a kernel module, but in the kernel itself, then\n the string “kernel” will be returned.\n
function::msecs_to_string — \n Human readable string for given milliseconds\n
Synopsis
\n msecs_to_string:string(msecs:long)\n-
Arguments
msecs
\n+
Arguments
msecs
\n Number of milliseconds to translate.\n-
Description
\n+
Description
\n Returns a string representing the number of\n milliseconds as a human readable string consisting of “XmY.ZZZs”,\n where X is the number of minutes, Y is the number of seconds and\n ZZZ is the number of milliseconds.\n
probe::netdev.change_mac — \n Called when the netdev_name has the MAC changed\n-
Synopsis
netdev.change_mac
Values
old_mac
\n- The current MAC address\n-
mac_len
\n- The MAC length\n+
Synopsis
netdev.change_mac
Values
dev_name
\n+ The device that will have the MAC changed\n
new_mac
\n The new MAC address\n-
dev_name
\n- The device that will have the MAC changed\n+
mac_len
\n+ The MAC length\n+
old_mac
\n+ The current MAC address\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::netdev.change_mac \u2014 Called when the netdev_name has the MAC changed\n ***** Synopsis *****\n netdev.change_mac\n ***** Values *****\n- old_mac\n- The current MAC address\n- mac_len\n- The MAC length\n- new_mac\n- The new MAC address\n dev_name\n The device that will have the MAC changed\n+ new_mac\n+ The new MAC address\n+ mac_len\n+ The MAC length\n+ old_mac\n+ The current MAC address\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n function::ntohs\u00a0Home \u00a0probe::netdev.change_mtu\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netdev-change-mtu.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netdev-change-mtu.html", "unified_diff": "@@ -1,9 +1,9 @@\n probe::netdev.change_mtu
probe::netdev.change_mtu — \n Called when the netdev MTU is changed\n-
Synopsis
netdev.change_mtu
Values
dev_name
\n- The device that will have the MTU changed\n-
old_mtu
\n+
Synopsis
netdev.change_mtu
Values
old_mtu
\n The current MTU\n
new_mtu
\n The new MTU\n+
dev_name
\n+ The device that will have the MTU changed\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,16 +2,16 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::netdev.change_mtu \u2014 Called when the netdev MTU is changed\n ***** Synopsis *****\n netdev.change_mtu\n ***** Values *****\n- dev_name\n- The device that will have the MTU changed\n old_mtu\n The current MTU\n new_mtu\n The new MTU\n+ dev_name\n+ The device that will have the MTU changed\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netdev.change_mac\u00a0Home \u00a0probe::netdev.change_rx_flag\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netdev-change-rx-flag.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netdev-change-rx-flag.html", "unified_diff": "@@ -1,7 +1,7 @@\n probe::netdev.change_rx_flag
probe::netdev.change_rx_flag — \n Called when the device RX flag will be changed\n-
Synopsis
netdev.change_rx_flag
Values
flags
\n- The new flags\n-
dev_name
\n+
Synopsis
netdev.change_rx_flag
Values
dev_name
\n The device that will be changed\n+
flags
\n+ The new flags\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,14 +2,14 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::netdev.change_rx_flag \u2014 Called when the device RX flag will be changed\n ***** Synopsis *****\n netdev.change_rx_flag\n ***** Values *****\n- flags\n- The new flags\n dev_name\n The device that will be changed\n+ flags\n+ The new flags\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netdev.change_mtu\u00a0Home \u00a0probe::netdev.close\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netdev-close.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netdev-close.html", "unified_diff": "@@ -1,5 +1,5 @@\n probe::netdev.close
probe::netdev.hard_transmit — \n Called when the devices is going to TX (hard)\n-
Synopsis
netdev.hard_transmit
Values
length
\n+
Synopsis
netdev.hard_transmit
Values
length
\n The length of the transmit buffer.\n-
dev_name
\n- The device scheduled to transmit\n
protocol
\n The protocol used in the transmission\n+
dev_name
\n+ The device scheduled to transmit\n
truesize
\n The size of the data to be transmitted.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,16 +4,16 @@\n ***** Name *****\n probe::netdev.hard_transmit \u2014 Called when the devices is going to TX (hard)\n ***** Synopsis *****\n netdev.hard_transmit\n ***** Values *****\n length\n The length of the transmit buffer.\n- dev_name\n- The device scheduled to transmit\n protocol\n The protocol used in the transmission\n+ dev_name\n+ The device scheduled to transmit\n truesize\n The size of the data to be transmitted.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netdev.get_stats\u00a0Home \u00a0probe::netdev.ioctl\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netdev-ioctl.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netdev-ioctl.html", "unified_diff": "@@ -1,7 +1,7 @@\n probe::netdev.ioctl
probe::netdev.receive — \n Data received from network device.\n-
Synopsis
netdev.receive
Values
protocol
\n- Protocol of received packet.\n+
Synopsis
netdev.receive
Values
length
\n+ The length of the receiving buffer.\n
dev_name
\n The name of the device. e.g: eth0, ath1.\n-
length
\n- The length of the receiving buffer.\n+
protocol
\n+ Protocol of received packet.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,16 +2,16 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::netdev.receive \u2014 Data received from network device.\n ***** Synopsis *****\n netdev.receive\n ***** Values *****\n- protocol\n- Protocol of received packet.\n- dev_name\n- The name of the device. e.g: eth0, ath1.\n length\n The length of the receiving buffer.\n+ dev_name\n+ The name of the device. e.g: eth0, ath1.\n+ protocol\n+ Protocol of received packet.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netdev.open\u00a0Home \u00a0probe::netdev.register\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netdev-register.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netdev-register.html", "unified_diff": "@@ -1,5 +1,5 @@\n probe::netdev.register
\n The protocol of this packet(defined in include/linux/if_ether.h).\n-
truesize
\n- The size of the data to be transmitted.\n+
dev_name
\n+ The name of the device. e.g: eth0, ath1.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::netdev.transmit \u2014 Network device transmitting buffer\n ***** Synopsis *****\n netdev.transmit\n ***** Values *****\n+ truesize\n+ The size of the data to be transmitted.\n length\n The length of the transmit buffer.\n- dev_name\n- The name of the device. e.g: eth0, ath1.\n protocol\n The protocol of this packet(defined in include/linux/if_ether.h).\n- truesize\n- The size of the data to be transmitted.\n+ dev_name\n+ The name of the device. e.g: eth0, ath1.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netdev.set_promiscuity\u00a0Home \u00a0probe::netdev.unregister\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netdev-unregister.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netdev-unregister.html", "unified_diff": "@@ -1,5 +1,5 @@\n probe::netdev.unregister
probe::netfilter.arp.forward — \n - Called for each ARP packet to be forwarded\n-
Synopsis
netfilter.arp.forward
Values
data_hex
\n+
Synopsis
netfilter.arp.forward
Values
nf_queue
\n+ Constant used to signify a 'queue' verdict\n+
nf_drop
\n+ Constant used to signify a 'drop' verdict\n+
ar_tip
\n+ Ethernet+IP only (ar_pro==0x800): target IP address\n+
data_hex
\n A hexadecimal string representing the packet buffer contents\n+
nf_accept
\n+ Constant used to signify an 'accept' verdict\n+
indev_name
\n+ Name of network device packet was received on (if known)\n
ar_tha
\n Ethernet+IP only (ar_pro==0x800): target hardware (MAC) address\n-
nf_drop
\n- Constant used to signify a 'drop' verdict\n
nf_stolen
\n Constant used to signify a 'stolen' verdict\n-
ar_hrd
\n- Format of hardware address\n-
nf_queue
\n- Constant used to signify a 'queue' verdict\n-
pf
\n- Protocol family -- always “arp”\n-
nf_stop
\n- Constant used to signify a 'stop' verdict\n+
indev
\n+ Address of net_device representing input device, 0 if unknown\n
data_str
\n A string representing the packet buffer contents\n-
ar_pro
\n- Format of protocol address\n-
ar_tip
\n- Ethernet+IP only (ar_pro==0x800): target IP address\n-
ar_pln
\n- Length of protocol address\n-
nf_repeat
\n- Constant used to signify a 'repeat' verdict\n-
outdev
\n- Address of net_device representing output device, 0 if unknown\n
ar_data
\n Address of ARP packet data region (after the header)\n
outdev_name
\n Name of network device packet will be routed to (if known)\n-
length
\n- The length of the packet buffer contents, in bytes\n-
indev
\n- Address of net_device representing input device, 0 if unknown\n+
ar_pro
\n+ Format of protocol address\n+
nf_stop
\n+ Constant used to signify a 'stop' verdict\n+
outdev
\n+ Address of net_device representing output device, 0 if unknown\n+
nf_repeat
\n+ Constant used to signify a 'repeat' verdict\n
ar_hln
\n Length of hardware address\n
ar_sha
\n Ethernet+IP only (ar_pro==0x800): source hardware (MAC) address \n-
nf_accept
\n- Constant used to signify an 'accept' verdict\n+
ar_sip
\n+ Ethernet+IP only (ar_pro==0x800): source IP address\n+
length
\n+ The length of the packet buffer contents, in bytes\n+
ar_pln
\n+ Length of protocol address\n+
pf
\n+ Protocol family -- always “arp”\n
ar_op
\n ARP opcode (command)\n-
indev_name
\n- Name of network device packet was received on (if known)\n
arphdr
\n Address of ARP header\n-
ar_sip
\n- Ethernet+IP only (ar_pro==0x800): source IP address\n+
ar_hrd
\n+ Format of hardware address\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,60 +2,60 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::netfilter.arp.forward \u2014 - Called for each ARP packet to be forwarded\n ***** Synopsis *****\n netfilter.arp.forward\n ***** Values *****\n+ nf_queue\n+ Constant used to signify a 'queue' verdict\n+ nf_drop\n+ Constant used to signify a 'drop' verdict\n+ ar_tip\n+ Ethernet+IP only (ar_pro==0x800): target IP address\n data_hex\n A hexadecimal string representing the packet buffer contents\n+ nf_accept\n+ Constant used to signify an 'accept' verdict\n+ indev_name\n+ Name of network device packet was received on (if known)\n ar_tha\n Ethernet+IP only (ar_pro==0x800): target hardware (MAC) address\n- nf_drop\n- Constant used to signify a 'drop' verdict\n nf_stolen\n Constant used to signify a 'stolen' verdict\n- ar_hrd\n- Format of hardware address\n- nf_queue\n- Constant used to signify a 'queue' verdict\n- pf\n- Protocol family -- always \u201carp\u201d\n- nf_stop\n- Constant used to signify a 'stop' verdict\n+ indev\n+ Address of net_device representing input device, 0 if unknown\n data_str\n A string representing the packet buffer contents\n- ar_pro\n- Format of protocol address\n- ar_tip\n- Ethernet+IP only (ar_pro==0x800): target IP address\n- ar_pln\n- Length of protocol address\n- nf_repeat\n- Constant used to signify a 'repeat' verdict\n- outdev\n- Address of net_device representing output device, 0 if unknown\n ar_data\n Address of ARP packet data region (after the header)\n outdev_name\n Name of network device packet will be routed to (if known)\n- length\n- The length of the packet buffer contents, in bytes\n- indev\n- Address of net_device representing input device, 0 if unknown\n+ ar_pro\n+ Format of protocol address\n+ nf_stop\n+ Constant used to signify a 'stop' verdict\n+ outdev\n+ Address of net_device representing output device, 0 if unknown\n+ nf_repeat\n+ Constant used to signify a 'repeat' verdict\n ar_hln\n Length of hardware address\n ar_sha\n Ethernet+IP only (ar_pro==0x800): source hardware (MAC) address\n- nf_accept\n- Constant used to signify an 'accept' verdict\n+ ar_sip\n+ Ethernet+IP only (ar_pro==0x800): source IP address\n+ length\n+ The length of the packet buffer contents, in bytes\n+ ar_pln\n+ Length of protocol address\n+ pf\n+ Protocol family -- always \u201carp\u201d\n ar_op\n ARP opcode (command)\n- indev_name\n- Name of network device packet was received on (if known)\n arphdr\n Address of ARP header\n- ar_sip\n- Ethernet+IP only (ar_pro==0x800): source IP address\n+ ar_hrd\n+ Format of hardware address\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netdev.unregister\u00a0Home \u00a0probe::netfilter.arp.in\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-arp-in.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-arp-in.html", "unified_diff": "@@ -1,53 +1,53 @@\n probe::netfilter.arp.in
probe::netfilter.arp.in — \n - Called for each incoming ARP packet\n-
Synopsis
netfilter.arp.in
Values
ar_sha
\n+
Synopsis
netfilter.arp.in
Values
ar_pro
\n+ Format of protocol address\n+
outdev_name
\n+ Name of network device packet will be routed to (if known)\n+
data_str
\n+ A string representing the packet buffer contents\n+
ar_data
\n+ Address of ARP packet data region (after the header)\n+
ar_sha
\n Ethernet+IP only (ar_pro==0x800): source hardware (MAC) address \n
ar_hln
\n Length of hardware address\n-
indev
\n- Address of net_device representing input device, 0 if unknown\n-
nf_accept
\n- Constant used to signify an 'accept' verdict\n-
ar_sip
\n- Ethernet+IP only (ar_pro==0x800): source IP address\n+
nf_repeat
\n+ Constant used to signify a 'repeat' verdict\n+
nf_stop
\n+ Constant used to signify a 'stop' verdict\n+
outdev
\n+ Address of net_device representing output device, 0 if unknown\n
arphdr
\n Address of ARP header\n-
indev_name
\n- Name of network device packet was received on (if known)\n
ar_op
\n ARP opcode (command)\n-
data_hex
\n- A hexadecimal string representing the packet buffer contents\n+
ar_pln
\n+ Length of protocol address\n+
pf
\n+ Protocol family -- always “arp”\n+
length
\n+ The length of the packet buffer contents, in bytes\n+
ar_sip
\n+ Ethernet+IP only (ar_pro==0x800): source IP address\n+
ar_hrd
\n+ Format of hardware address\n
nf_drop
\n Constant used to signify a 'drop' verdict\n-
ar_tha
\n- Ethernet+IP only (ar_pro==0x800): target hardware (MAC) address\n-
nf_stolen
\n- Constant used to signify a 'stolen' verdict\n
nf_queue
\n Constant used to signify a 'queue' verdict\n-
ar_hrd
\n- Format of hardware address\n-
ar_pro
\n- Format of protocol address\n-
data_str
\n- A string representing the packet buffer contents\n-
nf_stop
\n- Constant used to signify a 'stop' verdict\n-
pf
\n- Protocol family -- always “arp”\n-
nf_repeat
\n- Constant used to signify a 'repeat' verdict\n-
ar_pln
\n- Length of protocol address\n+
data_hex
\n+ A hexadecimal string representing the packet buffer contents\n+
nf_accept
\n+ Constant used to signify an 'accept' verdict\n
ar_tip
\n Ethernet+IP only (ar_pro==0x800): target IP address\n-
length
\n- The length of the packet buffer contents, in bytes\n-
outdev
\n- Address of net_device representing output device, 0 if unknown\n-
ar_data
\n- Address of ARP packet data region (after the header)\n-
outdev_name
\n- Name of network device packet will be routed to (if known)\n+
ar_tha
\n+ Ethernet+IP only (ar_pro==0x800): target hardware (MAC) address\n+
indev_name
\n+ Name of network device packet was received on (if known)\n+
indev
\n+ Address of net_device representing input device, 0 if unknown\n+
nf_stolen
\n+ Constant used to signify a 'stolen' verdict\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,60 +2,60 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::netfilter.arp.in \u2014 - Called for each incoming ARP packet\n ***** Synopsis *****\n netfilter.arp.in\n ***** Values *****\n+ ar_pro\n+ Format of protocol address\n+ outdev_name\n+ Name of network device packet will be routed to (if known)\n+ data_str\n+ A string representing the packet buffer contents\n+ ar_data\n+ Address of ARP packet data region (after the header)\n ar_sha\n Ethernet+IP only (ar_pro==0x800): source hardware (MAC) address\n ar_hln\n Length of hardware address\n- indev\n- Address of net_device representing input device, 0 if unknown\n- nf_accept\n- Constant used to signify an 'accept' verdict\n- ar_sip\n- Ethernet+IP only (ar_pro==0x800): source IP address\n+ nf_repeat\n+ Constant used to signify a 'repeat' verdict\n+ nf_stop\n+ Constant used to signify a 'stop' verdict\n+ outdev\n+ Address of net_device representing output device, 0 if unknown\n arphdr\n Address of ARP header\n- indev_name\n- Name of network device packet was received on (if known)\n ar_op\n ARP opcode (command)\n- data_hex\n- A hexadecimal string representing the packet buffer contents\n+ ar_pln\n+ Length of protocol address\n+ pf\n+ Protocol family -- always \u201carp\u201d\n+ length\n+ The length of the packet buffer contents, in bytes\n+ ar_sip\n+ Ethernet+IP only (ar_pro==0x800): source IP address\n+ ar_hrd\n+ Format of hardware address\n nf_drop\n Constant used to signify a 'drop' verdict\n- ar_tha\n- Ethernet+IP only (ar_pro==0x800): target hardware (MAC) address\n- nf_stolen\n- Constant used to signify a 'stolen' verdict\n nf_queue\n Constant used to signify a 'queue' verdict\n- ar_hrd\n- Format of hardware address\n- ar_pro\n- Format of protocol address\n- data_str\n- A string representing the packet buffer contents\n- nf_stop\n- Constant used to signify a 'stop' verdict\n- pf\n- Protocol family -- always \u201carp\u201d\n- nf_repeat\n- Constant used to signify a 'repeat' verdict\n- ar_pln\n- Length of protocol address\n+ data_hex\n+ A hexadecimal string representing the packet buffer contents\n+ nf_accept\n+ Constant used to signify an 'accept' verdict\n ar_tip\n Ethernet+IP only (ar_pro==0x800): target IP address\n- length\n- The length of the packet buffer contents, in bytes\n- outdev\n- Address of net_device representing output device, 0 if unknown\n- ar_data\n- Address of ARP packet data region (after the header)\n- outdev_name\n- Name of network device packet will be routed to (if known)\n+ ar_tha\n+ Ethernet+IP only (ar_pro==0x800): target hardware (MAC) address\n+ indev_name\n+ Name of network device packet was received on (if known)\n+ indev\n+ Address of net_device representing input device, 0 if unknown\n+ nf_stolen\n+ Constant used to signify a 'stolen' verdict\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netfilter.arp.forward\u00a0Home \u00a0probe::netfilter.arp.out\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-arp-out.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-arp-out.html", "unified_diff": "@@ -1,53 +1,53 @@\n probe::netfilter.arp.out
probe::netfilter.arp.out — \n - Called for each outgoing ARP packet\n-
Synopsis
netfilter.arp.out
Values
ar_tip
\n- Ethernet+IP only (ar_pro==0x800): target IP address\n-
ar_pln
\n- Length of protocol address\n-
nf_repeat
\n- Constant used to signify a 'repeat' verdict\n-
outdev
\n- Address of net_device representing output device, 0 if unknown\n-
ar_data
\n- Address of ARP packet data region (after the header)\n-
outdev_name
\n- Name of network device packet will be routed to (if known)\n-
length
\n- The length of the packet buffer contents, in bytes\n-
pf
\n- Protocol family -- always “arp”\n-
nf_stop
\n- Constant used to signify a 'stop' verdict\n-
ar_pro
\n- Format of protocol address\n-
data_str
\n- A string representing the packet buffer contents\n+
Synopsis
netfilter.arp.out
Values
ar_tha
\n+ Ethernet+IP only (ar_pro==0x800): target hardware (MAC) address\n+
indev_name
\n+ Name of network device packet was received on (if known)\n+
indev
\n+ Address of net_device representing input device, 0 if unknown\n
nf_stolen
\n Constant used to signify a 'stolen' verdict\n-
ar_hrd
\n- Format of hardware address\n+
nf_drop
\n+ Constant used to signify a 'drop' verdict\n
nf_queue
\n Constant used to signify a 'queue' verdict\n
data_hex
\n A hexadecimal string representing the packet buffer contents\n-
ar_tha
\n- Ethernet+IP only (ar_pro==0x800): target hardware (MAC) address\n-
nf_drop
\n- Constant used to signify a 'drop' verdict\n-
ar_op
\n- ARP opcode (command)\n-
indev_name
\n- Name of network device packet was received on (if known)\n+
nf_accept
\n+ Constant used to signify an 'accept' verdict\n+
ar_tip
\n+ Ethernet+IP only (ar_pro==0x800): target IP address\n
arphdr
\n Address of ARP header\n+
ar_op
\n+ ARP opcode (command)\n+
ar_pln
\n+ Length of protocol address\n+
pf
\n+ Protocol family -- always “arp”\n
ar_sip
\n Ethernet+IP only (ar_pro==0x800): source IP address\n-
nf_accept
\n- Constant used to signify an 'accept' verdict\n-
indev
\n- Address of net_device representing input device, 0 if unknown\n-
ar_hln
\n- Length of hardware address\n+
length
\n+ The length of the packet buffer contents, in bytes\n+
ar_hrd
\n+ Format of hardware address\n+
ar_pro
\n+ Format of protocol address\n+
outdev_name
\n+ Name of network device packet will be routed to (if known)\n+
data_str
\n+ A string representing the packet buffer contents\n+
ar_data
\n+ Address of ARP packet data region (after the header)\n
ar_sha
\n Ethernet+IP only (ar_pro==0x800): source hardware (MAC) address \n+
ar_hln
\n+ Length of hardware address\n+
nf_repeat
\n+ Constant used to signify a 'repeat' verdict\n+
nf_stop
\n+ Constant used to signify a 'stop' verdict\n+
outdev
\n+ Address of net_device representing output device, 0 if unknown\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,60 +2,60 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::netfilter.arp.out \u2014 - Called for each outgoing ARP packet\n ***** Synopsis *****\n netfilter.arp.out\n ***** Values *****\n- ar_tip\n- Ethernet+IP only (ar_pro==0x800): target IP address\n- ar_pln\n- Length of protocol address\n- nf_repeat\n- Constant used to signify a 'repeat' verdict\n- outdev\n- Address of net_device representing output device, 0 if unknown\n- ar_data\n- Address of ARP packet data region (after the header)\n- outdev_name\n- Name of network device packet will be routed to (if known)\n- length\n- The length of the packet buffer contents, in bytes\n- pf\n- Protocol family -- always \u201carp\u201d\n- nf_stop\n- Constant used to signify a 'stop' verdict\n- ar_pro\n- Format of protocol address\n- data_str\n- A string representing the packet buffer contents\n+ ar_tha\n+ Ethernet+IP only (ar_pro==0x800): target hardware (MAC) address\n+ indev_name\n+ Name of network device packet was received on (if known)\n+ indev\n+ Address of net_device representing input device, 0 if unknown\n nf_stolen\n Constant used to signify a 'stolen' verdict\n- ar_hrd\n- Format of hardware address\n+ nf_drop\n+ Constant used to signify a 'drop' verdict\n nf_queue\n Constant used to signify a 'queue' verdict\n data_hex\n A hexadecimal string representing the packet buffer contents\n- ar_tha\n- Ethernet+IP only (ar_pro==0x800): target hardware (MAC) address\n- nf_drop\n- Constant used to signify a 'drop' verdict\n- ar_op\n- ARP opcode (command)\n- indev_name\n- Name of network device packet was received on (if known)\n+ nf_accept\n+ Constant used to signify an 'accept' verdict\n+ ar_tip\n+ Ethernet+IP only (ar_pro==0x800): target IP address\n arphdr\n Address of ARP header\n+ ar_op\n+ ARP opcode (command)\n+ ar_pln\n+ Length of protocol address\n+ pf\n+ Protocol family -- always \u201carp\u201d\n ar_sip\n Ethernet+IP only (ar_pro==0x800): source IP address\n- nf_accept\n- Constant used to signify an 'accept' verdict\n- indev\n- Address of net_device representing input device, 0 if unknown\n- ar_hln\n- Length of hardware address\n+ length\n+ The length of the packet buffer contents, in bytes\n+ ar_hrd\n+ Format of hardware address\n+ ar_pro\n+ Format of protocol address\n+ outdev_name\n+ Name of network device packet will be routed to (if known)\n+ data_str\n+ A string representing the packet buffer contents\n+ ar_data\n+ Address of ARP packet data region (after the header)\n ar_sha\n Ethernet+IP only (ar_pro==0x800): source hardware (MAC) address\n+ ar_hln\n+ Length of hardware address\n+ nf_repeat\n+ Constant used to signify a 'repeat' verdict\n+ nf_stop\n+ Constant used to signify a 'stop' verdict\n+ outdev\n+ Address of net_device representing output device, 0 if unknown\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netfilter.arp.in\u00a0Home \u00a0probe::netfilter.bridge.forward\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-bridge-forward.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-bridge-forward.html", "unified_diff": "@@ -1,67 +1,67 @@\n probe::netfilter.bridge.forward
probe::netfilter.bridge.forward — \n Called on an incoming bridging packet destined for some other computer\n-
Synopsis
netfilter.bridge.forward
Values
br_cost
\n- Total cost from transmitting bridge to root\n+
Synopsis
netfilter.bridge.forward
Values
length
\n+ The length of the packet buffer contents, in bytes\n+
br_bid
\n+ Identity of bridge\n
br_vid
\n Protocol version identifier\n-
indev
\n- Address of net_device representing input device, 0 if unknown\n-
br_max
\n- Max age in 1/256 secs\n-
br_fd
\n- Forward delay in 1/256 secs\n-
br_msg
\n- Message age in 1/256 secs\n+
pf
\n+ Protocol family -- always “bridge”\n
br_flags
\n BPDU flags\n-
llcproto_stp
\n- Constant used to signify Bridge Spanning Tree Protocol packet\n-
nf_accept
\n- Constant used to signify an 'accept' verdict\n-
brhdr
\n- Address of bridge header\n-
br_poid
\n- Port identifier\n-
br_mac
\n- Bridge MAC address\n-
br_prid
\n- Protocol identifier\n-
br_type
\n- BPDU type\n-
indev_name
\n- Name of network device packet was received on (if known)\n-
nf_drop
\n- Constant used to signify a 'drop' verdict\n-
data_hex
\n- A hexadecimal string representing the packet buffer contents\n-
nf_queue
\n- Constant used to signify a 'queue' verdict\n-
nf_stolen
\n- Constant used to signify a 'stolen' verdict\n-
data_str
\n- A string representing the packet buffer contents\n+
br_msg
\n+ Message age in 1/256 secs\n
br_rmac
\n Root bridge MAC address\n-
pf
\n- Protocol family -- always “bridge”\n-
llcpdu
\n- Address of LLC Protocol Data Unit\n+
protocol
\n+ Packet protocol\n+
outdev_name
\n+ Name of network device packet will be routed to (if known)\n+
br_cost
\n+ Total cost from transmitting bridge to root\n+
data_str
\n+ A string representing the packet buffer contents\n
br_htime
\n Hello time in 1/256 secs\n
nf_stop
\n Constant used to signify a 'stop' verdict\n-
br_bid
\n- Identity of bridge\n+
llcproto_stp
\n+ Constant used to signify Bridge Spanning Tree Protocol packet\n
outdev
\n Address of net_device representing output device, 0 if unknown\n-
outdev_name
\n- Name of network device packet will be routed to (if known)\n-
length
\n- The length of the packet buffer contents, in bytes\n+
br_prid
\n+ Protocol identifier\n
nf_repeat
\n Constant used to signify a 'repeat' verdict\n-
protocol
\n- Packet protocol\n
br_rid
\n Identity of root bridge\n+
br_max
\n+ Max age in 1/256 secs\n+
indev_name
\n+ Name of network device packet was received on (if known)\n+
nf_stolen
\n+ Constant used to signify a 'stolen' verdict\n+
llcpdu
\n+ Address of LLC Protocol Data Unit\n+
indev
\n+ Address of net_device representing input device, 0 if unknown\n+
br_fd
\n+ Forward delay in 1/256 secs\n+
br_mac
\n+ Bridge MAC address\n+
nf_drop
\n+ Constant used to signify a 'drop' verdict\n+
br_type
\n+ BPDU type\n+
br_poid
\n+ Port identifier\n+
nf_queue
\n+ Constant used to signify a 'queue' verdict\n+
data_hex
\n+ A hexadecimal string representing the packet buffer contents\n+
nf_accept
\n+ Constant used to signify an 'accept' verdict\n+
brhdr
\n+ Address of bridge header\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,74 +3,74 @@\n ===============================================================================\n ***** Name *****\n probe::netfilter.bridge.forward \u2014 Called on an incoming bridging packet\n destined for some other computer\n ***** Synopsis *****\n netfilter.bridge.forward\n ***** Values *****\n- br_cost\n- Total cost from transmitting bridge to root\n+ length\n+ The length of the packet buffer contents, in bytes\n+ br_bid\n+ Identity of bridge\n br_vid\n Protocol version identifier\n- indev\n- Address of net_device representing input device, 0 if unknown\n- br_max\n- Max age in 1/256 secs\n- br_fd\n- Forward delay in 1/256 secs\n- br_msg\n- Message age in 1/256 secs\n+ pf\n+ Protocol family -- always \u201cbridge\u201d\n br_flags\n BPDU flags\n- llcproto_stp\n- Constant used to signify Bridge Spanning Tree Protocol packet\n- nf_accept\n- Constant used to signify an 'accept' verdict\n- brhdr\n- Address of bridge header\n- br_poid\n- Port identifier\n- br_mac\n- Bridge MAC address\n- br_prid\n- Protocol identifier\n- br_type\n- BPDU type\n- indev_name\n- Name of network device packet was received on (if known)\n- nf_drop\n- Constant used to signify a 'drop' verdict\n- data_hex\n- A hexadecimal string representing the packet buffer contents\n- nf_queue\n- Constant used to signify a 'queue' verdict\n- nf_stolen\n- Constant used to signify a 'stolen' verdict\n- data_str\n- A string representing the packet buffer contents\n+ br_msg\n+ Message age in 1/256 secs\n br_rmac\n Root bridge MAC address\n- pf\n- Protocol family -- always \u201cbridge\u201d\n- llcpdu\n- Address of LLC Protocol Data Unit\n+ protocol\n+ Packet protocol\n+ outdev_name\n+ Name of network device packet will be routed to (if known)\n+ br_cost\n+ Total cost from transmitting bridge to root\n+ data_str\n+ A string representing the packet buffer contents\n br_htime\n Hello time in 1/256 secs\n nf_stop\n Constant used to signify a 'stop' verdict\n- br_bid\n- Identity of bridge\n+ llcproto_stp\n+ Constant used to signify Bridge Spanning Tree Protocol packet\n outdev\n Address of net_device representing output device, 0 if unknown\n- outdev_name\n- Name of network device packet will be routed to (if known)\n- length\n- The length of the packet buffer contents, in bytes\n+ br_prid\n+ Protocol identifier\n nf_repeat\n Constant used to signify a 'repeat' verdict\n- protocol\n- Packet protocol\n br_rid\n Identity of root bridge\n+ br_max\n+ Max age in 1/256 secs\n+ indev_name\n+ Name of network device packet was received on (if known)\n+ nf_stolen\n+ Constant used to signify a 'stolen' verdict\n+ llcpdu\n+ Address of LLC Protocol Data Unit\n+ indev\n+ Address of net_device representing input device, 0 if unknown\n+ br_fd\n+ Forward delay in 1/256 secs\n+ br_mac\n+ Bridge MAC address\n+ nf_drop\n+ Constant used to signify a 'drop' verdict\n+ br_type\n+ BPDU type\n+ br_poid\n+ Port identifier\n+ nf_queue\n+ Constant used to signify a 'queue' verdict\n+ data_hex\n+ A hexadecimal string representing the packet buffer contents\n+ nf_accept\n+ Constant used to signify an 'accept' verdict\n+ brhdr\n+ Address of bridge header\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netfilter.arp.out\u00a0Home \u00a0probe::netfilter.bridge.local_in\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-bridge-local-in.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-bridge-local-in.html", "unified_diff": "@@ -1,67 +1,67 @@\n probe::netfilter.bridge.local_in
probe::netfilter.bridge.local_in — \n Called on a bridging packet destined for the local computer\n-
Synopsis
netfilter.bridge.local_in
Values
nf_drop
\n- Constant used to signify a 'drop' verdict\n-
data_hex
\n- A hexadecimal string representing the packet buffer contents\n-
nf_queue
\n- Constant used to signify a 'queue' verdict\n-
nf_stolen
\n- Constant used to signify a 'stolen' verdict\n-
pf
\n- Protocol family -- always “bridge”\n-
llcpdu
\n- Address of LLC Protocol Data Unit\n-
nf_stop
\n- Constant used to signify a 'stop' verdict\n-
br_htime
\n- Hello time in 1/256 secs\n-
data_str
\n- A string representing the packet buffer contents\n-
br_rmac
\n- Root bridge MAC address\n-
outdev
\n- Address of net_device representing output device, 0 if unknown\n+
Synopsis
netfilter.bridge.local_in
Values
br_cost
\n+ Total cost from transmitting bridge to root\n
outdev_name
\n Name of network device packet will be routed to (if known)\n-
length
\n- The length of the packet buffer contents, in bytes\n-
br_bid
\n- Identity of bridge\n
protocol
\n Packet protocol\n+
br_rmac
\n+ Root bridge MAC address\n+
data_str
\n+ A string representing the packet buffer contents\n+
br_htime
\n+ Hello time in 1/256 secs\n
nf_repeat
\n Constant used to signify a 'repeat' verdict\n-
br_rid
\n- Identity of root bridge\n-
indev
\n- Address of net_device representing input device, 0 if unknown\n-
br_max
\n- Max age in 1/256 secs\n-
br_cost
\n- Total cost from transmitting bridge to root\n+
br_prid
\n+ Protocol identifier\n+
outdev
\n+ Address of net_device representing output device, 0 if unknown\n+
llcproto_stp
\n+ Constant used to signify Bridge Spanning Tree Protocol packet\n+
nf_stop
\n+ Constant used to signify a 'stop' verdict\n+
br_flags
\n+ BPDU flags\n+
pf
\n+ Protocol family -- always “bridge”\n
br_vid
\n Protocol version identifier\n+
br_bid
\n+ Identity of bridge\n+
length
\n+ The length of the packet buffer contents, in bytes\n
br_msg
\n Message age in 1/256 secs\n+
nf_drop
\n+ Constant used to signify a 'drop' verdict\n+
br_mac
\n+ Bridge MAC address\n
br_fd
\n Forward delay in 1/256 secs\n-
br_flags
\n- BPDU flags\n-
llcproto_stp
\n- Constant used to signify Bridge Spanning Tree Protocol packet\n-
nf_accept
\n- Constant used to signify an 'accept' verdict\n-
brhdr
\n- Address of bridge header\n+
nf_queue
\n+ Constant used to signify a 'queue' verdict\n
br_poid
\n Port identifier\n-
br_mac
\n- Bridge MAC address\n
br_type
\n BPDU type\n+
nf_accept
\n+ Constant used to signify an 'accept' verdict\n+
data_hex
\n+ A hexadecimal string representing the packet buffer contents\n+
brhdr
\n+ Address of bridge header\n+
br_rid
\n+ Identity of root bridge\n+
br_max
\n+ Max age in 1/256 secs\n
indev_name
\n Name of network device packet was received on (if known)\n-
br_prid
\n- Protocol identifier\n+
indev
\n+ Address of net_device representing input device, 0 if unknown\n+
llcpdu
\n+ Address of LLC Protocol Data Unit\n+
nf_stolen
\n+ Constant used to signify a 'stolen' verdict\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,74 +3,74 @@\n ===============================================================================\n ***** Name *****\n probe::netfilter.bridge.local_in \u2014 Called on a bridging packet destined for the\n local computer\n ***** Synopsis *****\n netfilter.bridge.local_in\n ***** Values *****\n- nf_drop\n- Constant used to signify a 'drop' verdict\n- data_hex\n- A hexadecimal string representing the packet buffer contents\n- nf_queue\n- Constant used to signify a 'queue' verdict\n- nf_stolen\n- Constant used to signify a 'stolen' verdict\n- pf\n- Protocol family -- always \u201cbridge\u201d\n- llcpdu\n- Address of LLC Protocol Data Unit\n- nf_stop\n- Constant used to signify a 'stop' verdict\n- br_htime\n- Hello time in 1/256 secs\n- data_str\n- A string representing the packet buffer contents\n- br_rmac\n- Root bridge MAC address\n- outdev\n- Address of net_device representing output device, 0 if unknown\n+ br_cost\n+ Total cost from transmitting bridge to root\n outdev_name\n Name of network device packet will be routed to (if known)\n- length\n- The length of the packet buffer contents, in bytes\n- br_bid\n- Identity of bridge\n protocol\n Packet protocol\n+ br_rmac\n+ Root bridge MAC address\n+ data_str\n+ A string representing the packet buffer contents\n+ br_htime\n+ Hello time in 1/256 secs\n nf_repeat\n Constant used to signify a 'repeat' verdict\n- br_rid\n- Identity of root bridge\n- indev\n- Address of net_device representing input device, 0 if unknown\n- br_max\n- Max age in 1/256 secs\n- br_cost\n- Total cost from transmitting bridge to root\n+ br_prid\n+ Protocol identifier\n+ outdev\n+ Address of net_device representing output device, 0 if unknown\n+ llcproto_stp\n+ Constant used to signify Bridge Spanning Tree Protocol packet\n+ nf_stop\n+ Constant used to signify a 'stop' verdict\n+ br_flags\n+ BPDU flags\n+ pf\n+ Protocol family -- always \u201cbridge\u201d\n br_vid\n Protocol version identifier\n+ br_bid\n+ Identity of bridge\n+ length\n+ The length of the packet buffer contents, in bytes\n br_msg\n Message age in 1/256 secs\n+ nf_drop\n+ Constant used to signify a 'drop' verdict\n+ br_mac\n+ Bridge MAC address\n br_fd\n Forward delay in 1/256 secs\n- br_flags\n- BPDU flags\n- llcproto_stp\n- Constant used to signify Bridge Spanning Tree Protocol packet\n- nf_accept\n- Constant used to signify an 'accept' verdict\n- brhdr\n- Address of bridge header\n+ nf_queue\n+ Constant used to signify a 'queue' verdict\n br_poid\n Port identifier\n- br_mac\n- Bridge MAC address\n br_type\n BPDU type\n+ nf_accept\n+ Constant used to signify an 'accept' verdict\n+ data_hex\n+ A hexadecimal string representing the packet buffer contents\n+ brhdr\n+ Address of bridge header\n+ br_rid\n+ Identity of root bridge\n+ br_max\n+ Max age in 1/256 secs\n indev_name\n Name of network device packet was received on (if known)\n- br_prid\n- Protocol identifier\n+ indev\n+ Address of net_device representing input device, 0 if unknown\n+ llcpdu\n+ Address of LLC Protocol Data Unit\n+ nf_stolen\n+ Constant used to signify a 'stolen' verdict\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netfilter.bridge.forward\u00a0Home \u00a0probe::netfilter.bridge.local_out\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-bridge-local-out.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-bridge-local-out.html", "unified_diff": "@@ -1,67 +1,67 @@\n probe::netfilter.bridge.local_out
probe::netfilter.bridge.local_out — \n Called on a bridging packet coming from a local process\n-
Synopsis
netfilter.bridge.local_out
Values
outdev
\n+
Synopsis
netfilter.bridge.local_out
Values
nf_stop
\n+ Constant used to signify a 'stop' verdict\n+
llcproto_stp
\n+ Constant used to signify Bridge Spanning Tree Protocol packet\n+
outdev
\n Address of net_device representing output device, 0 if unknown\n-
outdev_name
\n- Name of network device packet will be routed to (if known)\n-
length
\n- The length of the packet buffer contents, in bytes\n-
br_bid
\n- Identity of bridge\n-
br_rid
\n- Identity of root bridge\n+
br_prid
\n+ Protocol identifier\n
nf_repeat
\n Constant used to signify a 'repeat' verdict\n
protocol
\n Packet protocol\n-
pf
\n- Protocol family -- always “bridge”\n-
llcpdu
\n- Address of LLC Protocol Data Unit\n-
nf_stop
\n- Constant used to signify a 'stop' verdict\n+
br_rmac
\n+ Root bridge MAC address\n+
outdev_name
\n+ Name of network device packet will be routed to (if known)\n+
br_cost
\n+ Total cost from transmitting bridge to root\n
br_htime
\n Hello time in 1/256 secs\n
data_str
\n A string representing the packet buffer contents\n-
br_rmac
\n- Root bridge MAC address\n-
nf_queue
\n- Constant used to signify a 'queue' verdict\n-
nf_stolen
\n- Constant used to signify a 'stolen' verdict\n-
nf_drop
\n- Constant used to signify a 'drop' verdict\n+
br_msg
\n+ Message age in 1/256 secs\n+
length
\n+ The length of the packet buffer contents, in bytes\n+
br_bid
\n+ Identity of bridge\n+
br_vid
\n+ Protocol version identifier\n+
pf
\n+ Protocol family -- always “bridge”\n+
br_flags
\n+ BPDU flags\n
data_hex
\n A hexadecimal string representing the packet buffer contents\n+
nf_accept
\n+ Constant used to signify an 'accept' verdict\n+
brhdr
\n+ Address of bridge header\n+
br_fd
\n+ Forward delay in 1/256 secs\n
br_mac
\n Bridge MAC address\n+
nf_drop
\n+ Constant used to signify a 'drop' verdict\n
br_type
\n BPDU type\n-
indev_name
\n- Name of network device packet was received on (if known)\n-
br_prid
\n- Protocol identifier\n-
brhdr
\n- Address of bridge header\n
br_poid
\n Port identifier\n-
br_flags
\n- BPDU flags\n-
llcproto_stp
\n- Constant used to signify Bridge Spanning Tree Protocol packet\n-
nf_accept
\n- Constant used to signify an 'accept' verdict\n-
br_max
\n- Max age in 1/256 secs\n+
nf_queue
\n+ Constant used to signify a 'queue' verdict\n+
nf_stolen
\n+ Constant used to signify a 'stolen' verdict\n+
llcpdu
\n+ Address of LLC Protocol Data Unit\n
indev
\n Address of net_device representing input device, 0 if unknown\n-
br_cost
\n- Total cost from transmitting bridge to root\n-
br_vid
\n- Protocol version identifier\n-
br_msg
\n- Message age in 1/256 secs\n-
br_fd
\n- Forward delay in 1/256 secs\n+
br_rid
\n+ Identity of root bridge\n+
indev_name
\n+ Name of network device packet was received on (if known)\n+
br_max
\n+ Max age in 1/256 secs\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,74 +3,74 @@\n ===============================================================================\n ***** Name *****\n probe::netfilter.bridge.local_out \u2014 Called on a bridging packet coming from a\n local process\n ***** Synopsis *****\n netfilter.bridge.local_out\n ***** Values *****\n+ nf_stop\n+ Constant used to signify a 'stop' verdict\n+ llcproto_stp\n+ Constant used to signify Bridge Spanning Tree Protocol packet\n outdev\n Address of net_device representing output device, 0 if unknown\n- outdev_name\n- Name of network device packet will be routed to (if known)\n- length\n- The length of the packet buffer contents, in bytes\n- br_bid\n- Identity of bridge\n- br_rid\n- Identity of root bridge\n+ br_prid\n+ Protocol identifier\n nf_repeat\n Constant used to signify a 'repeat' verdict\n protocol\n Packet protocol\n- pf\n- Protocol family -- always \u201cbridge\u201d\n- llcpdu\n- Address of LLC Protocol Data Unit\n- nf_stop\n- Constant used to signify a 'stop' verdict\n+ br_rmac\n+ Root bridge MAC address\n+ outdev_name\n+ Name of network device packet will be routed to (if known)\n+ br_cost\n+ Total cost from transmitting bridge to root\n br_htime\n Hello time in 1/256 secs\n data_str\n A string representing the packet buffer contents\n- br_rmac\n- Root bridge MAC address\n- nf_queue\n- Constant used to signify a 'queue' verdict\n- nf_stolen\n- Constant used to signify a 'stolen' verdict\n- nf_drop\n- Constant used to signify a 'drop' verdict\n+ br_msg\n+ Message age in 1/256 secs\n+ length\n+ The length of the packet buffer contents, in bytes\n+ br_bid\n+ Identity of bridge\n+ br_vid\n+ Protocol version identifier\n+ pf\n+ Protocol family -- always \u201cbridge\u201d\n+ br_flags\n+ BPDU flags\n data_hex\n A hexadecimal string representing the packet buffer contents\n+ nf_accept\n+ Constant used to signify an 'accept' verdict\n+ brhdr\n+ Address of bridge header\n+ br_fd\n+ Forward delay in 1/256 secs\n br_mac\n Bridge MAC address\n+ nf_drop\n+ Constant used to signify a 'drop' verdict\n br_type\n BPDU type\n- indev_name\n- Name of network device packet was received on (if known)\n- br_prid\n- Protocol identifier\n- brhdr\n- Address of bridge header\n br_poid\n Port identifier\n- br_flags\n- BPDU flags\n- llcproto_stp\n- Constant used to signify Bridge Spanning Tree Protocol packet\n- nf_accept\n- Constant used to signify an 'accept' verdict\n- br_max\n- Max age in 1/256 secs\n+ nf_queue\n+ Constant used to signify a 'queue' verdict\n+ nf_stolen\n+ Constant used to signify a 'stolen' verdict\n+ llcpdu\n+ Address of LLC Protocol Data Unit\n indev\n Address of net_device representing input device, 0 if unknown\n- br_cost\n- Total cost from transmitting bridge to root\n- br_vid\n- Protocol version identifier\n- br_msg\n- Message age in 1/256 secs\n- br_fd\n- Forward delay in 1/256 secs\n+ br_rid\n+ Identity of root bridge\n+ indev_name\n+ Name of network device packet was received on (if known)\n+ br_max\n+ Max age in 1/256 secs\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netfilter.bridge.local_in\u00a0Home \u00a0probe::netfilter.bridge.post_routing\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-bridge-post-routing.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-bridge-post-routing.html", "unified_diff": "@@ -1,67 +1,67 @@\n probe::netfilter.bridge.post_routing
probe::netfilter.bridge.post_routing — \n - Called before a bridging packet hits the wire\n-
Synopsis
netfilter.bridge.post_routing
Values
br_poid
\n- Port identifier\n-
brhdr
\n- Address of bridge header\n-
indev_name
\n- Name of network device packet was received on (if known)\n-
br_type
\n- BPDU type\n-
br_prid
\n- Protocol identifier\n-
br_mac
\n- Bridge MAC address\n-
br_msg
\n+
Synopsis
netfilter.bridge.post_routing
Values
br_msg
\n Message age in 1/256 secs\n-
br_fd
\n- Forward delay in 1/256 secs\n-
br_max
\n- Max age in 1/256 secs\n-
indev
\n- Address of net_device representing input device, 0 if unknown\n+
br_flags
\n+ BPDU flags\n+
pf
\n+ Protocol family -- always “bridge”\n
br_vid
\n Protocol version identifier\n-
br_cost
\n- Total cost from transmitting bridge to root\n-
nf_accept
\n- Constant used to signify an 'accept' verdict\n+
br_bid
\n+ Identity of bridge\n+
length
\n+ The length of the packet buffer contents, in bytes\n+
nf_repeat
\n+ Constant used to signify a 'repeat' verdict\n+
br_prid
\n+ Protocol identifier\n+
outdev
\n+ Address of net_device representing output device, 0 if unknown\n
llcproto_stp
\n Constant used to signify Bridge Spanning Tree Protocol packet\n-
br_flags
\n- BPDU flags\n
nf_stop
\n Constant used to signify a 'stop' verdict\n-
br_htime
\n- Hello time in 1/256 secs\n-
llcpdu
\n- Address of LLC Protocol Data Unit\n-
pf
\n- Protocol family -- always “bridge”\n+
br_cost
\n+ Total cost from transmitting bridge to root\n+
outdev_name
\n+ Name of network device packet will be routed to (if known)\n+
protocol
\n+ Packet protocol\n
br_rmac
\n Root bridge MAC address\n
data_str
\n A string representing the packet buffer contents\n-
nf_repeat
\n- Constant used to signify a 'repeat' verdict\n-
protocol
\n- Packet protocol\n+
br_htime
\n+ Hello time in 1/256 secs\n+
indev
\n+ Address of net_device representing input device, 0 if unknown\n+
llcpdu
\n+ Address of LLC Protocol Data Unit\n+
nf_stolen
\n+ Constant used to signify a 'stolen' verdict\n
br_rid
\n Identity of root bridge\n-
length
\n- The length of the packet buffer contents, in bytes\n-
outdev
\n- Address of net_device representing output device, 0 if unknown\n-
outdev_name
\n- Name of network device packet will be routed to (if known)\n-
br_bid
\n- Identity of bridge\n+
indev_name
\n+ Name of network device packet was received on (if known)\n+
br_max
\n+ Max age in 1/256 secs\n+
nf_accept
\n+ Constant used to signify an 'accept' verdict\n
data_hex
\n A hexadecimal string representing the packet buffer contents\n+
brhdr
\n+ Address of bridge header\n
nf_drop
\n Constant used to signify a 'drop' verdict\n-
nf_stolen
\n- Constant used to signify a 'stolen' verdict\n+
br_mac
\n+ Bridge MAC address\n+
br_fd
\n+ Forward delay in 1/256 secs\n
nf_queue
\n Constant used to signify a 'queue' verdict\n+
br_poid
\n+ Port identifier\n+
br_type
\n+ BPDU type\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,74 +3,74 @@\n ===============================================================================\n ***** Name *****\n probe::netfilter.bridge.post_routing \u2014 - Called before a bridging packet hits\n the wire\n ***** Synopsis *****\n netfilter.bridge.post_routing\n ***** Values *****\n- br_poid\n- Port identifier\n- brhdr\n- Address of bridge header\n- indev_name\n- Name of network device packet was received on (if known)\n- br_type\n- BPDU type\n- br_prid\n- Protocol identifier\n- br_mac\n- Bridge MAC address\n br_msg\n Message age in 1/256 secs\n- br_fd\n- Forward delay in 1/256 secs\n- br_max\n- Max age in 1/256 secs\n- indev\n- Address of net_device representing input device, 0 if unknown\n+ br_flags\n+ BPDU flags\n+ pf\n+ Protocol family -- always \u201cbridge\u201d\n br_vid\n Protocol version identifier\n- br_cost\n- Total cost from transmitting bridge to root\n- nf_accept\n- Constant used to signify an 'accept' verdict\n+ br_bid\n+ Identity of bridge\n+ length\n+ The length of the packet buffer contents, in bytes\n+ nf_repeat\n+ Constant used to signify a 'repeat' verdict\n+ br_prid\n+ Protocol identifier\n+ outdev\n+ Address of net_device representing output device, 0 if unknown\n llcproto_stp\n Constant used to signify Bridge Spanning Tree Protocol packet\n- br_flags\n- BPDU flags\n nf_stop\n Constant used to signify a 'stop' verdict\n- br_htime\n- Hello time in 1/256 secs\n- llcpdu\n- Address of LLC Protocol Data Unit\n- pf\n- Protocol family -- always \u201cbridge\u201d\n+ br_cost\n+ Total cost from transmitting bridge to root\n+ outdev_name\n+ Name of network device packet will be routed to (if known)\n+ protocol\n+ Packet protocol\n br_rmac\n Root bridge MAC address\n data_str\n A string representing the packet buffer contents\n- nf_repeat\n- Constant used to signify a 'repeat' verdict\n- protocol\n- Packet protocol\n+ br_htime\n+ Hello time in 1/256 secs\n+ indev\n+ Address of net_device representing input device, 0 if unknown\n+ llcpdu\n+ Address of LLC Protocol Data Unit\n+ nf_stolen\n+ Constant used to signify a 'stolen' verdict\n br_rid\n Identity of root bridge\n- length\n- The length of the packet buffer contents, in bytes\n- outdev\n- Address of net_device representing output device, 0 if unknown\n- outdev_name\n- Name of network device packet will be routed to (if known)\n- br_bid\n- Identity of bridge\n+ indev_name\n+ Name of network device packet was received on (if known)\n+ br_max\n+ Max age in 1/256 secs\n+ nf_accept\n+ Constant used to signify an 'accept' verdict\n data_hex\n A hexadecimal string representing the packet buffer contents\n+ brhdr\n+ Address of bridge header\n nf_drop\n Constant used to signify a 'drop' verdict\n- nf_stolen\n- Constant used to signify a 'stolen' verdict\n+ br_mac\n+ Bridge MAC address\n+ br_fd\n+ Forward delay in 1/256 secs\n nf_queue\n Constant used to signify a 'queue' verdict\n+ br_poid\n+ Port identifier\n+ br_type\n+ BPDU type\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netfilter.bridge.local_out\u00a0Home \u00a0probe::netfilter.bridge.pre_routing\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-bridge-pre-routing.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-bridge-pre-routing.html", "unified_diff": "@@ -1,67 +1,67 @@\n probe::netfilter.bridge.pre_routing
probe::netfilter.bridge.pre_routing — \n - Called before a bridging packet is routed\n-
Synopsis
netfilter.bridge.pre_routing
Values
nf_repeat
\n- Constant used to signify a 'repeat' verdict\n-
br_rid
\n- Identity of root bridge\n-
protocol
\n- Packet protocol\n-
br_bid
\n- Identity of bridge\n+
Synopsis
netfilter.bridge.pre_routing
Values
pf
\n+ Protocol family -- always “bridge”\n+
br_flags
\n+ BPDU flags\n
length
\n The length of the packet buffer contents, in bytes\n-
outdev
\n- Address of net_device representing output device, 0 if unknown\n-
outdev_name
\n- Name of network device packet will be routed to (if known)\n+
br_bid
\n+ Identity of bridge\n+
br_vid
\n+ Protocol version identifier\n+
br_msg
\n+ Message age in 1/256 secs\n+
br_cost
\n+ Total cost from transmitting bridge to root\n+
protocol
\n+ Packet protocol\n
br_rmac
\n Root bridge MAC address\n-
data_str
\n- A string representing the packet buffer contents\n+
outdev_name
\n+ Name of network device packet will be routed to (if known)\n
br_htime
\n Hello time in 1/256 secs\n+
data_str
\n+ A string representing the packet buffer contents\n+
nf_repeat
\n+ Constant used to signify a 'repeat' verdict\n+
br_prid
\n+ Protocol identifier\n+
llcproto_stp
\n+ Constant used to signify Bridge Spanning Tree Protocol packet\n
nf_stop
\n Constant used to signify a 'stop' verdict\n+
outdev
\n+ Address of net_device representing output device, 0 if unknown\n+
br_rid
\n+ Identity of root bridge\n+
indev_name
\n+ Name of network device packet was received on (if known)\n+
br_max
\n+ Max age in 1/256 secs\n
llcpdu
\n Address of LLC Protocol Data Unit\n-
pf
\n- Protocol family -- always “bridge”\n+
indev
\n+ Address of net_device representing input device, 0 if unknown\n
nf_stolen
\n Constant used to signify a 'stolen' verdict\n-
nf_queue
\n- Constant used to signify a 'queue' verdict\n-
data_hex
\n- A hexadecimal string representing the packet buffer contents\n
nf_drop
\n Constant used to signify a 'drop' verdict\n-
br_prid
\n- Protocol identifier\n-
indev_name
\n- Name of network device packet was received on (if known)\n-
br_type
\n- BPDU type\n+
br_fd
\n+ Forward delay in 1/256 secs\n
br_mac
\n Bridge MAC address\n
br_poid
\n Port identifier\n-
brhdr
\n- Address of bridge header\n+
nf_queue
\n+ Constant used to signify a 'queue' verdict\n+
br_type
\n+ BPDU type\n+
data_hex
\n+ A hexadecimal string representing the packet buffer contents\n
nf_accept
\n Constant used to signify an 'accept' verdict\n-
llcproto_stp
\n- Constant used to signify Bridge Spanning Tree Protocol packet\n-
br_flags
\n- BPDU flags\n-
br_fd
\n- Forward delay in 1/256 secs\n-
br_msg
\n- Message age in 1/256 secs\n-
br_vid
\n- Protocol version identifier\n-
br_cost
\n- Total cost from transmitting bridge to root\n-
br_max
\n- Max age in 1/256 secs\n-
indev
\n- Address of net_device representing input device, 0 if unknown\n+
brhdr
\n+ Address of bridge header\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,74 +3,74 @@\n ===============================================================================\n ***** Name *****\n probe::netfilter.bridge.pre_routing \u2014 - Called before a bridging packet is\n routed\n ***** Synopsis *****\n netfilter.bridge.pre_routing\n ***** Values *****\n- nf_repeat\n- Constant used to signify a 'repeat' verdict\n- br_rid\n- Identity of root bridge\n- protocol\n- Packet protocol\n- br_bid\n- Identity of bridge\n+ pf\n+ Protocol family -- always \u201cbridge\u201d\n+ br_flags\n+ BPDU flags\n length\n The length of the packet buffer contents, in bytes\n- outdev\n- Address of net_device representing output device, 0 if unknown\n- outdev_name\n- Name of network device packet will be routed to (if known)\n+ br_bid\n+ Identity of bridge\n+ br_vid\n+ Protocol version identifier\n+ br_msg\n+ Message age in 1/256 secs\n+ br_cost\n+ Total cost from transmitting bridge to root\n+ protocol\n+ Packet protocol\n br_rmac\n Root bridge MAC address\n- data_str\n- A string representing the packet buffer contents\n+ outdev_name\n+ Name of network device packet will be routed to (if known)\n br_htime\n Hello time in 1/256 secs\n+ data_str\n+ A string representing the packet buffer contents\n+ nf_repeat\n+ Constant used to signify a 'repeat' verdict\n+ br_prid\n+ Protocol identifier\n+ llcproto_stp\n+ Constant used to signify Bridge Spanning Tree Protocol packet\n nf_stop\n Constant used to signify a 'stop' verdict\n+ outdev\n+ Address of net_device representing output device, 0 if unknown\n+ br_rid\n+ Identity of root bridge\n+ indev_name\n+ Name of network device packet was received on (if known)\n+ br_max\n+ Max age in 1/256 secs\n llcpdu\n Address of LLC Protocol Data Unit\n- pf\n- Protocol family -- always \u201cbridge\u201d\n+ indev\n+ Address of net_device representing input device, 0 if unknown\n nf_stolen\n Constant used to signify a 'stolen' verdict\n- nf_queue\n- Constant used to signify a 'queue' verdict\n- data_hex\n- A hexadecimal string representing the packet buffer contents\n nf_drop\n Constant used to signify a 'drop' verdict\n- br_prid\n- Protocol identifier\n- indev_name\n- Name of network device packet was received on (if known)\n- br_type\n- BPDU type\n+ br_fd\n+ Forward delay in 1/256 secs\n br_mac\n Bridge MAC address\n br_poid\n Port identifier\n- brhdr\n- Address of bridge header\n+ nf_queue\n+ Constant used to signify a 'queue' verdict\n+ br_type\n+ BPDU type\n+ data_hex\n+ A hexadecimal string representing the packet buffer contents\n nf_accept\n Constant used to signify an 'accept' verdict\n- llcproto_stp\n- Constant used to signify Bridge Spanning Tree Protocol packet\n- br_flags\n- BPDU flags\n- br_fd\n- Forward delay in 1/256 secs\n- br_msg\n- Message age in 1/256 secs\n- br_vid\n- Protocol version identifier\n- br_cost\n- Total cost from transmitting bridge to root\n- br_max\n- Max age in 1/256 secs\n- indev\n- Address of net_device representing input device, 0 if unknown\n+ brhdr\n+ Address of bridge header\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netfilter.bridge.post_routing\u00a0Home \u00a0probe::netfilter.ip.forward\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-ip-forward.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-ip-forward.html", "unified_diff": "@@ -1,61 +1,61 @@\n probe::netfilter.ip.forward
probe::netfilter.ip.forward — \n Called on an incoming IP packet addressed to some other computer\n-
Synopsis
netfilter.ip.forward
Values
length
\n+
Synopsis
netfilter.ip.forward
Values
indev
\n+ Address of net_device representing input device, 0 if unknown\n+
sport
\n+ TCP or UDP source port (ipv4 only)\n+
nf_stolen
\n+ Constant used to signify a 'stolen' verdict\n+
rst
\n+ TCP RST flag (if protocol is TCP; ipv4 only)\n+
syn
\n+ TCP SYN flag (if protocol is TCP; ipv4 only)\n+
indev_name
\n+ Name of network device packet was received on (if known)\n+
iphdr
\n+ Address of IP header\n+
nf_accept
\n+ Constant used to signify an 'accept' verdict\n+
data_hex
\n+ A hexadecimal string representing the packet buffer contents\n+
family
\n+ IP address family\n+
nf_drop
\n+ Constant used to signify a 'drop' verdict\n+
saddr
\n+ A string representing the source IP address\n+
nf_queue
\n+ Constant used to signify a 'queue' verdict\n+
ack
\n+ TCP ACK flag (if protocol is TCP; ipv4 only)\n+
ipproto_udp
\n+ Constant used to signify that the packet protocol is UDP\n+
daddr
\n+ A string representing the destination IP address\n+
fin
\n+ TCP FIN flag (if protocol is TCP; ipv4 only)\n+
pf
\n+ Protocol family -- either “ipv4” or “ipv6”\n+
ipproto_tcp
\n+ Constant used to signify that the packet protocol is TCP\n+
length
\n The length of the packet buffer contents, in bytes\n-
outdev_name
\n- Name of network device packet will be routed to (if known)\n+
nf_repeat
\n+ Constant used to signify a 'repeat' verdict\n
outdev
\n Address of net_device representing output device, 0 if unknown\n+
nf_stop
\n+ Constant used to signify a 'stop' verdict\n+
outdev_name
\n+ Name of network device packet will be routed to (if known)\n
protocol
\n Packet protocol from driver (ipv4 only)\n-
nf_repeat
\n- Constant used to signify a 'repeat' verdict\n-
ack
\n- TCP ACK flag (if protocol is TCP; ipv4 only)\n
data_str
\n A string representing the packet buffer contents\n-
nf_stop
\n- Constant used to signify a 'stop' verdict\n-
pf
\n- Protocol family -- either “ipv4” or “ipv6”\n-
nf_queue
\n- Constant used to signify a 'queue' verdict\n-
iphdr
\n- Address of IP header\n-
nf_stolen
\n- Constant used to signify a 'stolen' verdict\n
dport
\n TCP or UDP destination port (ipv4 only)\n-
nf_drop
\n- Constant used to signify a 'drop' verdict\n-
data_hex
\n- A hexadecimal string representing the packet buffer contents\n-
daddr
\n- A string representing the destination IP address\n-
psh
\n- TCP PSH flag (if protocol is TCP; ipv4 only)\n-
ipproto_tcp
\n- Constant used to signify that the packet protocol is TCP\n
urg
\n TCP URG flag (if protocol is TCP; ipv4 only)\n-
indev_name
\n- Name of network device packet was received on (if known)\n-
fin
\n- TCP FIN flag (if protocol is TCP; ipv4 only)\n-
sport
\n- TCP or UDP source port (ipv4 only)\n-
rst
\n- TCP RST flag (if protocol is TCP; ipv4 only)\n-
syn
\n- TCP SYN flag (if protocol is TCP; ipv4 only)\n-
saddr
\n- A string representing the source IP address\n-
family
\n- IP address family\n-
nf_accept
\n- Constant used to signify an 'accept' verdict\n-
indev
\n- Address of net_device representing input device, 0 if unknown\n-
ipproto_udp
\n- Constant used to signify that the packet protocol is UDP\n+
psh
\n+ TCP PSH flag (if protocol is TCP; ipv4 only)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,68 +3,68 @@\n ===============================================================================\n ***** Name *****\n probe::netfilter.ip.forward \u2014 Called on an incoming IP packet addressed to some\n other computer\n ***** Synopsis *****\n netfilter.ip.forward\n ***** Values *****\n+ indev\n+ Address of net_device representing input device, 0 if unknown\n+ sport\n+ TCP or UDP source port (ipv4 only)\n+ nf_stolen\n+ Constant used to signify a 'stolen' verdict\n+ rst\n+ TCP RST flag (if protocol is TCP; ipv4 only)\n+ syn\n+ TCP SYN flag (if protocol is TCP; ipv4 only)\n+ indev_name\n+ Name of network device packet was received on (if known)\n+ iphdr\n+ Address of IP header\n+ nf_accept\n+ Constant used to signify an 'accept' verdict\n+ data_hex\n+ A hexadecimal string representing the packet buffer contents\n+ family\n+ IP address family\n+ nf_drop\n+ Constant used to signify a 'drop' verdict\n+ saddr\n+ A string representing the source IP address\n+ nf_queue\n+ Constant used to signify a 'queue' verdict\n+ ack\n+ TCP ACK flag (if protocol is TCP; ipv4 only)\n+ ipproto_udp\n+ Constant used to signify that the packet protocol is UDP\n+ daddr\n+ A string representing the destination IP address\n+ fin\n+ TCP FIN flag (if protocol is TCP; ipv4 only)\n+ pf\n+ Protocol family -- either \u201cipv4\u201d or \u201cipv6\u201d\n+ ipproto_tcp\n+ Constant used to signify that the packet protocol is TCP\n length\n The length of the packet buffer contents, in bytes\n- outdev_name\n- Name of network device packet will be routed to (if known)\n+ nf_repeat\n+ Constant used to signify a 'repeat' verdict\n outdev\n Address of net_device representing output device, 0 if unknown\n+ nf_stop\n+ Constant used to signify a 'stop' verdict\n+ outdev_name\n+ Name of network device packet will be routed to (if known)\n protocol\n Packet protocol from driver (ipv4 only)\n- nf_repeat\n- Constant used to signify a 'repeat' verdict\n- ack\n- TCP ACK flag (if protocol is TCP; ipv4 only)\n data_str\n A string representing the packet buffer contents\n- nf_stop\n- Constant used to signify a 'stop' verdict\n- pf\n- Protocol family -- either \u201cipv4\u201d or \u201cipv6\u201d\n- nf_queue\n- Constant used to signify a 'queue' verdict\n- iphdr\n- Address of IP header\n- nf_stolen\n- Constant used to signify a 'stolen' verdict\n dport\n TCP or UDP destination port (ipv4 only)\n- nf_drop\n- Constant used to signify a 'drop' verdict\n- data_hex\n- A hexadecimal string representing the packet buffer contents\n- daddr\n- A string representing the destination IP address\n- psh\n- TCP PSH flag (if protocol is TCP; ipv4 only)\n- ipproto_tcp\n- Constant used to signify that the packet protocol is TCP\n urg\n TCP URG flag (if protocol is TCP; ipv4 only)\n- indev_name\n- Name of network device packet was received on (if known)\n- fin\n- TCP FIN flag (if protocol is TCP; ipv4 only)\n- sport\n- TCP or UDP source port (ipv4 only)\n- rst\n- TCP RST flag (if protocol is TCP; ipv4 only)\n- syn\n- TCP SYN flag (if protocol is TCP; ipv4 only)\n- saddr\n- A string representing the source IP address\n- family\n- IP address family\n- nf_accept\n- Constant used to signify an 'accept' verdict\n- indev\n- Address of net_device representing input device, 0 if unknown\n- ipproto_udp\n- Constant used to signify that the packet protocol is UDP\n+ psh\n+ TCP PSH flag (if protocol is TCP; ipv4 only)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netfilter.bridge.pre_routing\u00a0Home \u00a0probe::netfilter.ip.local_in\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-ip-local-in.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-ip-local-in.html", "unified_diff": "@@ -1,61 +1,61 @@\n probe::netfilter.ip.local_in
probe::netfilter.ip.local_in — \n Called on an incoming IP packet addressed to the local computer\n-
Synopsis
netfilter.ip.local_in
Values
iphdr
\n+
Synopsis
netfilter.ip.local_in
Values
rst
\n+ TCP RST flag (if protocol is TCP; ipv4 only)\n+
nf_stolen
\n+ Constant used to signify a 'stolen' verdict\n+
indev
\n+ Address of net_device representing input device, 0 if unknown\n+
sport
\n+ TCP or UDP source port (ipv4 only)\n+
iphdr
\n Address of IP header\n+
indev_name
\n+ Name of network device packet was received on (if known)\n+
syn
\n+ TCP SYN flag (if protocol is TCP; ipv4 only)\n+
family
\n+ IP address family\n+
nf_accept
\n+ Constant used to signify an 'accept' verdict\n+
data_hex
\n+ A hexadecimal string representing the packet buffer contents\n
nf_queue
\n Constant used to signify a 'queue' verdict\n-
nf_stolen
\n- Constant used to signify a 'stolen' verdict\n
nf_drop
\n Constant used to signify a 'drop' verdict\n-
dport
\n- TCP or UDP destination port (ipv4 only)\n+
saddr
\n+ A string representing the source IP address\n
daddr
\n A string representing the destination IP address\n-
data_hex
\n- A hexadecimal string representing the packet buffer contents\n-
outdev
\n- Address of net_device representing output device, 0 if unknown\n-
outdev_name
\n- Name of network device packet will be routed to (if known)\n-
length
\n- The length of the packet buffer contents, in bytes\n-
protocol
\n- Packet protocol from driver (ipv4 only)\n-
nf_repeat
\n- Constant used to signify a 'repeat' verdict\n+
ipproto_udp
\n+ Constant used to signify that the packet protocol is UDP\n
ack
\n TCP ACK flag (if protocol is TCP; ipv4 only)\n-
data_str
\n- A string representing the packet buffer contents\n+
length
\n+ The length of the packet buffer contents, in bytes\n+
ipproto_tcp
\n+ Constant used to signify that the packet protocol is TCP\n
pf
\n Protocol family -- either “ipv4” or “ipv6”\n+
fin
\n+ TCP FIN flag (if protocol is TCP; ipv4 only)\n+
outdev
\n+ Address of net_device representing output device, 0 if unknown\n
nf_stop
\n Constant used to signify a 'stop' verdict\n-
family
\n- IP address family\n-
nf_accept
\n- Constant used to signify an 'accept' verdict\n-
indev
\n- Address of net_device representing input device, 0 if unknown\n-
ipproto_udp
\n- Constant used to signify that the packet protocol is UDP\n-
psh
\n- TCP PSH flag (if protocol is TCP; ipv4 only)\n-
ipproto_tcp
\n- Constant used to signify that the packet protocol is TCP\n+
nf_repeat
\n+ Constant used to signify a 'repeat' verdict\n
urg
\n TCP URG flag (if protocol is TCP; ipv4 only)\n-
fin
\n- TCP FIN flag (if protocol is TCP; ipv4 only)\n-
indev_name
\n- Name of network device packet was received on (if known)\n-
sport
\n- TCP or UDP source port (ipv4 only)\n-
rst
\n- TCP RST flag (if protocol is TCP; ipv4 only)\n-
saddr
\n- A string representing the source IP address\n-
syn
\n- TCP SYN flag (if protocol is TCP; ipv4 only)\n+
psh
\n+ TCP PSH flag (if protocol is TCP; ipv4 only)\n+
dport
\n+ TCP or UDP destination port (ipv4 only)\n+
data_str
\n+ A string representing the packet buffer contents\n+
outdev_name
\n+ Name of network device packet will be routed to (if known)\n+
protocol
\n+ Packet protocol from driver (ipv4 only)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,68 +3,68 @@\n ===============================================================================\n ***** Name *****\n probe::netfilter.ip.local_in \u2014 Called on an incoming IP packet addressed to the\n local computer\n ***** Synopsis *****\n netfilter.ip.local_in\n ***** Values *****\n+ rst\n+ TCP RST flag (if protocol is TCP; ipv4 only)\n+ nf_stolen\n+ Constant used to signify a 'stolen' verdict\n+ indev\n+ Address of net_device representing input device, 0 if unknown\n+ sport\n+ TCP or UDP source port (ipv4 only)\n iphdr\n Address of IP header\n+ indev_name\n+ Name of network device packet was received on (if known)\n+ syn\n+ TCP SYN flag (if protocol is TCP; ipv4 only)\n+ family\n+ IP address family\n+ nf_accept\n+ Constant used to signify an 'accept' verdict\n+ data_hex\n+ A hexadecimal string representing the packet buffer contents\n nf_queue\n Constant used to signify a 'queue' verdict\n- nf_stolen\n- Constant used to signify a 'stolen' verdict\n nf_drop\n Constant used to signify a 'drop' verdict\n- dport\n- TCP or UDP destination port (ipv4 only)\n+ saddr\n+ A string representing the source IP address\n daddr\n A string representing the destination IP address\n- data_hex\n- A hexadecimal string representing the packet buffer contents\n- outdev\n- Address of net_device representing output device, 0 if unknown\n- outdev_name\n- Name of network device packet will be routed to (if known)\n- length\n- The length of the packet buffer contents, in bytes\n- protocol\n- Packet protocol from driver (ipv4 only)\n- nf_repeat\n- Constant used to signify a 'repeat' verdict\n+ ipproto_udp\n+ Constant used to signify that the packet protocol is UDP\n ack\n TCP ACK flag (if protocol is TCP; ipv4 only)\n- data_str\n- A string representing the packet buffer contents\n+ length\n+ The length of the packet buffer contents, in bytes\n+ ipproto_tcp\n+ Constant used to signify that the packet protocol is TCP\n pf\n Protocol family -- either \u201cipv4\u201d or \u201cipv6\u201d\n+ fin\n+ TCP FIN flag (if protocol is TCP; ipv4 only)\n+ outdev\n+ Address of net_device representing output device, 0 if unknown\n nf_stop\n Constant used to signify a 'stop' verdict\n- family\n- IP address family\n- nf_accept\n- Constant used to signify an 'accept' verdict\n- indev\n- Address of net_device representing input device, 0 if unknown\n- ipproto_udp\n- Constant used to signify that the packet protocol is UDP\n- psh\n- TCP PSH flag (if protocol is TCP; ipv4 only)\n- ipproto_tcp\n- Constant used to signify that the packet protocol is TCP\n+ nf_repeat\n+ Constant used to signify a 'repeat' verdict\n urg\n TCP URG flag (if protocol is TCP; ipv4 only)\n- fin\n- TCP FIN flag (if protocol is TCP; ipv4 only)\n- indev_name\n- Name of network device packet was received on (if known)\n- sport\n- TCP or UDP source port (ipv4 only)\n- rst\n- TCP RST flag (if protocol is TCP; ipv4 only)\n- saddr\n- A string representing the source IP address\n- syn\n- TCP SYN flag (if protocol is TCP; ipv4 only)\n+ psh\n+ TCP PSH flag (if protocol is TCP; ipv4 only)\n+ dport\n+ TCP or UDP destination port (ipv4 only)\n+ data_str\n+ A string representing the packet buffer contents\n+ outdev_name\n+ Name of network device packet will be routed to (if known)\n+ protocol\n+ Packet protocol from driver (ipv4 only)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netfilter.ip.forward\u00a0Home \u00a0probe::netfilter.ip.local_out\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-ip-local-out.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-ip-local-out.html", "unified_diff": "@@ -1,61 +1,61 @@\n probe::netfilter.ip.local_out
probe::netfilter.ip.local_out — \n Called on an outgoing IP packet\n-
Synopsis
netfilter.ip.local_out
Values
ack
\n- TCP ACK flag (if protocol is TCP; ipv4 only)\n-
data_str
\n- A string representing the packet buffer contents\n-
nf_stop
\n- Constant used to signify a 'stop' verdict\n-
pf
\n- Protocol family -- either “ipv4” or “ipv6”\n-
length
\n- The length of the packet buffer contents, in bytes\n-
outdev
\n- Address of net_device representing output device, 0 if unknown\n-
outdev_name
\n- Name of network device packet will be routed to (if known)\n-
protocol
\n- Packet protocol from driver (ipv4 only)\n-
nf_repeat
\n- Constant used to signify a 'repeat' verdict\n-
nf_drop
\n- Constant used to signify a 'drop' verdict\n-
dport
\n- TCP or UDP destination port (ipv4 only)\n-
data_hex
\n- A hexadecimal string representing the packet buffer contents\n-
daddr
\n- A string representing the destination IP address\n-
nf_queue
\n- Constant used to signify a 'queue' verdict\n-
iphdr
\n- Address of IP header\n+
Synopsis
netfilter.ip.local_out
Values
rst
\n+ TCP RST flag (if protocol is TCP; ipv4 only)\n
nf_stolen
\n Constant used to signify a 'stolen' verdict\n
sport
\n TCP or UDP source port (ipv4 only)\n-
rst
\n- TCP RST flag (if protocol is TCP; ipv4 only)\n+
indev
\n+ Address of net_device representing input device, 0 if unknown\n+
iphdr
\n+ Address of IP header\n+
indev_name
\n+ Name of network device packet was received on (if known)\n
syn
\n TCP SYN flag (if protocol is TCP; ipv4 only)\n+
family
\n+ IP address family\n+
data_hex
\n+ A hexadecimal string representing the packet buffer contents\n+
nf_accept
\n+ Constant used to signify an 'accept' verdict\n+
nf_queue
\n+ Constant used to signify a 'queue' verdict\n+
nf_drop
\n+ Constant used to signify a 'drop' verdict\n
saddr
\n A string representing the source IP address\n+
daddr
\n+ A string representing the destination IP address\n+
ipproto_udp
\n+ Constant used to signify that the packet protocol is UDP\n+
ack
\n+ TCP ACK flag (if protocol is TCP; ipv4 only)\n+
length
\n+ The length of the packet buffer contents, in bytes\n+
pf
\n+ Protocol family -- either “ipv4” or “ipv6”\n
ipproto_tcp
\n Constant used to signify that the packet protocol is TCP\n-
psh
\n- TCP PSH flag (if protocol is TCP; ipv4 only)\n-
urg
\n- TCP URG flag (if protocol is TCP; ipv4 only)\n-
indev_name
\n- Name of network device packet was received on (if known)\n
fin
\n TCP FIN flag (if protocol is TCP; ipv4 only)\n-
indev
\n- Address of net_device representing input device, 0 if unknown\n-
ipproto_udp
\n- Constant used to signify that the packet protocol is UDP\n-
family
\n- IP address family\n-
nf_accept
\n- Constant used to signify an 'accept' verdict\n+
nf_stop
\n+ Constant used to signify a 'stop' verdict\n+
outdev
\n+ Address of net_device representing output device, 0 if unknown\n+
nf_repeat
\n+ Constant used to signify a 'repeat' verdict\n+
urg
\n+ TCP URG flag (if protocol is TCP; ipv4 only)\n+
psh
\n+ TCP PSH flag (if protocol is TCP; ipv4 only)\n+
data_str
\n+ A string representing the packet buffer contents\n+
dport
\n+ TCP or UDP destination port (ipv4 only)\n+
protocol
\n+ Packet protocol from driver (ipv4 only)\n+
outdev_name
\n+ Name of network device packet will be routed to (if known)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,68 +2,68 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::netfilter.ip.local_out \u2014 Called on an outgoing IP packet\n ***** Synopsis *****\n netfilter.ip.local_out\n ***** Values *****\n- ack\n- TCP ACK flag (if protocol is TCP; ipv4 only)\n- data_str\n- A string representing the packet buffer contents\n- nf_stop\n- Constant used to signify a 'stop' verdict\n- pf\n- Protocol family -- either \u201cipv4\u201d or \u201cipv6\u201d\n- length\n- The length of the packet buffer contents, in bytes\n- outdev\n- Address of net_device representing output device, 0 if unknown\n- outdev_name\n- Name of network device packet will be routed to (if known)\n- protocol\n- Packet protocol from driver (ipv4 only)\n- nf_repeat\n- Constant used to signify a 'repeat' verdict\n- nf_drop\n- Constant used to signify a 'drop' verdict\n- dport\n- TCP or UDP destination port (ipv4 only)\n- data_hex\n- A hexadecimal string representing the packet buffer contents\n- daddr\n- A string representing the destination IP address\n- nf_queue\n- Constant used to signify a 'queue' verdict\n- iphdr\n- Address of IP header\n+ rst\n+ TCP RST flag (if protocol is TCP; ipv4 only)\n nf_stolen\n Constant used to signify a 'stolen' verdict\n sport\n TCP or UDP source port (ipv4 only)\n- rst\n- TCP RST flag (if protocol is TCP; ipv4 only)\n+ indev\n+ Address of net_device representing input device, 0 if unknown\n+ iphdr\n+ Address of IP header\n+ indev_name\n+ Name of network device packet was received on (if known)\n syn\n TCP SYN flag (if protocol is TCP; ipv4 only)\n+ family\n+ IP address family\n+ data_hex\n+ A hexadecimal string representing the packet buffer contents\n+ nf_accept\n+ Constant used to signify an 'accept' verdict\n+ nf_queue\n+ Constant used to signify a 'queue' verdict\n+ nf_drop\n+ Constant used to signify a 'drop' verdict\n saddr\n A string representing the source IP address\n+ daddr\n+ A string representing the destination IP address\n+ ipproto_udp\n+ Constant used to signify that the packet protocol is UDP\n+ ack\n+ TCP ACK flag (if protocol is TCP; ipv4 only)\n+ length\n+ The length of the packet buffer contents, in bytes\n+ pf\n+ Protocol family -- either \u201cipv4\u201d or \u201cipv6\u201d\n ipproto_tcp\n Constant used to signify that the packet protocol is TCP\n- psh\n- TCP PSH flag (if protocol is TCP; ipv4 only)\n- urg\n- TCP URG flag (if protocol is TCP; ipv4 only)\n- indev_name\n- Name of network device packet was received on (if known)\n fin\n TCP FIN flag (if protocol is TCP; ipv4 only)\n- indev\n- Address of net_device representing input device, 0 if unknown\n- ipproto_udp\n- Constant used to signify that the packet protocol is UDP\n- family\n- IP address family\n- nf_accept\n- Constant used to signify an 'accept' verdict\n+ nf_stop\n+ Constant used to signify a 'stop' verdict\n+ outdev\n+ Address of net_device representing output device, 0 if unknown\n+ nf_repeat\n+ Constant used to signify a 'repeat' verdict\n+ urg\n+ TCP URG flag (if protocol is TCP; ipv4 only)\n+ psh\n+ TCP PSH flag (if protocol is TCP; ipv4 only)\n+ data_str\n+ A string representing the packet buffer contents\n+ dport\n+ TCP or UDP destination port (ipv4 only)\n+ protocol\n+ Packet protocol from driver (ipv4 only)\n+ outdev_name\n+ Name of network device packet will be routed to (if known)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netfilter.ip.local_in\u00a0Home \u00a0probe::netfilter.ip.post_routing\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-ip-post-routing.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-ip-post-routing.html", "unified_diff": "@@ -1,61 +1,61 @@\n probe::netfilter.ip.post_routing
probe::netfilter.ip.post_routing — \n Called immediately before an outgoing IP packet leaves the computer\n-
Synopsis
netfilter.ip.post_routing
Values
ipproto_udp
\n- Constant used to signify that the packet protocol is UDP\n-
indev
\n- Address of net_device representing input device, 0 if unknown\n-
nf_accept
\n- Constant used to signify an 'accept' verdict\n-
family
\n- IP address family\n-
rst
\n- TCP RST flag (if protocol is TCP; ipv4 only)\n-
syn
\n- TCP SYN flag (if protocol is TCP; ipv4 only)\n-
saddr
\n- A string representing the source IP address\n-
sport
\n- TCP or UDP source port (ipv4 only)\n+
Synopsis
netfilter.ip.post_routing
Values
nf_repeat
\n+ Constant used to signify a 'repeat' verdict\n+
nf_stop
\n+ Constant used to signify a 'stop' verdict\n+
outdev
\n+ Address of net_device representing output device, 0 if unknown\n+
protocol
\n+ Packet protocol from driver (ipv4 only)\n+
outdev_name
\n+ Name of network device packet will be routed to (if known)\n+
data_str
\n+ A string representing the packet buffer contents\n+
dport
\n+ TCP or UDP destination port (ipv4 only)\n+
psh
\n+ TCP PSH flag (if protocol is TCP; ipv4 only)\n
urg
\n TCP URG flag (if protocol is TCP; ipv4 only)\n-
indev_name
\n- Name of network device packet was received on (if known)\n+
ack
\n+ TCP ACK flag (if protocol is TCP; ipv4 only)\n+
ipproto_udp
\n+ Constant used to signify that the packet protocol is UDP\n+
daddr
\n+ A string representing the destination IP address\n
fin
\n TCP FIN flag (if protocol is TCP; ipv4 only)\n+
pf
\n+ Protocol family -- either “ipv4” or “ipv6”\n
ipproto_tcp
\n Constant used to signify that the packet protocol is TCP\n-
psh
\n- TCP PSH flag (if protocol is TCP; ipv4 only)\n+
length
\n+ The length of the packet buffer contents, in bytes\n
data_hex
\n A hexadecimal string representing the packet buffer contents\n-
daddr
\n- A string representing the destination IP address\n-
dport
\n- TCP or UDP destination port (ipv4 only)\n+
nf_accept
\n+ Constant used to signify an 'accept' verdict\n+
family
\n+ IP address family\n
nf_drop
\n Constant used to signify a 'drop' verdict\n-
nf_stolen
\n- Constant used to signify a 'stolen' verdict\n+
saddr
\n+ A string representing the source IP address\n
nf_queue
\n Constant used to signify a 'queue' verdict\n+
sport
\n+ TCP or UDP source port (ipv4 only)\n+
indev
\n+ Address of net_device representing input device, 0 if unknown\n+
nf_stolen
\n+ Constant used to signify a 'stolen' verdict\n+
rst
\n+ TCP RST flag (if protocol is TCP; ipv4 only)\n+
syn
\n+ TCP SYN flag (if protocol is TCP; ipv4 only)\n+
indev_name
\n+ Name of network device packet was received on (if known)\n
iphdr
\n Address of IP header\n-
data_str
\n- A string representing the packet buffer contents\n-
nf_stop
\n- Constant used to signify a 'stop' verdict\n-
pf
\n- Protocol family -- either “ipv4” or “ipv6”\n-
ack
\n- TCP ACK flag (if protocol is TCP; ipv4 only)\n-
nf_repeat
\n- Constant used to signify a 'repeat' verdict\n-
protocol
\n- Packet protocol from driver (ipv4 only)\n-
length
\n- The length of the packet buffer contents, in bytes\n-
outdev
\n- Address of net_device representing output device, 0 if unknown\n-
outdev_name
\n- Name of network device packet will be routed to (if known)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,68 +3,68 @@\n ===============================================================================\n ***** Name *****\n probe::netfilter.ip.post_routing \u2014 Called immediately before an outgoing IP\n packet leaves the computer\n ***** Synopsis *****\n netfilter.ip.post_routing\n ***** Values *****\n- ipproto_udp\n- Constant used to signify that the packet protocol is UDP\n- indev\n- Address of net_device representing input device, 0 if unknown\n- nf_accept\n- Constant used to signify an 'accept' verdict\n- family\n- IP address family\n- rst\n- TCP RST flag (if protocol is TCP; ipv4 only)\n- syn\n- TCP SYN flag (if protocol is TCP; ipv4 only)\n- saddr\n- A string representing the source IP address\n- sport\n- TCP or UDP source port (ipv4 only)\n+ nf_repeat\n+ Constant used to signify a 'repeat' verdict\n+ nf_stop\n+ Constant used to signify a 'stop' verdict\n+ outdev\n+ Address of net_device representing output device, 0 if unknown\n+ protocol\n+ Packet protocol from driver (ipv4 only)\n+ outdev_name\n+ Name of network device packet will be routed to (if known)\n+ data_str\n+ A string representing the packet buffer contents\n+ dport\n+ TCP or UDP destination port (ipv4 only)\n+ psh\n+ TCP PSH flag (if protocol is TCP; ipv4 only)\n urg\n TCP URG flag (if protocol is TCP; ipv4 only)\n- indev_name\n- Name of network device packet was received on (if known)\n+ ack\n+ TCP ACK flag (if protocol is TCP; ipv4 only)\n+ ipproto_udp\n+ Constant used to signify that the packet protocol is UDP\n+ daddr\n+ A string representing the destination IP address\n fin\n TCP FIN flag (if protocol is TCP; ipv4 only)\n+ pf\n+ Protocol family -- either \u201cipv4\u201d or \u201cipv6\u201d\n ipproto_tcp\n Constant used to signify that the packet protocol is TCP\n- psh\n- TCP PSH flag (if protocol is TCP; ipv4 only)\n+ length\n+ The length of the packet buffer contents, in bytes\n data_hex\n A hexadecimal string representing the packet buffer contents\n- daddr\n- A string representing the destination IP address\n- dport\n- TCP or UDP destination port (ipv4 only)\n+ nf_accept\n+ Constant used to signify an 'accept' verdict\n+ family\n+ IP address family\n nf_drop\n Constant used to signify a 'drop' verdict\n- nf_stolen\n- Constant used to signify a 'stolen' verdict\n+ saddr\n+ A string representing the source IP address\n nf_queue\n Constant used to signify a 'queue' verdict\n+ sport\n+ TCP or UDP source port (ipv4 only)\n+ indev\n+ Address of net_device representing input device, 0 if unknown\n+ nf_stolen\n+ Constant used to signify a 'stolen' verdict\n+ rst\n+ TCP RST flag (if protocol is TCP; ipv4 only)\n+ syn\n+ TCP SYN flag (if protocol is TCP; ipv4 only)\n+ indev_name\n+ Name of network device packet was received on (if known)\n iphdr\n Address of IP header\n- data_str\n- A string representing the packet buffer contents\n- nf_stop\n- Constant used to signify a 'stop' verdict\n- pf\n- Protocol family -- either \u201cipv4\u201d or \u201cipv6\u201d\n- ack\n- TCP ACK flag (if protocol is TCP; ipv4 only)\n- nf_repeat\n- Constant used to signify a 'repeat' verdict\n- protocol\n- Packet protocol from driver (ipv4 only)\n- length\n- The length of the packet buffer contents, in bytes\n- outdev\n- Address of net_device representing output device, 0 if unknown\n- outdev_name\n- Name of network device packet will be routed to (if known)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netfilter.ip.local_out\u00a0Home \u00a0probe::netfilter.ip.pre_routing\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-ip-pre-routing.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-netfilter-ip-pre-routing.html", "unified_diff": "@@ -1,61 +1,61 @@\n probe::netfilter.ip.pre_routing
probe::netfilter.ip.pre_routing — \n Called before an IP packet is routed\n-
Synopsis
netfilter.ip.pre_routing
Values
daddr
\n- A string representing the destination IP address\n-
data_hex
\n- A hexadecimal string representing the packet buffer contents\n-
dport
\n- TCP or UDP destination port (ipv4 only)\n+
Synopsis
netfilter.ip.pre_routing
Values
nf_queue
\n+ Constant used to signify a 'queue' verdict\n
nf_drop
\n Constant used to signify a 'drop' verdict\n-
nf_stolen
\n- Constant used to signify a 'stolen' verdict\n+
saddr
\n+ A string representing the source IP address\n+
family
\n+ IP address family\n+
data_hex
\n+ A hexadecimal string representing the packet buffer contents\n+
nf_accept
\n+ Constant used to signify an 'accept' verdict\n
iphdr
\n Address of IP header\n-
nf_queue
\n- Constant used to signify a 'queue' verdict\n+
indev_name
\n+ Name of network device packet was received on (if known)\n+
syn
\n+ TCP SYN flag (if protocol is TCP; ipv4 only)\n+
rst
\n+ TCP RST flag (if protocol is TCP; ipv4 only)\n+
nf_stolen
\n+ Constant used to signify a 'stolen' verdict\n+
sport
\n+ TCP or UDP source port (ipv4 only)\n+
indev
\n+ Address of net_device representing input device, 0 if unknown\n+
urg
\n+ TCP URG flag (if protocol is TCP; ipv4 only)\n+
psh
\n+ TCP PSH flag (if protocol is TCP; ipv4 only)\n
data_str
\n A string representing the packet buffer contents\n-
pf
\n- Protocol family - either 'ipv4' or 'ipv6'\n-
nf_stop
\n- Constant used to signify a 'stop' verdict\n-
ack
\n- TCP ACK flag (if protocol is TCP; ipv4 only)\n+
dport
\n+ TCP or UDP destination port (ipv4 only)\n
protocol
\n Packet protocol from driver (ipv4 only)\n-
nf_repeat
\n- Constant used to signify a 'repeat' verdict\n
outdev_name
\n Name of network device packet will be routed to (if known)\n+
nf_stop
\n+ Constant used to signify a 'stop' verdict\n
outdev
\n Address of net_device representing output device, 0 if unknown\n+
nf_repeat
\n+ Constant used to signify a 'repeat' verdict\n
length
\n The length of the packet buffer contents, in bytes\n-
ipproto_udp
\n- Constant used to signify that the packet protocol is UDP\n-
indev
\n- Address of net_device representing input device, 0 if unknown\n-
nf_accept
\n- Constant used to signify an 'accept' verdict\n-
family
\n- IP address family\n-
rst
\n- TCP RST flag (if protocol is TCP; ipv4 only)\n-
saddr
\n- A string representing the source IP address\n-
syn
\n- TCP SYN flag (if protocol is TCP; ipv4 only)\n-
sport
\n- TCP or UDP source port (ipv4 only)\n-
urg
\n- TCP URG flag (if protocol is TCP; ipv4 only)\n-
fin
\n- TCP FIN flag (if protocol is TCP; ipv4 only)\n-
indev_name
\n- Name of network device packet was received on (if known)\n
ipproto_tcp
\n Constant used to signify that the packet protocol is TCP\n-
psh
\n- TCP PSH flag (if protocol is TCP; ipv4 only)\n+
pf
\n+ Protocol family - either 'ipv4' or 'ipv6'\n+
fin
\n+ TCP FIN flag (if protocol is TCP; ipv4 only)\n+
daddr
\n+ A string representing the destination IP address\n+
ipproto_udp
\n+ Constant used to signify that the packet protocol is UDP\n+
ack
\n+ TCP ACK flag (if protocol is TCP; ipv4 only)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,68 +2,68 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::netfilter.ip.pre_routing \u2014 Called before an IP packet is routed\n ***** Synopsis *****\n netfilter.ip.pre_routing\n ***** Values *****\n- daddr\n- A string representing the destination IP address\n- data_hex\n- A hexadecimal string representing the packet buffer contents\n- dport\n- TCP or UDP destination port (ipv4 only)\n+ nf_queue\n+ Constant used to signify a 'queue' verdict\n nf_drop\n Constant used to signify a 'drop' verdict\n- nf_stolen\n- Constant used to signify a 'stolen' verdict\n+ saddr\n+ A string representing the source IP address\n+ family\n+ IP address family\n+ data_hex\n+ A hexadecimal string representing the packet buffer contents\n+ nf_accept\n+ Constant used to signify an 'accept' verdict\n iphdr\n Address of IP header\n- nf_queue\n- Constant used to signify a 'queue' verdict\n+ indev_name\n+ Name of network device packet was received on (if known)\n+ syn\n+ TCP SYN flag (if protocol is TCP; ipv4 only)\n+ rst\n+ TCP RST flag (if protocol is TCP; ipv4 only)\n+ nf_stolen\n+ Constant used to signify a 'stolen' verdict\n+ sport\n+ TCP or UDP source port (ipv4 only)\n+ indev\n+ Address of net_device representing input device, 0 if unknown\n+ urg\n+ TCP URG flag (if protocol is TCP; ipv4 only)\n+ psh\n+ TCP PSH flag (if protocol is TCP; ipv4 only)\n data_str\n A string representing the packet buffer contents\n- pf\n- Protocol family - either 'ipv4' or 'ipv6'\n- nf_stop\n- Constant used to signify a 'stop' verdict\n- ack\n- TCP ACK flag (if protocol is TCP; ipv4 only)\n+ dport\n+ TCP or UDP destination port (ipv4 only)\n protocol\n Packet protocol from driver (ipv4 only)\n- nf_repeat\n- Constant used to signify a 'repeat' verdict\n outdev_name\n Name of network device packet will be routed to (if known)\n+ nf_stop\n+ Constant used to signify a 'stop' verdict\n outdev\n Address of net_device representing output device, 0 if unknown\n+ nf_repeat\n+ Constant used to signify a 'repeat' verdict\n length\n The length of the packet buffer contents, in bytes\n- ipproto_udp\n- Constant used to signify that the packet protocol is UDP\n- indev\n- Address of net_device representing input device, 0 if unknown\n- nf_accept\n- Constant used to signify an 'accept' verdict\n- family\n- IP address family\n- rst\n- TCP RST flag (if protocol is TCP; ipv4 only)\n- saddr\n- A string representing the source IP address\n- syn\n- TCP SYN flag (if protocol is TCP; ipv4 only)\n- sport\n- TCP or UDP source port (ipv4 only)\n- urg\n- TCP URG flag (if protocol is TCP; ipv4 only)\n- fin\n- TCP FIN flag (if protocol is TCP; ipv4 only)\n- indev_name\n- Name of network device packet was received on (if known)\n ipproto_tcp\n Constant used to signify that the packet protocol is TCP\n- psh\n- TCP PSH flag (if protocol is TCP; ipv4 only)\n+ pf\n+ Protocol family - either 'ipv4' or 'ipv6'\n+ fin\n+ TCP FIN flag (if protocol is TCP; ipv4 only)\n+ daddr\n+ A string representing the destination IP address\n+ ipproto_udp\n+ Constant used to signify that the packet protocol is UDP\n+ ack\n+ TCP ACK flag (if protocol is TCP; ipv4 only)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netfilter.ip.post_routing\u00a0Home \u00a0probe::sunrpc.clnt.bind_new_program\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-aop-readpage.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-aop-readpage.html", "unified_diff": "@@ -1,27 +1,27 @@\n probe::nfs.aop.readpage
probe::nfs.aop.readpage — \n NFS client synchronously reading a page\n-
Synopsis
nfs.aop.readpage
Values
file
\n+
Synopsis
nfs.aop.readpage
Values
rsize
\n+ read size (in bytes)\n+
size
\n+ number of pages to be read in this execution \n+
dev
\n+ device identifier\n+
i_flag
\n+ file flags\n+
file
\n file argument\n+
__page
\n+ the address of page\n
sb_flag
\n super block flags\n+
i_size
\n+ file length in bytes\n
page_index
\n offset within mapping, can used a page identifier\n and position identifier in the page frame\n-
i_size
\n- file length in bytes\n-
__page
\n- the address of page\n-
dev
\n- device identifier\n-
i_flag
\n- file flags\n
ino
\n inode number\n-
rsize
\n- read size (in bytes)\n-
size
\n- number of pages to be read in this execution \n-
Description
\n+
Description
\n Read the page over, only fires when a previous async\n read operation failed\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,33 +2,33 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.aop.readpage \u2014 NFS client synchronously reading a page\n ***** Synopsis *****\n nfs.aop.readpage\n ***** Values *****\n+ rsize\n+ read size (in bytes)\n+ size\n+ number of pages to be read in this execution\n+ dev\n+ device identifier\n+ i_flag\n+ file flags\n file\n file argument\n+ __page\n+ the address of page\n sb_flag\n super block flags\n+ i_size\n+ file length in bytes\n page_index\n offset within mapping, can used a page identifier and position identifier\n in the page frame\n- i_size\n- file length in bytes\n- __page\n- the address of page\n- dev\n- device identifier\n- i_flag\n- file flags\n ino\n inode number\n- rsize\n- read size (in bytes)\n- size\n- number of pages to be read in this execution\n ***** Description *****\n Read the page over, only fires when a previous async read operation failed\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::\u00a0Home \u00a0probe::nfs.aop.readpages\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-aop-readpages.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-aop-readpages.html", "unified_diff": "@@ -1,19 +1,19 @@\n probe::nfs.aop.readpages
\n- number of pages attempted to read in this execution\n-
rsize
\n- read size (in bytes)\n-
dev
\n- device identifier\n+
Synopsis
nfs.aop.readpages
Values
rpages
\n+ read size (in pages)\n
ino
\n inode number \n-
nr_pages
\n- number of pages attempted to read in this execution\n-
rpages
\n- read size (in pages)\n
file
\n filp argument\n-
Description
\n+
dev
\n+ device identifier\n+
size
\n+ number of pages attempted to read in this execution\n+
nr_pages
\n+ number of pages attempted to read in this execution\n+
rsize
\n+ read size (in bytes)\n+
Description
\n Fires when in readahead way, read several pages once\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,26 +2,26 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.aop.readpages \u2014 NFS client reading multiple pages\n ***** Synopsis *****\n nfs.aop.readpages\n ***** Values *****\n- size\n- number of pages attempted to read in this execution\n- rsize\n- read size (in bytes)\n- dev\n- device identifier\n- ino\n- inode number\n- nr_pages\n- number of pages attempted to read in this execution\n rpages\n read size (in pages)\n+ ino\n+ inode number\n file\n filp argument\n+ dev\n+ device identifier\n+ size\n+ number of pages attempted to read in this execution\n+ nr_pages\n+ number of pages attempted to read in this execution\n+ rsize\n+ read size (in bytes)\n ***** Description *****\n Fires when in readahead way, read several pages once\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.aop.readpage\u00a0Home \u00a0probe::nfs.aop.release_page\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-aop-release-page.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-aop-release-page.html", "unified_diff": "@@ -1,16 +1,16 @@\n probe::nfs.aop.release_page
probe::nfs.aop.set_page_dirty — \n NFS client marking page as dirty\n-
Synopsis
nfs.aop.set_page_dirty
Values
page_flag
\n- page flags\n-
__page
\n+
Synopsis
nfs.aop.set_page_dirty
Values
__page
\n the address of page\n-
Description
\n+
page_flag
\n+ page flags\n+
Description
\n This probe attaches to the generic __set_page_dirty_nobuffers function.\n Thus, this probe is going to fire on many other file systems in\n addition to the NFS client.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.aop.set_page_dirty \u2014 NFS client marking page as dirty\n ***** Synopsis *****\n nfs.aop.set_page_dirty\n ***** Values *****\n- page_flag\n- page flags\n __page\n the address of page\n+ page_flag\n+ page flags\n ***** Description *****\n This probe attaches to the generic __set_page_dirty_nobuffers function. Thus,\n this probe is going to fire on many other file systems in addition to the NFS\n client.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.aop.release_page\u00a0Home \u00a0probe::nfs.aop.write_begin\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-aop-write-begin.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-aop-write-begin.html", "unified_diff": "@@ -1,25 +1,25 @@\n probe::nfs.aop.write_begin
probe::nfs.aop.write_begin — \n NFS client begin to write data\n-
Synopsis
nfs.aop.write_begin
Values
dev
\n- device identifier\n+
Synopsis
nfs.aop.write_begin
Values
__page
\n+ the address of page\n
ino
\n inode number \n-
offset
\n- start address of this write operation \n
to
\n end address of this write operation \n
size
\n write bytes\n+
dev
\n+ device identifier\n
page_index
\n offset within mapping, can used a page identifier\n and position identifier in the page frame\n-
__page
\n- the address of page\n-
Description
\n+
offset
\n+ start address of this write operation \n+
Description
\n Occurs when write operation occurs on nfs. It prepare a page for writing,\n look for a request corresponding to the page. If there\n is one, and it belongs to another file, it flush it out\n before it tries to copy anything into the page. \n Also do the same if it finds a request from an existing\n dropped page\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,29 +2,29 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.aop.write_begin \u2014 NFS client begin to write data\n ***** Synopsis *****\n nfs.aop.write_begin\n ***** Values *****\n- dev\n- device identifier\n+ __page\n+ the address of page\n ino\n inode number\n- offset\n- start address of this write operation\n to\n end address of this write operation\n size\n write bytes\n+ dev\n+ device identifier\n page_index\n offset within mapping, can used a page identifier and position identifier\n in the page frame\n- __page\n- the address of page\n+ offset\n+ start address of this write operation\n ***** Description *****\n Occurs when write operation occurs on nfs. It prepare a page for writing, look\n for a request corresponding to the page. If there is one, and it belongs to\n another file, it flush it out before it tries to copy anything into the page.\n Also do the same if it finds a request from an existing dropped page\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-aop-write-end.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-aop-write-end.html", "unified_diff": "@@ -1,29 +1,29 @@\n probe::nfs.aop.write_end
\n offset within mapping, can used a page identifier and position identifier in the page frame\n-
i_size
\n- file length in bytes\n-
Description
\n+
sb_flag
\n+ super block flags\n+
offset
\n+ start address of this write operation\n+
Description
\n Fires when do a write operation on nfs,\n often after prepare_write\n
\n \n Update and possibly write a cached page of an NFS file.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,34 +2,34 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.aop.write_end \u2014 NFS client complete writing data\n ***** Synopsis *****\n nfs.aop.write_end\n ***** Values *****\n- offset\n- start address of this write operation\n+ ino\n+ inode number\n to\n end address of this write operation\n+ i_size\n+ file length in bytes\n+ __page\n+ the address of page\n size\n write bytes\n- i_flag\n- file flags\n dev\n device identifier\n- ino\n- inode number\n- __page\n- the address of page\n- sb_flag\n- super block flags\n+ i_flag\n+ file flags\n page_index\n offset within mapping, can used a page identifier and position identifier\n in the page frame\n- i_size\n- file length in bytes\n+ sb_flag\n+ super block flags\n+ offset\n+ start address of this write operation\n ***** Description *****\n Fires when do a write operation on nfs, often after prepare_write\n Update and possibly write a cached page of an NFS file.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.aop.write_begin\u00a0Home \u00a0probe::nfs.aop.writepage\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-aop-writepage.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-aop-writepage.html", "unified_diff": "@@ -1,33 +1,33 @@\n probe::nfs.aop.writepage
probe::nfs.aop.writepage — \n NFS client writing a mapped page to the NFS server\n-
Synopsis
nfs.aop.writepage
Values
__page
\n- the address of page\n-
sb_flag
\n- super block flags\n-
i_size
\n- file length in bytes\n+
Synopsis
nfs.aop.writepage
Values
dev
\n+ device identifier\n+
size
\n+ number of pages to be written in this execution\n+
i_flag
\n+ file flags\n+
wsize
\n+ write size\n
for_reclaim
\n a flag of writeback_control,\n indicates if it's invoked from the page allocator\n+
i_size
\n+ file length in bytes\n+
ino
\n+ inode number \n+
for_kupdate
\n+ a flag of writeback_control,\n+ indicates if it's a kupdate writeback\n+
__page
\n+ the address of page\n
page_index
\n offset within mapping,\n can used a page identifier and position identifier in the page frame\n-
size
\n- number of pages to be written in this execution\n
i_state
\n inode state flags\n-
for_kupdate
\n- a flag of writeback_control,\n- indicates if it's a kupdate writeback\n-
i_flag
\n- file flags\n-
dev
\n- device identifier\n-
ino
\n- inode number \n-
wsize
\n- write size\n-
Description
\n+
sb_flag
\n+ super block flags\n+
Description
\n The priority of wb is decided by the flags\n for_reclaim and for_kupdate.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,38 +2,38 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.aop.writepage \u2014 NFS client writing a mapped page to the NFS server\n ***** Synopsis *****\n nfs.aop.writepage\n ***** Values *****\n- __page\n- the address of page\n- sb_flag\n- super block flags\n- i_size\n- file length in bytes\n+ dev\n+ device identifier\n+ size\n+ number of pages to be written in this execution\n+ i_flag\n+ file flags\n+ wsize\n+ write size\n for_reclaim\n a flag of writeback_control, indicates if it's invoked from the page\n allocator\n+ i_size\n+ file length in bytes\n+ ino\n+ inode number\n+ for_kupdate\n+ a flag of writeback_control, indicates if it's a kupdate writeback\n+ __page\n+ the address of page\n page_index\n offset within mapping, can used a page identifier and position identifier\n in the page frame\n- size\n- number of pages to be written in this execution\n i_state\n inode state flags\n- for_kupdate\n- a flag of writeback_control, indicates if it's a kupdate writeback\n- i_flag\n- file flags\n- dev\n- device identifier\n- ino\n- inode number\n- wsize\n- write size\n+ sb_flag\n+ super block flags\n ***** Description *****\n The priority of wb is decided by the flags for_reclaim and for_kupdate.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.aop.write_end\u00a0Home \u00a0probe::nfs.aop.writepages\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-aop-writepages.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-aop-writepages.html", "unified_diff": "@@ -1,24 +1,24 @@\n probe::nfs.aop.writepages
probe::nfs.aop.writepages — \n NFS client writing several dirty pages to the NFS server\n-
Synopsis
nfs.aop.writepages
Values
wpages
\n- write size (in pages)\n+
Synopsis
nfs.aop.writepages
Values
wsize
\n+ write size\n
for_reclaim
\n a flag of writeback_control,\n indicates if it's invoked from the page allocator\n-
size
\n- number of pages attempted to be written in this execution\n
nr_to_write
\n number of pages attempted to be written in this execution\n
dev
\n device identifier\n+
size
\n+ number of pages attempted to be written in this execution\n
for_kupdate
\n a flag of writeback_control,\n indicates if it's a kupdate writeback\n
ino
\n inode number\n-
wsize
\n- write size\n-
Description
\n+
wpages
\n+ write size (in pages)\n+
Description
\n The priority of wb is decided by the flags\n for_reclaim and for_kupdate.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,29 +3,29 @@\n ===============================================================================\n ***** Name *****\n probe::nfs.aop.writepages \u2014 NFS client writing several dirty pages to the NFS\n server\n ***** Synopsis *****\n nfs.aop.writepages\n ***** Values *****\n- wpages\n- write size (in pages)\n+ wsize\n+ write size\n for_reclaim\n a flag of writeback_control, indicates if it's invoked from the page\n allocator\n- size\n- number of pages attempted to be written in this execution\n nr_to_write\n number of pages attempted to be written in this execution\n dev\n device identifier\n+ size\n+ number of pages attempted to be written in this execution\n for_kupdate\n a flag of writeback_control, indicates if it's a kupdate writeback\n ino\n inode number\n- wsize\n- write size\n+ wpages\n+ write size (in pages)\n ***** Description *****\n The priority of wb is decided by the flags for_reclaim and for_kupdate.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.aop.writepage\u00a0Home \u00a0probe::nfs.fop.aio_read\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-fop-aio-read.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-fop-aio-read.html", "unified_diff": "@@ -1,25 +1,25 @@\n probe::nfs.fop.aio_read
\n how long the cached information is assumed to be valid.\n We need to revalidate the cached attrs for this inode\n if jiffies - read_cache_jiffies > attrtimeo.\n-
ino
\n- inode number \n+
pos
\n+ current position of file \n+
buf
\n+ the address of buf in user space\n
file_name
\n file name\n
parent_name
\n parent dir name\n-
pos
\n- current position of file \n+
dev
\n+ device identifier\n+
cache_valid
\n+ cache related bit mask flag\n+
ino
\n+ inode number \n+
cache_time
\n+ when we started read-caching this inode\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,32 +2,32 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.fop.aio_read \u2014 NFS client aio_read file operation\n ***** Synopsis *****\n nfs.fop.aio_read\n ***** Values *****\n- buf\n- the address of buf in user space\n- cache_valid\n- cache related bit mask flag\n count\n read bytes\n- cache_time\n- when we started read-caching this inode\n- dev\n- device identifier\n attrtimeo\n how long the cached information is assumed to be valid. We need to\n revalidate the cached attrs for this inode if jiffies -\n read_cache_jiffies > attrtimeo.\n- ino\n- inode number\n+ pos\n+ current position of file\n+ buf\n+ the address of buf in user space\n file_name\n file name\n parent_name\n parent dir name\n- pos\n- current position of file\n+ dev\n+ device identifier\n+ cache_valid\n+ cache related bit mask flag\n+ ino\n+ inode number\n+ cache_time\n+ when we started read-caching this inode\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.aop.writepages\u00a0Home \u00a0probe::nfs.fop.aio_write\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-fop-aio-write.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-fop-aio-write.html", "unified_diff": "@@ -1,17 +1,17 @@\n probe::nfs.fop.aio_write
\n symbolic string representation of the position to seek from\n-
whence
\n- the position to seek from\n
ino
\n inode number\n+
whence
\n+ the position to seek from\n
dev
\n device identifier\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -6,16 +6,16 @@\n ***** Synopsis *****\n nfs.fop.llseek\n ***** Values *****\n offset\n the offset of the file will be repositioned\n whence_str\n symbolic string representation of the position to seek from\n- whence\n- the position to seek from\n ino\n inode number\n+ whence\n+ the position to seek from\n dev\n device identifier\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.fop.fsync\u00a0Home \u00a0probe::nfs.fop.lock\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-fop-lock.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-fop-lock.html", "unified_diff": "@@ -1,19 +1,19 @@\n probe::nfs.fop.lock
\n how long the cached information is assumed to be valid.\n We need to revalidate the cached attrs for this inode \n if jiffies - read_cache_jiffies > attrtimeo.\n+
vm_flag
\n+ vm flags\n
buf
\n the address of buf in user space\n-
vm_end
\n- the first byte after end address within vm_mm\n
file_name
\n file name\n-
parent_name
\n- parent dir name\n-
ino
\n- inode number \n
dev
\n device identifier\n+
parent_name
\n+ parent dir name\n+
vm_end
\n+ the first byte after end address within vm_mm\n+
vm_start
\n+ start address within vm_mm \n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,34 +2,34 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.fop.mmap \u2014 NFS client mmap operation\n ***** Synopsis *****\n nfs.fop.mmap\n ***** Values *****\n- cache_time\n- when we started read-caching this inode\n cache_valid\n cache related bit mask flag\n- vm_flag\n- vm flags\n- vm_start\n- start address within vm_mm\n+ ino\n+ inode number\n+ cache_time\n+ when we started read-caching this inode\n attrtimeo\n how long the cached information is assumed to be valid. We need to\n revalidate the cached attrs for this inode if jiffies -\n read_cache_jiffies > attrtimeo.\n+ vm_flag\n+ vm flags\n buf\n the address of buf in user space\n- vm_end\n- the first byte after end address within vm_mm\n file_name\n file name\n- parent_name\n- parent dir name\n- ino\n- inode number\n dev\n device identifier\n+ parent_name\n+ parent dir name\n+ vm_end\n+ the first byte after end address within vm_mm\n+ vm_start\n+ start address within vm_mm\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.fop.lock\u00a0Home \u00a0probe::nfs.fop.open\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-fop-open.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-fop-open.html", "unified_diff": "@@ -1,13 +1,13 @@\n probe::nfs.fop.open
\n- how long the cached information is assumed to be valid.\n- We need to revalidate the cached attrs for this inode\n- if jiffies - read_cache_jiffies > attrtimeo.\n
ino
\n inode number \n+
cache_valid
\n+ cache related bit mask flag\n
dev
\n device identifier\n
file_name
\n file name\n
parent_name
\n parent dir name\n
pos
\n current position of file \n+
count
\n+ read bytes\n+
attrtimeo
\n+ how long the cached information is assumed to be valid.\n+ We need to revalidate the cached attrs for this inode\n+ if jiffies - read_cache_jiffies > attrtimeo.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,30 +2,30 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.fop.read_iter \u2014 NFS client read_iter file operation\n ***** Synopsis *****\n nfs.fop.read_iter\n ***** Values *****\n- cache_valid\n- cache related bit mask flag\n- count\n- read bytes\n cache_time\n when we started read-caching this inode\n- attrtimeo\n- how long the cached information is assumed to be valid. We need to\n- revalidate the cached attrs for this inode if jiffies -\n- read_cache_jiffies > attrtimeo.\n ino\n inode number\n+ cache_valid\n+ cache related bit mask flag\n dev\n device identifier\n file_name\n file name\n parent_name\n parent dir name\n pos\n current position of file\n+ count\n+ read bytes\n+ attrtimeo\n+ how long the cached information is assumed to be valid. We need to\n+ revalidate the cached attrs for this inode if jiffies -\n+ read_cache_jiffies > attrtimeo.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.fop.read\u00a0Home \u00a0probe::nfs.fop.release\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-fop-read.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-fop-read.html", "unified_diff": "@@ -1,9 +1,9 @@\n probe::nfs.fop.read
\n SystemTap uses the vfs.do_sync_read probe to implement this probe\n and as a result will get operations other than the NFS client read\n operations.\n
\n how long the cached information is assumed to be valid.\n We need to revalidate the cached attrs for this inode\n if jiffies - read_cache_jiffies > attrtimeo.\n-
cache_valid
\n- cache related bit mask flag\n
cache_time
\n when we started read-caching this inode\n+
ino
\n+ inode number\n+
cache_valid
\n+ cache related bit mask flag\n+
ppos
\n+ current position of file\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,24 +4,24 @@\n ***** Name *****\n probe::nfs.fop.sendfile \u2014 NFS client send file operation\n ***** Synopsis *****\n nfs.fop.sendfile\n ***** Values *****\n dev\n device identifier\n- ino\n- inode number\n count\n read bytes\n- ppos\n- current position of file\n attrtimeo\n how long the cached information is assumed to be valid. We need to\n revalidate the cached attrs for this inode if jiffies -\n read_cache_jiffies > attrtimeo.\n- cache_valid\n- cache related bit mask flag\n cache_time\n when we started read-caching this inode\n+ ino\n+ inode number\n+ cache_valid\n+ cache related bit mask flag\n+ ppos\n+ current position of file\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.fop.release\u00a0Home \u00a0probe::nfs.fop.write\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-fop-write-iter.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-fop-write-iter.html", "unified_diff": "@@ -1,15 +1,15 @@\n probe::nfs.fop.write_iter
\n SystemTap uses the vfs.do_sync_write probe to implement this probe\n and as a result will get operations other than the NFS client write\n operations.\n
probe::nfs.proc.commit_done — \n NFS client response to a commit RPC task\n-
Synopsis
nfs.proc.commit_done
Values
prot
\n+
Synopsis
nfs.proc.commit_done
Values
server_ip
\n+ IP address of server\n+
prot
\n transfer protocol\n+
count
\n+ number of bytes committed\n
timestamp
\n V4 timestamp, which is used for lease renewal\n+
version
\n+ NFS version\n
status
\n result of last operation\n-
server_ip
\n- IP address of server\n-
count
\n- number of bytes committed\n
valid
\n fattr->valid, indicates which fields are valid \n-
version
\n- NFS version\n-
Description
\n+
Description
\n Fires when a reply to a commit RPC task is received\n or some commit operation error occur (timeout or socket shutdown).\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,27 +2,27 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.proc.commit_done \u2014 NFS client response to a commit RPC task\n ***** Synopsis *****\n nfs.proc.commit_done\n ***** Values *****\n+ server_ip\n+ IP address of server\n prot\n transfer protocol\n+ count\n+ number of bytes committed\n timestamp\n V4 timestamp, which is used for lease renewal\n+ version\n+ NFS version\n status\n result of last operation\n- server_ip\n- IP address of server\n- count\n- number of bytes committed\n valid\n fattr->valid, indicates which fields are valid\n- version\n- NFS version\n ***** Description *****\n Fires when a reply to a commit RPC task is received or some commit operation\n error occur (timeout or socket shutdown).\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.proc.commit\u00a0Home \u00a0probe::nfs.proc.commit_setup\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-commit-setup.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-commit-setup.html", "unified_diff": "@@ -1,25 +1,25 @@\n probe::nfs.proc.commit_setup
probe::nfs.proc.commit_setup — \n NFS client setting up a commit RPC task\n-
Synopsis
nfs.proc.commit_setup
Values
server_ip
\n- IP address of server\n+
Synopsis
nfs.proc.commit_setup
Values
size
\n+ bytes in this commit\n
offset
\n the file offset\n
count
\n bytes in this commit\n-
version
\n- NFS version\n+
bitmask0
\n+ V4 bitmask representing the set of attributes supported\n+ on this filesystem\n+
server_ip
\n+ IP address of server\n
prot
\n transfer protocol\n-
size
\n- bytes in this commit\n
bitmask1
\n V4 bitmask representing the set of attributes supported\n on this filesystem\n-
bitmask0
\n- V4 bitmask representing the set of attributes supported\n- on this filesystem\n-
Description
\n+
version
\n+ NFS version\n+
Description
\n The commit_setup function is used to setup a commit RPC task.\n Is is not doing the actual commit operation.\n It does not exist in NFSv2.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,31 +2,31 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.proc.commit_setup \u2014 NFS client setting up a commit RPC task\n ***** Synopsis *****\n nfs.proc.commit_setup\n ***** Values *****\n- server_ip\n- IP address of server\n+ size\n+ bytes in this commit\n offset\n the file offset\n count\n bytes in this commit\n- version\n- NFS version\n+ bitmask0\n+ V4 bitmask representing the set of attributes supported on this\n+ filesystem\n+ server_ip\n+ IP address of server\n prot\n transfer protocol\n- size\n- bytes in this commit\n bitmask1\n V4 bitmask representing the set of attributes supported on this\n filesystem\n- bitmask0\n- V4 bitmask representing the set of attributes supported on this\n- filesystem\n+ version\n+ NFS version\n ***** Description *****\n The commit_setup function is used to setup a commit RPC task. Is is not doing\n the actual commit operation. It does not exist in NFSv2.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.proc.commit_done\u00a0Home \u00a0probe::nfs.proc.create\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-commit.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-commit.html", "unified_diff": "@@ -1,26 +1,26 @@\n probe::nfs.proc.commit
probe::nfs.proc.commit — \n NFS client committing data on server\n-
Synopsis
nfs.proc.commit
Values
offset
\n+
Synopsis
nfs.proc.commit
Values
size
\n+ read bytes in this execution\n+
offset
\n the file offset\n-
server_ip
\n- IP address of server\n+
bitmask1
\n+ V4 bitmask representing the set of attributes supported\n+ on this filesystem\n
version
\n NFS version\n
prot
\n transfer protocol\n-
size
\n- read bytes in this execution\n
bitmask0
\n V4 bitmask representing the set of attributes supported\n on this filesystem\n-
bitmask1
\n- V4 bitmask representing the set of attributes supported\n- on this filesystem\n-
Description
\n+
server_ip
\n+ IP address of server\n+
Description
\n All the nfs.proc.commit kernel functions were removed in kernel\n commit 200baa in December 2006, so these probes do not exist on Linux\n 2.6.21 and newer kernels.\n
\n \n Fires when client writes the buffered data to disk.\n The buffered data is asynchronously written by client earlier.\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,30 +2,30 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.proc.commit \u2014 NFS client committing data on server\n ***** Synopsis *****\n nfs.proc.commit\n ***** Values *****\n+ size\n+ read bytes in this execution\n offset\n the file offset\n- server_ip\n- IP address of server\n+ bitmask1\n+ V4 bitmask representing the set of attributes supported on this\n+ filesystem\n version\n NFS version\n prot\n transfer protocol\n- size\n- read bytes in this execution\n bitmask0\n V4 bitmask representing the set of attributes supported on this\n filesystem\n- bitmask1\n- V4 bitmask representing the set of attributes supported on this\n- filesystem\n+ server_ip\n+ IP address of server\n ***** Description *****\n All the nfs.proc.commit kernel functions were removed in kernel commit 200baa\n in December 2006, so these probes do not exist on Linux 2.6.21 and newer\n kernels.\n Fires when client writes the buffered data to disk. The buffered data is\n asynchronously written by client earlier. The commit function works in sync\n way. This probe point does not exist in NFSv2.\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-create.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-create.html", "unified_diff": "@@ -1,17 +1,17 @@\n
probe::nfs.proc.create — \n NFS client creating file on server\n-
Synopsis
nfs.proc.create
Values
server_ip
\n- IP address of server\n-
filelen
\n- length of file name\n-
version
\n- NFS version (the function is used for all NFS version)\n-
filename
\n+
Synopsis
nfs.proc.create
Values
filename
\n file name\n+
fh
\n+ file handle of parent dir\n
prot
\n transfer protocol\n+
server_ip
\n+ IP address of server\n+
version
\n+ NFS version (the function is used for all NFS version)\n+
filelen
\n+ length of file name\n
flag
\n indicates create mode (only for NFSv3 and NFSv4)\n-
fh
\n- file handle of parent dir\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,24 +2,24 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.proc.create \u2014 NFS client creating file on server\n ***** Synopsis *****\n nfs.proc.create\n ***** Values *****\n- server_ip\n- IP address of server\n- filelen\n- length of file name\n- version\n- NFS version (the function is used for all NFS version)\n filename\n file name\n+ fh\n+ file handle of parent dir\n prot\n transfer protocol\n+ server_ip\n+ IP address of server\n+ version\n+ NFS version (the function is used for all NFS version)\n+ filelen\n+ length of file name\n flag\n indicates create mode (only for NFSv3 and NFSv4)\n- fh\n- file handle of parent dir\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.proc.commit_setup\u00a0Home \u00a0probe::nfs.proc.handle_exception\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-handle-exception.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-handle-exception.html", "unified_diff": "@@ -1,7 +1,7 @@\n probe::nfs.proc.handle_exception
probe::nfs.proc.lookup — \n NFS client opens/searches a file on server\n-
Synopsis
nfs.proc.lookup
Values
bitmask0
\n+
Synopsis
nfs.proc.lookup
Values
prot
\n+ transfer protocol\n+
server_ip
\n+ IP address of server\n+
bitmask0
\n V4 bitmask representing the set of attributes supported\n on this filesystem\n+
version
\n+ NFS version\n
bitmask1
\n V4 bitmask representing the set of attributes supported\n on this filesystem\n-
prot
\n- transfer protocol\n-
name_len
\n- the length of file name\n
filename
\n the name of file which client opens/searches on server\n-
version
\n- NFS version\n-
server_ip
\n- IP address of server\n+
name_len
\n+ the length of file name\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,26 +2,26 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.proc.lookup \u2014 NFS client opens/searches a file on server\n ***** Synopsis *****\n nfs.proc.lookup\n ***** Values *****\n+ prot\n+ transfer protocol\n+ server_ip\n+ IP address of server\n bitmask0\n V4 bitmask representing the set of attributes supported on this\n filesystem\n+ version\n+ NFS version\n bitmask1\n V4 bitmask representing the set of attributes supported on this\n filesystem\n- prot\n- transfer protocol\n- name_len\n- the length of file name\n filename\n the name of file which client opens/searches on server\n- version\n- NFS version\n- server_ip\n- IP address of server\n+ name_len\n+ the length of file name\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.proc.handle_exception\u00a0Home \u00a0probe::nfs.proc.open\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-open.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-open.html", "unified_diff": "@@ -1,17 +1,17 @@\n probe::nfs.proc.open
probe::nfs.proc.read_done — \n NFS client response to a read RPC task\n-
Synopsis
nfs.proc.read_done
Values
status
\n- result of last operation\n-
prot
\n+
Synopsis
nfs.proc.read_done
Values
prot
\n transfer protocol\n-
timestamp
\n- V4 timestamp, which is used for lease renewal\n-
version
\n- NFS version\n
server_ip
\n IP address of server\n+
timestamp
\n+ V4 timestamp, which is used for lease renewal\n
count
\n number of bytes read\n-
Description
\n+
version
\n+ NFS version\n+
status
\n+ result of last operation\n+
Description
\n Fires when a reply to a read RPC task is received or some read error occurs\n (timeout or socket shutdown).\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,25 +2,25 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.proc.read_done \u2014 NFS client response to a read RPC task\n ***** Synopsis *****\n nfs.proc.read_done\n ***** Values *****\n- status\n- result of last operation\n prot\n transfer protocol\n- timestamp\n- V4 timestamp, which is used for lease renewal\n- version\n- NFS version\n server_ip\n IP address of server\n+ timestamp\n+ V4 timestamp, which is used for lease renewal\n count\n number of bytes read\n+ version\n+ NFS version\n+ status\n+ result of last operation\n ***** Description *****\n Fires when a reply to a read RPC task is received or some read error occurs\n (timeout or socket shutdown).\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.proc.read\u00a0Home \u00a0probe::nfs.proc.read_setup\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-read-setup.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-read-setup.html", "unified_diff": "@@ -1,18 +1,18 @@\n probe::nfs.proc.read_setup
probe::nfs.proc.read_setup — \n NFS client setting up a read RPC task\n-
Synopsis
nfs.proc.read_setup
Values
prot
\n- transfer protocol\n-
size
\n- read bytes in this execution\n-
server_ip
\n- IP address of server\n-
offset
\n+
Synopsis
nfs.proc.read_setup
Values
offset
\n the file offset \n-
count
\n+
size
\n read bytes in this execution\n
version
\n NFS version\n-
Description
\n+
count
\n+ read bytes in this execution\n+
server_ip
\n+ IP address of server\n+
prot
\n+ transfer protocol\n+
Description
\n The read_setup function is used to setup a read RPC task.\n It is not doing the actual read operation.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,25 +2,25 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.proc.read_setup \u2014 NFS client setting up a read RPC task\n ***** Synopsis *****\n nfs.proc.read_setup\n ***** Values *****\n- prot\n- transfer protocol\n- size\n- read bytes in this execution\n- server_ip\n- IP address of server\n offset\n the file offset\n- count\n+ size\n read bytes in this execution\n version\n NFS version\n+ count\n+ read bytes in this execution\n+ server_ip\n+ IP address of server\n+ prot\n+ transfer protocol\n ***** Description *****\n The read_setup function is used to setup a read RPC task. It is not doing the\n actual read operation.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.proc.read_done\u00a0Home \u00a0probe::nfs.proc.release\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-read.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-read.html", "unified_diff": "@@ -1,19 +1,19 @@\n probe::nfs.proc.read
probe::nfs.proc.read — \n NFS client synchronously reads file from server\n-
Synopsis
nfs.proc.read
Values
count
\n- read bytes in this execution\n-
offset
\n- the file offset\n-
flags
\n- used to set task->tk_flags in rpc_init_task function\n+
Synopsis
nfs.proc.read
Values
version
\n+ NFS version\n
server_ip
\n IP address of server\n-
version
\n- NFS version\n
prot
\n transfer protocol\n-
Description
\n+
count
\n+ read bytes in this execution\n+
flags
\n+ used to set task->tk_flags in rpc_init_task function\n+
offset
\n+ the file offset\n+
Description
\n All the nfs.proc.read kernel functions were removed in kernel commit\n 8e0969 in December 2006, so these probes do not exist on Linux\n 2.6.21 and newer kernels.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,25 +2,25 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.proc.read \u2014 NFS client synchronously reads file from server\n ***** Synopsis *****\n nfs.proc.read\n ***** Values *****\n- count\n- read bytes in this execution\n- offset\n- the file offset\n- flags\n- used to set task->tk_flags in rpc_init_task function\n- server_ip\n- IP address of server\n version\n NFS version\n+ server_ip\n+ IP address of server\n prot\n transfer protocol\n+ count\n+ read bytes in this execution\n+ flags\n+ used to set task->tk_flags in rpc_init_task function\n+ offset\n+ the file offset\n ***** Description *****\n All the nfs.proc.read kernel functions were removed in kernel commit 8e0969 in\n December 2006, so these probes do not exist on Linux 2.6.21 and newer kernels.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.proc.open\u00a0Home \u00a0probe::nfs.proc.read_done\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-release.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-release.html", "unified_diff": "@@ -1,17 +1,17 @@\n probe::nfs.proc.release
probe::nfs.proc.rename_done — \n NFS client response to a rename RPC task\n-
Synopsis
nfs.proc.rename_done
Values
version
\n- NFS version\n+
Synopsis
nfs.proc.rename_done
Values
new_fh
\n+ file handle of new parent dir\n+
status
\n+ result of last operation\n
old_fh
\n file handle of old parent dir\n-
new_fh
\n- file handle of new parent dir\n+
timestamp
\n+ V4 timestamp, which is used for lease renewal\n
server_ip
\n IP address of server\n-
status
\n- result of last operation\n
prot
\n transfer protocol\n-
timestamp
\n- V4 timestamp, which is used for lease renewal\n-
Description
\n+
version
\n+ NFS version\n+
Description
\n Fires when a reply to a rename RPC task is received or some rename\n error occurs (timeout or socket shutdown).\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,27 +2,27 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.proc.rename_done \u2014 NFS client response to a rename RPC task\n ***** Synopsis *****\n nfs.proc.rename_done\n ***** Values *****\n- version\n- NFS version\n- old_fh\n- file handle of old parent dir\n new_fh\n file handle of new parent dir\n- server_ip\n- IP address of server\n status\n result of last operation\n- prot\n- transfer protocol\n+ old_fh\n+ file handle of old parent dir\n timestamp\n V4 timestamp, which is used for lease renewal\n+ server_ip\n+ IP address of server\n+ prot\n+ transfer protocol\n+ version\n+ NFS version\n ***** Description *****\n Fires when a reply to a rename RPC task is received or some rename error occurs\n (timeout or socket shutdown).\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.proc.rename\u00a0Home \u00a0probe::nfs.proc.rename_setup\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-rename-setup.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-rename-setup.html", "unified_diff": "@@ -1,14 +1,14 @@\n probe::nfs.proc.rename_setup
probe::nfs.proc.rename_setup — \n NFS client setting up a rename RPC task\n-
Synopsis
nfs.proc.rename_setup
Values
prot
\n- transfer protocol\n-
fh
\n+
Synopsis
nfs.proc.rename_setup
Values
fh
\n file handle of parent dir\n-
server_ip
\n- IP address of server\n
version
\n NFS version\n-
Description
\n+
prot
\n+ transfer protocol\n+
server_ip
\n+ IP address of server\n+
Description
\n The rename_setup function is used to setup a rename RPC task.\n Is is not doing the actual rename operation.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,21 +2,21 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.proc.rename_setup \u2014 NFS client setting up a rename RPC task\n ***** Synopsis *****\n nfs.proc.rename_setup\n ***** Values *****\n- prot\n- transfer protocol\n fh\n file handle of parent dir\n- server_ip\n- IP address of server\n version\n NFS version\n+ prot\n+ transfer protocol\n+ server_ip\n+ IP address of server\n ***** Description *****\n The rename_setup function is used to setup a rename RPC task. Is is not doing\n the actual rename operation.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.proc.rename_done\u00a0Home \u00a0probe::nfs.proc.write\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-rename.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-rename.html", "unified_diff": "@@ -1,21 +1,21 @@\n probe::nfs.proc.rename
probe::nfs.proc.rename — \n NFS client renames a file on server\n-
Synopsis
nfs.proc.rename
Values
version
\n- NFS version (the function is used for all NFS version)\n-
new_fh
\n- file handle of new parent dir\n-
server_ip
\n- IP address of server\n+
Synopsis
nfs.proc.rename
Values
old_filelen
\n+ length of old file name\n+
new_filelen
\n+ length of new file name\n
old_fh
\n file handle of old parent dir\n-
old_name
\n- old file name\n
new_name
\n new file name\n-
new_filelen
\n- length of new file name\n-
old_filelen
\n- length of old file name\n+
new_fh
\n+ file handle of new parent dir\n+
old_name
\n+ old file name\n+
server_ip
\n+ IP address of server\n
prot
\n transfer protocol\n+
version
\n+ NFS version (the function is used for all NFS version)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,28 +2,28 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.proc.rename \u2014 NFS client renames a file on server\n ***** Synopsis *****\n nfs.proc.rename\n ***** Values *****\n- version\n- NFS version (the function is used for all NFS version)\n- new_fh\n- file handle of new parent dir\n- server_ip\n- IP address of server\n+ old_filelen\n+ length of old file name\n+ new_filelen\n+ length of new file name\n old_fh\n file handle of old parent dir\n- old_name\n- old file name\n new_name\n new file name\n- new_filelen\n- length of new file name\n- old_filelen\n- length of old file name\n+ new_fh\n+ file handle of new parent dir\n+ old_name\n+ old file name\n+ server_ip\n+ IP address of server\n prot\n transfer protocol\n+ version\n+ NFS version (the function is used for all NFS version)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.proc.remove\u00a0Home \u00a0probe::nfs.proc.rename_done\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-write-done.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-write-done.html", "unified_diff": "@@ -1,20 +1,20 @@\n probe::nfs.proc.write_done
probe::nfs.proc.write_done — \n NFS client response to a write RPC task\n-
Synopsis
nfs.proc.write_done
Values
valid
\n- fattr->valid, indicates which fields are valid \n-
version
\n+
Synopsis
nfs.proc.write_done
Values
version
\n NFS version\n+
timestamp
\n+ V4 timestamp, which is used for lease renewal\n
count
\n number of bytes written\n
server_ip
\n IP address of server\n-
status
\n- result of last operation\n-
timestamp
\n- V4 timestamp, which is used for lease renewal\n
prot
\n transfer protocol\n-
Description
\n+
status
\n+ result of last operation\n+
valid
\n+ fattr->valid, indicates which fields are valid \n+
Description
\n Fires when a reply to a write RPC task is received or some write error occurs\n (timeout or socket shutdown).\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,27 +2,27 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.proc.write_done \u2014 NFS client response to a write RPC task\n ***** Synopsis *****\n nfs.proc.write_done\n ***** Values *****\n- valid\n- fattr->valid, indicates which fields are valid\n version\n NFS version\n+ timestamp\n+ V4 timestamp, which is used for lease renewal\n count\n number of bytes written\n server_ip\n IP address of server\n- status\n- result of last operation\n- timestamp\n- V4 timestamp, which is used for lease renewal\n prot\n transfer protocol\n+ status\n+ result of last operation\n+ valid\n+ fattr->valid, indicates which fields are valid\n ***** Description *****\n Fires when a reply to a write RPC task is received or some write error occurs\n (timeout or socket shutdown).\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.proc.write\u00a0Home \u00a0probe::nfs.proc.write_setup\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-write-setup.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-write-setup.html", "unified_diff": "@@ -1,28 +1,28 @@\n probe::nfs.proc.write_setup
probe::nfs.proc.write_setup — \n NFS client setting up a write RPC task\n-
Synopsis
nfs.proc.write_setup
Values
offset
\n- the file offset\n-
count
\n- bytes written in this execution\n+
Synopsis
nfs.proc.write_setup
Values
prot
\n+ transfer protocol\n+
bitmask0
\n+ V4 bitmask representing the set of attributes supported\n+ on this filesystem\n
server_ip
\n IP address of server\n-
how
\n- used to set args.stable. The stable value could be:\n- NFS_UNSTABLE,NFS_DATA_SYNC,NFS_FILE_SYNC\n- (in nfs.proc3.write_setup and nfs.proc4.write_setup)\n+
count
\n+ bytes written in this execution\n
version
\n NFS version\n-
prot
\n- transfer protocol\n-
size
\n- bytes written in this execution\n
bitmask1
\n V4 bitmask representing the set of attributes supported\n on this filesystem \n-
bitmask0
\n- V4 bitmask representing the set of attributes supported\n- on this filesystem\n-
Description
\n+
size
\n+ bytes written in this execution\n+
offset
\n+ the file offset\n+
how
\n+ used to set args.stable. The stable value could be:\n+ NFS_UNSTABLE,NFS_DATA_SYNC,NFS_FILE_SYNC\n+ (in nfs.proc3.write_setup and nfs.proc4.write_setup)\n+
Description
\n The write_setup function is used to setup a write RPC task.\n It is not doing the actual write operation.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,35 +2,35 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.proc.write_setup \u2014 NFS client setting up a write RPC task\n ***** Synopsis *****\n nfs.proc.write_setup\n ***** Values *****\n- offset\n- the file offset\n- count\n- bytes written in this execution\n+ prot\n+ transfer protocol\n+ bitmask0\n+ V4 bitmask representing the set of attributes supported on this\n+ filesystem\n server_ip\n IP address of server\n- how\n- used to set args.stable. The stable value could be:\n- NFS_UNSTABLE,NFS_DATA_SYNC,NFS_FILE_SYNC (in nfs.proc3.write_setup and\n- nfs.proc4.write_setup)\n+ count\n+ bytes written in this execution\n version\n NFS version\n- prot\n- transfer protocol\n- size\n- bytes written in this execution\n bitmask1\n V4 bitmask representing the set of attributes supported on this\n filesystem\n- bitmask0\n- V4 bitmask representing the set of attributes supported on this\n- filesystem\n+ size\n+ bytes written in this execution\n+ offset\n+ the file offset\n+ how\n+ used to set args.stable. The stable value could be:\n+ NFS_UNSTABLE,NFS_DATA_SYNC,NFS_FILE_SYNC (in nfs.proc3.write_setup and\n+ nfs.proc4.write_setup)\n ***** Description *****\n The write_setup function is used to setup a write RPC task. It is not doing the\n actual write operation.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfs.proc.write_done\u00a0Home \u00a0probe::nfsd.close\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-write.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfs-proc-write.html", "unified_diff": "@@ -1,25 +1,25 @@\n probe::nfs.proc.write
probe::nfs.proc.write — \n NFS client synchronously writes file to server\n-
Synopsis
nfs.proc.write
Values
bitmask1
\n+
Synopsis
nfs.proc.write
Values
prot
\n+ transfer protocol\n+
bitmask0
\n V4 bitmask representing the set of attributes supported\n on this filesystem\n-
bitmask0
\n+
server_ip
\n+ IP address of server\n+
bitmask1
\n V4 bitmask representing the set of attributes supported\n on this filesystem\n-
size
\n- read bytes in this execution\n-
prot
\n- transfer protocol\n
version
\n NFS version\n-
server_ip
\n- IP address of server\n+
size
\n+ read bytes in this execution\n
offset
\n the file offset\n
flags
\n used to set task->tk_flags in rpc_init_task function\n-
Description
\n+
Description
\n All the nfs.proc.write kernel functions were removed in kernel commit\n 200baa in December 2006, so these probes do not exist on Linux\n 2.6.21 and newer kernels.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,28 +2,28 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfs.proc.write \u2014 NFS client synchronously writes file to server\n ***** Synopsis *****\n nfs.proc.write\n ***** Values *****\n- bitmask1\n+ prot\n+ transfer protocol\n+ bitmask0\n V4 bitmask representing the set of attributes supported on this\n filesystem\n- bitmask0\n+ server_ip\n+ IP address of server\n+ bitmask1\n V4 bitmask representing the set of attributes supported on this\n filesystem\n- size\n- read bytes in this execution\n- prot\n- transfer protocol\n version\n NFS version\n- server_ip\n- IP address of server\n+ size\n+ read bytes in this execution\n offset\n the file offset\n flags\n used to set task->tk_flags in rpc_init_task function\n ***** Description *****\n All the nfs.proc.write kernel functions were removed in kernel commit 200baa in\n December 2006, so these probes do not exist on Linux 2.6.21 and newer kernels.\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-close.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-close.html", "unified_diff": "@@ -1,7 +1,7 @@\n probe::nfsd.close
probe::nfsd.commit — \n NFS server committing all pending writes to stable storage\n-
Synopsis
nfsd.commit
Values
fh
\n- file handle (the first part is the length of the file handle)\n-
client_ip
\n+
Synopsis
nfsd.commit
Values
client_ip
\n the ip address of client\n-
flag
\n- indicates whether this execution is a sync operation\n-
count
\n+
size
\n read bytes\n
offset
\n the offset of file\n-
size
\n+
fh
\n+ file handle (the first part is the length of the file handle)\n+
flag
\n+ indicates whether this execution is a sync operation\n+
count
\n read bytes\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,22 +2,22 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfsd.commit \u2014 NFS server committing all pending writes to stable storage\n ***** Synopsis *****\n nfsd.commit\n ***** Values *****\n- fh\n- file handle (the first part is the length of the file handle)\n client_ip\n the ip address of client\n- flag\n- indicates whether this execution is a sync operation\n- count\n+ size\n read bytes\n offset\n the offset of file\n- size\n+ fh\n+ file handle (the first part is the length of the file handle)\n+ flag\n+ indicates whether this execution is a sync operation\n+ count\n read bytes\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfsd.close\u00a0Home \u00a0probe::nfsd.create\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-create.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-create.html", "unified_diff": "@@ -1,19 +1,19 @@\n probe::nfsd.create
probe::nfsd.create — \n NFS server creating a file(regular,dir,device,fifo) for client\n-
Synopsis
nfsd.create
Values
filelen
\n- the length of file name\n-
type
\n+
Synopsis
nfsd.create
Values
type
\n file type(regular,dir,device,fifo ...)\n-
fh
\n- file handle (the first part is the length of the file handle)\n-
iap_mode
\n- file access mode\n
client_ip
\n the ip address of client\n-
iap_valid
\n- Attribute flags\n+
iap_mode
\n+ file access mode\n
filename
\n file name \n-
Description
\n+
iap_valid
\n+ Attribute flags\n+
filelen
\n+ the length of file name\n+
fh
\n+ file handle (the first part is the length of the file handle)\n+
Description
\n Sometimes nfsd will call nfsd_create_v3 instead of this this probe point.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,26 +3,26 @@\n ===============================================================================\n ***** Name *****\n probe::nfsd.create \u2014 NFS server creating a file(regular,dir,device,fifo) for\n client\n ***** Synopsis *****\n nfsd.create\n ***** Values *****\n- filelen\n- the length of file name\n type\n file type(regular,dir,device,fifo ...)\n- fh\n- file handle (the first part is the length of the file handle)\n- iap_mode\n- file access mode\n client_ip\n the ip address of client\n- iap_valid\n- Attribute flags\n+ iap_mode\n+ file access mode\n filename\n file name\n+ iap_valid\n+ Attribute flags\n+ filelen\n+ the length of file name\n+ fh\n+ file handle (the first part is the length of the file handle)\n ***** Description *****\n Sometimes nfsd will call nfsd_create_v3 instead of this this probe point.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfsd.commit\u00a0Home \u00a0probe::nfsd.createv3\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-createv3.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-createv3.html", "unified_diff": "@@ -1,24 +1,24 @@\n probe::nfsd.createv3
probe::nfsd.createv3 — \n NFS server creating a regular file or set file attributes for client\n-
Synopsis
nfsd.createv3
Values
iap_valid
\n+
Synopsis
nfsd.createv3
Values
verifier
\n+ file attributes (atime,mtime,mode). It's used to reset file attributes for CREATE_EXCLUSIVE\n+
iap_mode
\n+ file access mode\n+
client_ip
\n+ the ip address of client\n+
createmode
\n+ create mode .The possible values could be: NFS3_CREATE_EXCLUSIVE, NFS3_CREATE_UNCHECKED, or NFS3_CREATE_GUARDED\n+
iap_valid
\n Attribute flags\n+
filename
\n+ file name \n
fh
\n file handle (the first part is the length of the file handle)\n-
client_ip
\n- the ip address of client\n-
iap_mode
\n- file access mode\n
truncp
\n trunp arguments, indicates if the file shouldbe truncate\n-
filename
\n- file name \n-
createmode
\n- create mode .The possible values could be: NFS3_CREATE_EXCLUSIVE, NFS3_CREATE_UNCHECKED, or NFS3_CREATE_GUARDED\n
filelen
\n the length of file name\n-
verifier
\n- file attributes (atime,mtime,mode). It's used to reset file attributes for CREATE_EXCLUSIVE\n-
Description
\n+
Description
\n This probepoints is only called by nfsd3_proc_create and\n nfsd4_open when op_claim_type is NFS4_OPEN_CLAIM_NULL.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,33 +3,33 @@\n ===============================================================================\n ***** Name *****\n probe::nfsd.createv3 \u2014 NFS server creating a regular file or set file\n attributes for client\n ***** Synopsis *****\n nfsd.createv3\n ***** Values *****\n+ verifier\n+ file attributes (atime,mtime,mode). It's used to reset file attributes\n+ for CREATE_EXCLUSIVE\n+ iap_mode\n+ file access mode\n+ client_ip\n+ the ip address of client\n+ createmode\n+ create mode .The possible values could be: NFS3_CREATE_EXCLUSIVE,\n+ NFS3_CREATE_UNCHECKED, or NFS3_CREATE_GUARDED\n iap_valid\n Attribute flags\n+ filename\n+ file name\n fh\n file handle (the first part is the length of the file handle)\n- client_ip\n- the ip address of client\n- iap_mode\n- file access mode\n truncp\n trunp arguments, indicates if the file shouldbe truncate\n- filename\n- file name\n- createmode\n- create mode .The possible values could be: NFS3_CREATE_EXCLUSIVE,\n- NFS3_CREATE_UNCHECKED, or NFS3_CREATE_GUARDED\n filelen\n the length of file name\n- verifier\n- file attributes (atime,mtime,mode). It's used to reset file attributes\n- for CREATE_EXCLUSIVE\n ***** Description *****\n This probepoints is only called by nfsd3_proc_create and nfsd4_open when\n op_claim_type is NFS4_OPEN_CLAIM_NULL.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfsd.create\u00a0Home \u00a0probe::nfsd.dispatch\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-dispatch.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-dispatch.html", "unified_diff": "@@ -1,15 +1,15 @@\n probe::nfsd.dispatch
probe::nfsd.lookup — \n NFS server opening or searching file for a file for client\n-
Synopsis
nfsd.lookup
Values
client_ip
\n+
Synopsis
nfsd.lookup
Values
client_ip
\n the ip address of client\n+
filelen
\n+ the length of file name\n
fh
\n file handle of parent dir(the first part is the length of the file handle)\n
filename
\n file name \n-
filelen
\n- the length of file name\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,17 +4,17 @@\n ***** Name *****\n probe::nfsd.lookup \u2014 NFS server opening or searching file for a file for client\n ***** Synopsis *****\n nfsd.lookup\n ***** Values *****\n client_ip\n the ip address of client\n+ filelen\n+ the length of file name\n fh\n file handle of parent dir(the first part is the length of the file\n handle)\n filename\n file name\n- filelen\n- the length of file name\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfsd.dispatch\u00a0Home \u00a0probe::nfsd.open\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-open.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-open.html", "unified_diff": "@@ -1,11 +1,11 @@\n probe::nfsd.open
probe::nfsd.open — \n NFS server opening a file for client\n-
Synopsis
nfsd.open
Values
fh
\n- file handle (the first part is the length of the file handle)\n-
access
\n+
Synopsis
nfsd.open
Values
access
\n indicates the type of open (read/write/commit/readdir...) \n-
client_ip
\n- the ip address of client\n+
fh
\n+ file handle (the first part is the length of the file handle)\n
type
\n type of file (regular file or dir)\n+
client_ip
\n+ the ip address of client\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfsd.open \u2014 NFS server opening a file for client\n ***** Synopsis *****\n nfsd.open\n ***** Values *****\n- fh\n- file handle (the first part is the length of the file handle)\n access\n indicates the type of open (read/write/commit/readdir...)\n- client_ip\n- the ip address of client\n+ fh\n+ file handle (the first part is the length of the file handle)\n type\n type of file (regular file or dir)\n+ client_ip\n+ the ip address of client\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfsd.lookup\u00a0Home \u00a0probe::nfsd.proc.commit\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-proc-commit.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-proc-commit.html", "unified_diff": "@@ -1,21 +1,21 @@\n probe::nfsd.proc.commit
probe::nfsd.proc.commit — \n NFS server performing a commit operation for client\n-
Synopsis
nfsd.proc.commit
Values
count
\n+
Synopsis
nfsd.proc.commit
Values
size
\n read bytes\n-
gid
\n- requester's group id\n-
uid
\n- requester's user id\n+
offset
\n+ the offset of file \n+
proto
\n+ transfer protocol\n
client_ip
\n the ip address of client\n+
uid
\n+ requester's user id\n+
gid
\n+ requester's group id\n+
count
\n+ read bytes\n
fh
\n file handle (the first part is the length of the file handle)\n-
size
\n- read bytes\n
version
\n nfs version\n-
offset
\n- the offset of file \n-
proto
\n- transfer protocol\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,28 +2,28 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfsd.proc.commit \u2014 NFS server performing a commit operation for client\n ***** Synopsis *****\n nfsd.proc.commit\n ***** Values *****\n- count\n+ size\n read bytes\n- gid\n- requester's group id\n- uid\n- requester's user id\n+ offset\n+ the offset of file\n+ proto\n+ transfer protocol\n client_ip\n the ip address of client\n+ uid\n+ requester's user id\n+ gid\n+ requester's group id\n+ count\n+ read bytes\n fh\n file handle (the first part is the length of the file handle)\n- size\n- read bytes\n version\n nfs version\n- offset\n- the offset of file\n- proto\n- transfer protocol\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfsd.open\u00a0Home \u00a0probe::nfsd.proc.create\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-proc-create.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-proc-create.html", "unified_diff": "@@ -1,19 +1,19 @@\n probe::nfsd.proc.create
probe::nfsd.proc.create — \n NFS server creating a file for client\n-
Synopsis
nfsd.proc.create
Values
gid
\n- requester's group id\n-
client_ip
\n- the ip address of client\n-
uid
\n- requester's user id\n-
fh
\n- file handle (the first part is the length of the file handle)\n-
filename
\n+
Synopsis
nfsd.proc.create
Values
filename
\n file name\n+
gid
\n+ requester's group id\n+
version
\n+ nfs version\n
filelen
\n length of file name\n+
fh
\n+ file handle (the first part is the length of the file handle)\n+
uid
\n+ requester's user id\n+
client_ip
\n+ the ip address of client\n
proto
\n transfer protocol\n-
version
\n- nfs version\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,26 +2,26 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfsd.proc.create \u2014 NFS server creating a file for client\n ***** Synopsis *****\n nfsd.proc.create\n ***** Values *****\n- gid\n- requester's group id\n- client_ip\n- the ip address of client\n- uid\n- requester's user id\n- fh\n- file handle (the first part is the length of the file handle)\n filename\n file name\n+ gid\n+ requester's group id\n+ version\n+ nfs version\n filelen\n length of file name\n+ fh\n+ file handle (the first part is the length of the file handle)\n+ uid\n+ requester's user id\n+ client_ip\n+ the ip address of client\n proto\n transfer protocol\n- version\n- nfs version\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfsd.proc.commit\u00a0Home \u00a0probe::nfsd.proc.lookup\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-proc-lookup.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-proc-lookup.html", "unified_diff": "@@ -1,19 +1,19 @@\n probe::nfsd.proc.lookup
probe::nfsd.proc.lookup — \n NFS server opening or searching for a file for client\n-
Synopsis
nfsd.proc.lookup
Values
filename
\n- file name \n+
Synopsis
nfsd.proc.lookup
Values
uid
\n+ requester's user id\n+
client_ip
\n+ the ip address of client\n+
filelen
\n+ the length of file name\n
version
\n nfs version\n-
proto
\n- transfer protocol\n
fh
\n file handle of parent dir (the first part is the length of the file handle)\n-
uid
\n- requester's user id\n+
proto
\n+ transfer protocol\n+
filename
\n+ file name \n
gid
\n requester's group id\n-
client_ip
\n- the ip address of client\n-
filelen
\n- the length of file name\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,27 +2,27 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfsd.proc.lookup \u2014 NFS server opening or searching for a file for client\n ***** Synopsis *****\n nfsd.proc.lookup\n ***** Values *****\n- filename\n- file name\n+ uid\n+ requester's user id\n+ client_ip\n+ the ip address of client\n+ filelen\n+ the length of file name\n version\n nfs version\n- proto\n- transfer protocol\n fh\n file handle of parent dir (the first part is the length of the file\n handle)\n- uid\n- requester's user id\n+ proto\n+ transfer protocol\n+ filename\n+ file name\n gid\n requester's group id\n- client_ip\n- the ip address of client\n- filelen\n- the length of file name\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfsd.proc.create\u00a0Home \u00a0probe::nfsd.proc.read\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-proc-read.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-proc-read.html", "unified_diff": "@@ -1,25 +1,25 @@\n probe::nfsd.proc.read
probe::nfsd.proc.read — \n NFS server reading file for client\n-
Synopsis
nfsd.proc.read
Values
count
\n+
Synopsis
nfsd.proc.read
Values
offset
\n+ the offset of file \n+
count
\n read bytes\n-
vec
\n- struct kvec, includes buf address in kernel address and length of each buffer\n-
client_ip
\n- the ip address of client\n-
uid
\n- requester's user id\n-
gid
\n- requester's group id\n-
fh
\n- file handle (the first part is the length of the file handle)\n
vlen
\n read blocks \n+
gid
\n+ requester's group id\n
size
\n read bytes\n+
vec
\n+ struct kvec, includes buf address in kernel address and length of each buffer\n
version
\n nfs version\n-
offset
\n- the offset of file \n+
uid
\n+ requester's user id\n+
client_ip
\n+ the ip address of client\n
proto
\n transfer protocol\n+
fh
\n+ file handle (the first part is the length of the file handle)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,33 +2,33 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfsd.proc.read \u2014 NFS server reading file for client\n ***** Synopsis *****\n nfsd.proc.read\n ***** Values *****\n+ offset\n+ the offset of file\n count\n read bytes\n- vec\n- struct kvec, includes buf address in kernel address and length of each\n- buffer\n- client_ip\n- the ip address of client\n- uid\n- requester's user id\n- gid\n- requester's group id\n- fh\n- file handle (the first part is the length of the file handle)\n vlen\n read blocks\n+ gid\n+ requester's group id\n size\n read bytes\n+ vec\n+ struct kvec, includes buf address in kernel address and length of each\n+ buffer\n version\n nfs version\n- offset\n- the offset of file\n+ uid\n+ requester's user id\n+ client_ip\n+ the ip address of client\n proto\n transfer protocol\n+ fh\n+ file handle (the first part is the length of the file handle)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfsd.proc.lookup\u00a0Home \u00a0probe::nfsd.proc.remove\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-proc-remove.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-proc-remove.html", "unified_diff": "@@ -1,19 +1,19 @@\n probe::nfsd.proc.remove
probe::nfsd.proc.rename — \n NFS Server renaming a file for client\n-
Synopsis
nfsd.proc.rename
Values
fh
\n+
Synopsis
nfsd.proc.rename
Values
tlen
\n+ length of new file name\n+
fh
\n file handler of old path\n
flen
\n length of old file name \n+
filename
\n+ old file name \n
gid
\n requester's group id\n-
client_ip
\n- the ip address of client\n+
tfh
\n+ file handler of new path\n
uid
\n requester's user id\n+
client_ip
\n+ the ip address of client\n
tname
\n new file name\n-
filename
\n- old file name \n-
tlen
\n- length of new file name\n-
tfh
\n- file handler of new path\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,28 +2,28 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfsd.proc.rename \u2014 NFS Server renaming a file for client\n ***** Synopsis *****\n nfsd.proc.rename\n ***** Values *****\n+ tlen\n+ length of new file name\n fh\n file handler of old path\n flen\n length of old file name\n+ filename\n+ old file name\n gid\n requester's group id\n- client_ip\n- the ip address of client\n+ tfh\n+ file handler of new path\n uid\n requester's user id\n+ client_ip\n+ the ip address of client\n tname\n new file name\n- filename\n- old file name\n- tlen\n- length of new file name\n- tfh\n- file handler of new path\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfsd.proc.remove\u00a0Home \u00a0probe::nfsd.proc.write\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-proc-write.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-proc-write.html", "unified_diff": "@@ -1,27 +1,27 @@\n probe::nfsd.proc.write
probe::nfsd.proc.write — \n NFS server writing data to file for client\n-
Synopsis
nfsd.proc.write
Values
count
\n- read bytes\n-
vec
\n+
Synopsis
nfsd.proc.write
Values
vec
\n struct kvec, includes buf address in kernel address and length of each buffer\n+
size
\n+ read bytes\n+
vlen
\n+ read blocks \n+
offset
\n+ the offset of file \n
stable
\n argp->stable\n+
proto
\n+ transfer protocol\n
uid
\n requester's user id\n-
gid
\n- requester's group id\n
client_ip
\n the ip address of client\n-
vlen
\n- read blocks \n+
gid
\n+ requester's group id\n+
count
\n+ read bytes\n
fh
\n file handle (the first part is the length of the file handle)\n-
size
\n- read bytes\n
version
\n nfs version\n-
offset
\n- the offset of file \n-
proto
\n- transfer protocol\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,35 +2,35 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfsd.proc.write \u2014 NFS server writing data to file for client\n ***** Synopsis *****\n nfsd.proc.write\n ***** Values *****\n- count\n- read bytes\n vec\n struct kvec, includes buf address in kernel address and length of each\n buffer\n+ size\n+ read bytes\n+ vlen\n+ read blocks\n+ offset\n+ the offset of file\n stable\n argp->stable\n+ proto\n+ transfer protocol\n uid\n requester's user id\n- gid\n- requester's group id\n client_ip\n the ip address of client\n- vlen\n- read blocks\n+ gid\n+ requester's group id\n+ count\n+ read bytes\n fh\n file handle (the first part is the length of the file handle)\n- size\n- read bytes\n version\n nfs version\n- offset\n- the offset of file\n- proto\n- transfer protocol\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfsd.proc.rename\u00a0Home \u00a0probe::nfsd.read\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-read.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-read.html", "unified_diff": "@@ -1,19 +1,19 @@\n probe::nfsd.read
probe::nfsd.read — \n NFS server reading data from a file for client\n-
Synopsis
nfsd.read
Values
size
\n- read bytes\n+
Synopsis
nfsd.read
Values
vlen
\n+ read blocks \n
offset
\n the offset of file \n-
count
\n- read bytes\n
file
\n argument file, indicates if the file has been opened.\n
vec
\n struct kvec, includes buf address in kernel address and length of each buffer\n+
size
\n+ read bytes\n
client_ip
\n the ip address of client\n+
count
\n+ read bytes\n
fh
\n file handle (the first part is the length of the file handle)\n-
vlen
\n- read blocks \n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,27 +2,27 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfsd.read \u2014 NFS server reading data from a file for client\n ***** Synopsis *****\n nfsd.read\n ***** Values *****\n- size\n- read bytes\n+ vlen\n+ read blocks\n offset\n the offset of file\n- count\n- read bytes\n file\n argument file, indicates if the file has been opened.\n vec\n struct kvec, includes buf address in kernel address and length of each\n buffer\n+ size\n+ read bytes\n client_ip\n the ip address of client\n+ count\n+ read bytes\n fh\n file handle (the first part is the length of the file handle)\n- vlen\n- read blocks\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfsd.proc.write\u00a0Home \u00a0probe::nfsd.rename\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-rename.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-rename.html", "unified_diff": "@@ -1,17 +1,17 @@\n probe::nfsd.rename
probe::nfsd.rename — \n NFS server renaming a file for client\n-
Synopsis
nfsd.rename
Values
filename
\n- old file name \n-
tname
\n- new file name\n-
fh
\n+
Synopsis
nfsd.rename
Values
fh
\n file handler of old path\n-
flen
\n- length of old file name \n-
client_ip
\n- the ip address of client\n
tlen
\n length of new file name\n
tfh
\n file handler of new path\n+
filename
\n+ old file name \n+
flen
\n+ length of old file name \n+
client_ip
\n+ the ip address of client\n+
tname
\n+ new file name\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,24 +2,24 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfsd.rename \u2014 NFS server renaming a file for client\n ***** Synopsis *****\n nfsd.rename\n ***** Values *****\n- filename\n- old file name\n- tname\n- new file name\n fh\n file handler of old path\n- flen\n- length of old file name\n- client_ip\n- the ip address of client\n tlen\n length of new file name\n tfh\n file handler of new path\n+ filename\n+ old file name\n+ flen\n+ length of old file name\n+ client_ip\n+ the ip address of client\n+ tname\n+ new file name\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfsd.read\u00a0Home \u00a0probe::nfsd.unlink\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-unlink.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-unlink.html", "unified_diff": "@@ -1,13 +1,13 @@\n probe::nfsd.unlink
probe::nfsd.unlink — \n NFS server removing a file or a directory for client\n-
Synopsis
nfsd.unlink
Values
filelen
\n+
Synopsis
nfsd.unlink
Values
filelen
\n the length of file name\n-
type
\n- file type (file or dir)\n
fh
\n file handle (the first part is the length of the file handle)\n-
client_ip
\n- the ip address of client\n
filename
\n file name \n+
client_ip
\n+ the ip address of client\n+
type
\n+ file type (file or dir)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,18 +4,18 @@\n ***** Name *****\n probe::nfsd.unlink \u2014 NFS server removing a file or a directory for client\n ***** Synopsis *****\n nfsd.unlink\n ***** Values *****\n filelen\n the length of file name\n- type\n- file type (file or dir)\n fh\n file handle (the first part is the length of the file handle)\n- client_ip\n- the ip address of client\n filename\n file name\n+ client_ip\n+ the ip address of client\n+ type\n+ file type (file or dir)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfsd.rename\u00a0Home \u00a0probe::nfsd.write\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-write.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfsd-write.html", "unified_diff": "@@ -1,19 +1,19 @@\n probe::nfsd.write
probe::nfsd.write — \n NFS server writing data to a file for client\n-
Synopsis
nfsd.write
Values
size
\n+
Synopsis
nfsd.write
Values
fh
\n+ file handle (the first part is the length of the file handle)\n+
count
\n read bytes\n+
client_ip
\n+ the ip address of client\n
offset
\n the offset of file \n-
fh
\n- file handle (the first part is the length of the file handle)\n
vlen
\n read blocks \n-
client_ip
\n- the ip address of client\n-
count
\n+
size
\n read bytes\n-
vec
\n- struct kvec, includes buf address in kernel address and length of each buffer\n
file
\n argument file, indicates if the file has been opened.\n+
vec
\n+ struct kvec, includes buf address in kernel address and length of each buffer\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,27 +2,27 @@\n Prev\u00a0Chapter\u00a031.\u00a0Network File Storage Tapset\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::nfsd.write \u2014 NFS server writing data to a file for client\n ***** Synopsis *****\n nfsd.write\n ***** Values *****\n- size\n+ fh\n+ file handle (the first part is the length of the file handle)\n+ count\n read bytes\n+ client_ip\n+ the ip address of client\n offset\n the offset of file\n- fh\n- file handle (the first part is the length of the file handle)\n vlen\n read blocks\n- client_ip\n- the ip address of client\n- count\n+ size\n read bytes\n+ file\n+ argument file, indicates if the file has been opened.\n vec\n struct kvec, includes buf address in kernel address and length of each\n buffer\n- file\n- argument file, indicates if the file has been opened.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::nfsd.unlink\u00a0Home \u00a0Chapter\u00a032.\u00a0Speculation\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-nfsderror.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-nfsderror.html", "unified_diff": "@@ -1,10 +1,10 @@\n function::nfsderror
function::ngroups — \n Number of subexpressions in the last match.\n
Synopsis
\n ngroups:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n returns the number of subexpressions from the\n last successful use of the =~ regex matching operator.\n
\n \n Note that this number includes subexpressions which are present in\n the regex but did not match any string; for example, given the\n regex “a|(b)”, the subexpressions will count the group for (b)\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-ns-egid.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-ns-egid.html", "unified_diff": "@@ -1,9 +1,9 @@\n
function::ns_euid — \n Returns the effective user ID of a target process as seen in a user namespace\n
Synopsis
\n ns_euid:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function returns the effective user ID of the target process as seen in the target user namespace if provided, or the stap process namespace.\n
function::ns_pgrp — \n Returns the process group ID of the current process as seen in a pid namespace\n
Synopsis
\n ns_pgrp:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function returns the process group ID of the\n current process as seen in the target pid namespace if provided, or the stap process namespace.\n
function::ns_ppid — \n Returns the process ID of a target process's parent process as seen in a pid namespace\n
Synopsis
\n ns_ppid:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function return the process ID of the target proccess's parent process as seen in the target pid namespace if provided, or the stap process namespace.\n
function::ns_sid — \n Returns the session ID of the current process as seen in a pid namespace\n
Synopsis
\n ns_sid:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n The namespace-aware session ID of a process is the process group ID\n of the session leader as seen in the target pid namespace if provided, or the stap process namespace. Session ID is stored in the signal_struct\n since Kernel 2.6.0.\n
function::nsecs_to_string — \n Human readable string for given nanoseconds\n
Synopsis
\n nsecs_to_string:string(nsecs:long)\n-
Arguments
nsecs
\n+
Arguments
nsecs
\n Number of nanoseconds to translate.\n-
Description
\n+
Description
\n Returns a string representing the number of\n nanoseconds as a human readable string consisting of “XmY.ZZZZZZs”,\n where X is the number of minutes, Y is the number of seconds and\n ZZZZZZZZZ is the number of nanoseconds.\n
\n This function returns the script-level probe point\n associated with a currently running probe handler, including\n wild-card expansion effects. Context: The current probe point.\n
function::pnlabel — \n Returns the label name parsed from the probe name\n
Synopsis
\n pnlabel:string()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This returns the label name as parsed from the\n script-level probe point. This function will only work if called\n directly from the body of a '.label' probe point (i.e. no aliases).\n-
function::pp — \n Returns the active probe point\n
Synopsis
\n pp:string()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function returns the fully-resolved probe point\n associated with a currently running probe handler, including alias\n and wild-card expansion effects. Context: The current probe point.\n
function::print_backtrace_fileline — \n Print kernel stack back trace\n
Synopsis
\n print_backtrace_fileline()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function is equivalent to print_backtrace, but output\n for each symbol is longer including file names and line numbers.\n The function does not return a value.\n
function::print_backtrace — \n Print kernel stack back trace\n
Synopsis
\n print_backtrace()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function is equivalent to print_stack(backtrace), \n except that deeper stack nesting may be supported. See print_ubacktrace\n for user-space backtrace.\n The function does not return a value.\n
function::print_stack — \n Print out kernel stack from string\n
Synopsis
\n print_stack(stk:string)\n-
Arguments
stk
\n+
Arguments
stk
\n String with list of hexadecimal addresses\n-
Description
\n+
Description
\n This function performs a symbolic lookup of the addresses\n in the given string,\n which is assumed to be the result of a prior call to \n backtrace.\n
\n \n Print one line per address, including the address, the\n name of the function containing the address, and an estimate of\n its position within that function. Return nothing.\n-
NOTE
\n+
NOTE
\n it is recommended to use print_syms instead of this function.\n
function::print_syms — \n Print out kernel stack from string\n
Synopsis
\n print_syms(callers:string)\n-
Arguments
callers
\n+
Arguments
callers
\n String with list of hexadecimal (kernel) addresses\n-
Description
\n+
Description
\n This function performs a symbolic lookup of the addresses\n in the given string,\n which are assumed to be the result of prior calls to stack,\n callers, and similar functions.\n
\n \n Prints one line per address, including the address, the\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-print-ubacktrace-brief.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-print-ubacktrace-brief.html", "unified_diff": "@@ -1,17 +1,17 @@\n
function::print_ubacktrace_brief — \n Print stack back trace for current user-space task.\n
Synopsis
\n print_ubacktrace_brief()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n
\n \n Equivalent to print_ubacktrace, but output for each symbol is\n shorter (just name and offset, or just the hex address of no symbol\n could be found).\n-
Note
\n+
Note
\n To get (full) backtraces for user space applications and shared\n shared libraries not mentioned in the current script run stap with\n -d /path/to/exe-or-so and/or add --ldd to load all needed unwind data.\n
2) Equivalent toprint_ubacktrace, but output for each symbol is\n+
Description
1)
2) Equivalent toprint_ubacktrace, but output for each symbol is\n longer including file names and line numbers.\n
\n Equivalent to print_ubacktrace_fileline, but it performs the backtrace\n using the pc, sp, and fp passed in.\n-
Note
\n+
Note
\n To get (full) backtraces for user space applications and shared\n shared libraries not mentioned in the current script run stap with\n -d /path/to/exe-or-so and/or add --ldd to load all needed unwind data.\n
function::print_ubacktrace — \n Print stack back trace for current user-space task.\n-
Synopsis
1) print_ubacktrace()
2) print_ubacktrace(pc:long,sp:long,fp:long)
Arguments
pc
\n+
Synopsis
1) print_ubacktrace()
2) print_ubacktrace(pc:long,sp:long,fp:long)
Arguments
pc
\n override PC\n
sp
\n override SP\n
fp
\n override FP\n-
Description
1)
2) Equivalent to print_ustack(ubacktrace), except that deeper stack\n+
Description
1)
2) Equivalent to print_ustack(ubacktrace), except that deeper stack\n nesting may be supported. Returns nothing. See print_backtrace\n for kernel backtrace.\n
\n Equivalent to print_ubacktrace, but it performs the backtrace\n using the pc, sp, and fp provided. Useful \n-
Note
\n+
Note
\n To get (full) backtraces for user space applications and shared\n shared libraries not mentioned in the current script run stap with\n -d /path/to/exe-or-so and/or add --ldd to load all needed unwind data.\n
function::print_ustack — \n Print out stack for the current task from string.\n
Synopsis
\n print_ustack(stk:string)\n-
Arguments
stk
\n+
Arguments
stk
\n String with list of hexadecimal addresses for the current task.\n-
Description
\n+
Description
\n Perform a symbolic lookup of the addresses in the given string,\n which is assumed to be the result of a prior call to \n ubacktrace for the current task.\n
\n \n Print one line per address, including the address, the\n name of the function containing the address, and an estimate of\n its position within that function. Return nothing.\n-
NOTE
\n+
NOTE
\n it is recommended to use print_usyms instead of this function.\n
function::print_usyms — \n Print out user stack from string\n
Synopsis
\n print_usyms(callers:string)\n-
Arguments
callers
\n+
Arguments
callers
\n String with list of hexadecimal (user) addresses\n-
Description
\n+
Description
\n This function performs a symbolic lookup of the addresses\n in the given string,\n which are assumed to be the result of prior calls to ustack,\n ucallers, and similar functions.\n
\n \n Prints one line per address, including the address, the\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-printk.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-printk.html", "unified_diff": "@@ -1,14 +1,14 @@\n
function::printk — \n Send a message to the kernel trace buffer\n
Synopsis
\n printk(level:long,msg:string)\n-
Arguments
level
\n+
Arguments
level
\n an integer for the severity level (0=KERN_EMERG ... 7=KERN_DEBUG)\n
msg
\n The formatted message string\n-
Description
\n+
Description
\n Print a line of text to the kernel dmesg/console with the\n given severity. An implicit end-of-line is added. This function may \n not be safely called from all kernel probe contexts, so is restricted\n to guru mode only.\n
function::probe_type — \n The low level probe handler type of the current probe.\n
Synopsis
\n probe_type:string()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n Returns a short string describing the low level probe handler\n type for the current probe point. This is for informational purposes only.\n Depending on the low level probe handler different context functions can\n or cannot provide information about the current event (for example some\n probe handlers only trigger in user space and have no associated kernel\n context). High-level probes might map to the same or different low-level\n probes (depending on systemtap version and/or kernel used).\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-probefunc.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-probefunc.html", "unified_diff": "@@ -1,19 +1,19 @@\n
function::probefunc — \n Return the probe point's function name, if known\n
Synopsis
\n probefunc:string()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function returns the name of the function being probed\n based on the current address, as computed by symname(addr) or\n usymname(uaddr) depending on probe context (whether the probe is\n a user probe or a kernel probe).\n-
Please note
\n+
Please note
\n this function's behaviour differs between SystemTap 2.0\n and earlier versions. Prior to 2.0, probefunc obtained the function\n name from the probe point string as returned by pp, and used the\n current address as a fallback.\n
function::proc_mem_data — \n Program data size (data + stack) in pages\n-
Synopsis
1) proc_mem_data:long()
2) proc_mem_data:long(pid:long)
Arguments
pid
\n+
Synopsis
1) proc_mem_data:long()
2) proc_mem_data:long(pid:long)
Arguments
pid
\n The pid of process to examine\n-
Description
1) Returns the current process data size (data + stack)\n+
Description
1) Returns the current process data size (data + stack)\n in pages, or zero when there is no current process or the number of\n pages couldn't be retrieved.
2) Returns the given process data size (data + stack)\n in pages, or zero when the process doesn't exist or the number of\n pages couldn't be retrieved.
function::proc_mem_rss — \n Program resident set size in pages\n-
Synopsis
1) proc_mem_rss:long()
2) proc_mem_rss:long(pid:long)
Arguments
pid
\n+
Synopsis
1) proc_mem_rss:long()
2) proc_mem_rss:long(pid:long)
Arguments
pid
\n The pid of process to examine\n-
Description
1) Returns the resident set size in pages of the current\n+
Description
1) Returns the resident set size in pages of the current\n process, or zero when there is no current process or the number of\n pages couldn't be retrieved.
2) Returns the resident set size in pages of the given\n process, or zero when the process doesn't exist or the number of\n pages couldn't be retrieved.
function::proc_mem_shr — \n Program shared pages (from shared mappings)\n-
Synopsis
1) proc_mem_shr:long()
2) proc_mem_shr:long(pid:long)
Arguments
pid
\n+
Synopsis
1) proc_mem_shr:long()
2) proc_mem_shr:long(pid:long)
Arguments
pid
\n The pid of process to examine\n-
Description
1) Returns the shared pages (from shared mappings) of the\n+
Description
1) Returns the shared pages (from shared mappings) of the\n current process, or zero when there is no current process or the\n number of pages couldn't be retrieved.
2) Returns the shared pages (from shared mappings) of the\n given process, or zero when the process doesn't exist or the\n number of pages couldn't be retrieved.
function::proc_mem_size — \n Total program virtual memory size in pages\n-
Synopsis
1) proc_mem_size:long()
2) proc_mem_size:long(pid:long)
Arguments
pid
\n+
Synopsis
1) proc_mem_size:long()
2) proc_mem_size:long(pid:long)
Arguments
pid
\n The pid of process to examine\n-
Description
1) Returns the total virtual memory size in pages of the\n+
Description
1) Returns the total virtual memory size in pages of the\n current process, or zero when there is no current process or the\n number of pages couldn't be retrieved.
2) Returns the total virtual memory size in pages of the\n given process, or zero when that process doesn't exist or the\n number of pages couldn't be retrieved.
function::proc_mem_string — \n Human readable string of process memory usage\n-
Synopsis
1) proc_mem_string:string()
2) proc_mem_string:string(pid:long)
Arguments
pid
\n+
Synopsis
1) proc_mem_string:string()
2) proc_mem_string:string(pid:long)
Arguments
pid
\n The pid of process to examine\n-
Description
1) Returns a human readable string showing the size, rss,\n+
Description
1) Returns a human readable string showing the size, rss,\n shr, txt and data of the memory used by the current process.\n For example“size: 301m, rss: 11m, shr: 8m, txt: 52k, data: 2248k”.\n
2) Returns a human readable string showing the size, rss,\n shr, txt and data of the memory used by the given process.\n For example“size: 301m, rss: 11m, shr: 8m, txt: 52k, data: 2248k”.\n
function::pstrace — \n Chain of processes and pids back to init(1)\n
Synopsis
\n pstrace:string(task:long)\n-
Arguments
task
\n+
Arguments
task
\n Pointer to task struct of process\n-
Description
\n+
Description
\n This function returns a string listing execname and pid for each\n process starting from task back to the process ancestor\n that init(1) spawned.\n
function::qsq_print — \n Prints a line of statistics for the given queue\n
Synopsis
\n qsq_print(qname:string)\n-
Arguments
qname
\n+
Arguments
qname
\n queue name\n-
Description
\n+
Description
\n This function prints a line containing the following\n-
statistics for the given queue
\n+
statistics for the given queue
\n the queue name, \n the average rate of requests per second,\n the average wait queue length,\n the average time on the wait queue,\n the average time to service a request,\n the percentage of time the wait queue was used, \n and the percentage of time request was being serviced.\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-qsq-service-time.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-qsq-service-time.html", "unified_diff": "@@ -1,12 +1,12 @@\n
function::qsq_start — \n Function to reset the stats for a queue\n
Synopsis
\n qsq_start(qname:string)\n-
Arguments
qname
\n+
Arguments
qname
\n the name of the service that finished \n-
Description
\n+
Description
\n This function resets the statistics counters for the given\n queue, and restarts tracking from the moment the function was called.\n This function is also used to create intialize a queue.\n
function::raise — \n raise a signal in the current thread\n
Synopsis
\n raise(signo:long)\n-
Arguments
signo
\n+
Arguments
signo
\n signal number\n-
Description
\n+
Description
\n This function calls the kernel send_sig routine on\n the current thread, with the given raw unchecked signal number.\n It may raise an error if send_sig failed.\n It requires guru mode.\n
function::register — \n Return the signed value of the named CPU register\n
Synopsis
\n register:long(name:string)\n-
Arguments
name
\n+
Arguments
name
\n Name of the register to return\n-
Description
\n+
Description
\n Return the value of the named CPU register,\n as it was saved when the current probe point was hit.\n If the register is 32 bits, it is sign-extended to 64 bits.\n
\n \n For the i386 architecture, the following names are recognized.\n (name1/name2 indicates that name1 and name2 are alternative names\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-registers-valid.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-registers-valid.html", "unified_diff": "@@ -1,12 +1,12 @@\n
function::registers_valid — \n Determines validity of register and u_register in current context\n
Synopsis
\n registers_valid:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function returns 1 if register and u_register\n can be used in the current context, or 0 otherwise.\n For example, registers_valid returns 0\n when called from a begin or end probe.\n
function::regparm — \n Specify regparm value used to compile function\n
Synopsis
\n regparm(n:long)\n-
Arguments
n
\n+
Arguments
n
\n original regparm value\n-
Description
\n+
Description
\n Call this function with argument n before accessing function\n arguments using the *_arg function is the function was build with the\n gcc -mregparm=n option.\n
\n \n (The i386 kernel is built with \\-mregparm=3, so systemtap considers\n regparm(3) the default for kernel functions on that architecture.)\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-remote-id.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-remote-id.html", "unified_diff": "@@ -1,14 +1,14 @@\n
function::remote_id — \n The index of this instance in a remote execution.\n
Synopsis
\n remote_id:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function returns a number 0..N, which is the unique\n index of this particular script execution from a swarm of\n “stap --remote A --remote B ...” runs, and is the same number\n “stap --remote-prefix” would print. The function returns -1 if the\n script was not launched with “stap --remote”, or if the remote\n staprun/stapsh are older than version 1.7.\n
function::remote_uri — \n The name of this instance in a remote execution.\n
Synopsis
\n remote_uri:string()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function returns the remote host used to invoke\n this particular script execution from a swarm of “stap --remote” runs.\n It may not be unique among the swarm.\n The function returns an empty string if the script was not launched with\n “stap --remote”.\n
function::returnstr — \n Formats the return value as a string\n
Synopsis
\n returnstr:string(format:long)\n-
Arguments
format
\n+
Arguments
format
\n Variable to determine return type base value\n-
Description
\n+
Description
\n This function is used by the nd_syscall tapset, and \n returns a string. Set format equal to 1 for a decimal, \n 2 for hex, 3 for octal.\n
\n \n Note that this function should only be used in dwarfless probes\n (i.e. 'kprobe.function(“foo”)'). Other probes should use\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-returnval.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-returnval.html", "unified_diff": "@@ -1,12 +1,12 @@\n
function::returnval — \n Possible return value of probed function\n
Synopsis
\n returnval:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n Return the value of the register in which function values\n are typically returned. Can be used in probes where $return isn't\n available. This is only a guess of the actual return value and can be\n totally wrong. Normally only used in dwarfless probes.\n
probe::scheduler.cpu_off — \n Process is about to stop running on a cpu\n-
Synopsis
scheduler.cpu_off
Values
task_next
\n- the process replacing current\n-
task_prev
\n- the process leaving the cpu (same as current)\n-
name
\n+
Synopsis
scheduler.cpu_off
Values
name
\n name of the probe point\n
idle
\n boolean indicating whether current is the idle process\n-
Context
\n+
task_next
\n+ the process replacing current\n+
task_prev
\n+ the process leaving the cpu (same as current)\n+
Context
\n The process leaving the cpu.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,20 +2,20 @@\n Prev\u00a0Chapter\u00a08.\u00a0Scheduler Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::scheduler.cpu_off \u2014 Process is about to stop running on a cpu\n ***** Synopsis *****\n scheduler.cpu_off\n ***** Values *****\n- task_next\n- the process replacing current\n- task_prev\n- the process leaving the cpu (same as current)\n name\n name of the probe point\n idle\n boolean indicating whether current is the idle process\n+ task_next\n+ the process replacing current\n+ task_prev\n+ the process leaving the cpu (same as current)\n ***** Context *****\n The process leaving the cpu.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::scheduler.balance\u00a0Home \u00a0probe::scheduler.cpu_on\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-cpu-on.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-cpu-on.html", "unified_diff": "@@ -1,11 +1,11 @@\n probe::scheduler.cpu_on
probe::scheduler.cpu_on — \n Process is beginning execution on a cpu\n-
Synopsis
scheduler.cpu_on
Values
idle
\n- - boolean indicating whether current is the idle process\n-
task_prev
\n+
Synopsis
scheduler.cpu_on
Values
task_prev
\n the process that was previously running on this cpu\n+
idle
\n+ - boolean indicating whether current is the idle process\n
name
\n name of the probe point\n-
Context
\n+
Context
\n The resuming process.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a08.\u00a0Scheduler Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::scheduler.cpu_on \u2014 Process is beginning execution on a cpu\n ***** Synopsis *****\n scheduler.cpu_on\n ***** Values *****\n- idle\n- - boolean indicating whether current is the idle process\n task_prev\n the process that was previously running on this cpu\n+ idle\n+ - boolean indicating whether current is the idle process\n name\n name of the probe point\n ***** Context *****\n The resuming process.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::scheduler.cpu_off\u00a0Home \u00a0probe::scheduler.ctxswitch\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-ctxswitch.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-ctxswitch.html", "unified_diff": "@@ -1,25 +1,25 @@\n probe::scheduler.ctxswitch
probe::scheduler.ctxswitch — \n A context switch is occuring.\n-
Synopsis
scheduler.ctxswitch
Values
next_tid
\n- The TID of the process to be switched in\t \n-
prev_tid
\n- The TID of the process to be switched out\n-
name
\n- name of the probe point\n-
prevtsk_state
\n+
Synopsis
scheduler.ctxswitch
Values
prevtsk_state
\n the state of the process to be switched out\n
nexttsk_state
\n the state of the process to be switched in\n
prev_task_name
\n The name of the process to be switched out\n-
next_task_name
\n- The name of the process to be switched in\n-
prev_priority
\n- The priority of the process to be switched out\n-
next_pid
\n- The PID of the process to be switched in\n+
prev_tid
\n+ The TID of the process to be switched out\n
prev_pid
\n The PID of the process to be switched out\n+
name
\n+ name of the probe point\n
next_priority
\n The priority of the process to be switched in\n+
next_task_name
\n+ The name of the process to be switched in\n+
next_tid
\n+ The TID of the process to be switched in\t \n+
next_pid
\n+ The PID of the process to be switched in\n+
prev_priority
\n+ The priority of the process to be switched out\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,32 +2,32 @@\n Prev\u00a0Chapter\u00a08.\u00a0Scheduler Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::scheduler.ctxswitch \u2014 A context switch is occuring.\n ***** Synopsis *****\n scheduler.ctxswitch\n ***** Values *****\n- next_tid\n- The TID of the process to be switched in\n- prev_tid\n- The TID of the process to be switched out\n- name\n- name of the probe point\n prevtsk_state\n the state of the process to be switched out\n nexttsk_state\n the state of the process to be switched in\n prev_task_name\n The name of the process to be switched out\n- next_task_name\n- The name of the process to be switched in\n- prev_priority\n- The priority of the process to be switched out\n- next_pid\n- The PID of the process to be switched in\n+ prev_tid\n+ The TID of the process to be switched out\n prev_pid\n The PID of the process to be switched out\n+ name\n+ name of the probe point\n next_priority\n The priority of the process to be switched in\n+ next_task_name\n+ The name of the process to be switched in\n+ next_tid\n+ The TID of the process to be switched in\n+ next_pid\n+ The PID of the process to be switched in\n+ prev_priority\n+ The priority of the process to be switched out\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::scheduler.cpu_on\u00a0Home \u00a0probe::scheduler.kthread_stop\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-kthread-stop-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-kthread-stop-return.html", "unified_diff": "@@ -1,7 +1,7 @@\n probe::scheduler.kthread_stop.return
probe::scheduler.kthread_stop — \n A thread created by kthread_create is being stopped\n-
Synopsis
scheduler.kthread_stop
Values
thread_pid
\n- PID of the thread being stopped\n-
thread_priority
\n+
Synopsis
scheduler.kthread_stop
Values
thread_priority
\n priority of the thread\n+
thread_pid
\n+ PID of the thread being stopped\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,14 +3,14 @@\n ===============================================================================\n ***** Name *****\n probe::scheduler.kthread_stop \u2014 A thread created by kthread_create is being\n stopped\n ***** Synopsis *****\n scheduler.kthread_stop\n ***** Values *****\n- thread_pid\n- PID of the thread being stopped\n thread_priority\n priority of the thread\n+ thread_pid\n+ PID of the thread being stopped\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::scheduler.ctxswitch\u00a0Home \u00a0probe::scheduler.kthread_stop.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-migrate.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-migrate.html", "unified_diff": "@@ -1,15 +1,15 @@\n probe::scheduler.migrate
probe::scheduler.migrate — \n Task migrating across cpus\n-
Synopsis
scheduler.migrate
Values
task
\n- the process that is being migrated\n-
priority
\n- priority of the task being migrated\n-
name
\n- name of the probe point\n-
pid
\n+
Synopsis
scheduler.migrate
Values
pid
\n PID of the task being migrated\n+
task
\n+ the process that is being migrated\n
cpu_from
\n the original cpu\n+
name
\n+ name of the probe point\n
cpu_to
\n the destination cpu\n+
priority
\n+ priority of the task being migrated\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,22 +2,22 @@\n Prev\u00a0Chapter\u00a08.\u00a0Scheduler Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::scheduler.migrate \u2014 Task migrating across cpus\n ***** Synopsis *****\n scheduler.migrate\n ***** Values *****\n- task\n- the process that is being migrated\n- priority\n- priority of the task being migrated\n- name\n- name of the probe point\n pid\n PID of the task being migrated\n+ task\n+ the process that is being migrated\n cpu_from\n the original cpu\n+ name\n+ name of the probe point\n cpu_to\n the destination cpu\n+ priority\n+ priority of the task being migrated\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::scheduler.kthread_stop.return\u00a0Home \u00a0probe::scheduler.process_exit\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-process-exit.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-process-exit.html", "unified_diff": "@@ -1,9 +1,9 @@\n probe::scheduler.process_exit
probe::scheduler.process_exit — \n Process exiting\n-
Synopsis
scheduler.process_exit
Values
pid
\n+
Synopsis
scheduler.process_exit
Values
priority
\n+ priority of the process exiting\n+
pid
\n PID of the process exiting\n
name
\n name of the probe point\n-
priority
\n- priority of the process exiting\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,16 +2,16 @@\n Prev\u00a0Chapter\u00a08.\u00a0Scheduler Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::scheduler.process_exit \u2014 Process exiting\n ***** Synopsis *****\n scheduler.process_exit\n ***** Values *****\n+ priority\n+ priority of the process exiting\n pid\n PID of the process exiting\n name\n name of the probe point\n- priority\n- priority of the process exiting\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::scheduler.migrate\u00a0Home \u00a0probe::scheduler.process_fork\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-process-fork.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-process-fork.html", "unified_diff": "@@ -1,9 +1,9 @@\n probe::scheduler.process_fork
probe::scheduler.process_free — \n Scheduler freeing a data structure for a process\n-
Synopsis
scheduler.process_free
Values
name
\n+
Synopsis
scheduler.process_free
Values
priority
\n+ priority of the process getting freed\n+
name
\n name of the probe point\n
pid
\n PID of the process getting freed\n-
priority
\n- priority of the process getting freed\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,16 +3,16 @@\n ===============================================================================\n ***** Name *****\n probe::scheduler.process_free \u2014 Scheduler freeing a data structure for a\n process\n ***** Synopsis *****\n scheduler.process_free\n ***** Values *****\n+ priority\n+ priority of the process getting freed\n name\n name of the probe point\n pid\n PID of the process getting freed\n- priority\n- priority of the process getting freed\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::scheduler.process_fork\u00a0Home \u00a0probe::scheduler.process_wait\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-process-wait.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-process-wait.html", "unified_diff": "@@ -1,7 +1,7 @@\n probe::scheduler.process_wait
probe::scheduler.process_wait — \n Scheduler starting to wait on a process\n-
Synopsis
scheduler.process_wait
Values
name
\n- name of the probe point\n-
pid
\n+
Synopsis
scheduler.process_wait
Values
pid
\n PID of the process scheduler is waiting on\n+
name
\n+ name of the probe point\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,14 +2,14 @@\n Prev\u00a0Chapter\u00a08.\u00a0Scheduler Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::scheduler.process_wait \u2014 Scheduler starting to wait on a process\n ***** Synopsis *****\n scheduler.process_wait\n ***** Values *****\n- name\n- name of the probe point\n pid\n PID of the process scheduler is waiting on\n+ name\n+ name of the probe point\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::scheduler.process_free\u00a0Home \u00a0probe::scheduler.signal_send\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-signal-send.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-signal-send.html", "unified_diff": "@@ -1,9 +1,9 @@\n probe::scheduler.signal_send
probe::scheduler.tick — \n Schedulers internal tick, a processes timeslice accounting is updated\n-
Synopsis
scheduler.tick
Values
idle
\n- boolean indicating whether current is the idle process\n-
name
\n+
Synopsis
scheduler.tick
Values
name
\n name of the probe point\n-
Context
\n+
idle
\n+ boolean indicating whether current is the idle process\n+
Context
\n The process whose accounting will be updated.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,16 +3,16 @@\n ===============================================================================\n ***** Name *****\n probe::scheduler.tick \u2014 Schedulers internal tick, a processes timeslice\n accounting is updated\n ***** Synopsis *****\n scheduler.tick\n ***** Values *****\n- idle\n- boolean indicating whether current is the idle process\n name\n name of the probe point\n+ idle\n+ boolean indicating whether current is the idle process\n ***** Context *****\n The process whose accounting will be updated.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::scheduler.signal_send\u00a0Home \u00a0probe::scheduler.wait_task\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-wait-task.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-wait-task.html", "unified_diff": "@@ -1,9 +1,9 @@\n probe::scheduler.wait_task
probe::scheduler.wait_task — \n Waiting on a task to unschedule (become inactive)\n-
Synopsis
scheduler.wait_task
Values
name
\n+
Synopsis
scheduler.wait_task
Values
name
\n name of the probe point\n-
task_pid
\n- PID of the task the scheduler is waiting on\n
task_priority
\n priority of the task\n+
task_pid
\n+ PID of the task the scheduler is waiting on\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,14 +4,14 @@\n ***** Name *****\n probe::scheduler.wait_task \u2014 Waiting on a task to unschedule (become inactive)\n ***** Synopsis *****\n scheduler.wait_task\n ***** Values *****\n name\n name of the probe point\n- task_pid\n- PID of the task the scheduler is waiting on\n task_priority\n priority of the task\n+ task_pid\n+ PID of the task the scheduler is waiting on\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::scheduler.tick\u00a0Home \u00a0probe::scheduler.wakeup\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-wakeup-new.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-wakeup-new.html", "unified_diff": "@@ -1,15 +1,15 @@\n probe::scheduler.wakeup_new
probe::scheduler.wakeup_new — \n Newly created task is woken up for the first time\n-
Synopsis
scheduler.wakeup_new
Values
task_tid
\n- TID of the new task woken up\n-
task_cpu
\n- cpu of the task woken up\n+
Synopsis
scheduler.wakeup_new
Values
name
\n+ name of the probe point\n
task_state
\n state of the task woken up\n+
task_cpu
\n+ cpu of the task woken up\n
task_priority
\n priority of the new task\n+
task_tid
\n+ TID of the new task woken up\n
task_pid
\n PID of the new task woken up\n-
name
\n- name of the probe point\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,22 +2,22 @@\n Prev\u00a0Chapter\u00a08.\u00a0Scheduler Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::scheduler.wakeup_new \u2014 Newly created task is woken up for the first time\n ***** Synopsis *****\n scheduler.wakeup_new\n ***** Values *****\n- task_tid\n- TID of the new task woken up\n- task_cpu\n- cpu of the task woken up\n+ name\n+ name of the probe point\n task_state\n state of the task woken up\n+ task_cpu\n+ cpu of the task woken up\n task_priority\n priority of the new task\n+ task_tid\n+ TID of the new task woken up\n task_pid\n PID of the new task woken up\n- name\n- name of the probe point\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::scheduler.wakeup\u00a0Home \u00a0Chapter\u00a09.\u00a0IO Scheduler and block IO Tapset\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-wakeup.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-scheduler-wakeup.html", "unified_diff": "@@ -1,15 +1,15 @@\n probe::scheduler.wakeup
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,22 +2,22 @@\n Prev\u00a0Chapter\u00a08.\u00a0Scheduler Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::scheduler.wakeup \u2014 Task is woken up\n ***** Synopsis *****\n scheduler.wakeup\n ***** Values *****\n- name\n- name of the probe point\n- task_pid\n- PID of the task being woken up\n- task_state\n- state of the task being woken up\n- task_priority\n- priority of the task being woken up\n task_tid\n tid of the task being woken up\n+ task_pid\n+ PID of the task being woken up\n task_cpu\n cpu of the task being woken up\n+ task_priority\n+ priority of the task being woken up\n+ task_state\n+ state of the task being woken up\n+ name\n+ name of the probe point\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::scheduler.wait_task\u00a0Home \u00a0probe::scheduler.wakeup_new\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-scsi-iocompleted.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-scsi-iocompleted.html", "unified_diff": "@@ -1,24 +1,24 @@\n probe::scsi.iocompleted
probe::scsi.iocompleted — \n SCSI mid-layer running the completion processing for block device I/O requests\n-
Synopsis
scsi.iocompleted
Values
goodbytes
\n- The bytes completed\n-
channel
\n- The channel number\n-
lun
\n+
Synopsis
scsi.iocompleted
Values
lun
\n The lun number\n-
host_no
\n- The host number\n-
req_addr
\n- The current struct request pointer, as a number\n
device_state_str
\n The current state of the device, as a string\n-
device_state
\n- The current state of the device\n+
data_direction
\n+ The data_direction specifies whether this command is from/to\n+ the device\n+
req_addr
\n+ The current struct request pointer, as a number\n+
channel
\n+ The channel number\n
dev_id
\n The scsi device id\n+
host_no
\n+ The host number\n
data_direction_str
\n Data direction, as a string\n-
data_direction
\n- The data_direction specifies whether this command is from/to\n- the device\n+
device_state
\n+ The current state of the device\n+
goodbytes
\n+ The bytes completed\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,30 +3,30 @@\n ===============================================================================\n ***** Name *****\n probe::scsi.iocompleted \u2014 SCSI mid-layer running the completion processing for\n block device I/O requests\n ***** Synopsis *****\n scsi.iocompleted\n ***** Values *****\n- goodbytes\n- The bytes completed\n- channel\n- The channel number\n lun\n The lun number\n- host_no\n- The host number\n- req_addr\n- The current struct request pointer, as a number\n device_state_str\n The current state of the device, as a string\n- device_state\n- The current state of the device\n+ data_direction\n+ The data_direction specifies whether this command is from/to the device\n+ req_addr\n+ The current struct request pointer, as a number\n+ channel\n+ The channel number\n dev_id\n The scsi device id\n+ host_no\n+ The host number\n data_direction_str\n Data direction, as a string\n- data_direction\n- The data_direction specifies whether this command is from/to the device\n+ device_state\n+ The current state of the device\n+ goodbytes\n+ The bytes completed\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n Chapter\u00a010.\u00a0SCSI TapsetHome \u00a0probe::scsi.iodispatching\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-scsi-iodispatching.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-scsi-iodispatching.html", "unified_diff": "@@ -1,27 +1,27 @@\n probe::scsi.iodispatching
\n The current struct request pointer, as a number\n
device_state_str
\n The current state of the device, as a string\n-
device_state
\n- The current state of the device\n-
dev_id
\n- The scsi device id\n-
data_direction_str
\n- Data direction, as a string\n
data_direction
\n The data_direction specifies whether this command is from/to the device\n 0 (DMA_BIDIRECTIONAL), 1 (DMA_TO_DEVICE),\n 2 (DMA_FROM_DEVICE), 3 (DMA_NONE)\n+
lun
\n+ The lun number\n+
request_buffer
\n+ The request buffer address\n+
device_state
\n+ The current state of the device\n+
host_no
\n+ The host number\n+
data_direction_str
\n+ Data direction, as a string\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,33 +2,33 @@\n Prev\u00a0Chapter\u00a010.\u00a0SCSI Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::scsi.iodispatching \u2014 SCSI mid-layer dispatched low-level SCSI command\n ***** Synopsis *****\n scsi.iodispatching\n ***** Values *****\n- request_bufflen\n- The request buffer length\n- request_buffer\n- The request buffer address\n channel\n The channel number\n- lun\n- The lun number\n- host_no\n- The host number\n+ dev_id\n+ The scsi device id\n+ request_bufflen\n+ The request buffer length\n req_addr\n The current struct request pointer, as a number\n device_state_str\n The current state of the device, as a string\n+ data_direction\n+ The data_direction specifies whether this command is from/to the device 0\n+ (DMA_BIDIRECTIONAL), 1 (DMA_TO_DEVICE), 2 (DMA_FROM_DEVICE), 3 (DMA_NONE)\n+ lun\n+ The lun number\n+ request_buffer\n+ The request buffer address\n device_state\n The current state of the device\n- dev_id\n- The scsi device id\n+ host_no\n+ The host number\n data_direction_str\n Data direction, as a string\n- data_direction\n- The data_direction specifies whether this command is from/to the device 0\n- (DMA_BIDIRECTIONAL), 1 (DMA_TO_DEVICE), 2 (DMA_FROM_DEVICE), 3 (DMA_NONE)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::scsi.iocompleted\u00a0Home \u00a0probe::scsi.iodone\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-scsi-iodone.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-scsi-iodone.html", "unified_diff": "@@ -1,24 +1,24 @@\n probe::scsi.iodone
probe::scsi.iodone — \n SCSI command completed by low level driver and enqueued into the done queue.\n-
Synopsis
scsi.iodone
Values
device_state
\n- The current state of the device\n-
device_state_str
\n- The current state of the device, as a string\n-
scsi_timer_pending
\n- 1 if a timer is pending on this request\n-
host_no
\n- The host number\n+
Synopsis
scsi.iodone
Values
dev_id
\n+ The scsi device id\n+
channel
\n+ The channel number\n
req_addr
\n The current struct request pointer, as a number\n+
lun
\n+ The lun number\n
data_direction
\n The data_direction specifies whether this command is\n from/to the device.\n+
device_state_str
\n+ The current state of the device, as a string\n+
device_state
\n+ The current state of the device\n+
scsi_timer_pending
\n+ 1 if a timer is pending on this request\n
data_direction_str
\n Data direction, as a string\n-
dev_id
\n- The scsi device id\n-
lun
\n- The lun number\n-
channel
\n- The channel number\n+
host_no
\n+ The host number\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,30 +3,30 @@\n ===============================================================================\n ***** Name *****\n probe::scsi.iodone \u2014 SCSI command completed by low level driver and enqueued\n into the done queue.\n ***** Synopsis *****\n scsi.iodone\n ***** Values *****\n- device_state\n- The current state of the device\n- device_state_str\n- The current state of the device, as a string\n- scsi_timer_pending\n- 1 if a timer is pending on this request\n- host_no\n- The host number\n+ dev_id\n+ The scsi device id\n+ channel\n+ The channel number\n req_addr\n The current struct request pointer, as a number\n+ lun\n+ The lun number\n data_direction\n The data_direction specifies whether this command is from/to the device.\n+ device_state_str\n+ The current state of the device, as a string\n+ device_state\n+ The current state of the device\n+ scsi_timer_pending\n+ 1 if a timer is pending on this request\n data_direction_str\n Data direction, as a string\n- dev_id\n- The scsi device id\n- lun\n- The lun number\n- channel\n- The channel number\n+ host_no\n+ The host number\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::scsi.iodispatching\u00a0Home \u00a0probe::scsi.ioentry\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-scsi-ioentry.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-scsi-ioentry.html", "unified_diff": "@@ -1,13 +1,13 @@\n probe::scsi.ioentry
probe::scsi.ioentry — \n Prepares a SCSI mid-layer request\n-
Synopsis
scsi.ioentry
Values
disk_major
\n+
Synopsis
scsi.ioentry
Values
disk_major
\n The major number of the disk (-1 if no information)\n-
device_state_str
\n- The current state of the device, as a string\n
device_state
\n The current state of the device\n-
req_addr
\n- The current struct request pointer, as a number\n
disk_minor
\n The minor number of the disk (-1 if no information)\n+
device_state_str
\n+ The current state of the device, as a string\n+
req_addr
\n+ The current struct request pointer, as a number\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,18 +4,18 @@\n ***** Name *****\n probe::scsi.ioentry \u2014 Prepares a SCSI mid-layer request\n ***** Synopsis *****\n scsi.ioentry\n ***** Values *****\n disk_major\n The major number of the disk (-1 if no information)\n- device_state_str\n- The current state of the device, as a string\n device_state\n The current state of the device\n- req_addr\n- The current struct request pointer, as a number\n disk_minor\n The minor number of the disk (-1 if no information)\n+ device_state_str\n+ The current state of the device, as a string\n+ req_addr\n+ The current struct request pointer, as a number\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::scsi.iodone\u00a0Home \u00a0probe::scsi.ioexecute\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-scsi-ioexecute.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-scsi-ioexecute.html", "unified_diff": "@@ -1,28 +1,28 @@\n probe::scsi.ioexecute
probe::scsi.ioexecute — \n Create mid-layer SCSI request and wait for the result\n-
Synopsis
scsi.ioexecute
Values
channel
\n- The channel number\n-
lun
\n- The lun number\n-
request_buffer
\n- The data buffer address\n-
request_bufflen
\n- The data buffer buffer length\n-
data_direction_str
\n+
Synopsis
scsi.ioexecute
Values
data_direction_str
\n Data direction, as a string\n+
host_no
\n+ The host number\n
timeout
\n Request timeout in seconds\n+
device_state
\n+ The current state of the device\n+
request_buffer
\n+ The data buffer address\n+
lun
\n+ The lun number\n+
device_state_str
\n+ The current state of the device, as a string\n
data_direction
\n The data_direction specifies whether this command is\n from/to the device.\n-
dev_id
\n- The scsi device id\n-
device_state_str
\n- The current state of the device, as a string\n
retries
\n Number of times to retry request\n-
device_state
\n- The current state of the device\n-
host_no
\n- The host number\n+
request_bufflen
\n+ The data buffer buffer length\n+
dev_id
\n+ The scsi device id\n+
channel
\n+ The channel number\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,34 +2,34 @@\n Prev\u00a0Chapter\u00a010.\u00a0SCSI Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::scsi.ioexecute \u2014 Create mid-layer SCSI request and wait for the result\n ***** Synopsis *****\n scsi.ioexecute\n ***** Values *****\n- channel\n- The channel number\n- lun\n- The lun number\n- request_buffer\n- The data buffer address\n- request_bufflen\n- The data buffer buffer length\n data_direction_str\n Data direction, as a string\n+ host_no\n+ The host number\n timeout\n Request timeout in seconds\n- data_direction\n- The data_direction specifies whether this command is from/to the device.\n- dev_id\n- The scsi device id\n+ device_state\n+ The current state of the device\n+ request_buffer\n+ The data buffer address\n+ lun\n+ The lun number\n device_state_str\n The current state of the device, as a string\n+ data_direction\n+ The data_direction specifies whether this command is from/to the device.\n retries\n Number of times to retry request\n- device_state\n- The current state of the device\n- host_no\n- The host number\n+ request_bufflen\n+ The data buffer buffer length\n+ dev_id\n+ The scsi device id\n+ channel\n+ The channel number\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::scsi.ioentry\u00a0Home \u00a0probe::scsi.set_state\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-scsi-set-state.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-scsi-set-state.html", "unified_diff": "@@ -1,19 +1,19 @@\n probe::scsi.set_state
probe::scsi.set_state — \n Order SCSI device state change\n-
Synopsis
scsi.set_state
Values
host_no
\n+
Synopsis
scsi.set_state
Values
state_str
\n+ The new state of the device, as a string\n+
host_no
\n The host number\n+
old_state_str
\n+ The current state of the device, as a string\n
state
\n The new state of the device\n+
channel
\n+ The channel number\n
dev_id
\n The scsi device id\n-
state_str
\n- The new state of the device, as a string\n
old_state
\n The current state of the device\n-
old_state_str
\n- The current state of the device, as a string\n-
channel
\n- The channel number\n
lun
\n The lun number\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,26 +2,26 @@\n Prev\u00a0Chapter\u00a010.\u00a0SCSI Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::scsi.set_state \u2014 Order SCSI device state change\n ***** Synopsis *****\n scsi.set_state\n ***** Values *****\n+ state_str\n+ The new state of the device, as a string\n host_no\n The host number\n+ old_state_str\n+ The current state of the device, as a string\n state\n The new state of the device\n+ channel\n+ The channel number\n dev_id\n The scsi device id\n- state_str\n- The new state of the device, as a string\n old_state\n The current state of the device\n- old_state_str\n- The current state of the device, as a string\n- channel\n- The channel number\n lun\n The lun number\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::scsi.ioexecute\u00a0Home \u00a0Chapter\u00a011.\u00a0TTY Tapset\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-set-int-arg.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-set-int-arg.html", "unified_diff": "@@ -1,12 +1,12 @@\n function::set_int_arg
function::set_kernel_char — \n Writes a char value to kernel memory\n
Synopsis
\n set_kernel_char(addr:long,val:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The kernel address to write the char to\n
val
\n The char which is to be written\n-
Description
\n+
Description
\n Writes the char value to a given kernel memory address.\n Reports an error when writing to the given address fails.\n Requires the use of guru mode (-g).\n
function::set_kernel_int — \n Writes an int value to kernel memory\n
Synopsis
\n set_kernel_int(addr:long,val:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The kernel address to write the int to\n
val
\n The int which is to be written\n-
Description
\n+
Description
\n Writes the int value to a given kernel memory address.\n Reports an error when writing to the given address fails.\n Requires the use of guru mode (-g).\n
function::set_kernel_long — \n Writes a long value to kernel memory\n
Synopsis
\n set_kernel_long(addr:long,val:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The kernel address to write the long to\n
val
\n The long which is to be written\n-
Description
\n+
Description
\n Writes the long value to a given kernel memory address.\n Reports an error when writing to the given address fails.\n Requires the use of guru mode (-g).\n
function::set_kernel_pointer — \n Writes a pointer value to kernel memory.\n
Synopsis
\n set_kernel_pointer(addr:long,val:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The kernel address to write the pointer to\n
val
\n The pointer which is to be written\n-
Description
\n+
Description
\n Writes the pointer value to a given kernel memory address.\n Reports an error when writing to the given address fails.\n Requires the use of guru mode (-g).\n
function::set_kernel_short — \n Writes a short value to kernel memory\n
Synopsis
\n set_kernel_short(addr:long,val:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The kernel address to write the short to\n
val
\n The short which is to be written\n-
Description
\n+
Description
\n Writes the short value to a given kernel memory address.\n Reports an error when writing to the given address fails.\n Requires the use of guru mode (-g).\n
\n Writes the given string up to a maximum given length to a\n given kernel memory address. Reports an error on string copy fault.\n Requires the use of guru mode (-g).\n
function::set_user_char — \n Writes a char value to user memory\n
Synopsis
\n set_user_char(addr:long,val:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The user address to write the char to\n
val
\n The char which is to be written\n-
Description
\n+
Description
\n Writes the char value to a given user memory address.\n Reports an error when writing to the given address fails.\n Requires the use of guru mode (-g).\n
function::set_user_int — \n Writes an int value to user memory\n
Synopsis
\n set_user_int(addr:long,val:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The user address to write the int to\n
val
\n The int which is to be written\n-
Description
\n+
Description
\n Writes the int value to a given user memory address.\n Reports an error when writing to the given address fails.\n Requires the use of guru mode (-g).\n
function::set_user_long — \n Writes a long value to user memory\n
Synopsis
\n set_user_long(addr:long,val:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The user address to write the long to\n
val
\n The long which is to be written\n-
Description
\n+
Description
\n Writes the long value to a given user memory address.\n Reports an error when writing to the given address fails.\n Requires the use of guru mode (-g).\n
function::set_user_pointer — \n Writes a pointer value to user memory.\n
Synopsis
\n set_user_pointer(addr:long,val:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The user address to write the pointer to\n
val
\n The pointer which is to be written\n-
Description
\n+
Description
\n Writes the pointer value to a given user memory address.\n Reports an error when writing to the given address fails.\n Requires the use of guru mode (-g).\n
function::set_user_short — \n Writes a short value to user memory\n
Synopsis
\n set_user_short(addr:long,val:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The user address to write the short to\n
val
\n The short which is to be written\n-
Description
\n+
Description
\n Writes the short value to a given user memory address.\n Reports an error when writing to the given address fails.\n Requires the use of guru mode (-g).\n
\n Writes the given string up to a maximum given length to a given\n user memory address. Reports an error on string copy fault.\n Requires the use of guru mode (-g).\n
function::set_user_string — \n Writes a string to user memory\n
Synopsis
\n set_user_string(addr:long,val:string)\n-
Arguments
addr
\n+
Arguments
addr
\n The user address to write the string to\n
val
\n The string which is to be written\n-
Description
\n+
Description
\n Writes the given string to a given user memory address.\n Reports an error when writing to the given address fails.\n Requires the use of guru mode (-g).\n
probe::signal.check_ignored — \n Checking to see signal is ignored\n-
Synopsis
signal.check_ignored
Values
sig_pid
\n- The PID of the process receiving the signal\n-
sig_name
\n- A string representation of the signal\n-
pid_name
\n+
Synopsis
signal.check_ignored
Values
pid_name
\n Name of the process receiving the signal\n
sig
\n The number of the signal\n+
sig_name
\n+ A string representation of the signal\n+
sig_pid
\n+ The PID of the process receiving the signal\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a017.\u00a0Signal Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::signal.check_ignored \u2014 Checking to see signal is ignored\n ***** Synopsis *****\n signal.check_ignored\n ***** Values *****\n- sig_pid\n- The PID of the process receiving the signal\n- sig_name\n- A string representation of the signal\n pid_name\n Name of the process receiving the signal\n sig\n The number of the signal\n+ sig_name\n+ A string representation of the signal\n+ sig_pid\n+ The PID of the process receiving the signal\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n function::sigset_mask_str\u00a0Home \u00a0probe::signal.check_ignored.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-signal-checkperm-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-signal-checkperm-return.html", "unified_diff": "@@ -1,7 +1,7 @@\n probe::signal.checkperm.return
probe::signal.checkperm — \n Check being performed on a sent signal\n-
Synopsis
signal.checkperm
Values
sig
\n- The number of the signal\n+
Synopsis
signal.checkperm
Values
task
\n+ A task handle to the signal recipient\n
name
\n Name of the probe point\n-
task
\n- A task handle to the signal recipient\n-
sinfo
\n- The address of the siginfo structure\n
pid_name
\n Name of the process receiving the signal\n+
sig
\n+ The number of the signal\n
sig_name
\n A string representation of the signal\n-
si_code
\n- Indicates the signal type\n
sig_pid
\n The PID of the process receiving the signal\n+
si_code
\n+ Indicates the signal type\n+
sinfo
\n+ The address of the siginfo structure\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,26 +2,26 @@\n Prev\u00a0Chapter\u00a017.\u00a0Signal Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::signal.checkperm \u2014 Check being performed on a sent signal\n ***** Synopsis *****\n signal.checkperm\n ***** Values *****\n- sig\n- The number of the signal\n- name\n- Name of the probe point\n task\n A task handle to the signal recipient\n- sinfo\n- The address of the siginfo structure\n+ name\n+ Name of the probe point\n pid_name\n Name of the process receiving the signal\n+ sig\n+ The number of the signal\n sig_name\n A string representation of the signal\n- si_code\n- Indicates the signal type\n sig_pid\n The PID of the process receiving the signal\n+ si_code\n+ Indicates the signal type\n+ sinfo\n+ The address of the siginfo structure\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::signal.check_ignored.return\u00a0Home \u00a0probe::signal.checkperm.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-signal-do-action-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-signal-do-action-return.html", "unified_diff": "@@ -1,7 +1,7 @@\n probe::signal.do_action.return
probe::signal.do_action.return — \n Examining or changing a signal action completed\n-
Synopsis
signal.do_action.return
Values
retstr
\n- Return value as a string\n-
name
\n+
Synopsis
signal.do_action.return
Values
name
\n Name of the probe point\n+
retstr
\n+ Return value as a string\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,14 +3,14 @@\n ===============================================================================\n ***** Name *****\n probe::signal.do_action.return \u2014 Examining or changing a signal action\n completed\n ***** Synopsis *****\n signal.do_action.return\n ***** Values *****\n- retstr\n- Return value as a string\n name\n Name of the probe point\n+ retstr\n+ Return value as a string\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::signal.do_action\u00a0Home \u00a0probe::signal.flush\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-signal-do-action.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-signal-do-action.html", "unified_diff": "@@ -1,19 +1,19 @@\n probe::signal.do_action
probe::signal.do_action — \n Examining or changing a signal action\n-
Synopsis
signal.do_action
Values
sig
\n+
Synopsis
signal.do_action
Values
sig
\n The signal to be examined/changed\n-
sa_handler
\n- The new handler of the signal\n+
name
\n+ Name of the probe point\n
oldsigact_addr
\n The address of the old sigaction\n struct associated with the signal\n-
sa_mask
\n- The new mask of the signal\n-
name
\n- Name of the probe point\n
sig_name
\n A string representation of the signal\n
sigact_addr
\n The address of the new sigaction\n struct associated with the signal\n+
sa_handler
\n+ The new handler of the signal\n+
sa_mask
\n+ The new mask of the signal\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,22 +4,22 @@\n ***** Name *****\n probe::signal.do_action \u2014 Examining or changing a signal action\n ***** Synopsis *****\n signal.do_action\n ***** Values *****\n sig\n The signal to be examined/changed\n- sa_handler\n- The new handler of the signal\n- oldsigact_addr\n- The address of the old sigaction struct associated with the signal\n- sa_mask\n- The new mask of the signal\n name\n Name of the probe point\n+ oldsigact_addr\n+ The address of the old sigaction struct associated with the signal\n sig_name\n A string representation of the signal\n sigact_addr\n The address of the new sigaction struct associated with the signal\n+ sa_handler\n+ The new handler of the signal\n+ sa_mask\n+ The new mask of the signal\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::signal.checkperm.return\u00a0Home \u00a0probe::signal.do_action.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-signal-flush.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-signal-flush.html", "unified_diff": "@@ -1,13 +1,13 @@\n probe::signal.flush
probe::signal.flush — \n Flushing all pending signals for a task\n-
Synopsis
signal.flush
Values
pid_name
\n- The name of the process associated with the task\n- performing the flush\n-
sig_pid
\n+
Synopsis
signal.flush
Values
sig_pid
\n The PID of the process associated with the task\n performing the flush\n+
pid_name
\n+ The name of the process associated with the task\n+ performing the flush\n
task
\n The task handler of the process performing the flush\n
name
\n Name of the probe point\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a017.\u00a0Signal Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::signal.flush \u2014 Flushing all pending signals for a task\n ***** Synopsis *****\n signal.flush\n ***** Values *****\n- pid_name\n- The name of the process associated with the task performing the flush\n sig_pid\n The PID of the process associated with the task performing the flush\n+ pid_name\n+ The name of the process associated with the task performing the flush\n task\n The task handler of the process performing the flush\n name\n Name of the probe point\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::signal.do_action.return\u00a0Home \u00a0probe::signal.force_segv\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-signal-force-segv-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-signal-force-segv-return.html", "unified_diff": "@@ -1,7 +1,7 @@\n probe::signal.force_segv.return
probe::signal.force_segv — \n Forcing send of SIGSEGV\n-
Synopsis
signal.force_segv
Values
sig_name
\n- A string representation of the signal\n+
Synopsis
signal.force_segv
Values
sig
\n+ The number of the signal\n
pid_name
\n Name of the process receiving the signal\n-
sig_pid
\n- The PID of the process receiving the signal\n-
sig
\n- The number of the signal\n
name
\n Name of the probe point\n+
sig_name
\n+ A string representation of the signal\n+
sig_pid
\n+ The PID of the process receiving the signal\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,20 +2,20 @@\n Prev\u00a0Chapter\u00a017.\u00a0Signal Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::signal.force_segv \u2014 Forcing send of SIGSEGV\n ***** Synopsis *****\n signal.force_segv\n ***** Values *****\n- sig_name\n- A string representation of the signal\n- pid_name\n- Name of the process receiving the signal\n- sig_pid\n- The PID of the process receiving the signal\n sig\n The number of the signal\n+ pid_name\n+ Name of the process receiving the signal\n name\n Name of the probe point\n+ sig_name\n+ A string representation of the signal\n+ sig_pid\n+ The PID of the process receiving the signal\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::signal.flush\u00a0Home \u00a0probe::signal.force_segv.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-signal-handle-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-signal-handle-return.html", "unified_diff": "@@ -1,9 +1,9 @@\n probe::signal.handle.return
probe::signal.handle — \n Signal handler being invoked\n-
Synopsis
signal.handle
Values
sig_code
\n+
Synopsis
signal.handle
Values
sinfo
\n+ The address of the siginfo table\n+
ka_addr
\n+ The address of the k_sigaction table\n+ associated with the signal\n+
sig_code
\n The si_code value of the siginfo signal\n
oldset_addr
\n The address of the bitmask array of blocked signals\n (deprecated in SystemTap 2.1)\n-
sig
\n- The signal number that invoked the signal handler\n+
sig_name
\n+ A string representation of the signal\n
sig_mode
\n Indicates whether the signal was a user-mode or kernel-mode signal\n-
name
\n- Name of the probe point\n-
sinfo
\n- The address of the siginfo table\n+
sig
\n+ The signal number that invoked the signal handler\n
regs
\n The address of the kernel-mode stack area (deprecated in\n SystemTap 2.1)\n-
sig_name
\n- A string representation of the signal\n-
ka_addr
\n- The address of the k_sigaction table\n- associated with the signal\n+
name
\n+ Name of the probe point\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,29 +2,29 @@\n Prev\u00a0Chapter\u00a017.\u00a0Signal Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::signal.handle \u2014 Signal handler being invoked\n ***** Synopsis *****\n signal.handle\n ***** Values *****\n+ sinfo\n+ The address of the siginfo table\n+ ka_addr\n+ The address of the k_sigaction table associated with the signal\n sig_code\n The si_code value of the siginfo signal\n oldset_addr\n The address of the bitmask array of blocked signals (deprecated in\n SystemTap 2.1)\n- sig\n- The signal number that invoked the signal handler\n+ sig_name\n+ A string representation of the signal\n sig_mode\n Indicates whether the signal was a user-mode or kernel-mode signal\n- name\n- Name of the probe point\n- sinfo\n- The address of the siginfo table\n+ sig\n+ The signal number that invoked the signal handler\n regs\n The address of the kernel-mode stack area (deprecated in SystemTap 2.1)\n- sig_name\n- A string representation of the signal\n- ka_addr\n- The address of the k_sigaction table associated with the signal\n+ name\n+ Name of the probe point\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::signal.force_segv.return\u00a0Home \u00a0probe::signal.handle.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-signal-pending-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-signal-pending-return.html", "unified_diff": "@@ -1,7 +1,7 @@\n probe::signal.pending.return
\n The address of the user-space signal set\n (sigset_t)\n-
name
\n- Name of the probe point\n-
Description
\n+
Description
\n This probe is used to examine a set of signals pending for delivery\n to a specific thread. This normally occurs when the\n do_sigpending kernel function is executed.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,20 +2,20 @@\n Prev\u00a0Chapter\u00a017.\u00a0Signal Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::signal.pending \u2014 Examining pending signal\n ***** Synopsis *****\n signal.pending\n ***** Values *****\n+ name\n+ Name of the probe point\n sigset_size\n The size of the user-space signal set\n sigset_add\n The address of the user-space signal set (sigset_t)\n- name\n- Name of the probe point\n ***** Description *****\n This probe is used to examine a set of signals pending for delivery to a\n specific thread. This normally occurs when the do_sigpending kernel function is\n executed.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::signal.handle.return\u00a0Home \u00a0probe::signal.pending.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-signal-procmask-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-signal-procmask-return.html", "unified_diff": "@@ -1,7 +1,7 @@\n probe::signal.procmask.return
probe::signal.procmask — \n Examining or changing blocked signals\n-
Synopsis
signal.procmask
Values
sigset
\n+
Synopsis
signal.procmask
Values
sigset
\n The actual value to be set for sigset_t\n (correct?)\n+
oldsigset_addr
\n+ The old address of the signal set\n+ (sigset_t)\n
name
\n Name of the probe point\n
sigset_addr
\n The address of the signal set (sigset_t)\n to be implemented\n-
oldsigset_addr
\n- The old address of the signal set\n- (sigset_t)\n
how
\n Indicates how to change the blocked signals; possible values are\n SIG_BLOCK=0 (for blocking signals),\n SIG_UNBLOCK=1 (for unblocking signals), and\n SIG_SETMASK=2 for setting the signal mask.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,20 +4,20 @@\n ***** Name *****\n probe::signal.procmask \u2014 Examining or changing blocked signals\n ***** Synopsis *****\n signal.procmask\n ***** Values *****\n sigset\n The actual value to be set for sigset_t (correct?)\n+ oldsigset_addr\n+ The old address of the signal set (sigset_t)\n name\n Name of the probe point\n sigset_addr\n The address of the signal set (sigset_t) to be implemented\n- oldsigset_addr\n- The old address of the signal set (sigset_t)\n how\n Indicates how to change the blocked signals; possible values are\n SIG_BLOCK=0 (for blocking signals), SIG_UNBLOCK=1 (for unblocking\n signals), and SIG_SETMASK=2 for setting the signal mask.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::signal.pending.return\u00a0Home \u00a0probe::signal.procmask.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-signal-send-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-signal-send-return.html", "unified_diff": "@@ -1,20 +1,20 @@\n probe::signal.send.return
probe::signal.send.return — \n Signal being sent to a process completed (deprecated in SystemTap 2.1)\n-
Synopsis
signal.send.return
Values
shared
\n+
Synopsis
signal.send.return
Values
retstr
\n+ The return value to either __group_send_sig_info, specific_send_sig_info, or send_sigqueue\n+
name
\n+ The name of the function used to send out the signal\n+
shared
\n Indicates whether the sent signal is shared by the thread group.\n
send2queue
\n Indicates whether the sent signal was sent to an existing sigqueue\n-
name
\n- The name of the function used to send out the signal\n-
retstr
\n- The return value to either __group_send_sig_info, specific_send_sig_info, or send_sigqueue\n-
Context
\n+
Context
\n The signal's sender. (correct?)\n-
Description
\n+
Description
\n Possible __group_send_sig_info and\n specific_send_sig_info return values are as follows;\n
\n \n 0 -- The signal is successfully sent to a process,\n which means that, (1) the signal was ignored by the receiving process,\n (2) this is a non-RT signal and the system already has one queued, and\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,23 +3,23 @@\n ===============================================================================\n ***** Name *****\n probe::signal.send.return \u2014 Signal being sent to a process completed\n (deprecated in SystemTap 2.1)\n ***** Synopsis *****\n signal.send.return\n ***** Values *****\n+ retstr\n+ The return value to either __group_send_sig_info, specific_send_sig_info,\n+ or send_sigqueue\n+ name\n+ The name of the function used to send out the signal\n shared\n Indicates whether the sent signal is shared by the thread group.\n send2queue\n Indicates whether the sent signal was sent to an existing sigqueue\n- name\n- The name of the function used to send out the signal\n- retstr\n- The return value to either __group_send_sig_info, specific_send_sig_info,\n- or send_sigqueue\n ***** Context *****\n The signal's sender. (correct?)\n ***** Description *****\n Possible __group_send_sig_info and specific_send_sig_info return values are as\n follows;\n 0 -- The signal is successfully sent to a process, which means that, (1) the\n signal was ignored by the receiving process, (2) this is a non-RT signal and\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-signal-send-sig-queue-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-signal-send-sig-queue-return.html", "unified_diff": "@@ -1,7 +1,7 @@\n
probe::signal.send_sig_queue — \n Queuing a signal to a process\n-
Synopsis
signal.send_sig_queue
Values
name
\n+
Synopsis
signal.send_sig_queue
Values
sig_name
\n+ A string representation of the signal\n+
sigqueue_addr
\n+ The address of the signal queue\n+
name
\n Name of the probe point\n+
pid_name
\n+ Name of the process to which the signal is queued\n
sig
\n The queued signal\n-
sigqueue_addr
\n- The address of the signal queue\n
sig_pid
\n The PID of the process to which the signal is queued\n-
sig_name
\n- A string representation of the signal\n-
pid_name
\n- Name of the process to which the signal is queued\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,22 +2,22 @@\n Prev\u00a0Chapter\u00a017.\u00a0Signal Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::signal.send_sig_queue \u2014 Queuing a signal to a process\n ***** Synopsis *****\n signal.send_sig_queue\n ***** Values *****\n+ sig_name\n+ A string representation of the signal\n+ sigqueue_addr\n+ The address of the signal queue\n name\n Name of the probe point\n+ pid_name\n+ Name of the process to which the signal is queued\n sig\n The queued signal\n- sigqueue_addr\n- The address of the signal queue\n sig_pid\n The PID of the process to which the signal is queued\n- sig_name\n- A string representation of the signal\n- pid_name\n- Name of the process to which the signal is queued\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::signal.send.return\u00a0Home \u00a0probe::signal.send_sig_queue.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-signal-send.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-signal-send.html", "unified_diff": "@@ -1,26 +1,26 @@\n probe::signal.send
probe::signal.send — \n Signal being sent to a process\n-
Synopsis
signal.send
Values
sig
\n+
Synopsis
signal.send
Values
sig_name
\n+ A string representation of the signal\n+
shared
\n+ Indicates whether the signal is shared by the thread group\n+
sig
\n The number of the signal\n-
task
\n- A task handle to the signal recipient\n-
send2queue
\n- Indicates whether the signal is sent to an existing\n- sigqueue (deprecated in SystemTap 2.1)\n-
sinfo
\n- The address of siginfo struct\n
name
\n The name of the function used to send out the signal\n
pid_name
\n The name of the signal recipient\n-
sig_name
\n- A string representation of the signal\n-
shared
\n- Indicates whether the signal is shared by the thread group\n+
task
\n+ A task handle to the signal recipient\n+
sinfo
\n+ The address of siginfo struct\n
si_code
\n Indicates the signal type\n+
send2queue
\n+ Indicates whether the signal is sent to an existing\n+ sigqueue (deprecated in SystemTap 2.1)\n
sig_pid
\n The PID of the process receiving the signal\n-
Context
\n+
Context
\n The signal's sender.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,33 +2,33 @@\n Prev\u00a0Chapter\u00a017.\u00a0Signal Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::signal.send \u2014 Signal being sent to a process\n ***** Synopsis *****\n signal.send\n ***** Values *****\n+ sig_name\n+ A string representation of the signal\n+ shared\n+ Indicates whether the signal is shared by the thread group\n sig\n The number of the signal\n- task\n- A task handle to the signal recipient\n- send2queue\n- Indicates whether the signal is sent to an existing sigqueue (deprecated\n- in SystemTap 2.1)\n- sinfo\n- The address of siginfo struct\n name\n The name of the function used to send out the signal\n pid_name\n The name of the signal recipient\n- sig_name\n- A string representation of the signal\n- shared\n- Indicates whether the signal is shared by the thread group\n+ task\n+ A task handle to the signal recipient\n+ sinfo\n+ The address of siginfo struct\n si_code\n Indicates the signal type\n+ send2queue\n+ Indicates whether the signal is sent to an existing sigqueue (deprecated\n+ in SystemTap 2.1)\n sig_pid\n The PID of the process receiving the signal\n ***** Context *****\n The signal's sender.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::signal.procmask.return\u00a0Home \u00a0probe::signal.send.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-signal-str.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-signal-str.html", "unified_diff": "@@ -1,7 +1,7 @@\n function::signal_str
probe::signal.sys_tgkill — \n Sending kill signal to a thread group\n-
Synopsis
signal.sys_tgkill
Values
sig
\n+
Synopsis
signal.sys_tgkill
Values
sig
\n The specific kill signal sent to the process\n-
task
\n- A task handle to the signal recipient\n
name
\n Name of the probe point\n+
task
\n+ A task handle to the signal recipient\n
pid_name
\n The name of the signal recipient\n-
tgid
\n- The thread group ID of the thread receiving the kill signal\n
sig_name
\n A string representation of the signal\n
sig_pid
\n The PID of the thread receiving the kill signal\n-
Description
\n+
tgid
\n+ The thread group ID of the thread receiving the kill signal\n+
Description
\n The tgkill call is similar to tkill,\n except that it also allows the caller to specify the thread group ID of\n the thread to be signalled. This protects against TID reuse.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,26 +4,26 @@\n ***** Name *****\n probe::signal.sys_tgkill \u2014 Sending kill signal to a thread group\n ***** Synopsis *****\n signal.sys_tgkill\n ***** Values *****\n sig\n The specific kill signal sent to the process\n- task\n- A task handle to the signal recipient\n name\n Name of the probe point\n+ task\n+ A task handle to the signal recipient\n pid_name\n The name of the signal recipient\n- tgid\n- The thread group ID of the thread receiving the kill signal\n sig_name\n A string representation of the signal\n sig_pid\n The PID of the thread receiving the kill signal\n+ tgid\n+ The thread group ID of the thread receiving the kill signal\n ***** Description *****\n The tgkill call is similar to tkill, except that it also allows the caller to\n specify the thread group ID of the thread to be signalled. This protects\n against TID reuse.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::signal.send_sig_queue.return\u00a0Home \u00a0probe::signal.sys_tgkill.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-signal-sys-tkill.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-signal-sys-tkill.html", "unified_diff": "@@ -1,20 +1,20 @@\n probe::signal.sys_tkill
probe::signal.sys_tkill — \n Sending a kill signal to a thread\n-
Synopsis
signal.sys_tkill
Values
task
\n- A task handle to the signal recipient\n-
name
\n+
Synopsis
signal.sys_tkill
Values
name
\n Name of the probe point\n+
task
\n+ A task handle to the signal recipient\n+
pid_name
\n+ The name of the signal recipient\n
sig
\n The specific signal sent to the process\n-
sig_pid
\n- The PID of the process receiving the kill signal\n
sig_name
\n A string representation of the signal\n-
pid_name
\n- The name of the signal recipient\n-
Description
\n+
sig_pid
\n+ The PID of the process receiving the kill signal\n+
Description
\n The tkill call is analogous to kill(2),\n except that it also allows a process within a specific thread group to\n be targeted. Such processes are targeted through their unique\n thread IDs (TID).\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,26 +2,26 @@\n Prev\u00a0Chapter\u00a017.\u00a0Signal Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::signal.sys_tkill \u2014 Sending a kill signal to a thread\n ***** Synopsis *****\n signal.sys_tkill\n ***** Values *****\n- task\n- A task handle to the signal recipient\n name\n Name of the probe point\n+ task\n+ A task handle to the signal recipient\n+ pid_name\n+ The name of the signal recipient\n sig\n The specific signal sent to the process\n- sig_pid\n- The PID of the process receiving the kill signal\n sig_name\n A string representation of the signal\n- pid_name\n- The name of the signal recipient\n+ sig_pid\n+ The PID of the process receiving the kill signal\n ***** Description *****\n The tkill call is analogous to kill(2), except that it also allows a process\n within a specific thread group to be targeted. Such processes are targeted\n through their unique thread IDs (TID).\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::signal.sys_tgkill.return\u00a0Home \u00a0probe::signal.syskill\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-signal-syskill-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-signal-syskill-return.html", "unified_diff": "@@ -1,5 +1,5 @@\n probe::signal.syskill.return
probe::signal.syskill — \n Sending kill signal to a process\n-
Synopsis
signal.syskill
Values
sig
\n+
Synopsis
signal.syskill
Values
sig_name
\n+ A string representation of the signal\n+
sig
\n The specific signal sent to the process\n-
name
\n- Name of the probe point\n
task
\n A task handle to the signal recipient\n-
sig_name
\n- A string representation of the signal\n+
name
\n+ Name of the probe point\n
pid_name
\n The name of the signal recipient\n
sig_pid
\n The PID of the process receiving the signal\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,22 +2,22 @@\n Prev\u00a0Chapter\u00a017.\u00a0Signal Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::signal.syskill \u2014 Sending kill signal to a process\n ***** Synopsis *****\n signal.syskill\n ***** Values *****\n+ sig_name\n+ A string representation of the signal\n sig\n The specific signal sent to the process\n- name\n- Name of the probe point\n task\n A task handle to the signal recipient\n- sig_name\n- A string representation of the signal\n+ name\n+ Name of the probe point\n pid_name\n The name of the signal recipient\n sig_pid\n The PID of the process receiving the signal\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::signal.sys_tkill\u00a0Home \u00a0probe::signal.syskill.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-signal-systkill-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-signal-systkill-return.html", "unified_diff": "@@ -1,7 +1,7 @@\n probe::signal.systkill.return
probe::signal.systkill.return — \n Sending kill signal to a thread completed\n-
Synopsis
signal.systkill.return
Values
name
\n- Name of the probe point\n-
retstr
\n+
Synopsis
signal.systkill.return
Values
retstr
\n The return value to either __group_send_sig_info,\n+
name
\n+ Name of the probe point\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,14 +2,14 @@\n Prev\u00a0Chapter\u00a017.\u00a0Signal Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::signal.systkill.return \u2014 Sending kill signal to a thread completed\n ***** Synopsis *****\n signal.systkill.return\n ***** Values *****\n- name\n- Name of the probe point\n retstr\n The return value to either __group_send_sig_info,\n+ name\n+ Name of the probe point\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::signal.syskill.return\u00a0Home \u00a0probe::signal.wakeup\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-signal-wakeup.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-signal-wakeup.html", "unified_diff": "@@ -1,15 +1,15 @@\n probe::signal.wakeup
probe::signal.wakeup — \n Sleeping process being wakened for signal\n-
Synopsis
signal.wakeup
Values
pid_name
\n- Name of the process to wake\n-
sig_pid
\n- The PID of the process to wake\n-
resume
\n+
Synopsis
signal.wakeup
Values
resume
\n Indicates whether to wake up a task in a\n STOPPED or TRACED state\n+
pid_name
\n+ Name of the process to wake\n
state_mask
\n A string representation indicating the mask\n of task states to wake. Possible values are\n TASK_INTERRUPTIBLE, TASK_STOPPED,\n TASK_TRACED, TASK_WAKEKILL, and TASK_INTERRUPTIBLE.\n+
sig_pid
\n+ The PID of the process to wake\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,20 +2,20 @@\n Prev\u00a0Chapter\u00a017.\u00a0Signal Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::signal.wakeup \u2014 Sleeping process being wakened for signal\n ***** Synopsis *****\n signal.wakeup\n ***** Values *****\n- pid_name\n- Name of the process to wake\n- sig_pid\n- The PID of the process to wake\n resume\n Indicates whether to wake up a task in a STOPPED or TRACED state\n+ pid_name\n+ Name of the process to wake\n state_mask\n A string representation indicating the mask of task states to wake.\n Possible values are TASK_INTERRUPTIBLE, TASK_STOPPED, TASK_TRACED,\n TASK_WAKEKILL, and TASK_INTERRUPTIBLE.\n+ sig_pid\n+ The PID of the process to wake\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::signal.systkill.return\u00a0Home \u00a0Chapter\u00a018.\u00a0Errno Tapset\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sigset-mask-str.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sigset-mask-str.html", "unified_diff": "@@ -1,7 +1,7 @@\n function::sigset_mask_str
probe::socket.aio_read.return — \n Conclusion of message received via sock_aio_read\n-
Synopsis
socket.aio_read.return
Values
flags
\n- Socket flags value\n+
Synopsis
socket.aio_read.return
Values
state
\n+ Socket state value\n
protocol
\n Protocol value\n
family
\n Protocol family value\n
name
\n Name of this probe\n+
size
\n+ Size of message received (in bytes) or error code if success = 0\n
success
\n Was receive successful? (1 = yes, 0 = no)\n
type
\n Socket type value\n-
state
\n- Socket state value\n-
size
\n- Size of message received (in bytes) or error code if success = 0\n-
Context
\n+
flags
\n+ Socket flags value\n+
Context
\n The message receiver.\n-
Description
\n+
Description
\n Fires at the conclusion of receiving a message on a socket\n via the sock_aio_read function\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,30 +3,30 @@\n ===============================================================================\n ***** Name *****\n probe::socket.aio_read.return \u2014 Conclusion of message received via\n sock_aio_read\n ***** Synopsis *****\n socket.aio_read.return\n ***** Values *****\n- flags\n- Socket flags value\n+ state\n+ Socket state value\n protocol\n Protocol value\n family\n Protocol family value\n name\n Name of this probe\n+ size\n+ Size of message received (in bytes) or error code if success = 0\n success\n Was receive successful? (1 = yes, 0 = no)\n type\n Socket type value\n- state\n- Socket state value\n- size\n- Size of message received (in bytes) or error code if success = 0\n+ flags\n+ Socket flags value\n ***** Context *****\n The message receiver.\n ***** Description *****\n Fires at the conclusion of receiving a message on a socket via the\n sock_aio_read function\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-socket-aio-read.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-socket-aio-read.html", "unified_diff": "@@ -1,22 +1,22 @@\n probe::socket.aio_read
probe::socket.aio_write.return — \n Conclusion of message send via sock_aio_write\n-
Synopsis
socket.aio_write.return
Values
state
\n+
Synopsis
socket.aio_write.return
Values
protocol
\n+ Protocol value\n+
state
\n Socket state value\n-
size
\n- Size of message received (in bytes) or error code if success = 0\n
family
\n Protocol family value\n-
protocol
\n- Protocol value\n
name
\n Name of this probe\n-
type
\n- Socket type value\n
success
\n Was receive successful? (1 = yes, 0 = no)\n+
size
\n+ Size of message received (in bytes) or error code if success = 0\n
flags
\n Socket flags value\n-
Context
\n+
type
\n+ Socket type value\n+
Context
\n The message receiver.\n-
Description
\n+
Description
\n Fires at the conclusion of sending a message on a socket\n via the sock_aio_write function\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,30 +2,30 @@\n Prev\u00a0Chapter\u00a014.\u00a0Socket Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::socket.aio_write.return \u2014 Conclusion of message send via sock_aio_write\n ***** Synopsis *****\n socket.aio_write.return\n ***** Values *****\n+ protocol\n+ Protocol value\n state\n Socket state value\n- size\n- Size of message received (in bytes) or error code if success = 0\n family\n Protocol family value\n- protocol\n- Protocol value\n name\n Name of this probe\n- type\n- Socket type value\n success\n Was receive successful? (1 = yes, 0 = no)\n+ size\n+ Size of message received (in bytes) or error code if success = 0\n flags\n Socket flags value\n+ type\n+ Socket type value\n ***** Context *****\n The message receiver.\n ***** Description *****\n Fires at the conclusion of sending a message on a socket via the sock_aio_write\n function\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-socket-aio-write.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-socket-aio-write.html", "unified_diff": "@@ -1,22 +1,22 @@\n probe::socket.aio_write
probe::socket.aio_write — \n Message send via sock_aio_write\n-
Synopsis
socket.aio_write
Values
flags
\n+
Synopsis
socket.aio_write
Values
type
\n+ Socket type value\n+
flags
\n Socket flags value\n
state
\n Socket state value\n-
size
\n- Message size in bytes\n-
name
\n- Name of this probe\n-
type
\n- Socket type value\n-
protocol
\n- Protocol value\n
family
\n Protocol family value\n-
Context
\n+
protocol
\n+ Protocol value\n+
name
\n+ Name of this probe\n+
size
\n+ Message size in bytes\n+
Context
\n The message sender\n-
Description
\n+
Description
\n Fires at the beginning of sending a message on a socket\n via the sock_aio_write function\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,28 +2,28 @@\n Prev\u00a0Chapter\u00a014.\u00a0Socket Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::socket.aio_write \u2014 Message send via sock_aio_write\n ***** Synopsis *****\n socket.aio_write\n ***** Values *****\n+ type\n+ Socket type value\n flags\n Socket flags value\n state\n Socket state value\n- size\n- Message size in bytes\n- name\n- Name of this probe\n- type\n- Socket type value\n- protocol\n- Protocol value\n family\n Protocol family value\n+ protocol\n+ Protocol value\n+ name\n+ Name of this probe\n+ size\n+ Message size in bytes\n ***** Context *****\n The message sender\n ***** Description *****\n Fires at the beginning of sending a message on a socket via the sock_aio_write\n function\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-socket-close-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-socket-close-return.html", "unified_diff": "@@ -1,9 +1,9 @@\n probe::socket.close.return
\n- Requested by user process or the kernel (1 = kernel, 0 = user)\n-
Context
\n+
protocol
\n+ Protocol value\n+
family
\n+ Protocol family value\n+
Context
\n The requester (user process or kernel)\n-
Description
\n+
Description
\n Fires at the conclusion of creating a socket.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,26 +4,26 @@\n ***** Name *****\n probe::socket.create.return \u2014 Return from Creation of a socket\n ***** Synopsis *****\n socket.create.return\n ***** Values *****\n err\n Error code if success == 0\n- family\n- Protocol family value\n- protocol\n- Protocol value\n type\n Socket type value\n+ requester\n+ Requested by user process or the kernel (1 = kernel, 0 = user)\n success\n Was socket creation successful? (1 = yes, 0 = no)\n name\n Name of this probe\n- requester\n- Requested by user process or the kernel (1 = kernel, 0 = user)\n+ protocol\n+ Protocol value\n+ family\n+ Protocol family value\n ***** Context *****\n The requester (user process or kernel)\n ***** Description *****\n Fires at the conclusion of creating a socket.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::socket.create\u00a0Home \u00a0probe::socket.read_iter\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-socket-create.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-socket-create.html", "unified_diff": "@@ -1,17 +1,17 @@\n probe::socket.create
\n Requested by user process or the kernel (1 = kernel, 0 = user)\n
name
\n Name of this probe\n
type
\n Socket type value\n-
protocol
\n- Protocol value\n-
family
\n- Protocol family value\n-
Context
\n+
Context
\n The requester (see requester variable)\n-
Description
\n+
Description
\n Fires at the beginning of creating a socket.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,24 +2,24 @@\n Prev\u00a0Chapter\u00a014.\u00a0Socket Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::socket.create \u2014 Creation of a socket\n ***** Synopsis *****\n socket.create\n ***** Values *****\n+ protocol\n+ Protocol value\n+ family\n+ Protocol family value\n requester\n Requested by user process or the kernel (1 = kernel, 0 = user)\n name\n Name of this probe\n type\n Socket type value\n- protocol\n- Protocol value\n- family\n- Protocol family value\n ***** Context *****\n The requester (see requester variable)\n ***** Description *****\n Fires at the beginning of creating a socket.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::socket.close.return\u00a0Home \u00a0probe::socket.create.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-socket-read-iter-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-socket-read-iter-return.html", "unified_diff": "@@ -1,24 +1,24 @@\n probe::socket.read_iter.return
probe::socket.read_iter.return — \n Conclusion of message received via sock_read_iter\n-
Synopsis
socket.read_iter.return
Values
flags
\n- Socket flags value\n-
success
\n- Was receive successful? (1 = yes, 0 = no)\n-
type
\n- Socket type value\n-
name
\n- Name of this probe\n-
protocol
\n+
Synopsis
socket.read_iter.return
Values
protocol
\n Protocol value\n+
state
\n+ Socket state value\n
family
\n Protocol family value\n+
success
\n+ Was receive successful? (1 = yes, 0 = no)\n
size
\n Size of message received (in bytes) or error code if success = 0\n-
state
\n- Socket state value\n-
Context
\n+
name
\n+ Name of this probe\n+
flags
\n+ Socket flags value\n+
type
\n+ Socket type value\n+
Context
\n The message receiver.\n-
Description
\n+
Description
\n Fires at the conclusion of receiving a message on a socket\n via the sock_read_iter function\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,30 +3,30 @@\n ===============================================================================\n ***** Name *****\n probe::socket.read_iter.return \u2014 Conclusion of message received via\n sock_read_iter\n ***** Synopsis *****\n socket.read_iter.return\n ***** Values *****\n- flags\n- Socket flags value\n- success\n- Was receive successful? (1 = yes, 0 = no)\n- type\n- Socket type value\n- name\n- Name of this probe\n protocol\n Protocol value\n+ state\n+ Socket state value\n family\n Protocol family value\n+ success\n+ Was receive successful? (1 = yes, 0 = no)\n size\n Size of message received (in bytes) or error code if success = 0\n- state\n- Socket state value\n+ name\n+ Name of this probe\n+ flags\n+ Socket flags value\n+ type\n+ Socket type value\n ***** Context *****\n The message receiver.\n ***** Description *****\n Fires at the conclusion of receiving a message on a socket via the\n sock_read_iter function\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-socket-read-iter.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-socket-read-iter.html", "unified_diff": "@@ -1,22 +1,22 @@\n probe::socket.read_iter
probe::socket.read_iter — \n Receiving message via sock_read_iter\n-
Synopsis
socket.read_iter
Values
flags
\n+
Synopsis
socket.read_iter
Values
flags
\n Socket flags value\n-
name
\n- Name of this probe\n
type
\n Socket type value\n+
state
\n+ Socket state value\n
family
\n Protocol family value\n
protocol
\n Protocol value\n-
state
\n- Socket state value\n
size
\n Message size in bytes\n-
Context
\n+
name
\n+ Name of this probe\n+
Context
\n The message sender\n-
Description
\n+
Description
\n Fires at the beginning of receiving a message on a socket\n via the sock_read_iter function\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,26 +4,26 @@\n ***** Name *****\n probe::socket.read_iter \u2014 Receiving message via sock_read_iter\n ***** Synopsis *****\n socket.read_iter\n ***** Values *****\n flags\n Socket flags value\n- name\n- Name of this probe\n type\n Socket type value\n+ state\n+ Socket state value\n family\n Protocol family value\n protocol\n Protocol value\n- state\n- Socket state value\n size\n Message size in bytes\n+ name\n+ Name of this probe\n ***** Context *****\n The message sender\n ***** Description *****\n Fires at the beginning of receiving a message on a socket via the\n sock_read_iter function\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-socket-readv-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-socket-readv-return.html", "unified_diff": "@@ -1,24 +1,24 @@\n probe::socket.readv.return
probe::socket.readv.return — \n Conclusion of receiving a message via sock_readv\n-
Synopsis
socket.readv.return
Values
flags
\n+
Synopsis
socket.readv.return
Values
type
\n+ Socket type value\n+
flags
\n Socket flags value\n-
state
\n- Socket state value\n
size
\n Size of message received (in bytes) or error code if success = 0\n+
success
\n+ Was receive successful? (1 = yes, 0 = no)\n+
name
\n+ Name of this probe\n+
state
\n+ Socket state value\n
family
\n Protocol family value\n
protocol
\n Protocol value\n-
name
\n- Name of this probe\n-
type
\n- Socket type value\n-
success
\n- Was receive successful? (1 = yes, 0 = no)\n-
Context
\n+
Context
\n The message receiver.\n-
Description
\n+
Description
\n Fires at the conclusion of receiving a message on a socket\n via the sock_readv function\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,30 +2,30 @@\n Prev\u00a0Chapter\u00a014.\u00a0Socket Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::socket.readv.return \u2014 Conclusion of receiving a message via sock_readv\n ***** Synopsis *****\n socket.readv.return\n ***** Values *****\n+ type\n+ Socket type value\n flags\n Socket flags value\n- state\n- Socket state value\n size\n Size of message received (in bytes) or error code if success = 0\n+ success\n+ Was receive successful? (1 = yes, 0 = no)\n+ name\n+ Name of this probe\n+ state\n+ Socket state value\n family\n Protocol family value\n protocol\n Protocol value\n- name\n- Name of this probe\n- type\n- Socket type value\n- success\n- Was receive successful? (1 = yes, 0 = no)\n ***** Context *****\n The message receiver.\n ***** Description *****\n Fires at the conclusion of receiving a message on a socket via the sock_readv\n function\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-socket-readv.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-socket-readv.html", "unified_diff": "@@ -1,22 +1,22 @@\n probe::socket.readv
probe::socket.recvmsg.return — \n Return from Message being received on socket\n-
Synopsis
socket.recvmsg.return
Values
size
\n+
Synopsis
socket.recvmsg.return
Values
name
\n+ Name of this probe\n+
size
\n Size of message received (in bytes) or error code if success = 0\n-
state
\n- Socket state value\n-
type
\n- Socket type value\n
success
\n Was receive successful? (1 = yes, 0 = no)\n-
name
\n- Name of this probe\n
protocol
\n Protocol value\n+
state
\n+ Socket state value\n
family
\n Protocol family value\n+
type
\n+ Socket type value\n
flags
\n Socket flags value\n-
Context
\n+
Context
\n The message receiver.\n-
Description
\n+
Description
\n Fires at the conclusion of receiving a message on a socket\n via the sock_recvmsg function.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,28 +2,28 @@\n Prev\u00a0Chapter\u00a014.\u00a0Socket Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::socket.recvmsg.return \u2014 Return from Message being received on socket\n ***** Synopsis *****\n socket.recvmsg.return\n ***** Values *****\n+ name\n+ Name of this probe\n size\n Size of message received (in bytes) or error code if success = 0\n- state\n- Socket state value\n- type\n- Socket type value\n success\n Was receive successful? (1 = yes, 0 = no)\n- name\n- Name of this probe\n protocol\n Protocol value\n+ state\n+ Socket state value\n family\n Protocol family value\n+ type\n+ Socket type value\n flags\n Socket flags value\n ***** Context *****\n The message receiver.\n ***** Description *****\n Fires at the conclusion of receiving a message on a socket via the sock_recvmsg\n function.\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-socket-recvmsg.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-socket-recvmsg.html", "unified_diff": "@@ -1,22 +1,22 @@\n probe::socket.recvmsg
probe::socket.recvmsg — \n Message being received on socket\n-
Synopsis
socket.recvmsg
Values
size
\n- Message size in bytes\n-
state
\n+
Synopsis
socket.recvmsg
Values
state
\n Socket state value\n
protocol
\n Protocol value\n
family
\n Protocol family value\n-
type
\n- Socket type value\n
name
\n Name of this probe\n+
size
\n+ Message size in bytes\n+
type
\n+ Socket type value\n
flags
\n Socket flags value\n-
Context
\n+
Context
\n The message receiver.\n-
Description
\n+
Description
\n Fires at the beginning of receiving a message on a socket\n via the sock_recvmsg function\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,26 +2,26 @@\n Prev\u00a0Chapter\u00a014.\u00a0Socket Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::socket.recvmsg \u2014 Message being received on socket\n ***** Synopsis *****\n socket.recvmsg\n ***** Values *****\n- size\n- Message size in bytes\n state\n Socket state value\n protocol\n Protocol value\n family\n Protocol family value\n- type\n- Socket type value\n name\n Name of this probe\n+ size\n+ Message size in bytes\n+ type\n+ Socket type value\n flags\n Socket flags value\n ***** Context *****\n The message receiver.\n ***** Description *****\n Fires at the beginning of receiving a message on a socket via the sock_recvmsg\n function\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-socket-send.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-socket-send.html", "unified_diff": "@@ -1,21 +1,21 @@\n probe::socket.send
probe::socket.sendmsg.return — \n Return from socket.sendmsg.\n-
Synopsis
socket.sendmsg.return
Values
flags
\n- Socket flags value\n-
protocol
\n- Protocol value\n-
family
\n- Protocol family value\n+
Synopsis
socket.sendmsg.return
Values
success
\n+ Was send successful? (1 = yes, 0 = no)\n+
size
\n+ Size of message sent (in bytes) or error code if success = 0\n
name
\n Name of this probe\n-
type
\n- Socket type value\n-
success
\n- Was send successful? (1 = yes, 0 = no)\n+
family
\n+ Protocol family value\n
state
\n Socket state value\n-
size
\n- Size of message sent (in bytes) or error code if success = 0\n-
Context
\n+
protocol
\n+ Protocol value\n+
flags
\n+ Socket flags value\n+
type
\n+ Socket type value\n+
Context
\n The message sender.\n-
Description
\n+
Description
\n Fires at the conclusion of sending a message on a socket\n via the sock_sendmsg function\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,30 +2,30 @@\n Prev\u00a0Chapter\u00a014.\u00a0Socket Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::socket.sendmsg.return \u2014 Return from socket.sendmsg.\n ***** Synopsis *****\n socket.sendmsg.return\n ***** Values *****\n- flags\n- Socket flags value\n- protocol\n- Protocol value\n- family\n- Protocol family value\n- name\n- Name of this probe\n- type\n- Socket type value\n success\n Was send successful? (1 = yes, 0 = no)\n- state\n- Socket state value\n size\n Size of message sent (in bytes) or error code if success = 0\n+ name\n+ Name of this probe\n+ family\n+ Protocol family value\n+ state\n+ Socket state value\n+ protocol\n+ Protocol value\n+ flags\n+ Socket flags value\n+ type\n+ Socket type value\n ***** Context *****\n The message sender.\n ***** Description *****\n Fires at the conclusion of sending a message on a socket via the sock_sendmsg\n function\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-socket-sendmsg.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-socket-sendmsg.html", "unified_diff": "@@ -1,22 +1,22 @@\n probe::socket.sendmsg
probe::socket.sendmsg — \n Message is currently being sent on a socket.\n-
Synopsis
socket.sendmsg
Values
flags
\n- Socket flags value\n-
name
\n+
Synopsis
socket.sendmsg
Values
name
\n Name of this probe\n-
type
\n- Socket type value\n+
size
\n+ Message size in bytes\n
protocol
\n Protocol value\n-
family
\n- Protocol family value\n
state
\n Socket state value\n-
size
\n- Message size in bytes\n-
Context
\n+
family
\n+ Protocol family value\n+
type
\n+ Socket type value\n+
flags
\n+ Socket flags value\n+
Context
\n The message sender\n-
Description
\n+
Description
\n Fires at the beginning of sending a message on a socket\n via the sock_sendmsg function\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,28 +2,28 @@\n Prev\u00a0Chapter\u00a014.\u00a0Socket Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::socket.sendmsg \u2014 Message is currently being sent on a socket.\n ***** Synopsis *****\n socket.sendmsg\n ***** Values *****\n- flags\n- Socket flags value\n name\n Name of this probe\n- type\n- Socket type value\n+ size\n+ Message size in bytes\n protocol\n Protocol value\n- family\n- Protocol family value\n state\n Socket state value\n- size\n- Message size in bytes\n+ family\n+ Protocol family value\n+ type\n+ Socket type value\n+ flags\n+ Socket flags value\n ***** Context *****\n The message sender\n ***** Description *****\n Fires at the beginning of sending a message on a socket via the sock_sendmsg\n function\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-socket-write-iter-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-socket-write-iter-return.html", "unified_diff": "@@ -1,24 +1,24 @@\n probe::socket.write_iter.return
probe::socket.write_iter.return — \n Conclusion of message send via sock_write_iter\n-
Synopsis
socket.write_iter.return
Values
protocol
\n+
Synopsis
socket.write_iter.return
Values
success
\n+ Was receive successful? (1 = yes, 0 = no)\n+
size
\n+ Size of message received (in bytes) or error code if success = 0\n+
name
\n+ Name of this probe\n+
protocol
\n Protocol value\n+
state
\n+ Socket state value\n
family
\n Protocol family value\n-
name
\n- Name of this probe\n
type
\n Socket type value\n-
success
\n- Was receive successful? (1 = yes, 0 = no)\n-
state
\n- Socket state value\n-
size
\n- Size of message received (in bytes) or error code if success = 0\n
flags
\n Socket flags value\n-
Context
\n+
Context
\n The message receiver.\n-
Description
\n+
Description
\n Fires at the conclusion of sending a message on a socket\n via the sock_write_iter function\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,28 +3,28 @@\n ===============================================================================\n ***** Name *****\n probe::socket.write_iter.return \u2014 Conclusion of message send via\n sock_write_iter\n ***** Synopsis *****\n socket.write_iter.return\n ***** Values *****\n+ success\n+ Was receive successful? (1 = yes, 0 = no)\n+ size\n+ Size of message received (in bytes) or error code if success = 0\n+ name\n+ Name of this probe\n protocol\n Protocol value\n+ state\n+ Socket state value\n family\n Protocol family value\n- name\n- Name of this probe\n type\n Socket type value\n- success\n- Was receive successful? (1 = yes, 0 = no)\n- state\n- Socket state value\n- size\n- Size of message received (in bytes) or error code if success = 0\n flags\n Socket flags value\n ***** Context *****\n The message receiver.\n ***** Description *****\n Fires at the conclusion of sending a message on a socket via the\n sock_write_iter function\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-socket-write-iter.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-socket-write-iter.html", "unified_diff": "@@ -1,22 +1,22 @@\n probe::socket.write_iter
probe::socket.write_iter — \n Message send via sock_write_iter\n-
Synopsis
socket.write_iter
Values
flags
\n+
Synopsis
socket.write_iter
Values
flags
\n Socket flags value\n-
state
\n- Socket state value\n-
size
\n- Message size in bytes\n-
name
\n- Name of this probe\n
type
\n Socket type value\n-
family
\n- Protocol family value\n
protocol
\n Protocol value\n-
Context
\n+
state
\n+ Socket state value\n+
family
\n+ Protocol family value\n+
name
\n+ Name of this probe\n+
size
\n+ Message size in bytes\n+
Context
\n The message sender\n-
Description
\n+
Description
\n Fires at the beginning of sending a message on a socket\n via the sock_write_iter function\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,26 +4,26 @@\n ***** Name *****\n probe::socket.write_iter \u2014 Message send via sock_write_iter\n ***** Synopsis *****\n socket.write_iter\n ***** Values *****\n flags\n Socket flags value\n- state\n- Socket state value\n- size\n- Message size in bytes\n- name\n- Name of this probe\n type\n Socket type value\n- family\n- Protocol family value\n protocol\n Protocol value\n+ state\n+ Socket state value\n+ family\n+ Protocol family value\n+ name\n+ Name of this probe\n+ size\n+ Message size in bytes\n ***** Context *****\n The message sender\n ***** Description *****\n Fires at the beginning of sending a message on a socket via the sock_write_iter\n function\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-socket-writev-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-socket-writev-return.html", "unified_diff": "@@ -1,24 +1,24 @@\n probe::socket.writev.return
probe::socket.writev.return — \n Conclusion of message sent via socket_writev\n-
Synopsis
socket.writev.return
Values
state
\n- Socket state value\n+
Synopsis
socket.writev.return
Values
name
\n+ Name of this probe\n
size
\n Size of message sent (in bytes) or error code if success = 0\n-
family
\n- Protocol family value\n+
success
\n+ Was send successful? (1 = yes, 0 = no)\n
protocol
\n Protocol value\n-
name
\n- Name of this probe\n+
state
\n+ Socket state value\n+
family
\n+ Protocol family value\n
type
\n Socket type value\n-
success
\n- Was send successful? (1 = yes, 0 = no)\n
flags
\n Socket flags value\n-
Context
\n+
Context
\n The message receiver.\n-
Description
\n+
Description
\n Fires at the conclusion of sending a message on a socket\n via the sock_writev function\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,28 +2,28 @@\n Prev\u00a0Chapter\u00a014.\u00a0Socket Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::socket.writev.return \u2014 Conclusion of message sent via socket_writev\n ***** Synopsis *****\n socket.writev.return\n ***** Values *****\n- state\n- Socket state value\n+ name\n+ Name of this probe\n size\n Size of message sent (in bytes) or error code if success = 0\n- family\n- Protocol family value\n+ success\n+ Was send successful? (1 = yes, 0 = no)\n protocol\n Protocol value\n- name\n- Name of this probe\n+ state\n+ Socket state value\n+ family\n+ Protocol family value\n type\n Socket type value\n- success\n- Was send successful? (1 = yes, 0 = no)\n flags\n Socket flags value\n ***** Context *****\n The message receiver.\n ***** Description *****\n Fires at the conclusion of sending a message on a socket via the sock_writev\n function\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-socket-writev.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-socket-writev.html", "unified_diff": "@@ -1,22 +1,22 @@\n probe::socket.writev
probe::socket.writev — \n Message sent via socket_writev\n-
Synopsis
socket.writev
Values
size
\n- Message size in bytes\n+
Synopsis
socket.writev
Values
type
\n+ Socket type value\n+
flags
\n+ Socket flags value\n
state
\n Socket state value\n-
type
\n- Socket type value\n-
name
\n- Name of this probe\n
protocol
\n Protocol value\n
family
\n Protocol family value\n-
flags
\n- Socket flags value\n-
Context
\n+
name
\n+ Name of this probe\n+
size
\n+ Message size in bytes\n+
Context
\n The message sender\n-
Description
\n+
Description
\n Fires at the beginning of sending a message on a socket\n via the sock_writev function\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,28 +2,28 @@\n Prev\u00a0Chapter\u00a014.\u00a0Socket Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::socket.writev \u2014 Message sent via socket_writev\n ***** Synopsis *****\n socket.writev\n ***** Values *****\n- size\n- Message size in bytes\n- state\n- Socket state value\n type\n Socket type value\n- name\n- Name of this probe\n+ flags\n+ Socket flags value\n+ state\n+ Socket state value\n protocol\n Protocol value\n family\n Protocol family value\n- flags\n- Socket flags value\n+ name\n+ Name of this probe\n+ size\n+ Message size in bytes\n ***** Context *****\n The message sender\n ***** Description *****\n Fires at the beginning of sending a message on a socket via the sock_writev\n function\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-softirq-entry.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-softirq-entry.html", "unified_diff": "@@ -1,11 +1,11 @@\n probe::softirq.entry
function::speculation — \n Allocate a new id for speculative output\n
Synopsis
\n speculation:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n
\n \n The speculation function is called when a new speculation buffer is needed.\n It returns an id for the speculative output.\n There can be multiple threads being speculated on concurrently.\n This id is used by other speculation functions to keep the threads\n separate.\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sprint-backtrace.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sprint-backtrace.html", "unified_diff": "@@ -1,14 +1,14 @@\n
function::sprint_backtrace — \n Return stack back trace as string\n
Synopsis
\n sprint_backtrace:string()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n
\n \n Returns a simple (kernel) backtrace. One line per address.\n Includes the symbol name (or hex address if symbol\n couldn't be resolved) and module name (if found). Includes the\n offset from the start of the function if found, otherwise the\n offset will be added to the module (if found, between\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sprint-loadavg.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sprint-loadavg.html", "unified_diff": "@@ -1,10 +1,10 @@\n
function::sprint_stack — \n Return stack for kernel addresses from string\n
Synopsis
\n sprint_stack:string(stk:string)\n-
Arguments
stk
\n+
Arguments
stk
\n String with list of hexadecimal (kernel) addresses\n-
Description
\n+
Description
\n Perform a symbolic lookup of the addresses in the given string,\n which is assumed to be the result of a prior call to backtrace.\n
\n \n Returns a simple backtrace from the given hex string. One line per\n address. Includes the symbol name (or hex address if symbol\n couldn't be resolved) and module name (if found). Includes the\n offset from the start of the function if found, otherwise the\n offset will be added to the module (if found, between\n brackets). Returns the backtrace as string (each line terminated by\n a newline character). Note that the returned stack will be\n truncated to MAXSTRINGLEN, to print fuller and richer stacks use\n print_stack.\n-
NOTE
\n+
NOTE
\n it is recommended to use sprint_syms instead of this function.\n
function::sprint_syms — \n Return stack for kernel addresses from string\n
Synopsis
\n sprint_syms(callers:string)\n-
Arguments
callers
\n+
Arguments
callers
\n String with list of hexadecimal (kernel) addresses\n-
Description
\n+
Description
\n Perform a symbolic lookup of the addresses in the given string,\n which are assumed to be the result of a prior calls to stack,\n callers, and similar functions.\n
\n \n Returns a simple backtrace from the given hex string. One line per\n address. Includes the symbol name (or hex address if symbol\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sprint-ubacktrace.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sprint-ubacktrace.html", "unified_diff": "@@ -1,25 +1,25 @@\n
function::sprint_ubacktrace — \n Return stack back trace for current user-space task as string.\n
Synopsis
\n sprint_ubacktrace:string()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n
\n \n Returns a simple backtrace for the current task. One line per\n address. Includes the symbol name (or hex address if symbol\n couldn't be resolved) and module name (if found). Includes the\n offset from the start of the function if found, otherwise the\n offset will be added to the module (if found, between\n brackets). Returns the backtrace as string (each line terminated by\n a newline character). Note that the returned stack will be\n truncated to MAXSTRINGLEN, to print fuller and richer stacks use\n print_ubacktrace. Equivalent to sprint_ustack(ubacktrace),\n but more efficient (no need to translate between hex strings and\n final backtrace string).\n-
Note
\n+
Note
\n To get (full) backtraces for user space applications and shared\n shared libraries not mentioned in the current script run stap with\n -d /path/to/exe-or-so and/or add --ldd to load all needed unwind data.\n
function::sprint_ustack — \n Return stack for the current task from string.\n
Synopsis
\n sprint_ustack:string(stk:string)\n-
Arguments
stk
\n+
Arguments
stk
\n String with list of hexadecimal addresses for the current task.\n-
Description
\n+
Description
\n Perform a symbolic lookup of the addresses in the given string,\n which is assumed to be the result of a prior call to\n ubacktrace for the current task.\n
\n \n Returns a simple backtrace from the given hex string. One line per\n address. Includes the symbol name (or hex address if symbol\n couldn't be resolved) and module name (if found). Includes the\n offset from the start of the function if found, otherwise the\n offset will be added to the module (if found, between\n brackets). Returns the backtrace as string (each line terminated by\n a newline character). Note that the returned stack will be\n truncated to MAXSTRINGLEN, to print fuller and richer stacks use\n print_ustack.\n-
NOTE
\n+
NOTE
\n it is recommended to use sprint_usyms instead of this function.\n
function::sprint_usyms — \n Return stack for user addresses from string\n
Synopsis
\n sprint_usyms(callers:string)\n-
Arguments
callers
\n+
Arguments
callers
\n String with list of hexadecimal (user) addresses\n-
Description
\n+
Description
\n Perform a symbolic lookup of the addresses in the given string,\n which are assumed to be the result of a prior calls to ustack,\n ucallers, and similar functions.\n
\n \n Returns a simple backtrace from the given hex string. One line per\n address. Includes the symbol name (or hex address if symbol\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-stack-size.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-stack-size.html", "unified_diff": "@@ -1,9 +1,9 @@\n
function::stack — \n Return address at given depth of kernel stack backtrace\n
Synopsis
\n stack:long(n:long)\n-
Arguments
n
\n+
Arguments
n
\n number of levels to descend in the stack.\n-
Description
\n+
Description
\n Performs a simple (kernel) backtrace, and returns the\n element at the specified position. The results of the backtrace itself\n are cached, so that the backtrace computation is performed at most once\n no matter how many times stack is called, or in what order.\n
probe::stap.cache_add_mod — \n Adding kernel instrumentation module to cache\n-
Synopsis
stap.cache_add_mod
Values
source_path
\n- the path the .ko file is coming from (incl filename)\n-
dest_path
\n+
Synopsis
stap.cache_add_mod
Values
dest_path
\n the path the .ko file is going to (incl filename)\n-
Description
\n+
source_path
\n+ the path the .ko file is coming from (incl filename)\n+
Description
\n Fires just before the file is actually moved. Note: if moving fails,\n cache_add_src and cache_add_nss will not fire.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,17 +2,17 @@\n Prev\u00a0Chapter\u00a030.\u00a0SystemTap Translator Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::stap.cache_add_mod \u2014 Adding kernel instrumentation module to cache\n ***** Synopsis *****\n stap.cache_add_mod\n ***** Values *****\n- source_path\n- the path the .ko file is coming from (incl filename)\n dest_path\n the path the .ko file is going to (incl filename)\n+ source_path\n+ the path the .ko file is coming from (incl filename)\n ***** Description *****\n Fires just before the file is actually moved. Note: if moving fails,\n cache_add_src and cache_add_nss will not fire.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n Chapter\u00a030.\u00a0SystemTap Translator TapsetHome \u00a0probe::stap.cache_add_nss\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-stap-cache-add-nss.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-stap-cache-add-nss.html", "unified_diff": "@@ -1,11 +1,11 @@\n probe::stap.cache_add_nss
probe::stap.cache_add_nss — \n Add NSS (Network Security Services) information to cache\n-
Synopsis
stap.cache_add_nss
Values
dest_path
\n+
Synopsis
stap.cache_add_nss
Values
source_path
\n the path the .sgn file is coming from (incl filename)\n-
source_path
\n+
dest_path
\n the path the .sgn file is coming from (incl filename)\n-
Description
\n+
Description
\n Fires just before the file is actually moved. Note: stap must compiled\n with NSS support; if moving the kernel module fails, this probe will\n not fire.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,17 +3,17 @@\n ===============================================================================\n ***** Name *****\n probe::stap.cache_add_nss \u2014 Add NSS (Network Security Services) information to\n cache\n ***** Synopsis *****\n stap.cache_add_nss\n ***** Values *****\n- dest_path\n- the path the .sgn file is coming from (incl filename)\n source_path\n the path the .sgn file is coming from (incl filename)\n+ dest_path\n+ the path the .sgn file is coming from (incl filename)\n ***** Description *****\n Fires just before the file is actually moved. Note: stap must compiled with NSS\n support; if moving the kernel module fails, this probe will not fire.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::stap.cache_add_mod\u00a0Home \u00a0probe::stap.cache_add_src\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-stap-cache-add-src.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-stap-cache-add-src.html", "unified_diff": "@@ -1,10 +1,10 @@\n probe::stap.cache_add_src
probe::stap.cache_add_src — \n Adding C code translation to cache\n-
Synopsis
stap.cache_add_src
Values
dest_path
\n- the path the .c file is going to (incl filename)\n-
source_path
\n+
Synopsis
stap.cache_add_src
Values
source_path
\n the path the .c file is coming from (incl filename)\n-
Description
\n+
dest_path
\n+ the path the .c file is going to (incl filename)\n+
Description
\n Fires just before the file is actually moved. Note: if moving the\n kernel module fails, this probe will not fire.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,17 +2,17 @@\n Prev\u00a0Chapter\u00a030.\u00a0SystemTap Translator Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::stap.cache_add_src \u2014 Adding C code translation to cache\n ***** Synopsis *****\n stap.cache_add_src\n ***** Values *****\n- dest_path\n- the path the .c file is going to (incl filename)\n source_path\n the path the .c file is coming from (incl filename)\n+ dest_path\n+ the path the .c file is going to (incl filename)\n ***** Description *****\n Fires just before the file is actually moved. Note: if moving the kernel module\n fails, this probe will not fire.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::stap.cache_add_nss\u00a0Home \u00a0probe::stap.cache_clean\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-stap-cache-clean.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-stap-cache-clean.html", "unified_diff": "@@ -1,7 +1,7 @@\n probe::stap.cache_clean
probe::stapio.receive_control_message — \n Received a control message\n-
Synopsis
stapio.receive_control_message
Values
data
\n- a ptr to a binary blob of data sent as the control message\n-
len
\n+
Synopsis
stapio.receive_control_message
Values
len
\n the length (in bytes) of the data blob\n+
data
\n+ a ptr to a binary blob of data sent as the control message\n
type
\n type of message being send; defined in runtime/transport/transport_msgs.h\n-
Description
\n+
Description
\n Fires just after a message was receieved and before it's processed.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a030.\u00a0SystemTap Translator Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::stapio.receive_control_message \u2014 Received a control message\n ***** Synopsis *****\n stapio.receive_control_message\n ***** Values *****\n- data\n- a ptr to a binary blob of data sent as the control message\n len\n the length (in bytes) of the data blob\n+ data\n+ a ptr to a binary blob of data sent as the control message\n type\n type of message being send; defined in runtime/transport/transport_msgs.h\n ***** Description *****\n Fires just after a message was receieved and before it's processed.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::stap.system.spawn\u00a0Home \u00a0probe::staprun.insert_module\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-staprun-insert-module.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-staprun-insert-module.html", "unified_diff": "@@ -1,7 +1,7 @@\n probe::staprun.insert_module
function::stp_pid — \n The process id of the stapio process\n
Synopsis
\n stp_pid:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function returns the process id of the\n stapio process that launched this script. There could be\n other SystemTap scripts and stapio processes running on\n the system.\n
function::string_quoted — \n Quotes a given string\n
Synopsis
\n string_quoted:string(str:string)\n-
Arguments
str
\n+
Arguments
str
\n The kernel address to retrieve the string from\n-
Description
\n+
Description
\n Returns the quoted string version of the given string,\n with characters where any ASCII characters that are not printable\n are replaced by the corresponding escape sequence in the returned\n string. Note that the string will be surrounded by double quotes.\n
function::stringat — \n Returns the char at a given position in the string\n
Synopsis
\n stringat:long(str:string,pos:long)\n-
Arguments
str
\n+
Arguments
str
\n the string to fetch the character from\n
pos
\n the position to get the character from (first character is 0)\n-
Description
\n+
Description
\n This function returns the character at a given position in\n the string or zero if the string doesn't have as many characters. Reports\n an error if pos is out of bounds.\n
function::strpos — \n Returns location of a substring within another string\n
Synopsis
\n strpos:long(s1:string,s2:string)\n-
Arguments
s1
\n+
Arguments
s1
\n string to search in\n
s2
\n substring to find\n-
Description
\n+
Description
\n This function returns location of the first occurence of string\n s2 within s1, namely the return value is 0 in case s2 is a prefix of s1.\n If s2 is not a substring of s1, then the return value is -1.\n
function::strtol — \n strtol - Convert a string to a long\n
Synopsis
\n strtol:long(str:string,base:long)\n-
Arguments
str
\n+
Arguments
str
\n string to convert\n
base
\n the base to use\n-
Description
\n+
Description
\n This function converts the string representation of a number to an integer. \n The base parameter indicates the number base to assume for the string (eg. 16 for hex, 8 for octal, 2 for binary).\n
\n starting position of the extracted string (first character is 0)\n
length
\n length of string to return\n-
Description
\n+
Description
\n Returns the substring of the given string at the given\n start position with the given length (or smaller if the length of the\n original string is less than start + length, or length is bigger than\n MAXSTRINGLEN).\n
probe::sunrpc.clnt.bind_new_program — \n Bind a new RPC program to an existing client\n-
Synopsis
sunrpc.clnt.bind_new_program
Values
old_vers
\n+
Synopsis
sunrpc.clnt.bind_new_program
Values
old_vers
\n the version of old RPC program\n
old_prog
\n the number of old RPC program\n-
vers
\n- the version of new RPC program\n-
servername
\n- the server machine name\n-
progname
\n- the name of new RPC program\n
prog
\n the number of new RPC program\n+
progname
\n+ the name of new RPC program\n+
servername
\n+ the server machine name\n+
vers
\n+ the version of new RPC program\n
old_progname
\n the name of old RPC program\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -7,20 +7,20 @@\n ***** Synopsis *****\n sunrpc.clnt.bind_new_program\n ***** Values *****\n old_vers\n the version of old RPC program\n old_prog\n the number of old RPC program\n- vers\n- the version of new RPC program\n- servername\n- the server machine name\n- progname\n- the name of new RPC program\n prog\n the number of new RPC program\n+ progname\n+ the name of new RPC program\n+ servername\n+ the server machine name\n+ vers\n+ the version of new RPC program\n old_progname\n the name of old RPC program\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::netfilter.ip.pre_routing\u00a0Home \u00a0probe::sunrpc.clnt.call_async\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-clnt-call-async.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-clnt-call-async.html", "unified_diff": "@@ -1,25 +1,25 @@\n probe::sunrpc.clnt.call_async
probe::sunrpc.clnt.call_async — \n Make an asynchronous RPC call\n-
Synopsis
sunrpc.clnt.call_async
Values
vers
\n- the RPC program version number\n-
flags
\n- flags\n-
dead
\n- whether this client is abandoned\n-
prot
\n+
Synopsis
sunrpc.clnt.call_async
Values
prot
\n the IP protocol number\n+
procname
\n+ the procedure name in this RPC call\n+
proc
\n+ the procedure number in this RPC call\n
port
\n the port number\n+
flags
\n+ flags\n+
vers
\n+ the RPC program version number\n+
servername
\n+ the server machine name\n
xid
\n current transmission id\n-
proc
\n- the procedure number in this RPC call\n-
prog
\n- the RPC program number\n-
procname
\n- the procedure name in this RPC call\n
progname
\n the RPC program name\n-
servername
\n- the server machine name\n+
prog
\n+ the RPC program number\n+
dead
\n+ whether this client is abandoned\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,32 +2,32 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::sunrpc.clnt.call_async \u2014 Make an asynchronous RPC call\n ***** Synopsis *****\n sunrpc.clnt.call_async\n ***** Values *****\n- vers\n- the RPC program version number\n- flags\n- flags\n- dead\n- whether this client is abandoned\n prot\n the IP protocol number\n+ procname\n+ the procedure name in this RPC call\n+ proc\n+ the procedure number in this RPC call\n port\n the port number\n+ flags\n+ flags\n+ vers\n+ the RPC program version number\n+ servername\n+ the server machine name\n xid\n current transmission id\n- proc\n- the procedure number in this RPC call\n- prog\n- the RPC program number\n- procname\n- the procedure name in this RPC call\n progname\n the RPC program name\n- servername\n- the server machine name\n+ prog\n+ the RPC program number\n+ dead\n+ whether this client is abandoned\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::sunrpc.clnt.bind_new_program\u00a0Home \u00a0probe::sunrpc.clnt.call_sync\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-clnt-call-sync.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-clnt-call-sync.html", "unified_diff": "@@ -1,25 +1,25 @@\n probe::sunrpc.clnt.call_sync
probe::sunrpc.clnt.call_sync — \n Make a synchronous RPC call\n-
Synopsis
sunrpc.clnt.call_sync
Values
port
\n- the port number\n-
prot
\n- the IP protocol number\n-
procname
\n- the procedure name in this RPC call\n+
Synopsis
sunrpc.clnt.call_sync
Values
dead
\n+ whether this client is abandoned\n+
prog
\n+ the RPC program number\n
servername
\n the server machine name\n+
vers
\n+ the RPC program version number\n
progname
\n the RPC program name\n-
proc
\n- the procedure number in this RPC call\n
xid
\n current transmission id\n-
prog
\n- the RPC program number\n-
vers
\n- the RPC program version number\n-
dead
\n- whether this client is abandoned\n+
proc
\n+ the procedure number in this RPC call\n+
port
\n+ the port number\n
flags
\n flags\n+
prot
\n+ the IP protocol number\n+
procname
\n+ the procedure name in this RPC call\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,32 +2,32 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::sunrpc.clnt.call_sync \u2014 Make a synchronous RPC call\n ***** Synopsis *****\n sunrpc.clnt.call_sync\n ***** Values *****\n- port\n- the port number\n- prot\n- the IP protocol number\n- procname\n- the procedure name in this RPC call\n+ dead\n+ whether this client is abandoned\n+ prog\n+ the RPC program number\n servername\n the server machine name\n+ vers\n+ the RPC program version number\n progname\n the RPC program name\n- proc\n- the procedure number in this RPC call\n xid\n current transmission id\n- prog\n- the RPC program number\n- vers\n- the RPC program version number\n- dead\n- whether this client is abandoned\n+ proc\n+ the procedure number in this RPC call\n+ port\n+ the port number\n flags\n flags\n+ prot\n+ the IP protocol number\n+ procname\n+ the procedure name in this RPC call\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::sunrpc.clnt.call_async\u00a0Home \u00a0probe::sunrpc.clnt.clone_client\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-clnt-clone-client.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-clnt-clone-client.html", "unified_diff": "@@ -1,17 +1,17 @@\n probe::sunrpc.clnt.clone_client
probe::sunrpc.clnt.clone_client — \n Clone an RPC client structure\n-
Synopsis
sunrpc.clnt.clone_client
Values
prot
\n+
Synopsis
sunrpc.clnt.clone_client
Values
prog
\n+ the RPC program number\n+
authflavor
\n+ the authentication flavor\n+
port
\n+ the port number\n+
servername
\n+ the server machine name\n+
prot
\n the IP protocol number\n
vers
\n the RPC program version number\n-
port
\n- the port number\n-
authflavor
\n- the authentication flavor\n-
prog
\n- the RPC program number\n
progname
\n the RPC program name\n-
servername
\n- the server machine name\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,24 +2,24 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::sunrpc.clnt.clone_client \u2014 Clone an RPC client structure\n ***** Synopsis *****\n sunrpc.clnt.clone_client\n ***** Values *****\n+ prog\n+ the RPC program number\n+ authflavor\n+ the authentication flavor\n+ port\n+ the port number\n+ servername\n+ the server machine name\n prot\n the IP protocol number\n vers\n the RPC program version number\n- port\n- the port number\n- authflavor\n- the authentication flavor\n- prog\n- the RPC program number\n progname\n the RPC program name\n- servername\n- the server machine name\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::sunrpc.clnt.call_sync\u00a0Home \u00a0probe::sunrpc.clnt.create_client\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-clnt-create-client.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-clnt-create-client.html", "unified_diff": "@@ -1,17 +1,17 @@\n probe::sunrpc.clnt.create_client
probe::sunrpc.clnt.create_client — \n Create an RPC client\n-
Synopsis
sunrpc.clnt.create_client
Values
vers
\n- the RPC program version number\n+
Synopsis
sunrpc.clnt.create_client
Values
authflavor
\n+ the authentication flavor\n
port
\n the port number\n+
prog
\n+ the RPC program number\n+
progname
\n+ the RPC program name\n
prot
\n the IP protocol number\n
servername
\n the server machine name\n-
progname
\n- the RPC program name\n-
prog
\n- the RPC program number\n-
authflavor
\n- the authentication flavor\n+
vers
\n+ the RPC program version number\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,24 +2,24 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::sunrpc.clnt.create_client \u2014 Create an RPC client\n ***** Synopsis *****\n sunrpc.clnt.create_client\n ***** Values *****\n- vers\n- the RPC program version number\n+ authflavor\n+ the authentication flavor\n port\n the port number\n+ prog\n+ the RPC program number\n+ progname\n+ the RPC program name\n prot\n the IP protocol number\n servername\n the server machine name\n- progname\n- the RPC program name\n- prog\n- the RPC program number\n- authflavor\n- the authentication flavor\n+ vers\n+ the RPC program version number\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::sunrpc.clnt.clone_client\u00a0Home \u00a0probe::sunrpc.clnt.restart_call\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-clnt-restart-call.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-clnt-restart-call.html", "unified_diff": "@@ -1,17 +1,17 @@\n probe::sunrpc.clnt.restart_call
probe::sunrpc.clnt.restart_call — \n Restart an asynchronous RPC call\n-
Synopsis
sunrpc.clnt.restart_call
Values
prog
\n- the RPC program number\n-
tk_pid
\n+
Synopsis
sunrpc.clnt.restart_call
Values
tk_pid
\n the debugging aid of task\n-
xid
\n- the transmission id\n-
servername
\n- the server machine name\n-
tk_flags
\n- the task flags\n
tk_runstate
\n the task run status\n+
prog
\n+ the RPC program number\n+
tk_flags
\n+ the task flags\n
tk_priority
\n the task priority\n+
servername
\n+ the server machine name\n+
xid
\n+ the transmission id\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,24 +2,24 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::sunrpc.clnt.restart_call \u2014 Restart an asynchronous RPC call\n ***** Synopsis *****\n sunrpc.clnt.restart_call\n ***** Values *****\n- prog\n- the RPC program number\n tk_pid\n the debugging aid of task\n- xid\n- the transmission id\n- servername\n- the server machine name\n- tk_flags\n- the task flags\n tk_runstate\n the task run status\n+ prog\n+ the RPC program number\n+ tk_flags\n+ the task flags\n tk_priority\n the task priority\n+ servername\n+ the server machine name\n+ xid\n+ the transmission id\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::sunrpc.clnt.create_client\u00a0Home \u00a0probe::sunrpc.clnt.shutdown_client\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-clnt-shutdown-client.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-clnt-shutdown-client.html", "unified_diff": "@@ -1,39 +1,39 @@\n probe::sunrpc.clnt.shutdown_client
probe::sunrpc.clnt.shutdown_client — \n Shutdown an RPC client\n-
Synopsis
sunrpc.clnt.shutdown_client
Values
netreconn
\n- the count of reconnections\n-
rpccnt
\n- the count of RPC calls\n-
om_ops
\n- the count of operations\n-
om_execute
\n+
Synopsis
sunrpc.clnt.shutdown_client
Values
om_execute
\n the RPC execution jiffies\n-
om_bytes_sent
\n- the count of bytes out\n+
port
\n+ the port number\n
om_ntrans
\n the count of RPC transmissions\n-
vers
\n- the RPC program version number\n-
clones
\n- the number of clones\n+
om_bytes_recv
\n+ the count of bytes in\n+
netreconn
\n+ the count of reconnections\n+
om_bytes_sent
\n+ the count of bytes out\n+
authflavor
\n+ the authentication flavor\n
om_queue
\n the jiffies queued for xmit\n+
prot
\n+ the IP protocol number\n
prog
\n the RPC program number\n-
authflavor
\n- the authentication flavor\n+
clones
\n+ the number of clones\n+
rpccnt
\n+ the count of RPC calls\n+
tasks
\n+ the number of references\n
om_rtt
\n the RPC RTT jiffies\n
servername
\n the server machine name\n-
tasks
\n- the number of references\n+
vers
\n+ the RPC program version number\n+
om_ops
\n+ the count of operations\n
progname
\n the RPC program name\n-
om_bytes_recv
\n- the count of bytes in\n-
prot
\n- the IP protocol number\n-
port
\n- the port number\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,46 +2,46 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::sunrpc.clnt.shutdown_client \u2014 Shutdown an RPC client\n ***** Synopsis *****\n sunrpc.clnt.shutdown_client\n ***** Values *****\n- netreconn\n- the count of reconnections\n- rpccnt\n- the count of RPC calls\n- om_ops\n- the count of operations\n om_execute\n the RPC execution jiffies\n- om_bytes_sent\n- the count of bytes out\n+ port\n+ the port number\n om_ntrans\n the count of RPC transmissions\n- vers\n- the RPC program version number\n- clones\n- the number of clones\n+ om_bytes_recv\n+ the count of bytes in\n+ netreconn\n+ the count of reconnections\n+ om_bytes_sent\n+ the count of bytes out\n+ authflavor\n+ the authentication flavor\n om_queue\n the jiffies queued for xmit\n+ prot\n+ the IP protocol number\n prog\n the RPC program number\n- authflavor\n- the authentication flavor\n+ clones\n+ the number of clones\n+ rpccnt\n+ the count of RPC calls\n+ tasks\n+ the number of references\n om_rtt\n the RPC RTT jiffies\n servername\n the server machine name\n- tasks\n- the number of references\n+ vers\n+ the RPC program version number\n+ om_ops\n+ the count of operations\n progname\n the RPC program name\n- om_bytes_recv\n- the count of bytes in\n- prot\n- the IP protocol number\n- port\n- the port number\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::sunrpc.clnt.restart_call\u00a0Home \u00a0probe::sunrpc.sched.delay\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-sched-delay.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-sched-delay.html", "unified_diff": "@@ -1,17 +1,17 @@\n probe::sunrpc.sched.delay
probe::sunrpc.sched.delay — \n Delay an RPC task\n-
Synopsis
sunrpc.sched.delay
Values
prog
\n- the program number in the RPC call\n-
xid
\n- the transmission id in the RPC call\n+
Synopsis
sunrpc.sched.delay
Values
prot
\n+ the IP protocol in the RPC call\n
tk_pid
\n the debugging id of the task\n-
prot
\n- the IP protocol in the RPC call\n-
tk_flags
\n- the flags of the task\n-
delay
\n- the time delayed\n
vers
\n the program version in the RPC call\n+
xid
\n+ the transmission id in the RPC call\n+
delay
\n+ the time delayed\n+
tk_flags
\n+ the flags of the task\n+
prog
\n+ the program number in the RPC call\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,24 +2,24 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::sunrpc.sched.delay \u2014 Delay an RPC task\n ***** Synopsis *****\n sunrpc.sched.delay\n ***** Values *****\n- prog\n- the program number in the RPC call\n- xid\n- the transmission id in the RPC call\n- tk_pid\n- the debugging id of the task\n prot\n the IP protocol in the RPC call\n- tk_flags\n- the flags of the task\n- delay\n- the time delayed\n+ tk_pid\n+ the debugging id of the task\n vers\n the program version in the RPC call\n+ xid\n+ the transmission id in the RPC call\n+ delay\n+ the time delayed\n+ tk_flags\n+ the flags of the task\n+ prog\n+ the program number in the RPC call\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::sunrpc.clnt.shutdown_client\u00a0Home \u00a0probe::sunrpc.sched.execute\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-sched-execute.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-sched-execute.html", "unified_diff": "@@ -1,15 +1,15 @@\n probe::sunrpc.sched.execute
probe::sunrpc.sched.execute — \n Execute the RPC `scheduler'\n-
Synopsis
sunrpc.sched.execute
Values
vers
\n- the program version in the RPC call\n-
tk_flags
\n+
Synopsis
sunrpc.sched.execute
Values
tk_flags
\n the flags of the task\n-
prot
\n- the IP protocol in the RPC call\n-
tk_pid
\n- the debugging id of the task\n-
xid
\n- the transmission id in the RPC call\n
prog
\n the program number in the RPC call\n+
xid
\n+ the transmission id in the RPC call\n+
vers
\n+ the program version in the RPC call\n+
tk_pid
\n+ the debugging id of the task\n+
prot
\n+ the IP protocol in the RPC call\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,22 +2,22 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::sunrpc.sched.execute \u2014 Execute the RPC `scheduler'\n ***** Synopsis *****\n sunrpc.sched.execute\n ***** Values *****\n- vers\n- the program version in the RPC call\n tk_flags\n the flags of the task\n- prot\n- the IP protocol in the RPC call\n- tk_pid\n- the debugging id of the task\n- xid\n- the transmission id in the RPC call\n prog\n the program number in the RPC call\n+ xid\n+ the transmission id in the RPC call\n+ vers\n+ the program version in the RPC call\n+ tk_pid\n+ the debugging id of the task\n+ prot\n+ the IP protocol in the RPC call\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::sunrpc.sched.delay\u00a0Home \u00a0probe::sunrpc.sched.new_task\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-sched-new-task.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-sched-new-task.html", "unified_diff": "@@ -1,13 +1,13 @@\n probe::sunrpc.sched.new_task
probe::sunrpc.sched.new_task — \n Create new task for the specified client\n-
Synopsis
sunrpc.sched.new_task
Values
vers
\n- the program version in the RPC call\n+
Synopsis
sunrpc.sched.new_task
Values
prot
\n+ the IP protocol in the RPC call\n
tk_flags
\n the flags of the task\n-
prot
\n- the IP protocol in the RPC call\n
prog
\n the program number in the RPC call\n+
vers
\n+ the program version in the RPC call\n
xid
\n the transmission id in the RPC call\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,20 +2,20 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::sunrpc.sched.new_task \u2014 Create new task for the specified client\n ***** Synopsis *****\n sunrpc.sched.new_task\n ***** Values *****\n- vers\n- the program version in the RPC call\n- tk_flags\n- the flags of the task\n prot\n the IP protocol in the RPC call\n+ tk_flags\n+ the flags of the task\n prog\n the program number in the RPC call\n+ vers\n+ the program version in the RPC call\n xid\n the transmission id in the RPC call\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::sunrpc.sched.execute\u00a0Home \u00a0probe::sunrpc.sched.release_task\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-sched-release-task.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-sched-release-task.html", "unified_diff": "@@ -1,16 +1,16 @@\n probe::sunrpc.sched.release_task
probe::sunrpc.sched.release_task — \n Release all resources associated with a task\n-
Synopsis
sunrpc.sched.release_task
Values
vers
\n+
Synopsis
sunrpc.sched.release_task
Values
vers
\n the program version in the RPC call\n-
tk_flags
\n- the flags of the task\n-
prot
\n- the IP protocol in the RPC call\n
xid
\n the transmission id in the RPC call\n+
tk_flags
\n+ the flags of the task\n
prog
\n the program number in the RPC call\n-
Description
\n+
prot
\n+ the IP protocol in the RPC call\n+
Description
\n rpc_release_task function might not be found for a particular kernel.\n So, if we can't find it, just return '-1' for everything.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,21 +4,21 @@\n ***** Name *****\n probe::sunrpc.sched.release_task \u2014 Release all resources associated with a task\n ***** Synopsis *****\n sunrpc.sched.release_task\n ***** Values *****\n vers\n the program version in the RPC call\n- tk_flags\n- the flags of the task\n- prot\n- the IP protocol in the RPC call\n xid\n the transmission id in the RPC call\n+ tk_flags\n+ the flags of the task\n prog\n the program number in the RPC call\n+ prot\n+ the IP protocol in the RPC call\n ***** Description *****\n rpc_release_task function might not be found for a particular kernel. So, if we\n can't find it, just return '-1' for everything.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::sunrpc.sched.new_task\u00a0Home \u00a0probe::sunrpc.svc.create\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-svc-create.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-svc-create.html", "unified_diff": "@@ -1,10 +1,10 @@\n probe::sunrpc.svc.create
probe::sunrpc.svc.create — \n Create an RPC service\n-
Synopsis
sunrpc.svc.create
Values
bufsize
\n+
Synopsis
sunrpc.svc.create
Values
bufsize
\n the buffer size\n
progname
\n the name of the program\n
prog
\n the number of the program\n
pg_nvers
\n the number of supported versions\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-svc-destroy.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-svc-destroy.html", "unified_diff": "@@ -1,21 +1,21 @@\n
probe::sunrpc.svc.destroy — \n Destroy an RPC service\n-
Synopsis
sunrpc.svc.destroy
Values
nettcpconn
\n- the count of accepted TCP connections\n-
netcnt
\n- the count of received RPC requests\n+
Synopsis
sunrpc.svc.destroy
Values
rpcbadfmt
\n+ the count of requests dropped for bad formats\n
sv_progname
\n the name of the program\n-
sv_nrthreads
\n- the number of concurrent threads\n-
rpcbadfmt
\n- the count of requests dropped for bad formats\n
sv_name
\n the service name\n
rpccnt
\n the count of valid RPC requests\n-
sv_prog
\n- the number of the program\n
rpcbadauth
\n the count of requests drooped for authentication failure\n+
sv_prog
\n+ the number of the program\n+
netcnt
\n+ the count of received RPC requests\n+
sv_nrthreads
\n+ the number of concurrent threads\n+
nettcpconn
\n+ the count of accepted TCP connections\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,28 +2,28 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::sunrpc.svc.destroy \u2014 Destroy an RPC service\n ***** Synopsis *****\n sunrpc.svc.destroy\n ***** Values *****\n- nettcpconn\n- the count of accepted TCP connections\n- netcnt\n- the count of received RPC requests\n- sv_progname\n- the name of the program\n- sv_nrthreads\n- the number of concurrent threads\n rpcbadfmt\n the count of requests dropped for bad formats\n+ sv_progname\n+ the name of the program\n sv_name\n the service name\n rpccnt\n the count of valid RPC requests\n- sv_prog\n- the number of the program\n rpcbadauth\n the count of requests drooped for authentication failure\n+ sv_prog\n+ the number of the program\n+ netcnt\n+ the count of received RPC requests\n+ sv_nrthreads\n+ the number of concurrent threads\n+ nettcpconn\n+ the count of accepted TCP connections\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::sunrpc.svc.create\u00a0Home \u00a0probe::sunrpc.svc.drop\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-svc-drop.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-svc-drop.html", "unified_diff": "@@ -1,17 +1,17 @@\n probe::sunrpc.svc.drop
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,24 +2,24 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::sunrpc.svc.drop \u2014 Drop RPC request\n ***** Synopsis *****\n sunrpc.svc.drop\n ***** Values *****\n- rq_proc\n- the procedure number in the request\n rq_vers\n the program version in the request\n- sv_name\n- the service name\n- rq_prog\n- the program number in the request\n peer_ip\n the peer address where the request is from\n+ sv_name\n+ the service name\n rq_xid\n the transmission id in the request\n+ rq_proc\n+ the procedure number in the request\n+ rq_prog\n+ the program number in the request\n rq_prot\n the IP protocol of the reqeust\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::sunrpc.svc.destroy\u00a0Home \u00a0probe::sunrpc.svc.process\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-svc-process.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-svc-process.html", "unified_diff": "@@ -1,21 +1,21 @@\n probe::sunrpc.svc.process
probe::sunrpc.svc.process — \n Process an RPC request\n-
Synopsis
sunrpc.svc.process
Values
peer_ip
\n+
Synopsis
sunrpc.svc.process
Values
sv_prog
\n+ the number of the program\n+
rq_vers
\n+ the program version in the request\n+
sv_name
\n+ the service name\n+
peer_ip
\n the peer address where the request is from\n-
rq_prog
\n- the program number in the request\n+
rq_proc
\n+ the procedure number in the request\n
rq_xid
\n the transmission id in the request\n+
rq_prog
\n+ the program number in the request\n
rq_prot
\n the IP protocol of the reqeust\n
sv_nrthreads
\n the number of concurrent threads\n-
rq_vers
\n- the program version in the request\n-
rq_proc
\n- the procedure number in the request\n-
sv_prog
\n- the number of the program\n-
sv_name
\n- the service name\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,28 +2,28 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::sunrpc.svc.process \u2014 Process an RPC request\n ***** Synopsis *****\n sunrpc.svc.process\n ***** Values *****\n+ sv_prog\n+ the number of the program\n+ rq_vers\n+ the program version in the request\n+ sv_name\n+ the service name\n peer_ip\n the peer address where the request is from\n- rq_prog\n- the program number in the request\n+ rq_proc\n+ the procedure number in the request\n rq_xid\n the transmission id in the request\n+ rq_prog\n+ the program number in the request\n rq_prot\n the IP protocol of the reqeust\n sv_nrthreads\n the number of concurrent threads\n- rq_vers\n- the program version in the request\n- rq_proc\n- the procedure number in the request\n- sv_prog\n- the number of the program\n- sv_name\n- the service name\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::sunrpc.svc.drop\u00a0Home \u00a0probe::sunrpc.svc.recv\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-svc-recv.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-svc-recv.html", "unified_diff": "@@ -1,11 +1,11 @@\n probe::sunrpc.svc.recv
probe::sunrpc.svc.recv — \n Listen for the next RPC request on any socket\n-
Synopsis
sunrpc.svc.recv
Values
sv_nrthreads
\n+
Synopsis
sunrpc.svc.recv
Values
sv_nrthreads
\n the number of concurrent threads\n-
timeout
\n- the timeout of waiting for data\n-
sv_prog
\n- the number of the program\n
sv_name
\n the service name\n+
sv_prog
\n+ the number of the program\n+
timeout
\n+ the timeout of waiting for data\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,16 +4,16 @@\n ***** Name *****\n probe::sunrpc.svc.recv \u2014 Listen for the next RPC request on any socket\n ***** Synopsis *****\n sunrpc.svc.recv\n ***** Values *****\n sv_nrthreads\n the number of concurrent threads\n- timeout\n- the timeout of waiting for data\n- sv_prog\n- the number of the program\n sv_name\n the service name\n+ sv_prog\n+ the number of the program\n+ timeout\n+ the timeout of waiting for data\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::sunrpc.svc.process\u00a0Home \u00a0probe::sunrpc.svc.register\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-svc-register.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-svc-register.html", "unified_diff": "@@ -1,15 +1,15 @@\n probe::sunrpc.svc.register
probe::sunrpc.svc.register — \n Register an RPC service with the local portmapper\n-
Synopsis
sunrpc.svc.register
Values
sv_name
\n+
Synopsis
sunrpc.svc.register
Values
sv_name
\n the service name\n-
prot
\n- the IP protocol number\n-
port
\n- the port number\n
prog
\n the number of the program\n
progname
\n the name of the program\n-
Description
\n+
port
\n+ the port number\n+
prot
\n+ the IP protocol number\n+
Description
\n If proto and port are both 0, then unregister a service.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,20 +4,20 @@\n ***** Name *****\n probe::sunrpc.svc.register \u2014 Register an RPC service with the local portmapper\n ***** Synopsis *****\n sunrpc.svc.register\n ***** Values *****\n sv_name\n the service name\n- prot\n- the IP protocol number\n- port\n- the port number\n prog\n the number of the program\n progname\n the name of the program\n+ port\n+ the port number\n+ prot\n+ the IP protocol number\n ***** Description *****\n If proto and port are both 0, then unregister a service.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::sunrpc.svc.recv\u00a0Home \u00a0probe::sunrpc.svc.send\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-svc-send.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-sunrpc-svc-send.html", "unified_diff": "@@ -1,17 +1,17 @@\n probe::sunrpc.svc.send
probe::sunrpc.svc.send — \n Return reply to RPC client\n-
Synopsis
sunrpc.svc.send
Values
rq_proc
\n+
Synopsis
sunrpc.svc.send
Values
rq_proc
\n the procedure number in the request\n+
rq_xid
\n+ the transmission id in the request\n+
rq_prog
\n+ the program number in the request\n
rq_vers
\n the program version in the request\n-
sv_name
\n- the service name\n
peer_ip
\n the peer address where the request is from\n-
rq_prog
\n- the program number in the request\n+
sv_name
\n+ the service name\n
rq_prot
\n the IP protocol of the reqeust\n-
rq_xid
\n- the transmission id in the request\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,22 +4,22 @@\n ***** Name *****\n probe::sunrpc.svc.send \u2014 Return reply to RPC client\n ***** Synopsis *****\n sunrpc.svc.send\n ***** Values *****\n rq_proc\n the procedure number in the request\n+ rq_xid\n+ the transmission id in the request\n+ rq_prog\n+ the program number in the request\n rq_vers\n the program version in the request\n- sv_name\n- the service name\n peer_ip\n the peer address where the request is from\n- rq_prog\n- the program number in the request\n+ sv_name\n+ the service name\n rq_prot\n the IP protocol of the reqeust\n- rq_xid\n- the transmission id in the request\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::sunrpc.svc.register\u00a0Home \u00a0probe::tcp.disconnect\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-switch-file.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-switch-file.html", "unified_diff": "@@ -1,14 +1,14 @@\n function::switch_file
function::switch_file — \n switch to the next output file\n
Synopsis
\n switch_file()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function sends a signal to the stapio process,\n commanding it to rotate to the next output file when output is\n sent to file(s).\n
\n \n The mechanism of switching files was changed by upstream commit\n 5b39471380a238469c8fc18136f12600e5e9aec7 . With this commit, the\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-symdata.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-symdata.html", "unified_diff": "@@ -1,14 +1,14 @@\n
function::symdata — \n Return the kernel symbol and module offset for the address\n
Synopsis
\n symdata:string(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The address to translate\n-
Description
\n+
Description
\n Returns the (function) symbol name associated with the\n given address if known, the offset from the start and size of the\n symbol, plus module name (between brackets). If symbol is unknown,\n but module is known, the offset inside the module, plus the size of\n the module is added. If any element is not known it will be\n omitted and if the symbol name is unknown it will return the hex\n string for the given address.\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-symfile.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-symfile.html", "unified_diff": "@@ -1,11 +1,11 @@\n
function::symfile — \n Return the file name of a given address.\n
Synopsis
\n symfile:string(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The address to translate.\n-
Description
\n+
Description
\n Returns the file name of the given address, if known. If the\n file name cannot be found, the hex string representation of the address\n will be returned.\n
function::symfileline — \n Return the file name and line number of an address.\n
Synopsis
\n symfileline:string(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The address to translate.\n-
Description
\n+
Description
\n Returns the file name and the (approximate) line number of the\n given address, if known. If the file name or the line number cannot be\n found, the hex string representation of the address will be returned.\n
function::symline — \n Return the line number of an address.\n
Synopsis
\n symline:string(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The address to translate.\n-
Description
\n+
Description
\n Returns the (approximate) line number of the given address, if\n known. If the line number cannot be found, the hex string representation of\n the address will be returned.\n
function::symname — \n Return the kernel symbol associated with the given address\n
Synopsis
\n symname:string(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The address to translate\n-
Description
\n+
Description
\n Returns the (function) symbol name associated with the\n given address if known. If not known it will return the hex string\n representation of addr.\n
probe::syscall_any.return — \n Record exit from a syscall\n-
Synopsis
syscall_any.return
Values
syscall_nr
\n- number of the syscall\n-
retval
\n+
Synopsis
syscall_any.return
Values
retval
\n return value of the syscall\n
name
\n name of the syscall\n-
Context
\n+
syscall_nr
\n+ number of the syscall\n+
Context
\n The process performing the syscall\n-
Description
\n+
Description
\n The syscall_any.return probe point is designed to be a low overhead\n that monitors all the syscalls returns via a kernel tracepoint.\n Because of the breadth of syscalls it monitors it provides\n no information about the syscall arguments, argstr string\n representation of those arguments, or a string interpretation\n of the return value (retval).\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,20 +2,20 @@\n Prev\u00a0Chapter\u00a036.\u00a0Syscall Any Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::syscall_any.return \u2014 Record exit from a syscall\n ***** Synopsis *****\n syscall_any.return\n ***** Values *****\n- syscall_nr\n- number of the syscall\n retval\n return value of the syscall\n name\n name of the syscall\n+ syscall_nr\n+ number of the syscall\n ***** Context *****\n The process performing the syscall\n ***** Description *****\n The syscall_any.return probe point is designed to be a low overhead that\n monitors all the syscalls returns via a kernel tracepoint. Because of the\n breadth of syscalls it monitors it provides no information about the syscall\n arguments, argstr string representation of those arguments, or a string\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-syscall-any.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-syscall-any.html", "unified_diff": "@@ -1,16 +1,16 @@\n
probe::syscall_any — \n Record entry into a syscall\n-
Synopsis
syscall_any
Values
name
\n+
Synopsis
syscall_any
Values
name
\n name of the syscall\n
syscall_nr
\n number of the syscall\n-
Context
\n+
Context
\n The process performing the syscall\n-
Description
\n+
Description
\n The syscall_any probe point is designed to be a low overhead\n that monitors all the syscalls entered via a kernel tracepoint.\n Because of the breadth of syscalls it monitors it provides\n no information about the syscall arguments or argstr string\n representation of those arguments.\n
function::system — \n Issue a command to the system\n
Synopsis
\n system(cmd:string)\n-
Arguments
cmd
\n+
Arguments
cmd
\n the command to issue to the system\n-
Description
\n+
Description
\n This function runs a command on the system. The\n command is started in the background some time after the current\n probe completes. The command is run with the same UID as the user\n running the stap or staprun command. The runtime may impose a\n relatively short length limit on the command string. Exceeding it\n may print a warning.\n
function::target_set_pid — \n Does pid descend from target process?\n
Synopsis
\n target_set_pid(pid:)\n-
Arguments
pid
\n+
Arguments
pid
\n The pid of the process to query\n-
Description
\n+
Description
\n This function returns whether the given process-id is\n within the “target set”, that is whether it is a descendant of the\n top-level target process.\n
function::target — \n Return the process ID of the target process\n
Synopsis
\n target:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function returns the process ID of the target\n process. This is useful in conjunction with the -x PID or\n -c CMD command-line options to stap. An example of its use is\n to create scripts that filter on a specific process.\n
function::task_backtrace — \n Hex backtrace of an arbitrary task\n
Synopsis
\n task_backtrace:string(task:long)\n-
Arguments
task
\n+
Arguments
task
\n pointer to task_struct\n-
Description
\n+
Description
\n This function returns a string of hex addresses\n that are a backtrace of the stack of a particular task\n Output may be truncated as per maximum string length.\n Deprecated in SystemTap 1.6.\n
function::task_current — \n The current task_struct of the current task\n
Synopsis
\n task_current:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n This function returns the task_struct representing the current process.\n This address can be passed to the various task_*() functions to extract\n more task-specific data.\n
function::task_parent — \n The task_struct of the parent task\n
Synopsis
\n task_parent:long(task:long)\n-
Arguments
task
\n+
Arguments
task
\n task_struct pointer\n-
Description
\n+
Description
\n This function returns the parent task_struct of\n the given task. This address can be passed to the various \n task_*() functions to extract more task-specific data.\n
\n Return the state of the given task, one of:\n TASK_RUNNING (0), TASK_INTERRUPTIBLE (1), TASK_UNINTERRUPTIBLE (2),\n TASK_STOPPED (4), TASK_TRACED (8), EXIT_ZOMBIE (16), or EXIT_DEAD (32).\n
function::task_stime — \n System time of the task\n-
Synopsis
1) task_stime:long()
2) task_stime:long(tid:long)
Arguments
tid
\n+
Synopsis
1) task_stime:long()
2) task_stime:long(tid:long)
Arguments
tid
\n Thread id of the given task\n-
Description
1) Returns the system time of the current task in cputime.\n+
Description
1) Returns the system time of the current task in cputime.\n Does not include any time used by other tasks in this process, nor\n does it include any time of the children of this task.
2) Returns the system time of the given task in cputime,\n or zero if the task doesn't exist.\n Does not include any time used by other tasks in this process, nor\n does it include any time of the children of this task.
function::task_time_string_tid — \n Human readable string of task time usage\n
Synopsis
\n task_time_string_tid:string(tid:long)\n-
Arguments
tid
\n+
Arguments
tid
\n Thread id of the given task\n-
Description
\n+
Description
\n Returns a human readable string showing the user and\n system time the given task has used up to now. For example\n “usr: 0m12.908s, sys: 1m6.851s”.\n
function::task_time_string — \n Human readable string of task time usage\n
Synopsis
\n task_time_string:string()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n Returns a human readable string showing the user and\n system time the current task has used up to now. For example\n “usr: 0m12.908s, sys: 1m6.851s”.\n
function::task_utime — \n User time of the task\n-
Synopsis
1) task_utime:long()
2) task_utime:long(tid:long)
Arguments
tid
\n+
Synopsis
1) task_utime:long()
2) task_utime:long(tid:long)
Arguments
tid
\n Thread id of the given task\n-
Description
1) Returns the user time of the current task in cputime.\n+
Description
1) Returns the user time of the current task in cputime.\n Does not include any time used by other tasks in this process, nor\n does it include any time of the children of this task.
2) Returns the user time of the given task in cputime,\n or zero if the task doesn't exist.\n Does not include any time used by other tasks in this process, nor\n does it include any time of the children of this task.
\n- A string representing the destination IP address\n+
Synopsis
tcp.recvmsg.return
Values
name
\n+ Name of this probe\n+
saddr
\n+ A string representing the source IP address\n+
family
\n+ IP address family\n
dport
\n TCP destination port\n+
daddr
\n+ A string representing the destination IP address\n
size
\n Number of bytes received or error code if an error occurred.\n
sport
\n TCP source port \n-
name
\n- Name of this probe\n-
saddr
\n- A string representing the source IP address\n-
family
\n- IP address family\n-
Context
\n+
Context
\n The process which receives a tcp message\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,26 +2,26 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::tcp.recvmsg.return \u2014 Receiving TCP message complete\n ***** Synopsis *****\n tcp.recvmsg.return\n ***** Values *****\n- daddr\n- A string representing the destination IP address\n- dport\n- TCP destination port\n- size\n- Number of bytes received or error code if an error occurred.\n- sport\n- TCP source port\n name\n Name of this probe\n saddr\n A string representing the source IP address\n family\n IP address family\n+ dport\n+ TCP destination port\n+ daddr\n+ A string representing the destination IP address\n+ size\n+ Number of bytes received or error code if an error occurred.\n+ sport\n+ TCP source port\n ***** Context *****\n The process which receives a tcp message\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::tcp.recvmsg\u00a0Home \u00a0probe::tcp.sendmsg\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-tcp-recvmsg.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-tcp-recvmsg.html", "unified_diff": "@@ -1,21 +1,21 @@\n probe::tcp.recvmsg
\n+ A string representing the destination IP address\n+
sport
\n+ TCP source port \n
saddr
\n A string representing the source IP address\n+
family
\n+ IP address family\n
name
\n Name of this probe\n-
sport
\n- TCP source port \n
dport
\n TCP destination port\n-
daddr
\n- A string representing the destination IP address\n-
size
\n- Number of bytes to be received \n
sock
\n Network socket\n-
Context
\n+
Context
\n The process which receives a tcp message\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,28 +2,28 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::tcp.recvmsg \u2014 Receiving TCP message\n ***** Synopsis *****\n tcp.recvmsg\n ***** Values *****\n- family\n- IP address family\n+ size\n+ Number of bytes to be received\n+ daddr\n+ A string representing the destination IP address\n+ sport\n+ TCP source port\n saddr\n A string representing the source IP address\n+ family\n+ IP address family\n name\n Name of this probe\n- sport\n- TCP source port\n dport\n TCP destination port\n- daddr\n- A string representing the destination IP address\n- size\n- Number of bytes to be received\n sock\n Network socket\n ***** Context *****\n The process which receives a tcp message\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::tcp.receive\u00a0Home \u00a0probe::tcp.recvmsg.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-tcp-sendmsg-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-tcp-sendmsg-return.html", "unified_diff": "@@ -1,9 +1,9 @@\n probe::tcp.sendmsg.return
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,20 +2,20 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::tcp.sendmsg \u2014 Sending a tcp message\n ***** Synopsis *****\n tcp.sendmsg\n ***** Values *****\n+ size\n+ Number of bytes to send\n family\n IP address family\n name\n Name of this probe\n sock\n Network socket\n- size\n- Number of bytes to send\n ***** Context *****\n The process which sends a tcp message\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::tcp.recvmsg.return\u00a0Home \u00a0probe::tcp.sendmsg.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-tcp-setsockopt-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-tcp-setsockopt-return.html", "unified_diff": "@@ -1,9 +1,9 @@\n probe::tcp.setsockopt.return
probe::tcpmib.ActiveOpens — \n Count an active opening of a socket\n-
Synopsis
tcpmib.ActiveOpens
Values
sk
\n- pointer to the struct sock being acted on\n-
op
\n+
Synopsis
tcpmib.ActiveOpens
Values
op
\n value to be added to the counter (default value of 1)\n-
Description
\n+
sk
\n+ pointer to the struct sock being acted on\n+
Description
\n The packet pointed to by skb is filtered by the function\n tcpmib_filter_key. If the packet passes the filter is is\n counted in the global ActiveOpens (equivalent to SNMP's MIB\n TCP_MIB_ACTIVEOPENS)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a015.\u00a0SNMP Information Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::tcpmib.ActiveOpens \u2014 Count an active opening of a socket\n ***** Synopsis *****\n tcpmib.ActiveOpens\n ***** Values *****\n- sk\n- pointer to the struct sock being acted on\n op\n value to be added to the counter (default value of 1)\n+ sk\n+ pointer to the struct sock being acted on\n ***** Description *****\n The packet pointed to by skb is filtered by the function tcpmib_filter_key. If\n the packet passes the filter is is counted in the global ActiveOpens\n (equivalent to SNMP's MIB TCP_MIB_ACTIVEOPENS)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::linuxmib.TCPMemoryPressures\u00a0Home \u00a0probe::tcpmib.AttemptFails\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-tcpmib-AttemptFails.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-tcpmib-AttemptFails.html", "unified_diff": "@@ -1,12 +1,12 @@\n probe::tcpmib.AttemptFails
probe::tcpmib.AttemptFails — \n Count a failed attempt to open a socket\n-
Synopsis
tcpmib.AttemptFails
Values
sk
\n+
Synopsis
tcpmib.AttemptFails
Values
sk
\n pointer to the struct sock being acted on\n
op
\n value to be added to the counter (default value of 1)\n-
Description
\n+
Description
\n The packet pointed to by skb is filtered by the function\n tcpmib_filter_key. If the packet passes the filter is is\n counted in the global AttemptFails (equivalent to SNMP's MIB\n TCP_MIB_ATTEMPTFAILS)\n
probe::tcpmib.CurrEstab — \n Update the count of open sockets\n-
Synopsis
tcpmib.CurrEstab
Values
sk
\n+
Synopsis
tcpmib.CurrEstab
Values
sk
\n pointer to the struct sock being acted on\n
op
\n value to be added to the counter (default value of 1)\n-
Description
\n+
Description
\n The packet pointed to by skb is filtered by the function\n tcpmib_filter_key. If the packet passes the filter is is\n counted in the global CurrEstab (equivalent to SNMP's MIB\n TCP_MIB_CURRESTAB)\n
probe::tcpmib.EstabResets — \n Count the reset of a socket\n-
Synopsis
tcpmib.EstabResets
Values
sk
\n- pointer to the struct sock being acted on\n-
op
\n+
Synopsis
tcpmib.EstabResets
Values
op
\n value to be added to the counter (default value of 1)\n-
Description
\n+
sk
\n+ pointer to the struct sock being acted on\n+
Description
\n The packet pointed to by skb is filtered by the function\n tcpmib_filter_key. If the packet passes the filter is is\n counted in the global EstabResets (equivalent to SNMP's MIB\n TCP_MIB_ESTABRESETS)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a015.\u00a0SNMP Information Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::tcpmib.EstabResets \u2014 Count the reset of a socket\n ***** Synopsis *****\n tcpmib.EstabResets\n ***** Values *****\n- sk\n- pointer to the struct sock being acted on\n op\n value to be added to the counter (default value of 1)\n+ sk\n+ pointer to the struct sock being acted on\n ***** Description *****\n The packet pointed to by skb is filtered by the function tcpmib_filter_key. If\n the packet passes the filter is is counted in the global EstabResets\n (equivalent to SNMP's MIB TCP_MIB_ESTABRESETS)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::tcpmib.CurrEstab\u00a0Home \u00a0probe::tcpmib.InSegs\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-tcpmib-InSegs.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-tcpmib-InSegs.html", "unified_diff": "@@ -1,13 +1,13 @@\n probe::tcpmib.InSegs
probe::tcpmib.InSegs — \n Count an incoming tcp segment\n-
Synopsis
tcpmib.InSegs
Values
op
\n- value to be added to the counter (default value of 1)\n-
sk
\n+
Synopsis
tcpmib.InSegs
Values
sk
\n pointer to the struct sock being acted on\n-
Description
\n+
op
\n+ value to be added to the counter (default value of 1)\n+
Description
\n The packet pointed to by skb is filtered by the function\n tcpmib_filter_key (or ipmib_filter_key for tcp v4).\n If the packet passes the filter is is\n counted in the global InSegs (equivalent to SNMP's MIB\n TCP_MIB_INSEGS)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a015.\u00a0SNMP Information Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::tcpmib.InSegs \u2014 Count an incoming tcp segment\n ***** Synopsis *****\n tcpmib.InSegs\n ***** Values *****\n- op\n- value to be added to the counter (default value of 1)\n sk\n pointer to the struct sock being acted on\n+ op\n+ value to be added to the counter (default value of 1)\n ***** Description *****\n The packet pointed to by skb is filtered by the function tcpmib_filter_key (or\n ipmib_filter_key for tcp v4). If the packet passes the filter is is counted in\n the global InSegs (equivalent to SNMP's MIB TCP_MIB_INSEGS)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::tcpmib.EstabResets\u00a0Home \u00a0probe::tcpmib.OutRsts\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-tcpmib-OutRsts.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-tcpmib-OutRsts.html", "unified_diff": "@@ -1,12 +1,12 @@\n probe::tcpmib.OutRsts
probe::tcpmib.OutRsts — \n Count the sending of a reset packet\n-
Synopsis
tcpmib.OutRsts
Values
op
\n- value to be added to the counter (default value of 1)\n-
sk
\n+
Synopsis
tcpmib.OutRsts
Values
sk
\n pointer to the struct sock being acted on\n-
Description
\n+
op
\n+ value to be added to the counter (default value of 1)\n+
Description
\n The packet pointed to by skb is filtered by the function\n tcpmib_filter_key. If the packet passes the filter is is\n counted in the global OutRsts (equivalent to SNMP's MIB\n TCP_MIB_OUTRSTS)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a015.\u00a0SNMP Information Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::tcpmib.OutRsts \u2014 Count the sending of a reset packet\n ***** Synopsis *****\n tcpmib.OutRsts\n ***** Values *****\n- op\n- value to be added to the counter (default value of 1)\n sk\n pointer to the struct sock being acted on\n+ op\n+ value to be added to the counter (default value of 1)\n ***** Description *****\n The packet pointed to by skb is filtered by the function tcpmib_filter_key. If\n the packet passes the filter is is counted in the global OutRsts (equivalent to\n SNMP's MIB TCP_MIB_OUTRSTS)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::tcpmib.InSegs\u00a0Home \u00a0probe::tcpmib.OutSegs\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-tcpmib-OutSegs.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-tcpmib-OutSegs.html", "unified_diff": "@@ -1,12 +1,12 @@\n probe::tcpmib.OutSegs
probe::tcpmib.OutSegs — \n Count the sending of a TCP segment\n-
Synopsis
tcpmib.OutSegs
Values
op
\n- value to be added to the counter (default value of 1)\n-
sk
\n+
Synopsis
tcpmib.OutSegs
Values
sk
\n pointer to the struct sock being acted on\n-
Description
\n+
op
\n+ value to be added to the counter (default value of 1)\n+
Description
\n The packet pointed to by skb is filtered by the function\n tcpmib_filter_key. If the packet passes the filter is is\n counted in the global OutSegs (equivalent to SNMP's MIB\n TCP_MIB_OUTSEGS)\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a015.\u00a0SNMP Information Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::tcpmib.OutSegs \u2014 Count the sending of a TCP segment\n ***** Synopsis *****\n tcpmib.OutSegs\n ***** Values *****\n- op\n- value to be added to the counter (default value of 1)\n sk\n pointer to the struct sock being acted on\n+ op\n+ value to be added to the counter (default value of 1)\n ***** Description *****\n The packet pointed to by skb is filtered by the function tcpmib_filter_key. If\n the packet passes the filter is is counted in the global OutSegs (equivalent to\n SNMP's MIB TCP_MIB_OUTSEGS)\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::tcpmib.OutRsts\u00a0Home \u00a0probe::tcpmib.PassiveOpens\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-tcpmib-PassiveOpens.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-tcpmib-PassiveOpens.html", "unified_diff": "@@ -1,12 +1,12 @@\n probe::tcpmib.PassiveOpens
probe::tcpmib.PassiveOpens — \n Count the passive creation of a socket\n-
Synopsis
tcpmib.PassiveOpens
Values
sk
\n+
Synopsis
tcpmib.PassiveOpens
Values
sk
\n pointer to the struct sock being acted on\n
op
\n value to be added to the counter (default value of 1)\n-
Description
\n+
Description
\n The packet pointed to by skb is filtered by the function\n tcpmib_filter_key. If the packet passes the filter is is\n counted in the global PassiveOpens (equivalent to SNMP's MIB\n TCP_MIB_PASSIVEOPENS)\n
probe::tcpmib.RetransSegs — \n Count the retransmission of a TCP segment\n-
Synopsis
tcpmib.RetransSegs
Values
sk
\n+
Synopsis
tcpmib.RetransSegs
Values
sk
\n pointer to the struct sock being acted on\n
op
\n value to be added to the counter (default value of 1)\n-
Description
\n+
Description
\n The packet pointed to by skb is filtered by the function\n tcpmib_filter_key. If the packet passes the filter is is\n counted in the global RetransSegs (equivalent to SNMP's MIB\n TCP_MIB_RETRANSSEGS)\n
function::tcpmib_filter_key — \n Default filter function for tcpmib.* probes\n
Synopsis
\n tcpmib_filter_key:long(sk:long,op:long)\n-
Arguments
sk
\n+
Arguments
sk
\n pointer to the struct sock being acted on\n
op
\n value to be counted if sk passes the filter\n-
Description
\n+
Description
\n This function is a default filter function.\n The user can replace this function with their own.\n The user-supplied filter function returns an index key based on the values\n in sk.\n A return value of 0 means this particular sk should be not be counted.\n
function::text_str — \n Escape any non-printable chars in a string\n
Synopsis
\n text_str:string(input:string)\n-
Arguments
input
\n+
Arguments
input
\n the string to escape\n-
Description
\n+
Description
\n This function accepts a string argument, \n and any ASCII characters that are not\n printable are replaced by the corresponding escape sequence in the\n returned string.\n
\n maximum length of string to return (0 implies MAXSTRINGLEN)\n
quoted
\n put double quotes around the string. If input string is\n truncated it will have “...” after the second quote\n-
Description
\n+
Description
\n This function accepts a string of designated length,\n and any ASCII characters that are not\n printable are replaced by the corresponding escape sequence in the\n returned string.\n
function::thread_indent_depth — \n returns the nested-depth of the current task\n
Synopsis
\n thread_indent_depth:long(delta:long)\n-
Arguments
delta
\n+
Arguments
delta
\n the amount of depth added/removed for each call\n-
Description
\n+
Description
\n This function returns an integer equal to the nested\n function-call depth starting from the outermost initial level. This function\n is useful for saving space (consumed by whitespace) in traces with long\n nested function calls. Use this function in a similar fashion to\n thread_indent, i.e., in call-probe, use thread_indent_depth(1) and in\n return-probe, use thread_indent_depth(-1)\n
function::thread_indent — \n returns an amount of space with the current task information\n
Synopsis
\n thread_indent:string(delta:long)\n-
Arguments
delta
\n+
Arguments
delta
\n the amount of space added/removed for each call\n-
Description
\n+
Description
\n This function returns a string with appropriate\n indentation for a thread. Call it with a small positive or\n matching negative delta. If this is the real outermost,\n initial level of indentation, then the function resets the \n relative timestamp base to zero. The timestamp is as per\n provided by the __indent_timestamp function, which by default\n measures microseconds.\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-tid.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-tid.html", "unified_diff": "@@ -1,9 +1,9 @@\n
function::tokenize — \n Return the next non-empty token in a string\n-
Synopsis
1) tokenize:string(delim:string)
2) tokenize:string(input:string,delim:string)
Arguments
delim
\n+
Synopsis
1) tokenize:string(delim:string)
2) tokenize:string(input:string,delim:string)
Arguments
delim
\n set of characters that delimit the tokens\n
input
\n string to tokenize. If empty, returns the next non-empty token\n in the string passed in the previous call to tokenize.\n-
Description
1) This function returns the next token in the string\n+
Description
1) This function returns the next token in the string\n passed in the previous call to tokenize. If no delimiter is found,\n the entire remaining input string is * returned. It returns empty\n when no more tokens are available.
2) This function returns the next non-empty token in the\n given input string, where the tokens are delimited by characters in\n the delim string. If the input string is non-empty, it returns the\n first token. If the input string is empty, it returns the next\n token in the string passed in the previous call to tokenize.\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-tty-init.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-tty-init.html", "unified_diff": "@@ -1,9 +1,9 @@\n
probe::tty.read — \n called when a tty line will be read\n-
Synopsis
tty.read
Values
nr
\n- The amount of characters to be read\n-
file_name
\n+
Synopsis
tty.read
Values
file_name
\n the file name lreated to the tty\n-
buffer
\n- the buffer that will receive the characters\n
driver_name
\n the driver name\n+
buffer
\n+ the buffer that will receive the characters\n+
nr
\n+ The amount of characters to be read\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a011.\u00a0TTY Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::tty.read \u2014 called when a tty line will be read\n ***** Synopsis *****\n tty.read\n ***** Values *****\n- nr\n- The amount of characters to be read\n file_name\n the file name lreated to the tty\n- buffer\n- the buffer that will receive the characters\n driver_name\n the driver name\n+ buffer\n+ the buffer that will receive the characters\n+ nr\n+ The amount of characters to be read\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::tty.poll\u00a0Home \u00a0probe::tty.receive\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-tty-receive.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-tty-receive.html", "unified_diff": "@@ -1,17 +1,17 @@\n probe::tty.receive
probe::tty.receive — \n called when a tty receives a message\n-
Synopsis
tty.receive
Values
id
\n- the tty id\n+
Synopsis
tty.receive
Values
driver_name
\n+ the driver name\n
index
\n The tty Index\n-
name
\n- the name of the module file\n+
fp
\n+ The flag buffer\n
cp
\n the buffer that was received\n+
name
\n+ the name of the module file\n
count
\n The amount of characters received\n-
fp
\n- The flag buffer\n-
driver_name
\n- the driver name\n+
id
\n+ the tty id\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,24 +2,24 @@\n Prev\u00a0Chapter\u00a011.\u00a0TTY Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::tty.receive \u2014 called when a tty receives a message\n ***** Synopsis *****\n tty.receive\n ***** Values *****\n- id\n- the tty id\n+ driver_name\n+ the driver name\n index\n The tty Index\n- name\n- the name of the module file\n+ fp\n+ The flag buffer\n cp\n the buffer that was received\n+ name\n+ the name of the module file\n count\n The amount of characters received\n- fp\n- The flag buffer\n- driver_name\n- the driver name\n+ id\n+ the tty id\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::tty.read\u00a0Home \u00a0probe::tty.register\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-tty-register.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-tty-register.html", "unified_diff": "@@ -1,11 +1,11 @@\n probe::tty.register
probe::tty.resize — \n Called when a terminal resize happens\n-
Synopsis
tty.resize
Values
old_col
\n+
Synopsis
tty.resize
Values
name
\n+ the tty name\n+
new_xpixel
\n+ the new xpixel value\n+
old_xpixel
\n+ the old xpixel\n+
old_col
\n the old col value\n-
new_row
\n- the new row value\n
new_col
\n the new col value\n-
name
\n- the tty name\n+
new_ypixel
\n+ the new ypixel value\n
old_row
\n the old row value\n
old_ypixel
\n the old ypixel\n-
old_xpixel
\n- the old xpixel\n-
new_ypixel
\n- the new ypixel value\n-
new_xpixel
\n- the new xpixel value\n+
new_row
\n+ the new row value\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,28 +2,28 @@\n Prev\u00a0Chapter\u00a011.\u00a0TTY Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::tty.resize \u2014 Called when a terminal resize happens\n ***** Synopsis *****\n tty.resize\n ***** Values *****\n+ name\n+ the tty name\n+ new_xpixel\n+ the new xpixel value\n+ old_xpixel\n+ the old xpixel\n old_col\n the old col value\n- new_row\n- the new row value\n new_col\n the new col value\n- name\n- the tty name\n+ new_ypixel\n+ the new ypixel value\n old_row\n the old row value\n old_ypixel\n the old ypixel\n- old_xpixel\n- the old xpixel\n- new_ypixel\n- the new ypixel value\n- new_xpixel\n- the new xpixel value\n+ new_row\n+ the new row value\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::tty.release\u00a0Home \u00a0probe::tty.unregister\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-tty-unregister.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-tty-unregister.html", "unified_diff": "@@ -1,11 +1,11 @@\n probe::tty.unregister
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,16 +4,16 @@\n ***** Name *****\n probe::tty.write \u2014 write to the tty line\n ***** Synopsis *****\n tty.write\n ***** Values *****\n nr\n The amount of characters\n- file_name\n- the file name lreated to the tty\n buffer\n the buffer that will be written\n+ file_name\n+ the file name lreated to the tty\n driver_name\n the driver name\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::tty.unregister\u00a0Home \u00a0Chapter\u00a012.\u00a0Interrupt Request (IRQ) Tapset\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-tz-ctime.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-tz-ctime.html", "unified_diff": "@@ -1,13 +1,13 @@\n function::tz_ctime
function::tz_ctime — \n Convert seconds since epoch into human readable date/time string, with local time zone\n
Synopsis
\n tz_ctime(epochsecs:)\n-
Arguments
epochsecs
\n+
Arguments
epochsecs
\n number of seconds since epoch (as returned by gettimeofday_s)\n-
Description
\n+
Description
\n Takes an argument of seconds since the epoch as returned by\n gettimeofday_s. Returns a string of the same form as ctime, but\n offsets the epoch time for the local time zone, and appends the name of the\n local time zone. The string length may vary. The time zone information is\n passed by staprun at script startup only.\n
function::uaddr — \n User space address of current running task\n
Synopsis
\n uaddr:long()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n Returns the address in userspace that the current\n task was at when the probe occurred. When the current running task\n isn't a user space thread, or the address cannot be found, zero\n is returned. Can be used to see where the current task is combined\n with usymname or usymdata. Often the task will be in the VDSO\n where it entered the kernel.\n
function::ubacktrace — \n Hex backtrace of current user-space task stack.\n
Synopsis
\n ubacktrace:string()\n-
Arguments
\n+
Arguments
\n None\n-
Description
\n+
Description
\n
\n \n Return a string of hex addresses that are a backtrace of the \n stack of the current task. Output may be truncated as per maximum\n string length. Returns empty string when current probe point cannot\n determine user backtrace. See backtrace for kernel traceback.\n-
Note
\n+
Note
\n To get (full) backtraces for user space applications and shared\n shared libraries not mentioned in the current script run stap with\n -d /path/to/exe-or-so and/or add --ldd to load all needed unwind data.\n
function::ucallers — \n Return first n elements of user stack backtrace\n
Synopsis
\n ucallers:string(n:long)\n-
Arguments
n
\n+
Arguments
n
\n number of levels to descend in the stack (not counting the top\n level). If n is -1, print the entire stack.\n-
Description
\n+
Description
\n This function returns a string of the first n hex\n addresses from the backtrace of the user stack. Output may be\n truncated as per maximum string length (MAXSTRINGLEN).\n-
Note
\n+
Note
\n To get (full) backtraces for user space applications and shared\n shared libraries not mentioned in the current script run stap with\n -d /path/to/exe-or-so and/or add --ldd to load all needed unwind data.\n
probe::udp.disconnect.return — \n UDP has been disconnected successfully\n-
Synopsis
udp.disconnect.return
Values
family
\n- IP address family\n+
Synopsis
udp.disconnect.return
Values
sport
\n+ UDP source port\n+
saddr
\n+ A string representing the source IP address\n+
name
\n+ The name of this probe\n
ret
\n Error code (0: no error) \n+
family
\n+ IP address family\n
daddr
\n A string representing the destination IP address\n-
sport
\n- UDP source port\n-
name
\n- The name of this probe\n
dport
\n UDP destination port\n-
saddr
\n- A string representing the source IP address\n-
Context
\n+
Context
\n The process which requested a UDP disconnection\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,26 +2,26 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::udp.disconnect.return \u2014 UDP has been disconnected successfully\n ***** Synopsis *****\n udp.disconnect.return\n ***** Values *****\n- family\n- IP address family\n- ret\n- Error code (0: no error)\n- daddr\n- A string representing the destination IP address\n sport\n UDP source port\n+ saddr\n+ A string representing the source IP address\n name\n The name of this probe\n+ ret\n+ Error code (0: no error)\n+ family\n+ IP address family\n+ daddr\n+ A string representing the destination IP address\n dport\n UDP destination port\n- saddr\n- A string representing the source IP address\n ***** Context *****\n The process which requested a UDP disconnection\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::udp.disconnect\u00a0Home \u00a0probe::udp.recvmsg\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-udp-disconnect.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-udp-disconnect.html", "unified_diff": "@@ -1,21 +1,21 @@\n probe::udp.disconnect
probe::udp.disconnect — \n Fires when a process requests for a UDP disconnection\n-
Synopsis
udp.disconnect
Values
sock
\n- Network socket used by the process\n-
sport
\n+
Synopsis
udp.disconnect
Values
sport
\n UDP source port\n-
daddr
\n- A string representing the destination IP address\n-
family
\n- IP address family\n-
flags
\n- Flags (e.g. FIN, etc) \n+
saddr
\n+ A string representing the source IP address\n
name
\n The name of this probe\n+
flags
\n+ Flags (e.g. FIN, etc) \n+
family
\n+ IP address family\n+
daddr
\n+ A string representing the destination IP address\n
dport
\n UDP destination port\n-
saddr
\n- A string representing the source IP address\n-
Context
\n+
sock
\n+ Network socket used by the process\n+
Context
\n The process which requests a UDP disconnection \n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,28 +2,28 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::udp.disconnect \u2014 Fires when a process requests for a UDP disconnection\n ***** Synopsis *****\n udp.disconnect\n ***** Values *****\n- sock\n- Network socket used by the process\n sport\n UDP source port\n- daddr\n- A string representing the destination IP address\n- family\n- IP address family\n- flags\n- Flags (e.g. FIN, etc)\n+ saddr\n+ A string representing the source IP address\n name\n The name of this probe\n+ flags\n+ Flags (e.g. FIN, etc)\n+ family\n+ IP address family\n+ daddr\n+ A string representing the destination IP address\n dport\n UDP destination port\n- saddr\n- A string representing the source IP address\n+ sock\n+ Network socket used by the process\n ***** Context *****\n The process which requests a UDP disconnection\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::tcp.setsockopt.return\u00a0Home \u00a0probe::udp.disconnect.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-udp-recvmsg-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-udp-recvmsg-return.html", "unified_diff": "@@ -1,19 +1,19 @@\n probe::udp.recvmsg.return
probe::udp.recvmsg.return — \n Fires whenever an attempt to receive a UDP message received is completed\n-
Synopsis
udp.recvmsg.return
Values
name
\n+
Synopsis
udp.recvmsg.return
Values
name
\n The name of this probe\n
size
\n Number of bytes received by the process\n
saddr
\n A string representing the source IP address\n-
dport
\n- UDP destination port\n
sport
\n UDP source port\n+
dport
\n+ UDP destination port\n
daddr
\n A string representing the destination IP address\n
family
\n IP address family\n-
Context
\n+
Context
\n The process which received a UDP message\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -9,18 +9,18 @@\n ***** Values *****\n name\n The name of this probe\n size\n Number of bytes received by the process\n saddr\n A string representing the source IP address\n- dport\n- UDP destination port\n sport\n UDP source port\n+ dport\n+ UDP destination port\n daddr\n A string representing the destination IP address\n family\n IP address family\n ***** Context *****\n The process which received a UDP message\n ===============================================================================\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-udp-recvmsg.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-udp-recvmsg.html", "unified_diff": "@@ -1,21 +1,21 @@\n probe::udp.recvmsg
probe::udp.recvmsg — \n Fires whenever a UDP message is received\n-
Synopsis
udp.recvmsg
Values
sock
\n+
Synopsis
udp.recvmsg
Values
family
\n+ IP address family\n+
sock
\n Network socket used by the process\n
daddr
\n A string representing the destination IP address\n+
dport
\n+ UDP destination port\n
sport
\n UDP source port\n-
family
\n- IP address family\n-
name
\n- The name of this probe\n-
size
\n- Number of bytes received by the process\n
saddr
\n A string representing the source IP address\n-
dport
\n- UDP destination port\n-
Context
\n+
size
\n+ Number of bytes received by the process\n+
name
\n+ The name of this probe\n+
Context
\n The process which received a UDP message\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,28 +2,28 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::udp.recvmsg \u2014 Fires whenever a UDP message is received\n ***** Synopsis *****\n udp.recvmsg\n ***** Values *****\n+ family\n+ IP address family\n sock\n Network socket used by the process\n daddr\n A string representing the destination IP address\n+ dport\n+ UDP destination port\n sport\n UDP source port\n- family\n- IP address family\n- name\n- The name of this probe\n- size\n- Number of bytes received by the process\n saddr\n A string representing the source IP address\n- dport\n- UDP destination port\n+ size\n+ Number of bytes received by the process\n+ name\n+ The name of this probe\n ***** Context *****\n The process which received a UDP message\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::udp.disconnect.return\u00a0Home \u00a0probe::udp.recvmsg.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-udp-sendmsg-return.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-udp-sendmsg-return.html", "unified_diff": "@@ -1,9 +1,9 @@\n probe::udp.sendmsg.return
probe::udp.sendmsg.return — \n Fires whenever an attempt to send a UDP message is completed\n-
Synopsis
udp.sendmsg.return
Values
name
\n- The name of this probe\n-
size
\n+
Synopsis
udp.sendmsg.return
Values
size
\n Number of bytes sent by the process\n-
Context
\n+
name
\n+ The name of this probe\n+
Context
\n The process which sent a UDP message\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -3,16 +3,16 @@\n ===============================================================================\n ***** Name *****\n probe::udp.sendmsg.return \u2014 Fires whenever an attempt to send a UDP message is\n completed\n ***** Synopsis *****\n udp.sendmsg.return\n ***** Values *****\n- name\n- The name of this probe\n size\n Number of bytes sent by the process\n+ name\n+ The name of this probe\n ***** Context *****\n The process which sent a UDP message\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::udp.sendmsg\u00a0Home \u00a0Chapter\u00a014.\u00a0Socket Tapset\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-udp-sendmsg.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-udp-sendmsg.html", "unified_diff": "@@ -1,21 +1,21 @@\n probe::udp.sendmsg
probe::udp.sendmsg — \n Fires whenever a process sends a UDP message\n-
Synopsis
udp.sendmsg
Values
dport
\n+
Synopsis
udp.sendmsg
Values
family
\n+ IP address family\n+
sock
\n+ Network socket used by the process \n+
daddr
\n+ A string representing the destination IP address\n+
dport
\n UDP destination port\n
saddr
\n A string representing the source IP address\n+
sport
\n+ UDP source port\n
size
\n Number of bytes sent by the process\n
name
\n The name of this probe\n-
daddr
\n- A string representing the destination IP address\n-
sport
\n- UDP source port\n-
sock
\n- Network socket used by the process \n-
family
\n- IP address family\n-
Context
\n+
Context
\n The process which sent a UDP message \n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,28 +2,28 @@\n Prev\u00a0Chapter\u00a013.\u00a0Networking Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::udp.sendmsg \u2014 Fires whenever a process sends a UDP message\n ***** Synopsis *****\n udp.sendmsg\n ***** Values *****\n+ family\n+ IP address family\n+ sock\n+ Network socket used by the process\n+ daddr\n+ A string representing the destination IP address\n dport\n UDP destination port\n saddr\n A string representing the source IP address\n+ sport\n+ UDP source port\n size\n Number of bytes sent by the process\n name\n The name of this probe\n- daddr\n- A string representing the destination IP address\n- sport\n- UDP source port\n- sock\n- Network socket used by the process\n- family\n- IP address family\n ***** Context *****\n The process which sent a UDP message\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::udp.recvmsg.return\u00a0Home \u00a0probe::udp.sendmsg.return\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-uid.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-uid.html", "unified_diff": "@@ -1,9 +1,9 @@\n function::uid
function::umodname — \n Returns the (short) name of the user module.\n
Synopsis
\n umodname:string(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n User-space address\n-
Description
\n+
Description
\n Returns the short name of the user space module for the current task that\n that the given address is part of. Reports an error when the address\n isn't in a (mapped in) module, or the module cannot be found for some reason.\n
function::usecs_to_string — \n Human readable string for given microseconds\n
Synopsis
\n usecs_to_string:string(usecs:long)\n-
Arguments
usecs
\n+
Arguments
usecs
\n Number of microseconds to translate.\n-
Description
\n+
Description
\n Returns a string representing the number of\n microseconds as a human readable string consisting of “XmY.ZZZZZZs”,\n where X is the number of minutes, Y is the number of seconds and\n ZZZZZZ is the number of microseconds.\n
\n the user space address to retrieve the buffer from\n
inlen
\n the exact length of the buffer to read\n
outlen
\n the maximum length of the output string\n-
Description
\n+
Description
\n Reads inlen characters of a buffer from the given user space\n memory address, and returns up to outlen characters, where any ASCII\n characters that are not printable are replaced by the corresponding escape\n sequence in the returned string. Note that the string will be surrounded by\n double quotes. On the rare cases when user space data is not accessible at\n the given address, an error is thrown.\n
\n the user space address to retrieve the buffer from\n
inlen
\n the exact length of the buffer to read\n
outlen
\n the maximum length of the output string\n-
Description
\n+
Description
\n Reads inlen characters of a buffer from the given user space\n memory address, and returns up to outlen characters, where any ASCII\n characters that are not printable are replaced by the corresponding escape\n sequence in the returned string. Note that the string will be surrounded by\n double quotes. On the rare cases when user space data is not accessible at\n the given address, the address itself is returned as a string, without\n double quotes.\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-user-char-error.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-user-char-error.html", "unified_diff": "@@ -1,10 +1,10 @@\n
function::user_char_warn — \n Retrieves a char value stored in user space\n
Synopsis
\n user_char_warn:long(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n the user space address to retrieve the char from\n-
Description
\n+
Description
\n Returns the char value from a given user space\n address. Returns zero when user space data is not accessible and\n warns about the failure (but does not error).\n
function::user_int_warn — \n Retrieves an int value stored in user space\n
Synopsis
\n user_int_warn:long(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n the user space address to retrieve the int from\n-
Description
\n+
Description
\n Returns the int value from a given user space address.\n Returns zero when user space data is not accessible and warns about\n the failure (but does not error).\n
function::user_long_error — \n Retrieves a long value stored in user space\n
Synopsis
\n user_long_error:long(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n the user space address to retrieve the long from\n-
Description
\n+
Description
\n Returns the long value from a given user space\n address. If the user space data is not accessible, an error will\n occur. Note that the size of the long depends on the architecture\n of the current user space task (for those architectures that\n support both 64/32 bit compat tasks).\n
function::user_long_warn — \n Retrieves a long value stored in user space\n
Synopsis
\n user_long_warn:long(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n the user space address to retrieve the long from\n-
Description
\n+
Description
\n Returns the long value from a given user space\n address. Returns zero when user space data is not accessible and\n warns about the failure (but does not error). Note that the size\n of the long depends on the architecture of the current user space\n task (for those architectures that support both 64/32 bit compat\n tasks).\n
function::user_long — \n Retrieves a long value stored in user space\n
Synopsis
\n user_long:long(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n the user space address to retrieve the long from\n-
Description
\n+
Description
\n Returns the long value from a given user space address.\n Returns zero when user space data is not accessible. Note that the\n size of the long depends on the architecture of the current user space\n task (for those architectures that support both 64/32 bit compat tasks).\n
function::user_short_warn — \n Retrieves a short value stored in user space\n
Synopsis
\n user_short_warn:long(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n the user space address to retrieve the short from\n-
Description
\n+
Description
\n Returns the short value from a given user space\n address. Returns zero when user space data is not accessible and\n warns about the failure (but does not error).\n
function::user_string_n_nofault — \n Retrieves string of given length from user space\n
Synopsis
\n user_string_n_nofault(addr:long,n:long)\n-
Arguments
addr
\n+
Arguments
addr
\n the user space address to retrieve the string from\n
n
\n the maximum length of the string (if not null terminated)\n-
Description
\n+
Description
\n Returns the C string of a maximum given length from a\n given user space address. Returns the empty string when userspace\n data is not accessible at the given address.\n
\n the user space address to retrieve the string from\n
n
\n the maximum length of the string (if not null terminated)\n
inlen
\n the maximum length of the string to read (if not null terminated)\n
outlen
\n the maximum length of the output string\n-
Description
1) Returns up to n characters of a C string from the given\n+
Description
1) Returns up to n characters of a C string from the given\n user space memory address where any ASCII characters that are not\n printable are replaced by the corresponding escape sequence in the\n returned string. Note that the string will be surrounded by double quotes.\n On the rare cases when userspace data is not accessible at the given address,\n the address itself is returned as a string, without double quotes.
2) Reads up to inlen characters of a C string from the given user\n space memory address, and returns up to outlen characters, where any ASCII\n characters that are not printable are replaced by the corresponding escape\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-user-string-n-warn.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-user-string-n-warn.html", "unified_diff": "@@ -1,16 +1,16 @@\n
\n the user space address to retrieve the string from\n
n
\n the maximum length of the string (if not null terminated)\n
warn_msg
\n the warning message to return when data isn't available\n-
Description
1) Returns up to n characters of a C string from a given\n+
Description
1) Returns up to n characters of a C string from a given\n user space memory address. Reports“<unknown>” on the rare cases\n when userspace data is not accessible and warns (but does not abort)\n about the failure.\n
2) Returns up to n characters of a C string from a given\n user space memory address. Reports the given warning message on the\n rare cases when userspace data is not accessible and warns (but does\n not abort) about the failure.
\n the user space address to retrieve the string from\n
n
\n the maximum length of the string (if not null terminated)\n
err_msg
\n the error message to return when data isn't available\n-
Description
1) Returns the C string of a maximum given length from a\n+
Description
1) Returns the C string of a maximum given length from a\n given user space address. Reports an error on the rare cases\n when userspace data is not accessible at the given address.
2) Returns the C string of a maximum given length from a\n given user space address. Returns the given error message string on\n the rare cases when userspace data is not accessible at the given\n address.
function::user_string_quoted — \n Retrieves and quotes string from user space\n
Synopsis
\n user_string_quoted:string(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n the user space address to retrieve the string from\n-
Description
\n+
Description
\n Returns the null terminated C string from a given user space\n memory address where any ASCII characters that are not printable are\n replaced by the corresponding escape sequence in the returned string. Note\n that the string will be surrounded by double quotes. On the rare cases when\n userspace data is not accessible at the given address, the address itself is\n returned as a string, without double quotes.\n
\n The error message to return when data isn't available\n-
Description
1) This function returns a null terminated UTF-8 string converted\n+
Description
1) This function returns a null terminated UTF-8 string converted\n from the UTF-16 string at a given user memory address. Reports an error on\n string copy fault or conversion error.
2) This function returns a null terminated UTF-8 string converted\n from the UTF-16 string at a given user memory address. Reports the given\n error message on string copy fault or conversion error.
\n The error message to return when data isn't available\n-
Description
1) This function returns a null terminated UTF-8 string converted\n+
Description
1) This function returns a null terminated UTF-8 string converted\n from the UTF-32 string at a given user memory address. Reports an error on\n string copy fault or conversion error.
2) This function returns a null terminated UTF-8 string converted\n from the UTF-32 string at a given user memory address. Reports the given\n error message on string copy fault or conversion error.
\n the user space address to retrieve the string from\n
warn_msg
\n the warning message to return when data isn't available\n-
Description
1) Returns the null terminated C string from a given user space\n+
Description
1) Returns the null terminated C string from a given user space\n memory address. Reports \"\" on the rare cases when userspace data is\n not accessible and warns (but does not abort) about the failure.
2) Returns the null terminated C string from a given user space\n memory address. Reports the given warning message on the rare cases\n when userspace data is not accessible and warns (but does not abort)\n about the failure.
function::user_string — \n Retrieves string from user space\n-
Synopsis
1) user_string:string(addr:long)
2) user_string:string(addr:long,err_msg:string)
Arguments
addr
\n+
Synopsis
1) user_string:string(addr:long)
2) user_string:string(addr:long,err_msg:string)
Arguments
addr
\n the user space address to retrieve the string from\n
err_msg
\n the error message to return when data isn't available\n-
Description
1) Returns the null terminated C string from a given user space\n+
Description
1) Returns the null terminated C string from a given user space\n memory address. Reports an error on the rare cases when userspace\n data is not accessible.
2) Returns the null terminated C string from a given user space\n memory address. Reports the given error message on the rare cases when\n userspace data is not accessible.
function::user_ulong_error — \n Retrieves a unsigned long value stored in user space\n
Synopsis
\n user_ulong_error:long(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n the user space address to retrieve the unsigned long from\n-
Description
\n+
Description
\n Returns the unsigned long value from a given user space\n address. If the user space data is not accessible, an error will\n occur. Note that the size of the unsigned long depends on the architecture\n of the current user space task (for those architectures that\n support both 64/32 bit compat tasks).\n
function::user_ulong_warn — \n Retrieves an unsigned long value stored in user space\n
Synopsis
\n user_ulong_warn:long(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n the user space address to retrieve the unsigned long from\n-
Description
\n+
Description
\n Returns the unsigned long value from a given user\n space address. Returns zero when user space data is not accessible\n and warns about the failure (but does not error). Note that the\n size of the unsigned long depends on the architecture of the\n current user space task (for those architectures that support both\n 64/32 bit compat tasks).\n
function::user_ulong — \n Retrieves an unsigned long value stored in user space\n
Synopsis
\n user_ulong:long(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n the user space address to retrieve the unsigned long from\n-
Description
\n+
Description
\n Returns the unsigned long value from a given user\n space address. Returns zero when user space data is not\n accessible. Note that the size of the unsigned long depends on the\n architecture of the current user space task (for those\n architectures that support both 64/32 bit compat tasks).\n
function::user_ushort_warn — \n Retrieves an unsigned short value stored in user space\n
Synopsis
\n user_ushort_warn:long(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n the user space address to retrieve the unsigned short from\n-
Description
\n+
Description
\n Returns the unsigned short value from a given user\n space address. Returns zero when user space data is not accessible\n and warns about the failure (but does not error).\n
function::ustack — \n Return address at given depth of user stack backtrace\n
Synopsis
\n ustack:long(n:long)\n-
Arguments
n
\n+
Arguments
n
\n number of levels to descend in the stack.\n-
Description
\n+
Description
\n Performs a simple (user space) backtrace, and returns the\n element at the specified position. The results of the backtrace itself\n are cached, so that the backtrace computation is performed at most once\n no matter how many times ustack is called, or in what order.\n
function::usymdata — \n Return the symbol and module offset of an address.\n
Synopsis
\n usymdata:string(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The address to translate.\n-
Description
\n+
Description
\n Returns the (function) symbol name associated with the\n given address in the current task if known, the offset from the\n start and the size of the symbol, plus the module name (between\n brackets). If symbol is unknown, but module is known, the offset\n inside the module, plus the size of the module is added. If any\n element is not known it will be omitted and if the symbol name is\n unknown it will return the hex string for the given address.\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-usymfile.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-usymfile.html", "unified_diff": "@@ -1,11 +1,11 @@\n
function::usymfile — \n Return the file name of a given address.\n
Synopsis
\n usymfile:string(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The address to translate.\n-
Description
\n+
Description
\n Returns the file name of the given address, if known. If the\n file name cannot be found, the hex string representation of the address\n will be returned.\n
function::usymfileline — \n Return the file name and line number of an address.\n
Synopsis
\n usymfileline:string(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The address to translate.\n-
Description
\n+
Description
\n Returns the file name and the (approximate) line number of the\n given address, if known. If the file name or the line number cannot be\n found, the hex string representation of the address will be returned.\n
function::usymline — \n Return the line number of an address.\n
Synopsis
\n usymline:string(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The address to translate.\n-
Description
\n+
Description
\n Returns the (approximate) line number of the given address, if\n known. If the line number cannot be found, the hex string representation of\n the address will be returned.\n
function::usymname — \n Return the symbol of an address in the current task.\n
Synopsis
\n usymname:string(addr:long)\n-
Arguments
addr
\n+
Arguments
addr
\n The address to translate.\n-
Description
\n+
Description
\n Returns the (function) symbol name associated with the\n given address if known. If not known it will return the hex string\n representation of addr.\n
probe::vm.brk — \n Fires when a brk is requested (i.e. the heap will be resized)\n-
Synopsis
vm.brk
Values
name
\n- name of the probe point\n+
Synopsis
vm.brk
Values
address
\n+ the requested address\n
length
\n the length of the memory segment \n-
address
\n- the requested address\n-
Context
\n+
name
\n+ name of the probe point\n+
Context
\n The process calling brk.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a06.\u00a0Memory Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::vm.brk \u2014 Fires when a brk is requested (i.e. the heap will be resized)\n ***** Synopsis *****\n vm.brk\n ***** Values *****\n- name\n- name of the probe point\n- length\n- the length of the memory segment\n address\n the requested address\n+ length\n+ the length of the memory segment\n+ name\n+ name of the probe point\n ***** Context *****\n The process calling brk.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n function::vm_fault_contains\u00a0Home \u00a0probe::vm.kfree\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-vm-fault-contains.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-vm-fault-contains.html", "unified_diff": "@@ -1,9 +1,9 @@\n function::vm_fault_contains
probe::vm.kfree — \n Fires when kfree is requested\n-
Synopsis
vm.kfree
Values
caller_function
\n- name of the caller function.\n-
call_site
\n- address of the function calling this kmemory function\n-
ptr
\n+
Synopsis
vm.kfree
Values
ptr
\n pointer to the kmemory allocated which is returned by kmalloc\n+
caller_function
\n+ name of the caller function.\n
name
\n name of the probe point\n+
call_site
\n+ address of the function calling this kmemory function\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a06.\u00a0Memory Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::vm.kfree \u2014 Fires when kfree is requested\n ***** Synopsis *****\n vm.kfree\n ***** Values *****\n- caller_function\n- name of the caller function.\n- call_site\n- address of the function calling this kmemory function\n ptr\n pointer to the kmemory allocated which is returned by kmalloc\n+ caller_function\n+ name of the caller function.\n name\n name of the probe point\n+ call_site\n+ address of the function calling this kmemory function\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::vm.brk\u00a0Home \u00a0probe::vm.kmalloc\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-vm-kmalloc-node.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-vm-kmalloc-node.html", "unified_diff": "@@ -1,19 +1,19 @@\n probe::vm.kmalloc_node
probe::vm.kmalloc_node — \n Fires when kmalloc_node is requested\n-
Synopsis
vm.kmalloc_node
Values
name
\n- name of the probe point\n-
ptr
\n+
Synopsis
vm.kmalloc_node
Values
ptr
\n pointer to the kmemory allocated\n
bytes_req
\n requested Bytes\n+
bytes_alloc
\n+ allocated Bytes\n+
gfp_flags
\n+ type of kmemory to allocate\n
gfp_flag_name
\n type of kmemory to allocate(in string format)\n-
caller_function
\n- name of the caller function\n
call_site
\n address of the function caling this kmemory function\n-
gfp_flags
\n- type of kmemory to allocate\n-
bytes_alloc
\n- allocated Bytes\n+
name
\n+ name of the probe point\n+
caller_function
\n+ name of the caller function\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,26 +2,26 @@\n Prev\u00a0Chapter\u00a06.\u00a0Memory Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::vm.kmalloc_node \u2014 Fires when kmalloc_node is requested\n ***** Synopsis *****\n vm.kmalloc_node\n ***** Values *****\n- name\n- name of the probe point\n ptr\n pointer to the kmemory allocated\n bytes_req\n requested Bytes\n+ bytes_alloc\n+ allocated Bytes\n+ gfp_flags\n+ type of kmemory to allocate\n gfp_flag_name\n type of kmemory to allocate(in string format)\n- caller_function\n- name of the caller function\n call_site\n address of the function caling this kmemory function\n- gfp_flags\n- type of kmemory to allocate\n- bytes_alloc\n- allocated Bytes\n+ name\n+ name of the probe point\n+ caller_function\n+ name of the caller function\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::vm.kmalloc\u00a0Home \u00a0probe::vm.kmem_cache_alloc\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-vm-kmalloc.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-vm-kmalloc.html", "unified_diff": "@@ -1,19 +1,19 @@\n probe::vm.kmalloc
probe::vm.kmalloc — \n Fires when kmalloc is requested\n-
Synopsis
vm.kmalloc
Values
bytes_req
\n- requested Bytes\n+
Synopsis
vm.kmalloc
Values
gfp_flags
\n+ type of kmemory to allocate\n
gfp_flag_name
\n type of kmemory to allocate (in String format)\n-
name
\n- name of the probe point\n
ptr
\n pointer to the kmemory allocated\n-
gfp_flags
\n- type of kmemory to allocate\n+
bytes_req
\n+ requested Bytes\n
bytes_alloc
\n allocated Bytes\n
call_site
\n address of the kmemory function\n+
name
\n+ name of the probe point\n
caller_function
\n name of the caller function\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,26 +2,26 @@\n Prev\u00a0Chapter\u00a06.\u00a0Memory Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::vm.kmalloc \u2014 Fires when kmalloc is requested\n ***** Synopsis *****\n vm.kmalloc\n ***** Values *****\n- bytes_req\n- requested Bytes\n+ gfp_flags\n+ type of kmemory to allocate\n gfp_flag_name\n type of kmemory to allocate (in String format)\n- name\n- name of the probe point\n ptr\n pointer to the kmemory allocated\n- gfp_flags\n- type of kmemory to allocate\n+ bytes_req\n+ requested Bytes\n bytes_alloc\n allocated Bytes\n call_site\n address of the kmemory function\n+ name\n+ name of the probe point\n caller_function\n name of the caller function\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::vm.kfree\u00a0Home \u00a0probe::vm.kmalloc_node\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-vm-kmem-cache-alloc-node.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-vm-kmem-cache-alloc-node.html", "unified_diff": "@@ -1,19 +1,19 @@\n probe::vm.kmem_cache_alloc_node
probe::vm.kmem_cache_alloc_node — \n Fires when kmem_cache_alloc_node is requested\n-
Synopsis
vm.kmem_cache_alloc_node
Values
gfp_flags
\n+
Synopsis
vm.kmem_cache_alloc_node
Values
caller_function
\n+ name of the caller function\n+
call_site
\n+ address of the function calling this kmemory function\n+
name
\n+ name of the probe point\n+
gfp_flag_name
\n+ type of kmemory to allocate(in string format)\n+
gfp_flags
\n type of kmemory to allocate\n
bytes_alloc
\n allocated Bytes\n-
call_site
\n- address of the function calling this kmemory function\n-
caller_function
\n- name of the caller function\n
bytes_req
\n requested Bytes\n-
gfp_flag_name
\n- type of kmemory to allocate(in string format)\n-
name
\n- name of the probe point\n
ptr
\n pointer to the kmemory allocated\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,26 +2,26 @@\n Prev\u00a0Chapter\u00a06.\u00a0Memory Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::vm.kmem_cache_alloc_node \u2014 Fires when kmem_cache_alloc_node is requested\n ***** Synopsis *****\n vm.kmem_cache_alloc_node\n ***** Values *****\n+ caller_function\n+ name of the caller function\n+ call_site\n+ address of the function calling this kmemory function\n+ name\n+ name of the probe point\n+ gfp_flag_name\n+ type of kmemory to allocate(in string format)\n gfp_flags\n type of kmemory to allocate\n bytes_alloc\n allocated Bytes\n- call_site\n- address of the function calling this kmemory function\n- caller_function\n- name of the caller function\n bytes_req\n requested Bytes\n- gfp_flag_name\n- type of kmemory to allocate(in string format)\n- name\n- name of the probe point\n ptr\n pointer to the kmemory allocated\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::vm.kmem_cache_alloc\u00a0Home \u00a0probe::vm.kmem_cache_free\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-vm-kmem-cache-alloc.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-vm-kmem-cache-alloc.html", "unified_diff": "@@ -1,19 +1,19 @@\n probe::vm.kmem_cache_alloc
probe::vm.kmem_cache_alloc — \n Fires when kmem_cache_alloc is requested\n-
Synopsis
vm.kmem_cache_alloc
Values
bytes_alloc
\n- allocated Bytes\n-
gfp_flags
\n- type of kmemory to allocate\n-
call_site
\n+
Synopsis
vm.kmem_cache_alloc
Values
call_site
\n address of the function calling this kmemory function.\n+
name
\n+ name of the probe point\n
caller_function
\n name of the caller function.\n+
gfp_flags
\n+ type of kmemory to allocate\n
gfp_flag_name
\n type of kmemory to allocate(in string format)\n-
bytes_req
\n- requested Bytes\n
ptr
\n pointer to the kmemory allocated\n-
name
\n- name of the probe point\n+
bytes_alloc
\n+ allocated Bytes\n+
bytes_req
\n+ requested Bytes\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,26 +2,26 @@\n Prev\u00a0Chapter\u00a06.\u00a0Memory Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::vm.kmem_cache_alloc \u2014 Fires when kmem_cache_alloc is requested\n ***** Synopsis *****\n vm.kmem_cache_alloc\n ***** Values *****\n- bytes_alloc\n- allocated Bytes\n- gfp_flags\n- type of kmemory to allocate\n call_site\n address of the function calling this kmemory function.\n+ name\n+ name of the probe point\n caller_function\n name of the caller function.\n+ gfp_flags\n+ type of kmemory to allocate\n gfp_flag_name\n type of kmemory to allocate(in string format)\n- bytes_req\n- requested Bytes\n ptr\n pointer to the kmemory allocated\n- name\n- name of the probe point\n+ bytes_alloc\n+ allocated Bytes\n+ bytes_req\n+ requested Bytes\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::vm.kmalloc_node\u00a0Home \u00a0probe::vm.kmem_cache_alloc_node\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-vm-kmem-cache-free.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-vm-kmem-cache-free.html", "unified_diff": "@@ -1,11 +1,11 @@\n probe::vm.kmem_cache_free
probe::vm.kmem_cache_free — \n Fires when kmem_cache_free is requested\n-
Synopsis
vm.kmem_cache_free
Values
name
\n+
Synopsis
vm.kmem_cache_free
Values
name
\n Name of the probe point\n-
ptr
\n- Pointer to the kmemory allocated which is returned by kmem_cache\n
call_site
\n Address of the function calling this kmemory function\n
caller_function
\n Name of the caller function.\n+
ptr
\n+ Pointer to the kmemory allocated which is returned by kmem_cache\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,16 +4,16 @@\n ***** Name *****\n probe::vm.kmem_cache_free \u2014 Fires when kmem_cache_free is requested\n ***** Synopsis *****\n vm.kmem_cache_free\n ***** Values *****\n name\n Name of the probe point\n- ptr\n- Pointer to the kmemory allocated which is returned by kmem_cache\n call_site\n Address of the function calling this kmemory function\n caller_function\n Name of the caller function.\n+ ptr\n+ Pointer to the kmemory allocated which is returned by kmem_cache\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::vm.kmem_cache_alloc_node\u00a0Home \u00a0probe::vm.mmap\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-vm-mmap.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-vm-mmap.html", "unified_diff": "@@ -1,11 +1,11 @@\n probe::vm.mmap
probe::vm.mmap — \n Fires when an mmap is requested\n-
Synopsis
vm.mmap
Values
length
\n+
Synopsis
vm.mmap
Values
length
\n the length of the memory segment \n-
name
\n- name of the probe point\n
address
\n the requested address\n-
Context
\n+
name
\n+ name of the probe point\n+
Context
\n The process calling mmap.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -4,16 +4,16 @@\n ***** Name *****\n probe::vm.mmap \u2014 Fires when an mmap is requested\n ***** Synopsis *****\n vm.mmap\n ***** Values *****\n length\n the length of the memory segment\n- name\n- name of the probe point\n address\n the requested address\n+ name\n+ name of the probe point\n ***** Context *****\n The process calling mmap.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::vm.kmem_cache_free\u00a0Home \u00a0probe::vm.munmap\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-vm-munmap.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-vm-munmap.html", "unified_diff": "@@ -1,11 +1,11 @@\n probe::vm.munmap
probe::vm.munmap — \n Fires when an munmap is requested\n-
Synopsis
vm.munmap
Values
name
\n- name of the probe point\n+
Synopsis
vm.munmap
Values
address
\n+ the requested address\n
length
\n the length of the memory segment \n-
address
\n- the requested address\n-
Context
\n+
name
\n+ name of the probe point\n+
Context
\n The process calling munmap.\n
\n", "details": [{"source1": "html2text {}", "source2": "html2text {}", "unified_diff": "@@ -2,18 +2,18 @@\n Prev\u00a0Chapter\u00a06.\u00a0Memory Tapse\u00a0Next\n ===============================================================================\n ***** Name *****\n probe::vm.munmap \u2014 Fires when an munmap is requested\n ***** Synopsis *****\n vm.munmap\n ***** Values *****\n- name\n- name of the probe point\n- length\n- the length of the memory segment\n address\n the requested address\n+ length\n+ the length of the memory segment\n+ name\n+ name of the probe point\n ***** Context *****\n The process calling munmap.\n ===============================================================================\n Prev\u00a0 Up \u00a0Next\n probe::vm.mmap\u00a0Home \u00a0probe::vm.oom_kill\n"}]}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-vm-oom-kill.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-vm-oom-kill.html", "unified_diff": "@@ -1,10 +1,10 @@\n probe::vm.oom_kill
probe::vm.pagefault.return — \n Indicates what type of fault occurred\n-
Synopsis
vm.pagefault.return
Values
fault_type
\n+
Synopsis
vm.pagefault.return
Values
fault_type
\n returns either \n 0 (VM_FAULT_OOM) for out of memory faults, \n 2 (VM_FAULT_MINOR) for minor faults, 3 (VM_FAULT_MAJOR) for \n major faults, or 1 (VM_FAULT_SIGBUS) if the fault was neither OOM, minor fault, \n nor major fault.\n
name
\n name of the probe point\n"}, {"source1": "./usr/share/doc/systemtap-doc/tapsets/API-vm-pagefault.html", "source2": "./usr/share/doc/systemtap-doc/tapsets/API-vm-pagefault.html", "unified_diff": "@@ -1,12 +1,12 @@\n