blob: 41ff829c8948e9940664f7bd1ba719c086d24957 (
plain)
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
|
# lfs
[![CI][s3]][l3] [![MIT][s2]][l2] [![Latest Version][s1]][l1] [![Chat on Miaou][s4]][l4]
[s1]: https://img.shields.io/crates/v/lfs.svg
[l1]: https://crates.io/crates/lfs
[s2]: https://img.shields.io/badge/license-MIT-blue.svg
[l2]: LICENSE
[s3]: https://travis-ci.org/Canop/lfs.svg?branch=master
[l3]: https://travis-ci.org/Canop/lfs
[s4]: https://miaou.dystroy.org/static/shields/room.svg
[l4]: https://miaou.dystroy.org/3768?Rust
A linux utility listing your filesystems.
![screenshot](doc/screenshot.png)
Besides traditional columns, the `disk` column helps you identify your "disk" (or the mapping standing between your filesystem and the physical device) :
* `remov` : a removable device (such as an USB key)
* `HDD` : a rotational disk
* `SSD` : a solid state storage device
* `RAM` : an in-memory device (such as zram)
* `LVM` : a device mapped to one or several disks using LVM
* `crypt` : a crypted disk
All sizes are normally based on the current SI recommendations (1M is one million bytes) but can be changed with `--units binary` (then 1M is 1,048,576 bytes).
## Installation
### Precompiled binary
You can download it from https://github.com/Canop/lfs/releases
### From source
You need the [Rust tool chain](https://rustup.rs/).
```
cargo install lfs
```
### Arch Linux
**lfs** can be installed from the [community repository](https://archlinux.org/packages/community/x86_64/lfs/):
```
pacman -S lfs
```
## Usage
```
lfs
```
By default, **lfs** only shows mount points backed by normal block devices, which are usually the "storage" filesystems you're interested into.
To show them all, use
```
lfs -a
```
To get the output as JSON, do `lfs -j` or `lfs -a -j`.
You may pass a path to have only the relevant device shown.
For example:
![lfs dot](doc/lfs-dot.png)
Use `lfs --help` to list the other arguments.
## Internals
If you want to display the same data in your Rust application, have a look at the [lfs-core](https://docs.rs/lfs-core/) crate.
|