OpenSolaris

Printable Version Enter a New Search
Bug ID 6245341
Synopsis SOL10: doc bugs in DYNMCTRCGGD (817-6223-10)
State 6-Fix Understood (Fix is known)
Category:Subcategory doc:dtrace
Keywords DYNMCTRCGGD | SOL10ja
Responsible Engineer Paul Echeverri
Reported Against
Duplicate Of
Introduced In
Commit to Fix s10u6_fcs
Fixed In
Release Fixed
Related Bugs
Submit Date 24-March-2005
Last Update Date 28-July-2008
Description
Reporting doc bugs in Solaris Dynamic Tracing Guide (817-6223-10).

*1, *2, *3 - already fixed on 817-6223-11 (04/01/2005).

[preface.sgm] Preface
- In the platform note, ulink type definition [type="text_url"] should be [type="url"]. 
This causes duplicated "http://www.sun.com/bigadmin/hcl/" in PDF file.

----------------
The supported systems appear in the <citetitle>Solaris 10 
Hardware Compatibility List</citetitle> at 
<ulink url="http://www.sun.com/bigadmin/hcl/"type="text_url">
http://www.sun.com/bigadmin/hcl/</ulink>.
----------------

*1 [chapter1.sgm] Chapter 1. Introduction
- In "External Symbols and Types", the book title "Tunable Parameters 
Guide" should be the correct title "Solaris Tunable Parameters 
Reference Manual".

----------------
Solaris kernel contains a C declaration of a system tunable named
kmem_flags for enabling memory allocator debugging features. See the
Tunable Parameters Guide for more information about kmem_flags.
----------------

[chp-variables.sgm] Chapter 3. Variables
- In "External Variables", the book title "Tunable Parameters Guide" 
should be the correct title "Solaris Tunable Parameters Reference Manual".

----------------
For example, the Solaris kernel contains a C declaration of a 
system tunable named kmem_flags for enabling memory allocator 
debugging features. See the Tunable Parameters Guide for more 
information about kmem_flags. 
----------------

[chp-aggs.sgm] Chapter 9.Aggregations
- In "Aggregating Functions", the words "the number" should be 
removed from "to sum the number the elements in the set" in the 
last of the sentence below.

----------------
Determining the arithmetic mean of the set can be constructed 
from the function to count the number of elements in the set 
and the function to sum the number the elements in the set.
----------------

[chp-actsub.sgm]  Chapter 10. Actions and Subroutines
- In "tracemem()" of "Data Recording Actions", "specified by addr" 
should be "specified by address" in the sentence below.

----------------
tracemem() copies the memory from the address specified by addr 
into the directed buffer for the length specified by nbytes.
----------------

[chp-actsub.sgm]  Chapter 10. Actions and Subroutines
- In "ustack()" of "Data Recording Actions", the following command 
output is out of date and should be modified. 

----------------
To run this example for the Netscape web browser, .netscape.bin in
default Solaris installations, use the following command:

# dtrace -s brk.d .netscape.bin
dtrace: description  syscall::brk:entry  matched 1 probe
^C
	libc.so.1 _brk_unlocked+0xc
	88143f6
	88146cd
	.netscape.bin unlocked_malloc+0x3e
	.netscape.bin unlocked_calloc+0x22
	.netscape.bin calloc+0x26
	.netscape.bin _IMGCB_NewPixmap+0x149
	.netscape.bin il_size+0x2f7
		.
		.
		.
----------------

*2 [chp-dtrace.sgm] Chapter 17. dtrace Provider
- In "BEGIN Probe", the word "not" is missing in the following sentece.

----------------
These values should be relied upon or interpreted to infer any
meaningful information.	
----------------
In this context, this should be:
----------------
These values should not be relied upon or interpreted to infer any
meaningful information.
----------------

[chp-lockstat.sgm] Chapter 18. lockstat Provider
- In "Thread Locks", the sentence "The thread lock hold-event probe 
is in Table 18-3." should be "The thread lock contention-event probe 
is in Table 18-3."

*3 [chp-sysinfo.sgm] Chapter 23. sysinfo Provider
- In TABLE 23-1. sysinfo Probes, "cpu_ticks_io" should be 
"cpu_ticks_wait" in the following description of the "wait_ticks_io" probe.

----------------
No semantic difference between wait_ticks_io and cpu_ticks_io;
wait_ticks_io exists solely for historical reasons.
----------------

 xxxxx@xxxxx.com 2005-03-24 04:33:42 GMT
 xxxxx@xxxxx.com 2005-04-01 09:41:52 GMT
Work Around
N/A
Comments
N/A