Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

sysdiagnose(1) [osx man page]

sysdiagnose(1)						    BSD General Commands Manual 					    sysdiagnose(1)

NAME
sysdiagnose -- gathers system-wide diagnostic information helpful in investigating system performance issues. SYNOPSIS
sysdiagnose -h sysdiagnose [-f results_directory] [-t] [-q] [-b] [process_name | pid] DESCRIPTION
sysdiagnose tool gathers system diagnostic information helpful in investigating system performance issues. A great deal of information is harvested, spanning system state and configuration. sysdiagnose needs to be run as root. sysdiagnose can be triggered upon pressing a spe- cial 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 malloc-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 collected o If a specific process is supplied as an argument: data about the virtual memory regions allocated in the process OPTIONS
-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 completion. process_name | pid If a single process appears to be slowing down the system, passing in the process name or ID as the argument gathers additional process-specific diagnostic data. THOROUGH MODE
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 command-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" Note: Gathering the kernel trace can increase the size of sysdiagnose output by hundreds of MB as well as increase the time for sysdiagnose to com- plete. EXIT STATUS
sysdiagnose 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. Darwin June 2, 2019 Darwin

Check Out this Related Man Page

TMDIAGNOSE(8)						    BSD System Manager's Manual 					     TMDIAGNOSE(8)

NAME
tmdiagnose -- gather information to aid in diagnosing Time Machine issues SYNOPSIS
tmdiagnose -h tmdiagnose [-d seconds] [-f path] [-m] [-r] DESCRIPTION
The tmdiagnose tool gathers system and backup information in order to assist Apple when investigating issues related to Time Machine. A great deal of information is harvested, spanning system state, system and backup configuration, and snapshot details. What tmdiagnose Collects: o A spindump of the system o Several seconds of fs_usage ouput o Several seconds of top output o Individual samples of backupd, mtmd, mtmfs, and Finder o Power Management state and logs o IOKit registry information o A netstat inspection o A list of all open files on the system o All system logs o All kernel logs o All install logs o All fsck_hfs logs o All WiFi logs o Disk Utility logs for all local users o The system migration log o All spin and crash reports for the following processes: backupd mtmd mtmfs mds diskimages-helper Locum newfs_hfs NetAuthSysAgent o Recent spin and crash reports for the following processes, for all local users: Finder Locum System Preferences SystemUIServer iPhoto Mail MailTimeMachineHelper Address Book o Basic information about reachable AirPort and Time Capsule devices o The FindSystemFiles cache o Information about disks and mounted network shares o Information about attached disk images o A System Profiler report o A list of software that has been installed via the darwinup tool o Time Machine preferences, caches, and configuration information o Comprehensive information about Time Machine backups and snapshots The high-level backup structure for the current machine directory is recreated inside the diagnostic bundle, including the capture of various Time Machine log files contained within snapshots. Items in this "skeleton" structure have on them the extended attributes of the originals. Recreations of local snapshots are also captured in the same manner. The tmdiagnose tool will run the Spotlight diagnostic tool mddiagnose automatically, if it is available. What tmdiagnose Doesn't Collect: o No user files are harvested from within backups o No authentication credentials are harvested from the system o No authentication credentials are harvested for reachable AirPort and Time Capsule devices OPTIONS
-h Print full usage. -d sec Delay the start of the diagnostic by sec seconds. The system alert sound will play two times when the diagnostic begins. -f path Write the diagnostic to the specified path. -m Gather memory diagnostics for backupd, mtmd, mtmfs, and Finder. -r Do not reveal the diagnostic in Finder when finished. EXIT STATUS
tmdiagnose 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 6 September 2011 Mac OS X
Man Page