From: mmason Date: Thu, 18 Oct 2007 22:29:42 +0000 (+0000) Subject: Regenerated html to get latest man page changes. X-Git-Url: https://sourceware.org/git/?a=commitdiff_plain;h=61985732070981c1d8a519dcb42d338d07933f5e;p=systemtap-htdocs.git Regenerated html to get latest man page changes. --- diff --git a/man/stap.1.html b/man/stap.1.html index 8ea04eb6..07216502 100644 --- a/man/stap.1.html +++ b/man/stap.1.html @@ -2,7 +2,7 @@ Manpage of STAP

STAP

-Section: User Commands (1)
Updated: 2007-10-11
Index +Section: User Commands (1)
Updated: 2007-10-18
Index Return to Main Contents

@@ -1319,6 +1319,6 @@ Use the Bugzilla link off of the project web page or our mailing list. This document was created by man2html, using the manual pages.
-Time: 17:18:18 GMT, October 11, 2007 +Time: 22:28:05 GMT, October 18, 2007 diff --git a/man/stapex.5.html b/man/stapex.5.html index a281959c..0949d831 100644 --- a/man/stapex.5.html +++ b/man/stapex.5.html @@ -2,7 +2,7 @@ Manpage of STAPEX

STAPEX

-Section: File Formats (5)
Updated: 2007-10-11
Index +Section: File Formats (5)
Updated: 2007-10-18
Index Return to Main Contents

@@ -192,6 +192,6 @@ each inlined function instance is listed separately. This document was created by man2html, using the manual pages.
-Time: 17:18:18 GMT, October 11, 2007 +Time: 22:28:05 GMT, October 18, 2007 diff --git a/man/stapfuncs.5.html b/man/stapfuncs.5.html index ee93cbe2..22da8858 100644 --- a/man/stapfuncs.5.html +++ b/man/stapfuncs.5.html @@ -2,7 +2,7 @@ Manpage of STAPFUNCS

STAPFUNCS

-Section: File Formats (5)
Updated: 2007-10-11
Index +Section: File Formats (5)
Updated: 2007-10-18
Index Return to Main Contents

@@ -88,6 +88,11 @@ or if a user-space access would cause a fault.

kernel_string:string (addr:long): Copy a 0-terminated string from kernel space at given address. +
kernel_string_n:string (addr:long, n:long): +Similar with kernel_string, except that not more than n bytes are copied. +Thus, if there are null bytes among the first n bytes, it is same as +kernel_string(addr). If not, n bytes will be copied and a null byte will +be padded to the end.
kernel_long:long (addr:long): Copy a long from kernel space at given address.
kernel_int:long (addr:long): @@ -146,7 +151,7 @@ Return the number of seconds since the UNIX epoch.

CONTEXTINFO

CONTEXT INFO

cpu:long (): @@ -221,6 +226,69 @@ Return the symbolic string associated with the given error code, like

TASK

+ +

+ +These functions return data about a task. They all require +a task handle as input, such as the value return by task_current() or the variables +prev_task and next_task in the scheduler.ctxswitch probe alias. +

task_current:long()

+Return the task_struct of the current process. +

task_parent:long(task:long)

+Return the parent task_struct of the given task. +

task_state:long(task:long)

+Return the state of the given task, which can be one of the following: +

+
   TASK_RUNNING           0 +
   TASK_INTERRUPTIBLE     1 +
   TASK_UNINTERRUPTIBLE   2 +
   TASK_STOPPED           4 +
   TASK_TRACED            8 +
   EXIT_ZOMBIE           16 +
   EXIT_DEAD             32 +

task_execname:string(task:long)

+Return the name of the given task. +

task_pid:long(task:long)

+Return the process id of the given task. +

task_tid:long(task:long)

+Return the thread id of the given task. +

task_gid:long(task:long)

+Return the group id of the given task. +

task_egid:long(task:long)

+Return the effective group id of the given task. +

task_uid:long(task:long)

+Return the user id of the given task. +

task_euid:long(task:long)

+Return the effective user id of the given task. +

task_prio:long(task:long)

+Return the priority of the given task. +

task_nice:long(task:long)

+Return the nice value of the given task. +

task_cpu:long(task:long)

+Return the scheduled cpu for the given task. +

task_open_file_handles:long(task:long)

+Return the number of open file handles for the given task. +

task_max_file_handles:long(task:long)

+Return the maximum number of file handles for the given task. +

QUEUE_STATS

@@ -272,7 +340,7 @@ Return the average time a request took from being enqueued to completed. Return the average rate of requests per scale units of time.

- +

INDENT

@@ -293,7 +361,7 @@ The default function uses

- +

SYSTEM

@@ -302,7 +370,7 @@ Runs a command on the system. The command will run in the background when the current probe completes.

- +

NUMA

@@ -310,7 +378,7 @@ when the current probe completes. Return which node the given address belongs to in a NUMA system.

- +

CTIME

@@ -321,7 +389,7 @@ of the given number of seconds since the epoch, as perhaps returned by

- +

PERFMON

@@ -331,7 +399,7 @@ handle. The body of the a perfmon probe should set record the handle being used for that event.

- +

SOCKETS

These functions convert arguments in the socket tapset back and @@ -364,7 +432,7 @@ Returns the string representation of the given socket flags value. Returns the string representation of the given message flags bit map.

- +

INET

These functions convert between network (big-endian) and host byte order, like their @@ -385,7 +453,7 @@ Convert from host to network byte order, 16-bit.

- +

FILES

@@ -393,7 +461,7 @@ Convert from host to network byte order, 16-bit.

- +

STAPPROBES

-Section: File Formats (5)
Updated: 2007-10-11
Index +Section: File Formats (5)
Updated: 2007-10-18
Index Return to Main Contents

@@ -33,6 +33,7 @@ and that no error should result if it fails to expand. Optionalness passes down through all levels of alias/wildcard expansion.

These are all syntactically valid probe points: +

@@ -87,6 +88,7 @@ target variables available in either context. If the order of execution among "begin" or "end" probes is significant, then an optional sequence number may be provided: +

@@ -100,6 +102,7 @@ end(N) +

The number N may be positive or negative. The probe handlers are run in increasing order, and the order between handlers with the same sequence number is unspecified. When "begin" or "end" are given without a @@ -135,6 +138,7 @@ conjunction with optional probes. Intervals defined by the standard kernel "jiffies" timer may be used to trigger probe handlers asynchronously. Two probe point variants are supported by the translator: +

@@ -148,6 +152,7 @@ timer.jiffies(N).randomize(M) +

The probe handler is run every N jiffies (a kernel-defined unit of time, typically between 1 and 60 ms). If the "randomize" component is given, a linearly distributed random value in the range [-M..+M] is @@ -160,6 +165,7 @@ a multi-processor computer. Alternatively, intervals may be specified in units of time. There are two probe point variants similar to the jiffies timer: +

@@ -173,6 +179,7 @@ timer.ms(N).randomize(M) +

Here, N and M are specified in milliseconds, but the full options for units are seconds (s/sec), milliseconds (ms/msec), microseconds (us/usec), nanoseconds (ns/nsec), and hertz (hz). Randomization is not supported for @@ -189,6 +196,7 @@ before any rounding occurs. Profiling timers are also available to provide probes that execute on all CPUs at the rate of the system tick. This probe takes no parameters. +

@@ -201,6 +209,7 @@ timer.profile +

Full context information of the interrupted process is available, making this probe suitable for a time-based sampling profiler.

@@ -220,7 +229,7 @@ processor, the probe handler is run in that context.

Points in a kernel, which are identified by -module, source file, line number, function name, C label name, or some +module, source file, line number, function name, or some combination of these.

@@ -255,6 +264,7 @@ probes. The variant places a probe at the exact spot, exposing those local variables that are visible there. +

@@ -288,22 +298,32 @@ module(MPATTERN).statement(PATTERN) +

In the above list, MPATTERN stands for a string literal that aims to identify the loaded kernel module of interest. It may include "*", "[]", and "?" wildcards. PATTERN stands for a string literal that aims to identify a point in the program. It is made up of three -parts. The first part is the name of a function, as would appear in -the +parts: +

*: +The first part is the name of a function, as would appear in the nm program's output. This part may use the "*" and "?" wildcarding -operators to match multiple names. The second part is optional, and -begins with the "@" character. It is followed by a source file name -wildcard pattern, such as -mm/slab*. - +operators to match multiple names. +
*: +The second part is optional and begins with the "@" character. +It is followed by the path to the source file containing the function, +which may include a wildcard pattern, such as mm/slab*. +In most cases, the path should be relative to the top of the +linux source directory, although an absolute path may be necessary for some kernels. +If a relative pathname doesn't work, try absolute. +
*: Finally, the third part is optional if the file name part was given, and identifies the line number in the source file, preceded by a ":". +

+ As an alternative, PATTERN may be a numeric constant, indicating an (module-relative or kernel-_stext-relative) address. In guru mode only, absolute kernel addresses may be specified with the ".absolute" @@ -345,6 +365,7 @@ is the name of the systemtap module). The filesystem is a pseudo-filesystem which is used an an interface to kernel data structures. There are four probe point variants supported by the translator: +

@@ -360,6 +381,7 @@ procfs.write +

PATH is the file name (relative to /proc/systemtap/MODNAME) to be created. @@ -381,6 +403,7 @@ a variable named $value, like this: +

@@ -404,6 +427,7 @@ string variable named $value, like this: +

@@ -473,6 +497,7 @@ events, which are available on all processors. This sets up a counter on the processor to count the number of events occuring on the processor. For more details on the performance monitoring events available on a specific processor use the command perfmon2 command: +

@@ -580,6 +605,6 @@ refers to the group of probe aliases with any name in the third position This document was created by man2html, using the manual pages.
-Time: 17:18:18 GMT, October 11, 2007 +Time: 22:28:05 GMT, October 18, 2007 diff --git a/man/stapprobes.iosched.5.html b/man/stapprobes.iosched.5.html index 7358caa2..538888d7 100644 --- a/man/stapprobes.iosched.5.html +++ b/man/stapprobes.iosched.5.html @@ -2,7 +2,7 @@ Manpage of STAPPROBES.IOSCHED

STAPPROBES.IOSCHED

-Section: File Formats (5)
Updated: 2007-10-11
Index +Section: File Formats (5)
Updated: 2007-10-18
Index Return to Main Contents

@@ -140,6 +140,6 @@ Fires when a request is completed This document was created by man2html, using the manual pages.
-Time: 17:18:18 GMT, October 11, 2007 +Time: 22:28:05 GMT, October 18, 2007 diff --git a/man/stapprobes.netdev.5.html b/man/stapprobes.netdev.5.html index ab243a87..51fc17e5 100644 --- a/man/stapprobes.netdev.5.html +++ b/man/stapprobes.netdev.5.html @@ -2,7 +2,7 @@ Manpage of STAPPROBES.NETDEV

STAPPROBES.NETDEV

-Section: File Formats (5)
Updated: 2007-10-11
Index +Section: File Formats (5)
Updated: 2007-10-18
Index Return to Main Contents

@@ -106,6 +106,6 @@ Fires when the network device wants to transmit a buffer This document was created by man2html, using the manual pages.
-Time: 17:18:18 GMT, October 11, 2007 +Time: 22:28:05 GMT, October 18, 2007 diff --git a/man/stapprobes.nfs.5.html b/man/stapprobes.nfs.5.html index 963ee525..25370ec3 100644 --- a/man/stapprobes.nfs.5.html +++ b/man/stapprobes.nfs.5.html @@ -2,7 +2,7 @@ Manpage of STAPPROBES.NFS

STAPPROBES.NFS

-Section: File Formats (5)
Updated: 2007-10-11
Index +Section: File Formats (5)
Updated: 2007-10-18
Index Return to Main Contents

@@ -1607,6 +1607,6 @@ Fires whenever nfs client renames a file on server This document was created by man2html, using the manual pages.
-Time: 17:18:18 GMT, October 11, 2007 +Time: 22:28:05 GMT, October 18, 2007 diff --git a/man/stapprobes.nfsd.5.html b/man/stapprobes.nfsd.5.html index 9ac70dbc..dab75715 100644 --- a/man/stapprobes.nfsd.5.html +++ b/man/stapprobes.nfsd.5.html @@ -2,7 +2,7 @@ Manpage of STAPPROBES.NFSD

STAPPROBES.NFSD

-Section: File Formats (5)
Updated: 2007-10-11
Index +Section: File Formats (5)
Updated: 2007-10-18
Index Return to Main Contents

@@ -675,6 +675,6 @@ Fires whenever server receives NFS operation from client This document was created by man2html, using the manual pages.
-Time: 17:18:18 GMT, October 11, 2007 +Time: 22:28:05 GMT, October 18, 2007 diff --git a/man/stapprobes.pagefault.5.html b/man/stapprobes.pagefault.5.html index 60150b84..96e182d5 100644 --- a/man/stapprobes.pagefault.5.html +++ b/man/stapprobes.pagefault.5.html @@ -2,7 +2,7 @@ Manpage of STAPPROBES.PAGEFAULT

STAPPROBES.PAGEFAULT

-Section: File Formats (5)
Updated: 2007-10-11
Index +Section: File Formats (5)
Updated: 2007-10-18
Index Return to Main Contents

@@ -61,6 +61,6 @@ Fires when there is a pagefault This document was created by man2html, using the manual pages.
-Time: 17:18:18 GMT, October 11, 2007 +Time: 22:28:05 GMT, October 18, 2007 diff --git a/man/stapprobes.process.5.html b/man/stapprobes.process.5.html index a56eada7..9dde5359 100644 --- a/man/stapprobes.process.5.html +++ b/man/stapprobes.process.5.html @@ -2,7 +2,7 @@ Manpage of STAPPROBES.PROCESS

STAPPROBES.PROCESS

-Section: File Formats (5)
Updated: 2007-10-11
Index +Section: File Formats (5)
Updated: 2007-10-18
Index Return to Main Contents

@@ -144,6 +144,6 @@ process waits in a zombie state. This document was created by man2html, using the manual pages.
-Time: 17:18:18 GMT, October 11, 2007 +Time: 22:28:05 GMT, October 18, 2007 diff --git a/man/stapprobes.rpc.5.html b/man/stapprobes.rpc.5.html index 2840e884..0d6a953d 100644 --- a/man/stapprobes.rpc.5.html +++ b/man/stapprobes.rpc.5.html @@ -2,7 +2,7 @@ Manpage of STAPPROBES.RPC

STAPPROBES.RPC

-Section: File Formats (5)
Updated: 2007-10-11
Index +Section: File Formats (5)
Updated: 2007-10-18
Index Return to Main Contents

@@ -778,6 +778,6 @@ Fires when a task is to be delayed This document was created by man2html, using the manual pages.
-Time: 17:18:18 GMT, October 11, 2007 +Time: 22:28:05 GMT, October 18, 2007 diff --git a/man/stapprobes.scsi.5.html b/man/stapprobes.scsi.5.html index 82510b4b..0238045c 100644 --- a/man/stapprobes.scsi.5.html +++ b/man/stapprobes.scsi.5.html @@ -2,7 +2,7 @@ Manpage of STAPPROBES.SCSI

STAPPROBES.SCSI

-Section: File Formats (5)
Updated: 2007-10-11
Index +Section: File Formats (5)
Updated: 2007-10-18
Index Return to Main Contents

@@ -200,6 +200,6 @@ block device I/O requests This document was created by man2html, using the manual pages.
-Time: 17:18:18 GMT, October 11, 2007 +Time: 22:28:05 GMT, October 18, 2007 diff --git a/man/stapprobes.signal.5.html b/man/stapprobes.signal.5.html index 54b8e74b..6559638e 100644 --- a/man/stapprobes.signal.5.html +++ b/man/stapprobes.signal.5.html @@ -2,7 +2,7 @@ Manpage of STAPPROBES.SIGNAL

STAPPROBES.SIGNAL

-Section: File Formats (5)
Updated: 2007-10-11
Index +Section: File Formats (5)
Updated: 2007-10-18
Index Return to Main Contents

@@ -655,6 +655,6 @@ Fires when flush all pending signals for a task This document was created by man2html, using the manual pages.
-Time: 17:18:18 GMT, October 11, 2007 +Time: 22:28:05 GMT, October 18, 2007 diff --git a/man/stapprobes.socket.5.html b/man/stapprobes.socket.5.html index 36a6229b..cf591d57 100644 --- a/man/stapprobes.socket.5.html +++ b/man/stapprobes.socket.5.html @@ -2,7 +2,7 @@ Manpage of STAPPROBES.SOCKET

STAPPROBES.SOCKET

-Section: File Formats (5)
Updated: 2007-10-11
Index +Section: File Formats (5)
Updated: 2007-10-18
Index Return to Main Contents

@@ -621,6 +621,6 @@ The socket closer. This document was created by man2html, using the manual pages.
-Time: 17:18:18 GMT, October 11, 2007 +Time: 22:28:05 GMT, October 18, 2007 diff --git a/man/stapprobes.tcp.5.html b/man/stapprobes.tcp.5.html index f26dbebb..a9e555b3 100644 --- a/man/stapprobes.tcp.5.html +++ b/man/stapprobes.tcp.5.html @@ -2,7 +2,7 @@ Manpage of STAPPROBES.TCP

STAPPROBES.TCP

-Section: File Formats (5)
Updated: 2007-10-11
Index +Section: File Formats (5)
Updated: 2007-10-18
Index Return to Main Contents

@@ -140,6 +140,6 @@ Fires when returning from tcp.disconnect This document was created by man2html, using the manual pages.
-Time: 17:18:18 GMT, October 11, 2007 +Time: 22:28:06 GMT, October 18, 2007 diff --git a/man/stapprobes.udp.5.html b/man/stapprobes.udp.5.html index 6911e5e3..7bfd5756 100644 --- a/man/stapprobes.udp.5.html +++ b/man/stapprobes.udp.5.html @@ -2,7 +2,7 @@ Manpage of STAPPROBES.UDP

STAPPROBES.UDP

-Section: File Formats (5)
Updated: 2007-10-11
Index +Section: File Formats (5)
Updated: 2007-10-18
Index Return to Main Contents

@@ -140,6 +140,6 @@ Fires when returning from udp.disconnect This document was created by man2html, using the manual pages.
-Time: 17:18:18 GMT, October 11, 2007 +Time: 22:28:06 GMT, October 18, 2007 diff --git a/man/staprun.8.html b/man/staprun.8.html index deb0ed25..64e65d3d 100644 --- a/man/staprun.8.html +++ b/man/staprun.8.html @@ -2,7 +2,7 @@ Manpage of STAPRUN

STAPRUN

-Section: Maintenance Commands (8)
Updated: 2007-10-11
Index +Section: Maintenance Commands (8)
Updated: 2007-10-18
Index Return to Main Contents

@@ -261,6 +261,6 @@ Use the Bugzilla link off of the project web page or our mailing list. This document was created by man2html, using the manual pages.
-Time: 17:18:18 GMT, October 11, 2007 +Time: 22:28:05 GMT, October 18, 2007

STAP

STAPEX

STAPFUNCS

CONTEXTINFO

CONTEXT INFO

TASK

QUEUE_STATS

INDENT

SYSTEM

NUMA

CTIME

PERFMON

SOCKETS

INET

FILES

SEE ALSO

STAPPROBES

STAPPROBES.IOSCHED

STAPPROBES.NETDEV

STAPPROBES.NFS

STAPPROBES.NFSD

STAPPROBES.PAGEFAULT

STAPPROBES.PROCESS

STAPPROBES.RPC

STAPPROBES.SCSI

STAPPROBES.SIGNAL

STAPPROBES.SOCKET

STAPPROBES.TCP

STAPPROBES.UDP

STAPRUN