source: trunk/base/doc/port-space.1.txt @ 134980

Last change on this file since 134980 was 134974, checked in by cal@…, 4 years ago

base: doc/port-space.1: whitespace only, remove double space

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Rev URL
File size: 2.5 KB
Line 
1// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
2port-space(1)
3=============
4$Id: port-space.1.txt 134974 2015-04-12 19:12:49Z cal@macports.org $
5
6NAME
7----
8port-space - Show the disk usage of the given ports
9
10SYNOPSIS
11--------
12[cmdsynopsis]
13*port* [*-D* 'portdir'] *space* [--units 'unit'] ['total']
14    [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
15
16DESCRIPTION
17-----------
18*port space* lists the amount of disk space the port(s) given on the command
19line occupy on disk. Note that the space reported is for the files installed by
20a port, but not the image of the port's files MacPorts keeps internally. See the
21*PORT IMAGES* section for more information on how images work. Consequently,
22*port space* will only work on active ports.
23
24By default, *port space* will print a line with the size in an appropriate unit
25followed by the name of a port for each port given on the command line (or
26expanded from a pseudo-port expression given; see man:port[1] for more info on
27pseudo-port expressions). The last line of output will contain a total.
28
29If you are only interested in the total of all ports (e.g. if you want to get
30the total amount of space used by your installed ports) use the *--total* flag.
31If you want to sort the output by file size, you can pipe the results of *port
32space* to *sort -n*. Since *port space* defauts to using a suitable unit, you
33should specify a unit to allow for meaningful numeric sorting, e.g. *port space
34--units KiB* to get all output in KiB.
35
36OPTIONS
37-------
38*--total**::
39    Only print the total amount of space used by all given ports.
40
41*--units 'unit'*::
42    Choose the unit in which the size is given. You should specify this if you
43    intend to sort the output. Valid values for 'unit' are
44
45    *B*:::
46        List sizes in bytes.
47
48    *K*, *Ki*, *KiB*:::
49        List sizes in KiB, i.e., 1024 bytes.
50
51    *Mi*, *MiB*:::
52        List sizes in MiB, i.e., 1024 * 1024 bytes.
53
54    *Gi*, *GiB*:::
55        List sizes in GiB, i.e., 1024 * 1024 * 1024 bytes.
56
57    *k*, *kB*:::
58        List sizes in kB, i.e., 1000 bytes.
59
60    *M*, *MB*:::
61        List sizes in MB, i.e., 1000 * 1000 bytes.
62
63    *G*, *GB*:::
64        List sizes in GB, i.e., 1000 * 1000 * 1000 bytes.
65
66
67include::global-flags.txt[]
68
69include::archives.txt[]
70
71EXAMPLES
72--------
73To find the 10 largest ports in your MacPorts installation, you can use the
74following command:
75----
76$> port space --units MiB active | sort -rn | head -n10
77----
78
79SEE ALSO
80--------
81man:port[1], man:port-archive[1], man:sort[1]
82
83AUTHORS
84-------
85 (C) 2015 The MacPorts Project
86 Clemens Lang <cal@macports.org>
Note: See TracBrowser for help on using the repository browser.