Man Pages

---

Back to Software Index  Manpage Top Level

Name

Description

Each probe has a name and is associated with a set of symbolic keys, or categories. These are used to select and control probes from prex(1) . A probe that is enabled for tracing generates a TNF record, called an event record. An event record contains two common members and may contain other probe-specific data members.

Common Members

tnf type name	member name
tnf_probe_event
tnf_time_delta

tag

encodes TNF references to two other records:

tag

describes the layout of the event record

schedule

identifies the writing thread and also contains a 64-bit base time in nanoseconds.

time_delta

a 32-bit time offset from the base time; the sum of the two times is the actual time of the event.

Threads

	tnf_kthread_id
	tnf_pid
	tnf_symbol

Thread creation event.

tid

the thread identifier for the new thread

pid

the process identifier for the new thread

start_pc

the kernel address of its start routine.

thread_state

	tnf_kthread_id
	tnf_microstate

Thread microstate transition events.

tid

optional; if it is absent, the event is for the writing thread, otherwise the event is for the specified thread.

state

indicates the thread state:

running in user mode

running in system mode

asleep waiting for a user-mode lock

asleep on a kernel object,

runnable (waiting for a cpu)

stopped.

The values of this member are defined in

<sys/msacct.h>. Note that to reduce trace output, transitions between the system and user microstates that are induced by system calls are not traced. This information is implicit in the system call entry and exit events.

thread_exit

Thread termination event for writing thread. This probe has no data members other than the common members.

Scheduling

thread_queue

	tnf_kthread_id
	tnf_cpuid
	tnf_long
	tnf_ulong

Thread scheduling events. These are triggered when a runnable thread is placed on a dispatch queue.

cpuid

specifies the cpu to which the queue is attached.

priority

the (global) dispatch priority of the thread.

queue_length

the current length of the cpu’s dispatch queue.

Blocking

thread_block

	tnf_opaque
	tnf_symbols

Thread blockage event. This probe captures a partial stack backtrace when the current thread blocks.

reason

the address of the object on which the thread is blocking.

symbols

references a TNF array of kernel addresses representing the PCs on the stack at the time the thread blocks.

System Calls

syscall_start

tnf_sysnum

System call entry event.

sysnum

the system call number. The writing thread implicitly enters the system microstate with this event.

syscall_end

	tnf_long
	tnf_long
	tnf_long

System call exit event.

rval1

rval2

the two return values of the system call

errno

the error return.

The writing thread implicitly enters the user microstate with this event.

Page Faults

address_fault

	tnf_opaque
	tnf_fault_type
	tnf_seg_access

Address-space fault event.

address

gives the faulting virtual address.

fault_type

gives the fault type: invalid page, protection fault, software requested locking or unlocking.

access

gives the desired access protection: read, write, execute or create.

The values for these two members are defined in <vm/seg_enum.h>.

major_fault

	tnf_opaque
	tnf_offset

Major page fault event. The faulting page is mapped to the file given by the vnode member, at the given offset into the file. (The faulting virtual address is in the most recent address_fault event for the writing thread.)

anon_private

tnf_opaque

Copy-on-write page fault event.

address

the virtual address at which the new page is mapped.

anon_zero

tnf_opaque

Zero-fill page fault event.

address

the virtual address at which the new page is mapped.

page_unmap

	tnf_opaque
	tnf_offset

Page unmapping event. This probe marks the unmapping of a file system page from the system.

vnode and offset

identify the file and offset of the page being unmapped.

Pageins and Pageouts

pagein

	tnf_opaque
	tnf_offset
	tnf_size

Pagein start event. This event signals the initiation of pagein I/O.

vnode and offset

identify the file and offset to be paged in.

size

specifies the number of bytes to be paged in.

pageout

	tnf_opaque
	tnf_ulong
	tnf_ulong
	tnf_ulong

Pageout completion event. This event signals the completion of pageout I/O.

vnode

identifies the file of the pageout request.

pages_pageout

the number of pages written out.

pages_freed

the number of pages freed after being written out.

pages_reclaimed

the number of pages reclaimed after being written out.

Page Daemon (Page Stealer)

pageout_scan_start

	tnf_ulong
	tnf_ulong

Page daemon scan start event. This event signals the beginning of one iteration of the page daemon.

pages_free

the number of free pages in the system.

pages_needed

the number of pages desired free.

pageout_scan_end

	tnf_ulong
	tnf_ulong

Page daemon scan end event. This event signals the end of one iteration of the page daemon.

pages_free

the number of free pages in the system.

pages_scanned

the number of pages examined by the page daemon. (Potentially more pages will be freed when any queued pageout requests complete.)

Swapper

swapout_process

	tnf_pid
	tnf_ulong

Address space swapout event. This event marks the swapping out of a process address space.

pid

identifies the process.

page_count

reports the number of pages either freed or queued for pageout.

swapout_lwp

	tnf_pid
	tnf_lwpid
	tnf_kthread_id
	tnf_ulong

Light-weight process swapout event. This event marks the swapping out of an LWP and its stack.

pid

the LWP ’s process identifier

lwpid

the LWP identifier

tid member

the LWP ’s kernel thread identifier.

page_count

the number of pages swapped out.

swapin_lwp

	tnf_pid
	tnf_lwpid
	tnf_kthread_id
	tnf_ulong

Light-weight process swapin event. This event marks the swapping in of an LWP and its stack.

pid

the LWP ’s process identifier

lwpid

the LWP identifier

tid

the LWP ’s kernel thread identifier.

page_count

the number of pages swapped in.

Local I/O

strategy

	tnf_device
	tnf_diskaddr
	tnf_size
	tnf_opaque
	tnf_bioflags

Block I/O strategy event. This event marks a call to the strategy(9E) routine of a block device driver.

device

contains the major and minor numbers of the device.

block

the logical block number to be accessed on the device.

size

the size of the I/O request.

buf

the kernel address of the buf(9S) structure associated with the transfer.

flags

the buf(9S) flags associated with the transfer.

biodone

	tnf_device
	tnf_diskaddr
	tnf_opaque

Buffered I/O completion event. This event marks calls to the biodone(9F) routine.

device

contains the major and minor numbers of the device.

block

the logical block number accessed on the device.

buf

the kernel address of the buf(9S) structure associated with the transfer.

physio_start

	tnf_device
	tnf_offset
	tnf_size
	tnf_bioflags

Raw I/O start event. This event marks entry into the physio(9F) routine which performs unbuffered I/O.

device

contains the major and minor numbers of the device of the transfer.

offset

the logical offset on the device for the transfer.

size

the number of bytes to be transferred.

rw

the direction of the transfer: read or write (see buf(9S) ).

physio_end

tnf_device

Raw I/O end event. This event marks exit from the physio(9F) routine.

device

the major and minor numbers of the device of the transfer.

See Also

prex(1) , tnfdump(1) , tnfxtract(1) , TNF_PROBE(3X) , strategy(9E) , biodone(9F) , physio(9F) , buf(9S)

---

Table of Contents

• Name
• Description
• Common Members
• Threads
• Scheduling
• Blocking
• System Calls
• Page Faults
• Pageins and Pageouts
• Page Daemon (Page Stealer)
• Swapper
• Local I/O
• See Also