MDDIAGNOSE(8) BSD System Manager's Manual MDDIAGNOSE(8)
NAME
mddiagnose -- gather information to aid in diagnosing Spotlight issues
SYNOPSIS
mddiagnose -h
mddiagnose [-f path] [-e path] [-p path] [-n]
DESCRIPTION
The mddiagnose tool gathers system and Spotlight information in order to assist Apple when investigating issues related to Spotlight. A great
deal of information is harvested, spanning system state, system and Spotlight details.
What mddiagnose Collects:
o A spindump of the system
o Several seconds of top output
o Individual samples of mds and mdworker
o Paths for all files used by Spotlight to contain its database on every volume
o All system logs
o All spin and crash reports for the following processes:
mds
mdworker
o Recent spin and crash reports for the following processes, for all local users:
mds
mdworker
o The query text and result quality statistics for recent Spotlight searches. The actual results of the searches are not gathered
o General information about disks and mounted network shares
o The path of the last file indexed by each mdworker process on behalf of Spotlight. The path of the last file which resulted in a
crash of an mdworker process. In each case, only the path is gathered, not the contents of the file
o Spotlight configuration for each volume currently mounted on your system. This includes the path and size of all files used inter-
nally by Spotlight as well as a listing of paths that are user excluded from indexing
o Comprehensive information about internal state of Spotlight
What mddiagnose Doesn't Collect:
o No user data is harvested from any volume
o No paths or files found by any search are returned
o No database storage or user files are returned
o No authentication credentials are harvested from the system
OPTIONS
-h Print full usage.
-m Gather a subset of the normal report.
-f path Write the diagnostic to the specified path.
-p path Gather Spotlight permissions and filter information. Run as owner of that file.
EXIT STATUS
mddiagnose exits with status 0 if there were no internal errors encountered during the diagnostic, or >0 when an error unrelated to external
state occurs or unusable input is provided by the user.
Mac OS X 15 March 2011 Mac OS X