dsperfmonitor.1   [plain text]

.\"Modified from man(1) of FreeBSD, the NetBSD mdoc.template, and mdoc.samples.
.\"See Also:
.\"man mdoc.samples for a complete listing of options
.\"man mdoc for the short list of editing options
.Dd Nov 17, 2003       \" DATE 
.Dt dsperfmonitor 1       \" Program name and manual section number 
.Os MacOSX
.Sh NAME                 \" Section Header - required - don't modify 
.Nm dsperfmonitor 
.\" The following lines are read in generating the apropos(man -k) database. Use only key
.\" words here as the database is built based on the words here and in the .ND line. 
.\" Use .Nm macro to designate other names for the documented program.
.Nd A Directory Tool for monitoring plugin performance in Directory Services
.Sh SYNOPSIS             \" Section Header - required - don't modify
.Fl a | d | dump | flush       \" [options] 
.Sh DESCRIPTION          \" Section Header - required - don't modify
The dsperfmonitor tool is a command line utility for enabling internal plugin performance monitoring in the DirectoryService daemon.  This tool allows you active and deactivate/dump information on what API calls are made to plugins, how long they took to respond, and what the last 5 errors in any API were.
The options are as follows:
.Nm options:
.Bl -tag -width -indent  \" Differs from above in -compact tag removed 
.It Fl a
Acivate performance monitoring 
.It Fl d
Deactivate performance monitoring and dump a tab delimited result to /var/log/system.log
.It Fl dump
Dump a tab delimited result to /var/log/system.log
.It Fl flush
Reset statistics
.El                      \" Ends the list
.\" The following are optional section headers. Remove the comment tag to use.
.\" .Sh RETURN VALUES    \"Sections 2 and 3
.\" .Sh ENVIRONMENT      \"Sections 1, 6, 7, and 8
.\" .Sh FILES
.\" .Ev PAGER
.\" .Sh DIAGNOSTICS      \"Sections 1, 6, 7, and 8
.\" .Sh ERRORS           \"Sections 2 and 3
.\" List links in ascending order by section, alphabetically within a section.
.\" Please do not reference files that do not exist without filing a bug report
.Xr DirectoryService 8
.Xr dscl 1
.Xr dirt 1
.Xr DirectoryServiceAttributes 7
.\" .Sh BUGS