From ea0d9eba0281927cd657f0465ce796630edff8de Mon Sep 17 00:00:00 2001 From: bootandy Date: Mon, 19 Mar 2018 12:04:00 -0400 Subject: [PATCH] Update Readme --- README.md | 36 +++++++++++++++++++++++++++++++++--- 1 file changed, 33 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 847ca2b..04e69ef 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,39 @@ # Dust du + rust = dust. A rust alternative to du -unlike du, dust is meant to give you an instant overview of which directories are using disk space. +Unlike du, dust is meant to give you an instant overview of which directories are using disk space without requiring sort or head. Dust does not count file system blocks; it uses file sizes instead. Dust will print a maximum of 1 'Did not have permissions message'. + + +Dust will list the 15 biggest sub directories and will smartly recurse down the tree to find the larger ones. There is no need for a '-d' flag or a '-h' flag. The largest sub directory will have its size shown in red + +``` +Usage: dust +Usage: dust -n 30 (Shows 30 directories not 15) +``` + + +``` +dust . + 161M . + 160M └── ./target + 123M ├── ./target/debug + 83M │ ├── ./target/debug/deps + 16M │ │ ├── ./target/debug/deps/libclap-82e6176feef5d4b7.rlib + 8.6M │ │ └── ./target/debug/deps/dust-993f7d919d92f0f8.dSYM + 8.6M │ │ └── ./target/debug/deps/dust-993f7d919d92f0f8.dSYM/Contents + 8.6M │ │ └── ./target/debug/deps/dust-993f7d919d92f0f8.dSYM/Contents/Resources + 27M │ ├── ./target/debug/incremental + 12M │ └── ./target/debug/build + 20M ├── ./target/x86_64-apple-darwin + 20M │ └── ./target/x86_64-apple-darwin/debug + 20M │ └── ./target/x86_64-apple-darwin/debug/deps + 16M │ └── ./target/x86_64-apple-darwin/debug/deps/libclap-7e3f8513c52cd558.rlib + 16M └── ./target/release + 13M └── ./target/release/deps +``` + +Performance: dust is currently about 4 times slower than du. + -du is good when combined with sort and head. Dust is an all in one command. -do not use. strickly experimental for me messing around with rust.