system_cmds/zprint.tproj/zprint.1

   1 .\" Copyright (c) 2016, Apple Inc.  All rights reserved.
   2 .\"
   3 .Dd 2 May 2016
   4 .Dt ZPRINT 1
   5 .Os "Mac OS X"
   6 .Sh NAME
   7 .Nm zprint
   8 .Nd show information about kernel zones
   9 .Sh SYNOPSIS
  10 .Nm
  11 .Op Fl cdhlLstw
  12 .Op Ar name
  13 .Sh DESCRIPTION
  14 .Nm
  15 displays data about Mach zones (allocation buckets).  By default,
  16 .Nm
  17 will print out information about all Mach zones.  If the optional
  18 .Ar name
  19 is specified,
  20 .Nm
  21 will print information about each zone for which
  22 .Ar name
  23 is a substring of the zone's name.
  24 .Pp
  25 .Nm
  26 interprets the following options:
  27 .Pp
  28 .Bl -tag -width "disable -"
  29 .\" -c
  30 .It Fl c
  31 (Default)
  32 .Nm
  33 prints zone info in columns. Long zone names are truncated with
  34 .Ql \&$ ,
  35 and spaces are replaced with
  36 .Ql \&. ,
  37 to allow for sorting by column.  Pageable and collectible zones are shown with
  38 .Ql \&P
  39 and
  40 .Ql \&C
  41 on the far right, respectively.  Zones with preposterously large maximum sizes
  42 are shown with
  43 .Ql ----
  44 in the max size and max num elts fields.
  45 .\" -d
  46 .It Fl d
  47 Display deltas over time, showing any zones that have achieved a new maximum
  48 current allocation size during the interval.  If the total allocation sizes are
  49 being displayed for the zones in question, it will also display the deltas if
  50 the total allocations have doubled.
  51 .\" -h
  52 .It Fl h
  53 (Default) Shows headings for the columns printed with the
  54 .Fl c
  55 option.  It may be useful to override this option when sorting by column.
  56 .\" -l
  57 .It Fl l
  58 (Default) Show all wired memory information after the zone information.
  59 .\" -L
  60 .It Fl L
  61 Do not show all wired memory information after the zone information.
  62 .\" -s
  63 .It Fl s
  64 .Nm
  65 sorts the zones, showing the zone wasting the most memory first.
  66 .\" -t
  67 .It Fl t
  68 For each zone,
  69 .Nm
  70 calculates the total size of allocations from the zone over the life of the
  71 zone.
  72 .\" -w
  73 .It Fl w
  74 For each zone,
  75 .Nm
  76 calculates how much space is allocated but not currently in use, the space
  77 wasted by the zone.
  78 .El
  79 .Pp
  80 Any option (including default options) can be overridden by specifying the
  81 option in upper-case; for example,
  82 .Fl C
  83 overrides the default option
  84 .Fl c .
  85 .Sh DIAGNOSTICS
  86 .Ex -std
  87 .Sh SEE ALSO
  88 .Xr ioclasscount 1 ,
  89 .Xr lsmp 1 ,
  90 .Xr lskq 1 ,