dtrace_dtmalloc.4: Document the DTrace dtmalloc provider

[0mp]

• UMA -> uma

[0mp]

share/man/man4/dtrace_dtmalloc.4

19

This could go on one line.

[christos]

share/man/man4/dtrace_dtmalloc.4

11

I think the "9" in malloc(9) makes "kernel memory" redundant.

19

19

I think "type" can be explained a bit.

30

43

58

I am not really sure I understand this section.

101

Maybe "trace" instead of "instrument"? Not sure to be honest.

[markj]

share/man/man4/dtrace_dtmalloc.4

23

I think explaining briefly what a malloc "type" is would be useful.

48

The probe argument types are already listed by dtrace -lv so I'm not sure it's useful to list them here unless you also describe what they are.

Briefly, the first three arguments for each probe provide references to the malloc type internals; size is the size of the allocation; zindx is the index into the kmemzones[] array used for the allocation.

In practice, size is the most useful parameter.

58

It means that if the malloc type was defined by

MALLOC_DEFINE(M_FOO_BAR, "foo bar", "FooBar subsystem");

the probes will be called dtmalloc::foo_bar:.

[christos]

share/man/man4/dtrace_dtmalloc.4

58

Right, I think it'd be good to make that more explicit. I'm not sure it is immediately obvious.