| | 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 , |
projects / apple / system_cmds.git / blame_incremental