forked from Lainports/freebsd-ports
108 lines
2.7 KiB
Groff
108 lines
2.7 KiB
Groff
.\"
|
|
.\" Copyleft by nagae@an.ip.titech.ac.jp and mac@research.co.jp
|
|
.\" du2ps.man
|
|
.TH du2ps 1 "Mar 2, 1994"
|
|
.SH NAME
|
|
du2ps \- filter for converting output of du to PostScript file
|
|
.SH SYNOPSIS
|
|
.B du2ps
|
|
[
|
|
.I options
|
|
]
|
|
<
|
|
.I du_out_file
|
|
>
|
|
.I ps_file
|
|
.SH DESCRIPTION
|
|
The
|
|
.B du2ps
|
|
reads output of
|
|
.BR du (1),
|
|
then generate a figure of hierarchical structure and utilization of
|
|
directory as one page PostScript file.
|
|
.PP
|
|
Each directory is illustrated as rectangle in utilization order with
|
|
height corresponding to its utilization, and sub directories are placed
|
|
branched from left to right recursively.
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-land
|
|
Layout in landscape.
|
|
Default is in portrait.
|
|
.TP
|
|
.B \-sa
|
|
Place directories in alphabetical order.
|
|
Default is in utilization order.
|
|
.TP
|
|
.B \-b4
|
|
.TP
|
|
.B \-b5
|
|
.TP
|
|
.B \-us
|
|
Switch page size to B4, B5, or US letter. Default is A4.
|
|
.TP
|
|
.BI \-ff " name"
|
|
Specify font name for text. Default is Times-Roman.
|
|
.TP
|
|
.BI \-fs " size"
|
|
Specify font size. Default is 8.0 [pt].
|
|
.TP
|
|
.BI \-ms " size"
|
|
Specify margin around page. Default is 50.0 [pt].
|
|
.TP
|
|
.BI \-lw " size"
|
|
Line width for drawing rectangle area. Default is 0.5 [pt].
|
|
.TP
|
|
.BI \-ncols " num"
|
|
Specify number of rectangle columns (maximum directory depth).
|
|
Default is 7 for portrait and 10 for landscape.
|
|
.TP
|
|
.BI \-eps " width height"
|
|
Output in EPS format.
|
|
.I Width
|
|
and
|
|
.I height
|
|
are the width and height of BoundingBox.
|
|
.SH EXAMPLES
|
|
.B " du | du2ps | lpr
|
|
.IP
|
|
The most left directory name becomes ``.'', and ``The number of disk
|
|
blocks used at .'' will be displayed at the upper left corner.
|
|
.
|
|
.B " du /home/taro/work | du2ps | lpr
|
|
.PP
|
|
.B " du ~taro/work | du2ps | lpr
|
|
.IP
|
|
The most left directory name becomes ``work'', and
|
|
``The number of disk blocks used at /home/taro/work''
|
|
will be displayed at the upper left corner.
|
|
.PP
|
|
.B " du ../../ps | du2ps -us -fs 16 > tmp.ps; gs tmp.ps
|
|
.IP
|
|
The most left directory name becomes ``ps'', and
|
|
``The number of disk blocks used at ../../ps''
|
|
will be displayed at the upper left corner.
|
|
The ``-us'' option makes entire page to fit paper, because default size of
|
|
GhostScript is US letter.
|
|
.PP
|
|
.B " du ~taro/work ~taro/bin | du2ps -eps 200 300 > fig1.eps
|
|
.IP
|
|
The most left directory name becomes ``taro'', and
|
|
``The number of disk blocks used at /home/taro''
|
|
will be display at the upper left corner.
|
|
Output will be commented with ``%%BoundingBox: 0 0 200 300''.
|
|
.PP
|
|
.B " du work bin | du2ps -eps 100 100 -fs 4 > fig2.eps
|
|
.IP
|
|
The most left directory name becomes ``..'', and
|
|
``The number of disk blocks used at''
|
|
will be display at the upper left corner.
|
|
.SH SEE ALSO
|
|
.BR du (1),
|
|
.BR xdu (1)
|
|
.SH AUTHORS
|
|
Takanori Nagae <nagae@an.ip.titech.ac.jp> and
|
|
Shigeru Makino <mac@research.co.jp>
|
|
.PP
|
|
The du2ps is based on xdu.
|
|
The author of xdu is Phillip C. Dykstra <phil@BRL.MIL>.
|