Page MenuHomeFreeBSD

d.7: Document the DTrace scripting language
ClosedPublic

Authored by 0mp on Fri, Jul 11, 8:45 PM.
Referenced Files
F123909693: D51268.id158459.diff
Sun, Jul 20, 8:39 AM
F123909596: D51268.id158374.diff
Sun, Jul 20, 8:38 AM
F123908045: D51268.id158342.diff
Sun, Jul 20, 8:12 AM
F123907872: D51268.id158370.diff
Sun, Jul 20, 8:09 AM
F123907830: D51268.id158351.diff
Sun, Jul 20, 8:09 AM
F123907778: D51268.id158425.diff
Sun, Jul 20, 8:08 AM
F123906857: D51268.id158462.diff
Sun, Jul 20, 7:53 AM
Unknown Object (File)
Fri, Jul 18, 2:32 AM
Subscribers

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Skipped
Unit
Tests Skipped
Build Status
Buildable 65381
Build 62264: arc lint + arc unit

Event Timeline

0mp requested review of this revision.Fri, Jul 11, 8:45 PM
0mp added a project: DTrace.
share/man/man7/d.7
12

Maybe?

0mp marked an inline comment as done.
  • Improve Nd
share/man/man7/d.7
12

Why not! Thank you :)

A few minor things, the rest looks fine.

share/man/man7/d.7
77

I don't think you need a comma here.

80

same here

155

s/handling a/handling of a/

0mp added reviewers: bnovkov, christos, markj.
0mp added a project: docs.
0mp marked 2 inline comments as done.
  • Address bcr's feedback
  • Reference ddb(4) as the kernel debugger, not kgdb
  • Move cwd to BUGS and mention that it is not supported at the moment.
  • Document execargs
  • Add a note what execname is.
share/man/man7/d.7
79

Isn't this sentence redundant, since the previous sentence already says that an enabled probed is defined by its probe ID?

96

Better to make this the second one in order to match the order of the probe description fields (provider, module, function, name).

148
197

I think here and below it's better to get rid of the "a/an".

0mp marked 5 inline comments as done.
  • Address feedback

@ziaee, could you check the apropos(1) compliance? ;)

share/man/man7/d.7
79

So this comment is about:

The enabled probe ID which uniquely identifies an enabled probe.
An enabled probe is defined by its probe ID, its predicates, and its actions.

I think it is necessary, because those 3 items are what makes the enabled probe unique. It is not redundant.

share/man/man7/d.7
203

The first letter should be capitalized, no?

  • Capitalize descriptions of aggregation functions
0mp marked an inline comment as done.Mon, Jul 14, 12:21 PM
0mp added inline comments.
share/man/man7/d.7
203

Sure, why not.

0mp marked an inline comment as done.Mon, Jul 14, 12:22 PM
This revision is now accepted and ready to land.Mon, Jul 14, 12:26 PM
This revision was automatically updated to reflect the committed changes.