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
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
<refentry>
<refmeta>
<refentrytitle>
<application>flow-expire</application>
</refentrytitle>
<manvolnum>1</manvolnum>
</refmeta>
<refnamediv>
<refname>
<application>flow-expire</application>
</refname>
<refpurpose>
Manage storage of flow file archives by expiring old data.
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>flow-expire</command>
<arg>-h</arg>
<arg>-d<replaceable> debug_level</replaceable></arg>
<arg>-e<replaceable> expire_count</replaceable></arg>
<arg>-E<replaceable> expire_size</replaceable></arg>
<arg choice="req">-w<replaceable> workdir</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>DESCRIPTION</title>
<para>
The <command>flow-expire</command> utility will remove the oldest flow files
in a directory based on either a count of files or space utilization. The
directory is recursively searched for flow files. Files that do not have a
flow-tools signature will be ignored. The internal timestamp is used so
backups or copies of the flow files that do not retain the original
timestamp will not impact the operation of <command>flow-expire</command>.
<command>flow-expire</command> is typically used to manage storage in
a distributed environment where flows are collected on a different
server than they are archived.
</para>
</refsect1>
<refsect1>
<title>OPTIONS</title>
<variablelist>
<varlistentry>
<term>-d<replaceable> debug_level</replaceable></term>
<listitem>
<para>
Enable debugging.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-e<replaceable> expire_count</replaceable></term>
<listitem>
<para>
Retain the maximum number of files so that the total file count is
less than <replaceable>expire_count</replaceable>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-E<replaceable> expire_size</replaceable></term>
<listitem>
<para>
Retain the maximum number of files so that the total storage is less
than <replaceable>expire_size</replaceable>. The letters b,K,M,G can
be used as multipliers, ie 16 Megabytes is 16M.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-h</term>
<listitem>
<para>
Display help.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-w<replaceable> workdir</replaceable></term>
<listitem>
<para>
Work in <filename>workdir</filename>.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>EXAMPLES</title>
<informalexample>
<para>
Remove the oldest flow files in <filename>/flows/krc4</filename> until
the total storage is less then 2 Gigabytes.
</para>
<para>
<command>flow-expire -E2Gig -w /flows/krc4</command>
</para>
</informalexample>
<informalexample>
<para>
Remove the oldest flow files in <filename>/flows/krc4</filename> until
the total number of files is less then 100.
</para>
<para>
<command>flow-expire -e100 -w /flows/krc4</command>
</para>
</informalexample>
</refsect1>
<refsect1>
<title>BUGS</title>
<para>
Empty directories are not removed.
</para>
</refsect1>
<refsect1>
<title>AUTHOR</title>
<para>
<author>
<firstname>Mark</firstname>
<surname>Fullmer</surname>
</author>
<email>maf@splintered.net</email>
</para>
</refsect1>
<refsect1>
<title>SEE ALSO</title>
<para>
<application>flow-tools</application>(1)
</para>
</refsect1>
</refentry>
|
