oracle home
Oracle
®
Solaris 11.2 Dynamic Tracing Guide
Exit Print View
Search Term
Search Scope:
This Document
Entire Library
» ...
Documentation Home
»
Oracle Solaris 11.2 Information Library
»
Oracle
®
Solaris 11.2 Dynamic ...
»
Actions and Subroutines
»
Data Recording Actions
»
func
Updated: July 2014
Oracle
®
Solaris 11.2 Dynamic Tracing Guide
Document Information
Using This Documentation
Product Documentation Library
Access to Oracle Support
Feedback
Chapter 1 About DTrace
Getting Started
Providers and Probes
Chapter 2 D Programming Language
D Program Structure
Probe Clauses and Declarations
Probe Descriptions
Predicates
Actions
Order of Execution
Use of the C Preprocessor
Compilation and Instrumentation
Variables and Arithmetic Expressions
Predicates
Output Formatting
Arrays
External Symbols and Types
Types, Operators, and Expressions
Identifier Names and Keywords
Data Types and Sizes
Constants
Arithmetic Operators
Relational Operators
Logical Operators
Bitwise Operators
Assignment Operators
Increment and Decrement Operators
Conditional Expressions
Type Conversions
Precedence
Variables
Scalar Variables
Associative Arrays
Thread-Local Variables
Clause-Local Variables
Built-in Variables
External Variables
Pointers and Arrays
Pointers and Addresses
Pointer Safety
Array Declarations and Storage
Pointer and Array Relationship
Pointer Arithmetic
Generic Pointers
Multi-Dimensional Arrays
Pointers to DTrace Objects
Pointers and Address Spaces
Strings
String Representation
String Constants
String Assignment
String Conversion
String Comparison
Structs and Unions
Structs
Pointers to Structs
Unions
Member Sizes and Offsets
Bit-Fields
Type and Constant Definitions
typedef
Enumerations
Inlines
Type Namespaces
Chapter 3 Aggregations
Aggregating Functions
Aggregations
Printing Aggregations
Data Normalization
Clearing Aggregations
Sorting Aggregations
Truncating Aggregations
Minimizing Drops
Chapter 4 Actions and Subroutines
Actions
Default Action
Data Recording Actions
trace
tracemem
printf
printa
stack
ustack
jstack
clear
denormalize
normalize
trunc
mod
umod
func
ufunc
freopen
ftruncate
setopt
uaddr
sym
usym
Destructive Actions
Process Destructive Actions
stop
raise
copyout
copyoutstr
system
Kernel Destructive Actions
breakpoint
panic
chill
Special Actions
Speculative Actions
exit
Subroutines
alloca
basename
bcopy
cleanpath
copyin
copyinstr
copyinto
dirname
inet_ntoa
inet_ntoa6
inet_ntop
msgdsize
msgsize
mutex_owned
mutex_owner
mutex_type_adaptive
progenyof
rand
rw_iswriter
rw_write_held
speculation
strjoin
strlen
Chapter 5 Buffers and Buffering
Principal Buffers
Principal Buffer Policies
switch Policy
fill Policy
fill Policy and END Probes
ring Policy
Other Buffers
Buffer Sizes
Buffer Resizing Policy
Chapter 6 Output Formatting
printf
Conversion Specifications
Flag Specifiers
Width and Precision Specifiers
Size Prefixes
Conversion Formats
printa
trace Default Format
Chapter 7 Speculative Tracing
Speculation Interfaces
Creating a Speculation
Using a Speculation
Committing a Speculation
Discarding a Speculation
Speculation Example
Speculation Options and Tuning
Chapter 8 dtrace(1M) Utility
Description
Options
Operands
Exit Status
Chapter 9 Scripting
Interpreter Files
Macro Variables
Macro Arguments
Target Process ID
Chapter 10 Options and Tunables
Consumer Options
Modifying Options
Chapter 11 Providers
dtrace Provider
BEGIN Probe
END Probe
ERROR Probe
Stability
lockstat Provider
Overview
Adaptive Lock Probes
Spin Lock Probes
Thread Locks
Readers/Writer Lock Probes
Stability
profile Provider
profile- n probes
tick - n probes
Arguments
Timer Resolution
Probe Creation
Stability
cpc Provider
Probes
Arguments
Probe Availability
Probe Creation
Co-existence With Existing Tools
Examples
user-insts.d
kern-cycles.d
brendan-l2miss.d
brendan-generic-l2miss.d
off_core_event.d
l2miss.d
Stability
fbt Provider
Probes
Probe arguments
entry probes
return probes
Examples
Tail-call Optimization
Assembly Functions
Instruction Set Limitations
x86 Limitations
SPARC Limitations
Breakpoint Interaction
Module Loading
Stability
syscall Provider
Probes
System Call Anachronisms
Subcoded System Calls
New System Calls
Deleted System Calls
Large File System Calls
Private System Calls
Arguments
Stability
sdt Provider
Probes
Examples
Creating SDT Probes
Declaring Probes
Probe Arguments
Stability
mib Provider
Probes
Arguments
Stability
fpuinfo Provider
Probes
Arguments
Stability
pid Provider
Naming pid Probes
Function Boundary Probes
entry Probes
return Probes
Function Offset Probes
Stability
plockstat Provider
Overview
Mutex Probes
Reader/Writer Lock Probes
Stability
fasttrap Provider
Probes
Stability
sysinfo Provider
Probes
Arguments
Example
Stability
vminfo Provider
Probes
Arguments
Example
Stability
proc Provider
Probes
Arguments
lwpsinfo_t
psinfo_t
Examples
exec
start and exit
lwp-start and lwp-exit
signal-send
Stability
sched Provider
Probes
Arguments
cpuinfo_t
Examples
on-cpu and off-cpu
enqueue and dequeue
sleep and wakeup
preempt and remain-cpu
change-pri
tick
cpucaps-sleep and cpucaps-wakeup
Stability
io Provider
Probes
Arguments
bufinfo_t structure
devinfo_t
fileinfo_t
Examples
Stability
Protocols
ip Provider
Probes
Arguments
args[0] - pktinfo_t Structure
args[1] - csinfo_t Structure
args[2] - ipinfo_t Structure
args[3] - ifinfo_t Structure
args[4] - ipv4info_t Structure
args[5] - ipv6info_t Structure
Examples
Packets by host address
Sent size distribution
ipio.d
ipproto.d
Stability
iscsi Provider
Probes
Arguments
Types
Examples
One-liners
iscsiwho.d
iscsixfer.d
nfsv3 Provider
Arguments
Probes
Examples
nfsv3rwsnoop.d
nfsv3ops.d
nfsv3fileio.d
nfsv3rwtime.d
nfsv3io.d
nfsv4 Provider
Arguments
Probes
Examples
nfsv4rwsnoop.d
nfsv4ops.d
nfsv4fileio.d
nfsv4rwtime.d
nfsv4io.d
srp Provider
Probes
Probes Overview
Service up/down Event Probes
Remote Port Login/Logout Event Probes
SRP Command Event Probes
SCSI Command Event Probes
Data Transfer Probes
Types
scsicmd_t
conninfo_t
srp_portinfo_t
srp_logininfo_t
srp_taskinfo_t
xferinfo_t
Examples
service.d
srpwho.d
srpsnoop.d
tcp Provider
Probes
Arguments
pktinfo_t Structure
csinfo_t Structure
ipinfo_t Structure
tcpsinfo_t Structure
tcplsinfo_t Structure
tcpinfo_t Structure
Examples
Connections by Host Address
Connections by TCP Port
Who is Connecting to What
Who Isn't Connecting to What
Packets by Host Address
Packets by Local Port
Sent Size Distribution
tcpstate.d
tcpio.d
Stability
udp Provider
Probes
Arguments
pktinfo_t Structure
csinfo_t Structure
ipinfo_t Structure
udpsinfo_t Structure
udpsinfo_t Structure
Examples
Packets by Host Address
Packets by Local Port
Sent Size Distribution
Stability
Chapter 12 User Process Tracing
copyin and copyinstr Subroutines
Avoiding Errors
Eliminating dtrace(1M) Interference
syscall Provider
ustack Action
uregs[] Array
pid Provider
User Function Boundary Tracing
Tracing Arbitrary Instructions
Chapter 13 Statically Defined Tracing for User Applications
Choosing the Probe Points
Adding Probes to an Application
Defining Providers and Probes
Adding Probes to Application Code
Building Applications with Probes
Chapter 14 Security
Privileges
Privileged Use of DTrace
dtrace_proc Privilege
dtrace_user Privilege
dtrace_kernel Privilege
Super User Privileges
Chapter 15 Anonymous Tracing
Anonymous Enablings
Claiming Anonymous State
Anonymous Tracing Examples
Chapter 16 Postmortem Tracing
Displaying DTrace Consumers
Displaying Trace Data
Chapter 17 Performance Considerations
Limit Enabled Probes
Use Aggregations
Use Cacheable Predicates
Chapter 18 Stability
Stability Levels
Dependency Classes
Interface Attributes
USDT Interfaces
Stability Computations and Reports
Stability Enforcement
Chapter 19 Translators
Translator Declarations
Translate Operator
Process Model Translators
Stable Translations
Chapter 20 Versioning
Versions and Releases
Versioning Options
Provider Versioning
Index
Index Numbers and Symbols
Index A
Index B
Index C
Index D
Index E
Index F
Index I
Index K
Index L
Index M
Index N
Index O
Index P
Index R
Index S
Index T
Index U
Index V
Language:
English
func
func
action outputs the function name of the kernel argument.
Previous
Next