From 5fd83771641d15c418f747bd343ba6738d3875f7 Mon Sep 17 00:00:00 2001 From: Cameron Katri Date: Sun, 9 May 2021 14:20:58 -0400 Subject: Import macOS userland adv_cmds-176 basic_cmds-55 bootstrap_cmds-116.100.1 developer_cmds-66 diskdev_cmds-667.40.1 doc_cmds-53.60.1 file_cmds-321.40.3 mail_cmds-35 misc_cmds-34 network_cmds-606.40.1 patch_cmds-17 remote_cmds-63 shell_cmds-216.60.1 system_cmds-880.60.2 text_cmds-106 --- system_cmds/zlog.tproj/zlog.1 | 56 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 system_cmds/zlog.tproj/zlog.1 (limited to 'system_cmds/zlog.tproj/zlog.1') diff --git a/system_cmds/zlog.tproj/zlog.1 b/system_cmds/zlog.tproj/zlog.1 new file mode 100644 index 0000000..141caa9 --- /dev/null +++ b/system_cmds/zlog.tproj/zlog.1 @@ -0,0 +1,56 @@ +.\" Copyright (c) 2018, Apple Inc. All rights reserved. +.\" +.Dd February 21, 2018 +.Dt ZLOG 1 +.Os "Mac OS X" +.Sh NAME +.Nm zlog +.Nd show allocation backtraces for kernel zones +.Sh SYNOPSIS +.Nm +.Op Fl t +.Op Fl z Ar name Op Fl n Ar num | Fl l +.Op Fl h +.Sh DESCRIPTION +.Nm +displays allocation (and free, if used in corruption tracking mode with +the boot-arg "-zc") backtraces for zones that have zone logging enabled. +Zone logging can be turned on by using the boot-arg "zlog=", +where 'N' can range from 1 to 10, and 'name' is the name of the zone to +be tracked. +.Pp +.Nm +interprets the following options: +.Pp +.Bl -tag -width "disable -" +.\" -t +.It Fl t +(Default) list all the zones that have logging enabled +.\" -z +.It Fl z Ar name +show all allocation backtraces for zone +.Ar name +.\" -n +.It Fl n Ar num +Can be used in combination with the +.Fl z +option to show the top +.Ar num +backtraces with the most active references in the zone +.Ar name +.\" -l +.It Fl l +Can be used in combination with the +.Fl z +option to show the backtrace most likely contributing to a leak in the zone +.Ar name +(prints the backtrace with the most active references) +.\" -h +.It Fl h +show the help text +.El +.Sh DIAGNOSTICS +.Ex -std +.Sh SEE ALSO +.Xr zprint 1 , +.Xr ioclasscount 1 -- cgit v1.2.3-56-ge451