Rewrite to static site
With a complete reorganisation of the directory structure and most of the content converted to pandoc-flavoured markdown. Some TODO's left before this can go live: - Main page - Atom feeds - Bug tracker
This commit is contained in:
Yorhel
parent
5c85a7d32f
commit
6242b2ee9c
291 changed files with 4346 additions and 6141 deletions
102
dat/ncdu
102
dat/ncdu
|
|
@ -1,102 +0,0 @@
|
|||
=pod
|
||||
|
||||
Ncdu is a disk usage analyzer with an ncurses interface. It is designed to find
|
||||
space hogs on a remote server where you don't have an entire graphical setup
|
||||
available, but it is a useful tool even on regular desktop systems. Ncdu aims
|
||||
to be fast, simple and easy to use, and should be able to run in any minimal
|
||||
POSIX-like environment with ncurses installed.
|
||||
|
||||
|
||||
=head2 Download
|
||||
|
||||
=over
|
||||
|
||||
=item Latest version
|
||||
|
||||
1.14 ([dllink ncdu-1.14.tar.gz download]
|
||||
- L<changes|https://dev.yorhel.nl/ncdu/changes>)
|
||||
|
||||
I also have convenient static binaries for Linux
|
||||
L<i486|https://dev.yorhel.nl/download/ncdu-linux-i486-1.14.tar.gz> and
|
||||
L<ARM|https://dev.yorhel.nl/download/ncdu-linux-arm-1.14.tar.gz>. Download,
|
||||
extract and run; no compilation or installation necessary (uses
|
||||
L<musl|http://www.musl-libc.org/>).
|
||||
|
||||
=item Development version
|
||||
|
||||
The most recent code is available on a git repository and can be cloned with
|
||||
C<git clone git://g.blicky.net/ncdu.git/>. The repository is also available for
|
||||
L<online browsing|http://g.blicky.net/ncdu.git/>.
|
||||
|
||||
=back
|
||||
|
||||
Ncdu is entirely written in C and available under a liberal MIT license.
|
||||
|
||||
|
||||
|
||||
=head2 Packages and ports
|
||||
|
||||
Ncdu has been packaged for quite a few systems, here's a list of the ones I am aware of:
|
||||
|
||||
L<AIX|http://www.perzl.org/aix/index.php?n=Main.Ncdu> -
|
||||
L<Alpine Linux|http://pkgs.alpinelinux.org/packages?name=ncdu> -
|
||||
L<ALT Linux|http://sisyphus.ru/en/srpm/ncdu> -
|
||||
L<Arch Linux|https://www.archlinux.org/packages/?q=ncdu> -
|
||||
L<CRUX|https://crux.nu/portdb/?q=ncdu&a=search> -
|
||||
L<Cygwin|https://cygwin.com/cgi-bin2/package-grep.cgi?grep=ncdu> -
|
||||
L<Debian|http://packages.debian.org/ncdu> -
|
||||
L<Fedora|https://apps.fedoraproject.org/packages/ncdu> -
|
||||
L<FreeBSD|https://www.freebsd.org/cgi/ports.cgi?query=ncdu&stype=all> -
|
||||
L<Frugalware|http://frugalware.org/packages/?op=pkg&srch=ncdu&arch=all&ver=all> -
|
||||
L<Gentoo|https://packages.gentoo.org/packages/sys-fs/ncdu> -
|
||||
L<GNU Guix|https://www.gnu.org/software/guix/package-list.html> -
|
||||
L<OpenBSD|http://cvsweb.openbsd.org/cgi-bin/cvsweb/ports/sysutils/ncdu/> -
|
||||
Mac OS X (L<Fink|http://pdb.finkproject.org/pdb/package.php/ncdu> - L<Homebrew|https://formulae.brew.sh/formula/ncdu> - L<MacPorts|http://www.macports.org/ports.php?by=name&substr=ncdu>) -
|
||||
L<Puppy Linux|http://www.murga-linux.com/puppy/viewtopic.php?t=35024> -
|
||||
L<Solaris|http://www.opencsw.org/packages/ncdu> -
|
||||
L<Slackware|http://slackbuilds.org/repository/14.2/system/ncdu/> -
|
||||
L<Slax Linux|http://www.slax.org/modules.php?detail=ncdu> -
|
||||
L<Ubuntu|http://packages.ubuntu.com/search?searchon=sourcenames&keywords=ncdu> -
|
||||
L<Void Linux|https://voidlinux.org/packages/>
|
||||
|
||||
Packages for RHEL and (open)SUSE can be found on the
|
||||
L<Open Build Service|https://software.opensuse.org//download.html?project=utilities&package=ncdu>.
|
||||
|
||||
Packages for NetBSD, DragonFlyBSD, MirBSD and others can be found on
|
||||
L<pkgsrc|http://pkgsrc.se/sysutils/ncdu>.
|
||||
|
||||
A port to z/OS is available L<here|https://dovetail.com/community/ncdu.html>.
|
||||
|
||||
|
||||
|
||||
=head2 Similar projects
|
||||
|
||||
=over
|
||||
|
||||
=item L<Duc|http://duc.zevv.nl/> - Multiple user interfaces.
|
||||
|
||||
=item L<gt5|http://gt5.sourceforge.net/> - Quite similar to ncdu, but a different approach.
|
||||
|
||||
=item L<tdu|http://webonastick.com/tdu/> - Another small ncurses-based disk usage visualization utility.
|
||||
|
||||
=item L<TreeSize|http://treesize.sourceforge.net/> - GTK, using a treeview.
|
||||
|
||||
=item L<Baobab|http://www.marzocca.net/linux/baobab.html> - GTK, using pie-charts, a treeview and a treemap. Comes with GNOME.
|
||||
|
||||
=item L<GdMap|http://gdmap.sourceforge.net/> - GTK, with a treemap display.
|
||||
|
||||
=item L<Filelight|http://www.methylblue.com/filelight/> - KDE, using pie-charts.
|
||||
|
||||
=item L<KDirStat|http://kdirstat.sourceforge.net/> - KDE, with a treemap display.
|
||||
|
||||
=item L<QDiskUsage|http://qt-apps.org/content/show.php/QDiskUsage?content=107012> - Qt, using pie-charts.
|
||||
|
||||
=item L<xdiskusage|http://xdiskusage.sourceforge.net/> - FLTK, with a treemap display.
|
||||
|
||||
=item L<fsv|http://fsv.sourceforge.net/> - 3D visualization.
|
||||
|
||||
=item L<Philesight|http://zevv.nl/play/code/philesight/> - Web-based clone of Filelight.
|
||||
|
||||
=back
|
||||
|
||||
|
||||
220
dat/ncdu/jsonfmt.md
Normal file
220
dat/ncdu/jsonfmt.md
Normal file
|
|
@ -0,0 +1,220 @@
|
|||
% Ncdu Export File Format
|
||||
|
||||
This document describes the file format that ncdu 1.9 and later use for the
|
||||
export/import feature (the `-o` and `-f` options). Check the [ncdu
|
||||
manual](/ncdu/man) for a description on how to use that feature.
|
||||
|
||||
## Top-level object
|
||||
|
||||
Ncdu uses [JSON](http://json.org/) notation as its data format. The top-level
|
||||
object is an array:
|
||||
|
||||
[
|
||||
<majorver>,
|
||||
<minorver>,
|
||||
<metadata>,
|
||||
<directory>
|
||||
]
|
||||
|
||||
## Versioning
|
||||
|
||||
The `<majorver>` and `<minorver>` elements indicate the version of
|
||||
the file format. These are numbers with accepted values in the range of `0
|
||||
<= version <= 10000`. Major version must be `1`. Minor version is `0` for
|
||||
ncdu 1.9 till 1.12, and `1` since ncdu 1.13 for the addition of the extended
|
||||
mode. The major version should increase if backwards-incompatible changes are
|
||||
made (preferably never), the minor version can be increased to indicate
|
||||
additions to the existing format.
|
||||
|
||||
## Metadata
|
||||
|
||||
The `<metadata>` element is a JSON object holding whatever (short)
|
||||
metadata you'd want. This block is currently (1.9-1.13) ignored by ncdu when
|
||||
importing, but it writes out the following keys when exporting:
|
||||
|
||||
progname
|
||||
: String, name of the program that generated the file, i.e. `"ncdu"`.
|
||||
|
||||
progver
|
||||
: String, version of the program that generated the file, e.g. `"1.10"`.
|
||||
|
||||
timestamp
|
||||
: Number, UNIX timestamp as returned by the POSIX `time()` function at the time
|
||||
the file was generated. Note that this may not necessarily be equivant to when
|
||||
the directory has been scanned.
|
||||
|
||||
## Directory Info
|
||||
|
||||
A `<directory>` is represented with a JSON array:
|
||||
|
||||
[
|
||||
<infoblock>,
|
||||
<directory>, <directory>, <infoblock>, ...
|
||||
]
|
||||
|
||||
That is, the first element of the array must be an `<infoblock>`. If the
|
||||
directory is empty, that will be its only element. If it isn't, its
|
||||
subdirectories and files are listed in the remaining elements. Each
|
||||
subdirectory is represented as a `<directory>` array again, and each file
|
||||
is represented as just an `<infoblock>` object.
|
||||
|
||||
## The Info Object
|
||||
|
||||
An `<infoblock>` is a JSON object holding information about a file or
|
||||
directory. The following fields are supported:
|
||||
|
||||
name
|
||||
: String _(required)_. Name of the file/dir. For the top-level directory (that
|
||||
is, the `<directory>` item in the top-level JSON array), this should be
|
||||
the full absolute filesystem path, e.g. `"/media/harddrive"`. For any items
|
||||
below the top-level directory, the name should be just the name of the item.
|
||||
|
||||
The name will be in the same encoding as reported by the filesystem (i.e.
|
||||
[readdir()](http://manned.org/readdir.3)). The name may not exceed 32768 bytes.
|
||||
|
||||
asize
|
||||
: Number. The apparent file size, as reported by `lstat().st_size`. If absent, 0
|
||||
is assumed. Accepted values are in the range of `0 <= asize < 2^63`.
|
||||
|
||||
dsize
|
||||
: Number. Size of the file, as consumed on the disk. This is obtained through
|
||||
`lstat().st_blocks*S_BLKSIZE`. If absent, 0 is assumed. Accepted values are in
|
||||
the range of `0 <= dsize < 2^63`.
|
||||
|
||||
dev
|
||||
: Number. The device ID. Has to be a unique ID within the context of the exported
|
||||
dump, but may not have any meaning outside of that. I.e. this can be a
|
||||
serialization of `lstat().st_dev`, but also a randomly generated number only
|
||||
used within this file. As long as it uniquely identifies the device/filesystem
|
||||
on which this file is stored. This field may be absent, in which case it is
|
||||
equivalent to that of the parent directory. If this field is absent for the
|
||||
parent directory, a value of 0 is assumed. Accepted values are in the range of
|
||||
`0 <= dev < 2^64`.
|
||||
|
||||
ino
|
||||
: Number. Inode number as reported by `lstat().st_ino`. Together with the Device
|
||||
ID this uniquely identifies a file in this dump. In the case of hard links, two
|
||||
objects may appear with the same (`dev`,`ino`) combination. A value of 0 is
|
||||
assumed if this field is absent. This is currently (ncdu 1.9-1.13) not a
|
||||
problem as long as the `hlnkc` field is false, otherwise it will consider
|
||||
everything with the same `dev` and empty `ino` values as a single hardlinked
|
||||
file. Accepted values are in the range of `0 <= ino < 2^64`.
|
||||
|
||||
hlnkc
|
||||
: Boolean. `true` if this is a file with `lstat().st_nlink > 1`. If absent,
|
||||
`false` is assumed.
|
||||
|
||||
read\_error
|
||||
: Boolean. `true` if something went wrong while reading this entry. I.e. the
|
||||
information in this entry may not be complete. For files, this indicates that
|
||||
the `lstat()` call failed. For directories, this means that an error occurred
|
||||
while obtaining the file listing, and some items may be missing. Note that if
|
||||
`lstat()` failed, ncdu has no way of knowing whether an item is a file or a
|
||||
directory, so a file with `read_error` set might as well be a directory. If
|
||||
absent, `false` is assumed.
|
||||
|
||||
excluded
|
||||
: String. Set if this file or directory is to be excluded from calculation for
|
||||
some reason. The following values are recognized:
|
||||
|
||||
`"pattern"`
|
||||
: If the path matched an exclude pattern.
|
||||
|
||||
`"otherfs"`
|
||||
: If the item is on a different device/filesystem.
|
||||
|
||||
Excluded items may still be included in the export, but only by name. `size`,
|
||||
`asize` and other information may be absent. If this item was excluded by a
|
||||
pattern, ncdu will not do an `lstat()` on it, and may thus report this item as
|
||||
a file even if it is a directory.
|
||||
|
||||
Other values than mentioned above are accepted by ncdu, but are currently
|
||||
interpreted to be equivalent to "pattern". This field should be absent if the
|
||||
item has not been excluded from the calculation.
|
||||
|
||||
notreg
|
||||
: Boolean. This is `true` if neither S\_ISREG() nor S\_ISDIR() evaluates to true.
|
||||
I.e. this is a symlink, character device, block device, FIFO, socket, or
|
||||
whatever else your system may support. If absent, `false` is assumed.
|
||||
|
||||
### Extended information
|
||||
|
||||
In addition, the following fields are exported when _extended information_ mode
|
||||
is enabled (available since ncdu 1.13). See the `-e` flag in
|
||||
[ncdu(1)](/ncdu/man) for details.
|
||||
|
||||
uid
|
||||
: Number, user ID who owns the file. Accepted values are in the range
|
||||
`0 <= uid < 2^31`.
|
||||
|
||||
gid
|
||||
: Number, group ID who owns the file. Accepted values are in the range
|
||||
`0 <= uid < 2^31`.
|
||||
|
||||
mode
|
||||
: Number, the raw file mode as returned by
|
||||
[lstat(3)](https://manned.org/lstat.3). For Linux systems, see
|
||||
[inode(7)](https://manned.org/inode.7) for the interpretation of this
|
||||
field. Accepted range: `0 <= mode < 2^16`.
|
||||
|
||||
mtime
|
||||
: Number, last modification time as a UNIX timestamp. Accepted range:
|
||||
`0 <= mtime < 2^64`.
|
||||
|
||||
## Miscellaneous notes
|
||||
|
||||
As mentioned above, file/directory names are **not** converted to any specific
|
||||
encoding when exporting. If you want the exported info dump to be valid JSON
|
||||
(and thus valid UTF-8), you'll have to ensure that you have either no non-UTF-8
|
||||
filenames in your filesystem, or you should process the dump through a
|
||||
conversion utility such as `iconv`. When browsing an imported file with ncdu,
|
||||
you'll usually want to ensure that the filenames are in the same encoding as
|
||||
what your terminal is expecting. The browsing interface may look garbled or
|
||||
otherwise ugly if that's not the case.
|
||||
|
||||
Another important thing to keep in mind is that an export can be fairly large.
|
||||
If you write a program that reads a file in this format and you care about
|
||||
handling directories with several million files, make sure to optimize for
|
||||
that. For example, prefer the use of a stream-based JSON parser over a JSON
|
||||
library that reads the entire file in a single generic data structure, and only
|
||||
keep the minimum amount of data that you care about in memory.
|
||||
|
||||
## Example Export
|
||||
|
||||
Here's a simple example export that displays the basic structure of the format.
|
||||
|
||||
[
|
||||
1,
|
||||
0,
|
||||
{
|
||||
"progname" : "ncdu",
|
||||
"progver" : "1.9",
|
||||
"timestamp" : 1354477149
|
||||
},
|
||||
[
|
||||
{ "name" : "/media/harddrive",
|
||||
"dsize" : 4096,
|
||||
"asize" : 422,
|
||||
"dev" : 39123423,
|
||||
"ino" : 29342345
|
||||
},
|
||||
{ "name" : "SomeFile",
|
||||
"dsize" : 32768,
|
||||
"asize" : 32414,
|
||||
"ino" : 91245479284
|
||||
},
|
||||
[
|
||||
{ "name" : "EmptyDir",
|
||||
"dsize" : 4096,
|
||||
"asize" : 10,
|
||||
"ino" : 3924
|
||||
}
|
||||
]
|
||||
]
|
||||
]
|
||||
|
||||
The directory described above has the following structure:
|
||||
|
||||
/media/harddrive
|
||||
├── SomeFile
|
||||
└── EmptyDir
|
||||
29
dat/ncdu/scr.md
Normal file
29
dat/ncdu/scr.md
Normal file
|
|
@ -0,0 +1,29 @@
|
|||
% Ncdu Screenshots
|
||||
|
||||
These screenshots were made with ncdu 1.13 with the `--color=dark` option.
|
||||
Colors are not available in older versions and (in 1.13) still disabled by
|
||||
default.
|
||||
|
||||
## Scanning...
|
||||
|
||||
|
||||
|
||||
## Done scanning
|
||||
|
||||
|
||||
|
||||
## Directory information
|
||||
|
||||
|
||||
|
||||
## Delete confirmation
|
||||
|
||||
|
||||
|
||||
## Help screen
|
||||
|
||||
|
||||
|
||||
## About screen
|
||||
|
||||
|
||||
Loading…
Add table
Add a link
Reference in a new issue