File: README.md

package info (click to toggle)
di 6.2.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 856 kB
  • sloc: ansic: 9,271; sh: 5,090; perl: 1,749; awk: 463; makefile: 371
file content (194 lines) | stat: -rw-r--r-- 5,142 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
di - disk information utility

[SourceForge Project Page](https://sourceforge.net/projects/diskinfo-di/)
[Website](https://diskinfo-di.sourceforge.io/)
[Change Log](https://github.com/bll123/ballroomdj-4/wiki/Change%20Log/)

### CONTENTS

-  Important Notes: Version 5/6
-  Description
-  Documentation
-  Installation
-  Requirements
-  Porting Help
-  Acknowledgements
-  Copyright

### IMPORTANT NOTES: VERSION 5/6  (2025-3-10)

Version 5's code base has changed.  The build process has changed and
optionally uses cmake (3.18+). The display processing is entirely new code.
Version 6 had an ABI change to fix a crash.

Version 5/6 installs a shared library that can be used to get the disk
space or percentages.

### DESCRIPTION

'di' is a disk information utility, displaying everything
(and more) that your 'df' command does. It features the
ability to display your disk usage in whatever format you
prefer. It is designed to be highly portable. Great for
heterogenous networks.

### DOCUMENTATION

[wiki](https://sourceforge.net/p/diskinfo-di/wiki/Home/)
<br/>
[Change Log](https://sourceforge.net/p/diskinfo-di/wiki/ChangeLog)
<br/>
[Test Results](https://sourceforge.net/p/diskinfo-di/wiki/Testing)

### INSTALLATION

To build:

make -e PREFIX=$HOME/local
make -e PREFIX=$HOME/local test
make -e PREFIX=$HOME/local install

The build will use cmake if it is available and recent enough (3.18+),
otherwise the mkconfig configuration tool will be used.

To use cmake in a stand-alone fashion (as of version 5.0.4):

    cmake -DCMAKE_INSTALL_PREFIX=$HOME/local -S . -B build
    cmake --build build
    cmake --build build --target test
    cmake --install build

To select one of the multi-precision libraries when using cmake:

    DI_USE_MATH=DI_MPDECIMAL \
        cmake -DCMAKE_INSTALL_PREFIX=$HOME/local -S . -B build

Where DI_USE_MATH can be set to one of DI_GMP, DI_MPDECIMAL,
DI_TOMMATH or DI_INTERNAL.

If no multi-precision library is specified and the GMP, mpdecimal
(preferred) or libtommath library is found, it will be used, otherwise
the numerics will be handled using standard C data types (long double,
double, etc.).

To turn off the use of the multi-precision libraries;

    make -e PREFIX=$HOME/local DI_USE_MATH=DI_INTERNAL

Long doubles are quite capable, there's nothing wrong with
building it this way (as of 2025).

To force GMP:

    make -e PREFIX=$HOME/local DI_USE_MATH=DI_GMP

To force MPDecimal:

    make -e PREFIX=$HOME/local DI_USE_MATH=DI_MPDECIMAL

To force libtommath:

    make -e PREFIX=$HOME/local DI_USE_MATH=DI_TOMMATH

To force the use of mkconfig:

    make -e PREFIX=$HOME/local mkc-all
    make -e PREFIX=$HOME/local mkc-install

### REQUIREMENTS

- cmake build
    - make
    - cmake (3.18+)
    - pkg-config
    - msgfmt
    - C compiler
    - sed grep tr test /bin/sh
    - awk (gawk/nawk/awk)
- mkconfig build
    - make
    - pkg-config
    - msgfmt
    - C compiler
    - bourne/ksh/bash shell
    - awk (gawk/nawk/awk)
    - cat chmod ln mkdir mv rm sed test expr grep sort

- Required Libraries:
    - Linux: tirpc (nfs quotas)
    - MP Math (optional): gmp or libmpdec or libtommath

### BUG REPORTS

I need to know what operating system and what version of
operating system you are on.  Also which compiler, and the version
of the compiler.

For build issues, capture the output from `make`, and the files
listed below.

For runtime issues, I want to see the output from 'di -A -a -X 5'
and the output from your standard df command (as verbose as possible),

Files to include in your report:

- cmake:
    - build/config.h
    - build/CMakeOutput.log
    - build/CMakeError.log
    - build/CMakeFiles/CMakeConfigureLog.yaml
- mkconfig:
    - config.h
    - di.env
    - di.reqlibs
    - mkc_files/mkconfig.log
    - mkc_files/mkconfig_env.log
    - mkc_files/mkc_compile.log

Open a [ticket at SourceForge](https://sourceforge.net/p/diskinfo-di/tickets/)
Or e-mail : brad.lanam.di / gmail.com

### PORTING HELP

I use my own set of virtual machines, the gcc compile farm, and
polarhome (which is now limited, and will probably die at some
point).

If you have a computer on the internet with a less common or older
operating system, I could use access for portability testing.

I need access to HP-UX.

### ACKNOWLEDGEMENTS

And for their comments/source/manual pages and/or bug fixes, thanks!

    J.J.Bailey
    Karl Vogel [pyramid]
    Bryan Costales
    Mark Neale
    Pat Myrto [sunOS filesystem type stuff]
    Henri Karrenbeld [sgi]
    Peter Bray
    George M. Sipe [manual page]
    Jeffrey Mogul [ultrix, osf/1, manual page, new format options]
    Th. Bullinger [help usage]
    Seth Theriault [next, tru64]
    Stephen J. Walick [SCO]
    Gerald Rinske [sgi]
    Mike Grupenhoff [linux]
    R.K.Lloyd [hpux]
    William Gibbs [xenix]
    Randy Thompson [sequent]
    Erik O'Shaughnessy [aix]
    Bill Davidsen [linux, SCO, etc., new format options]
    Fred Smith [coherent 4.2.05]
    Andrey Blochintsev [bsdi]
    Brian Ginsbach [netbsd, irix, unicos]

    et. al.

### COPYRIGHT

Copyright 1994-2025 Brad Lanam, Pleasant Hill, CA, USA
brad.lanam.di / gmail.com