add dysk
This commit is contained in:
parent
5b1734d551
commit
c34f1d65d2
GPG key ID:
901B2ADDF27C2263
1 changed files with 141 additions and 0 deletions
141
technology/applications/cli/dysk.md
Normal file
141
technology/applications/cli/dysk.md
Normal file
|
|
@ -0,0 +1,141 @@
|
|||
---
|
||||
obj: application
|
||||
website: https://dystroy.org/dysk
|
||||
repo: https://github.com/Canop/dysk
|
||||
---
|
||||
|
||||
# dysk
|
||||
dysk is a [linux](../../linux/Linux.md) utility listing your [filesystems](../../linux/filesystems/Filesystems.md).
|
||||
|
||||
## Usage
|
||||
Usage: `dysk [-a, --all] [PATH]`
|
||||
|
||||
### Table
|
||||
The standard output of dysk is a table with a default set of columns and only the "normal looking" [filesystems](../../linux/filesystems/Filesystems.md). You can modify it easily.
|
||||
|
||||
#### Columns
|
||||
You can run `dysk --list-cols` for the list of all columns.
|
||||
|
||||
**All columns:**
|
||||
|
||||
| name | default | meaning |
|
||||
| ------------------ | ------- | ---------------------------------------------- |
|
||||
| id | | mount point id |
|
||||
| dev | | device id |
|
||||
| filesystem | ✓ | filesystem |
|
||||
| label | | label |
|
||||
| type | ✓ | filesystem type |
|
||||
| remote | | whether it's a remote filesystem |
|
||||
| disk | ✓ | short tag of the underlying storage identified |
|
||||
| used | ✓ | cumulated size of the occupied blocks |
|
||||
| use | ✓ | graphical view of the use share |
|
||||
| use_percent | | percentage of occupied blocks |
|
||||
| free | ✓ | cumulated size of the available blocks |
|
||||
| free_percent | | percentage of available blocks |
|
||||
| size | ✓ | size of the volume |
|
||||
| inodesfree | | available inodes |
|
||||
| inodesused | | inodes used |
|
||||
| inodes | | inodes use share, graphical |
|
||||
| inodes_use_percent | | inodes use share, in percents |
|
||||
| inodescount | | total number of inodes in the filesystem |
|
||||
| mount | ✓ | mounting path |
|
||||
|
||||
#### Choose columns
|
||||
With the `--cols` launch argument, shortened as `-c`, you can change the displayed columns or their order.
|
||||
|
||||
With `-c all`, you may see all available columns, but that's normally too much for convenience:
|
||||
|
||||
The most obvious use of the `--cols` argument is the explicit definition of the columns to display.
|
||||
For example `dysk -c label+use+size+disk+mount` will show the label, use, size, disk, and mount columns, in that order.
|
||||
|
||||
#### Sort
|
||||
With the `--sort` launch argument, shortened as `-s`, you can specify the order of displayed rows.
|
||||
|
||||
The argument's value must be either a column name, for example `dysk -s dev`, or a column name and a direction, for example `dysk --sort size-desc`.
|
||||
|
||||
The `desc` and `asc` directions can be abbreviated into `d` and `a`.
|
||||
|
||||
#### CSV
|
||||
With the `--csv` argument, you can ask dysk to output the table in [CSV](../../files/CSV.md):
|
||||
|
||||
`dysk --csv > mounts.csv`
|
||||
|
||||
You may choose the separator with the `--csv-separator` argument.
|
||||
|
||||
Filters, sorting, and column selection work the same than for standard tables so you may do this:
|
||||
|
||||
`dysk --csv -f 'size>100G' -c remote+default+inodes > mounts.csv`
|
||||
|
||||
### [JSON](../../files/JSON.md)
|
||||
Use `-j` or `--json`. The normal output is an array of all filesystem matching the filter.
|
||||
|
||||
`dysk -j | jq '.[0]' > disk.json`
|
||||
|
||||
```json
|
||||
{
|
||||
"bound": false,
|
||||
"dev": {
|
||||
"major": 8,
|
||||
"minor": 1
|
||||
},
|
||||
"disk": {
|
||||
"crypted": false,
|
||||
"ram": false,
|
||||
"removable": false,
|
||||
"rotational": false,
|
||||
"type": "SSD"
|
||||
},
|
||||
"fs": "/dev/sda1",
|
||||
"fs-label": null,
|
||||
"fs-type": "ext4",
|
||||
"id": 26,
|
||||
"mount-point": "/",
|
||||
"remote": false,
|
||||
"stats": {
|
||||
"available": "81G",
|
||||
"bavail": 19764035,
|
||||
"bfree": 22790364,
|
||||
"blocks": 59233748,
|
||||
"bsize": 4096,
|
||||
"inodes": {
|
||||
"avail": 13880393,
|
||||
"files": 15114240,
|
||||
"free": 13880393,
|
||||
"used-percent": "8%"
|
||||
},
|
||||
"size": "243G",
|
||||
"used": "162G",
|
||||
"used-percent": "67%"
|
||||
},
|
||||
"unreachable": false
|
||||
}
|
||||
```
|
||||
|
||||
The disk, stats, and stats.inodes structures, or the fs-label, may be null for some [filesystems](../../linux/filesystems/Filesystems.md).
|
||||
|
||||
### Filter
|
||||
The `--filter` argument, shortened in `-f`, lets you specify a constraint, or combine several ones.
|
||||
|
||||
A constraint can be related to any column.
|
||||
|
||||
You can for example fetch the [filesystems](../../linux/filesystems/Filesystems.md) with a given type with `dysk -f 'type=xfs'`.
|
||||
|
||||
Or remote volumes with `dysk -f 'remote=true'`.
|
||||
|
||||
The operators you can apply to a column are the following ones:
|
||||
|
||||
| operator | meaning |
|
||||
| -------- | -------------------------------------------------------- |
|
||||
| `<` | lower |
|
||||
| `<=` | lower or equal |
|
||||
| `>` | greater |
|
||||
| `>=` | greater or equal |
|
||||
| `<>` | different |
|
||||
| `=` | somehow equal - for example `fs=sda` matches `/dev/sda1` |
|
||||
| `==` | really equal |
|
||||
|
||||
You can combine several column conditions with boolean operators `|` (or), `&` (and) and `!` (not) and if needed you can use parenthesis.
|
||||
|
||||
For example you may want to select the volumes with not enough space with
|
||||
|
||||
`dysk -f 'free<100G | use>65%'`
|
||||
Loading…
Reference in a new issue