aboutsummaryrefslogtreecommitdiff
path: root/man/dir_monitor.1.adoc
blob: b1d4787c99a7b3e536f00ed3bc38f922ce10eff2 (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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
dir_monitor(1)
==============

== NAME

dir_monitor - present stat information of a path formatted and sorted


== SYNOPSIS

**dir_monitor** [*OPTION*]... directory


== DESCRIPTION
dir_monitor is a simple tool, intended to present the content of a directory in a sorted order with definition of which information from the *stat(2)* call are to be presented.

It can be used for continuous monitoring of a path by wrappers like *watch*.


== OPTIONS

**--format-string** 'format'::
define columns to print, details below

**--help**, **-h**::
    Show this message and exit

**--long-timestamp**, **-t**::
Print timestamp in long form 'yyyymmdd HH:MM:SS ZONE'

**--print-boxed**::
Print output in form of a boxed 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** 'name | size | time'::
Sort either by size or time

**--time-field** 'a | c | m'::
Sort by (a)ccess, (c)hange or (m)odification time. Default: 'm'


=== format-string characters
Other characters than the following are ignored.

[cols=2]
|===

|A
|access time

|C
|change time

|G
|group name

|g
|group id

|M
|modification time

|n
|file name

|p
|permissions

|s
|size

|T
|type

|t
|time defined by **--time-field** (default: 'modification time')

|U
|user name

|u
|user id

|===


== EXAMPLES

dir_monitor --long-timestamp --print-header --format-string \'sAMn' --sort-by time --show-hidden /tmp

watch -d \'*dir_monitor -t -H /tmp/*'

== SEE ALSO
*watch(1)*

== AUTHOR
Thorsten Töpper