.Dd Nov 15, 2016
.Dt odutil 1
.Os
.Sh NAME
.Nm odutil
.Nd allows caller to examine or change state of 
.Xr opendirectoryd 8
.Sh SYNOPSIS
.Nm
.Cm show
.Op Cm cache | sessions | nodes | modules | requests | nodenames | statistics | all
.Nm
.Cm show
.Cm configuration Ar nodename
.Op Cm module Ar modulename
.Op Cm option Ar option
.Nm
.Cm reset
.Op Cm cache | statistics
.Nm
.Cm set log
.Op Cm default | alert | critical | error | warning | notice | info | debug
.Nm
.Cm set configuration Ar nodename
.Op Cm module Ar modulename
.Cm option Ar option Ar value1 ...
.Nm
.Cm set statistics
.Op Cm on | off
.Sh DESCRIPTION
Use 
.Nm
to look at internal state information for opendirectoryd, enable or disable logging, or change statistics settings.
.Pp
Available commands:
.Bl -tag -width "set statistics"
.It Cm show
Show various internal information. Subcommands:
.Bl -tag -compact
.It Cm cache
Outputs contents of the cache.  Note, this output is not included in show all command.
.It Cm sessions
List all open sessions
.It Cm nodes
List all open nodes
.It Cm modules
List all loaded modules
.It Cm requests
List all active requests
.It Cm statistics
Outputs statistics information.  Some statistics are always enabled (membership). Additional statistics can be enabled see 'set statistics on'.
.It Cm nodenames
List all available node names
.It Cm all
List all of the above information (excludes cache)
.El
.El
.Bl -tag -width "set statistics"
.It Cm show configuration Ar nodename
Show configuration of a specific node, Subcommands:
.Bl -tag -compact
.It Cm module Ar modulename
Specific module is requested, otherwise global options
.It Cm option Ar option
Output a value of a specific option.
.El
.El
.Bl -tag -width "set statistics"
.It Cm reset
Reset various internal information. Subcommands:
.Bl -tag -compact
.It Cm cache
Resets all caches including membership and kernel (does not affect DNS cache)
.It Cm statistics
Resets any accumulated statistics.
.El
.El
.Bl -tag -width "set statistics"
.It Cm set log
Change the type of log messages saved to persistent storage. The configuration stays active across reboots and must be changed to a new type or 'default'.  The next type of messages are automatically stored to memory-only buffers for enhanced debugging.
.Bl -tag -compact
.It Cm default
Enables saving log messages based on default system behavior.  Typically, saves basic messages to persistent storage and info messages to memory-only buffers.
.It Cm info
Enables saving of info type messages to persistent storage and debug messages to memory-only buffers.
.It Cm debug
Enables saving all types of messages to persistent storage.
.El
.El
.Bl -tag -width "set statistics"
.It Cm set configuration Ar nodename
Sets either global or per-module options accordingly.
.Bl -tag -compact
.It Cm module Ar modulename
If module is omitted, then global option is assumed.
.It Cm option Ar option Ar value1 ...
Set a specific option to one or more values as appropriate.
.El
.El
.Bl -tag -width "set statistics"
.It Cm set statistics
Enables or disables extended statistics. Statistics include per-process-name call statistics and per-API call and latencies.  This setting is persistent across reboots and should not normally be run as it is memory intensive.
.Bl -tag -compact
.It Cm on
Enables statistics tracking
.It Cm off
Disables statistics tracking
.El
.El
.Sh SEE ALSO 
.Xr opendirectoryd 8