manpagez: man pages & more
man sysdiagnose(1)
Home | html | info | man
sysdiagnose(1)            BSD General Commands Manual           sysdiagnose(1)


     sysdiagnose -- gathers system-wide diagnostic information helpful in
     investigating system performance issues.


     sysdiagnose -h
     sysdiagnose [-f results_directory] [-t] [-q] [-b] [process_name | pid]


     sysdiagnose tool gathers system diagnostic information helpful in inves-
     tigating system performance issues. A great deal of information is har-
     vested, spanning system state and configuration.  sysdiagnose needs to be
     run as root.  sysdiagnose can be triggered upon pressing a special key
     chord; this is currently Control-Option-Command-Shift-Period.

   What sysdiagnose Collects:
           o   A spindump of the system
           o   Several seconds of fs_usage ouput
           o   Several seconds of top output
           o   Data about kernel zones
           o   Status of loaded kernel extensions
           o   Resident memory usage of user processes
           o   All system logs, kernel logs, opendirectory log, windowserver
               log, and log of power management events
           o   A System Profiler report
           o   All spin and crash reports
           o   Disk usage information
           o   I/O Kit registry information
           o   Network status
           o   If a specific process is supplied as an argument: list of mal-
               loc-allocated buffers in the process's heap is collected
           o   If a specific process is supplied as an argument: data about
               unreferenced malloc buffers in the process's memory is col-
           o   If a specific process is supplied as an argument: data about
               the virtual memory regions allocated in the process


     -h       Print full usage.

     -f results_directory
              Specify the directory where the results will be stored. The
              default results directory is /var/tmp.

     -q       Skips calling footprint.

     -t       Enable "Thorough Mode". See below.

     -b       Do not show the resulting archive in a Finder window upon com-

     process_name | pid
              If a single process appears to be slowing down the system, pass-
              ing in the process name or ID as the argument gathers additional
              process-specific diagnostic data.


     sysdiagnose can be run in a "Thorough Mode" in which standard data is
     gathered as well as a kernel trace. Enabling "Thorough Mode" for the com-
     mand-line sysdiagnose and key-chord sysdiagnose are independent and are
     performed as follows:

     For "Thorough Mode" in the command-line sysdiagnose use the "-t" flag.

     To enable "Thorough Mode" for special key-chord launches of sysdiagnose
     execute "touch /var/tmp/.thoroughsysdiagnose"

     To disable "Thorough Mode" for special key-chord launches of sysdiagnose
     execute "rm /var/tmp/.thoroughsysdiagnose"

     Gathering the kernel trace can increase the size of sysdiagnose output by
     hundreds of MB as well as increase the time for sysdiagnose to complete.


     sysdiagnose exits with status 0 if there were no internal errors encoun-
     tered during the diagnostic, or >0 when an error unrelated to external
     state occurs or unusable input is provided by the user.

Darwin                         October 13, 2013                         Darwin

Mac OS X 10.9 - Generated Sun Oct 13 13:08:00 CDT 2013
© 2000-2023
Individual documents may contain additional copyright information.