blob: 26f672f35f0cf5a303befce06f2fee6368b128fe (
plain) (
blame)
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
|
OVERVIEW
========
dir\_monitor is a simple utility to print stat information
from a directory in a formatted and organized form. In
combination with watch it can be used for continous monitoring.
OPTIONS
=======
Call: dir\_monitor [[OPTIONS]... path\_to\_open]
| long | short | option | description |
| ---- | ----- | ------ | ----------- |
| `--help` | `-h` | | Show this message and exit |
| `--format` | `-f` | format | define columns to print, details below |
| `--long-timestamp` | `-t` | | Print timestamp in long form yyyymmdd HH:MM:SS ZONE |
| `--print-boxed` | `-b` | | Print visual additions around the table |
| `--print-header` | `-H` | | Print a header above the columns |
| `--reverse-sort` | | | | Sort reversed |
| `--show-hidden-entries` | `-a` | | Show hidden entries in the directory |
| `--sort-by` | | variant | Sort either by variant |
| `--time-field` | | `a`\|`c`\|`m` | Sort by (a)ccess, (c)hange or (m)odification time. Default: m |
`--sort-by` variants: `name` | `size` | `time`
`--format` Aside from the characters in the table only space is
accepted. Currently at max 80 bytes of the format string are processed.
| char | description |
| ---- | ----------- |
| `A` | access time |
| `C` | change time |
| `G` | group name |
| `g` | group id |
| `M` | modification time |
| `n` | file name |
| `p` | permissions |
| `s` | size in bytes or kB (base 1024) |
| `T` | type (file, directory, link etc.) |
| `t` | time as defined by `--time-field` |
| `U` | user name |
| `u` | user id |
The time stamps in `t`, `A`, `C`, `M` are by default only the daily time,
`--long-timestamp` / `-t` needs to be set to activate the full timestamp
including date and timezone.
TODO
====
- option for output file
- option for recursion
- option for symlink handling
- configuration file in ${HOME}/.config/ ?
- formatting with non-ASCII characters in filenames, `--print-boxed`
misformats due to the strlen result not matching the visual representation.
|
