.\" Man page generated from reStructuredText. . .TH "DYLD_USAGE" "1" "2020-04-13" "" "dyld" .SH NAME dyld_usage \- report dynamic linker activity in real-time . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .SH SYNOPSIS .sp \fBdyld_usage\fP \fB[\-e] [\-f mode] [\-j] [\-h] [\-t seconds] [\-R rawfile [\-S start_time] [\-E end_time]] [pid | cmd [pid | cmd] ...]\fP .SH DESCRIPTION .sp The \fBdyld_usage\fP utility presents an ongoing display of information pertaining to dynamic linker activity within one or more processes. It requires root privileges due to the kernel tracing facility it uses to operate. By default \fBdyld_usage\fP monitors \fIdyld\fP activity in all processes except the running \fIdyld_usage\fP process, \fITerminal\fP, \fItelnetd\fP, \fIsshd\fP, \fIrlogind\fP, \fItcsh\fP, \fIcsh\fP, and \fIsh\fP\&. These defaults can be overridden such that output is limited to include or exclude a list of processes specified on the command line. Processes may be specified either by file name or by process id. .sp The output of \fBdyld_usage\fP is formatted according to the size of your window. A narrow window will display fewer columns of data. Use a wide window for maximum data display. .SH OPTIONS .sp \fBdyld_usage\fP supports the following options: .INDENT 0.0 .TP .B \-e Exclude the specified list of pids and commands from the sample, and exclude \fBdyld_usage\fP by default. .INDENT 7.0 .TP .B \-j .UNINDENT .sp Display output in JSON format. .UNINDENT .INDENT 0.0 .TP .B \-h Display usage information and exit. .UNINDENT .INDENT 0.0 .TP .B \-R Specify a raw trace file to process. .UNINDENT .INDENT 0.0 .TP .B \-t Specify timeout in seconds (for use in automated tools). .UNINDENT .SH DISPLAY .sp The data columns displayed are as follows: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .B TIMESTAMP Time of day when call occurred. .TP .B OPERATION The \fIdyld\fP operation triggered by the process. Typically these operations are triggered by process launch or via a \fBdlopen\fP or \fBdlsym\fP system call. System call entries include both the parameters to the system call and the system call\(aqs return code (e.g., 0 on success). .TP .B TIME INTERVAL The elapsed time spent in the dynamic linker operation or system call. .TP .B PROCESS NAME The process that generated the dynamic linker activity. If space allows, the thread id will be appended to the process name (i.e., Mail.nnn). .UNINDENT .UNINDENT .UNINDENT .SH SAMPLE USAGE .INDENT 0.0 .INDENT 3.5 \fBsudo dyld_usage Mail\fP .sp \fBdyld_usage\fP will display dynamic link operations for all instances of processes named Mail. .UNINDENT .UNINDENT .SH SEE ALSO .sp \fBdyld(1)\fP, \fBfs_usage(1)\fP .SH AUTHOR Apple, Inc. .SH COPYRIGHT 2000-2020, Apple, Inc. .\" Generated by docutils manpage writer. .