annotate imgpasterd-clean.8.in @ 0:f41e1b48510d

misc: initial import
author David Demelier <markand@malikania.fr>
date Wed, 25 Nov 2020 21:13:03 +0100
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
1 .\"
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
2 .\" Copyright (c) 2020 David Demelier <markand@malikania.fr>
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
3 .\"
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
4 .\" Permission to use, copy, modify, and/or distribute this software for any
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
5 .\" purpose with or without fee is hereby granted, provided that the above
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
6 .\" copyright notice and this permission notice appear in all copies.
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
7 .\"
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
8 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
9 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
10 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
11 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
12 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
13 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
14 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
15 .\"
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
16 .Dd 06 February, 2020
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
17 .Dt IMGPASTERD-CLEAN 8
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
18 .Os
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
19 .\" NAME
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
20 .Sh NAME
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
21 .Nm imgpasterd-clean
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
22 .Nd simple image hosting service cleaner
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
23 .\" SYNOPSIS
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
24 .Sh SYNOPSIS
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
25 .Nm
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
26 .Op Fl d Ar database-path
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
27 .\" DESCRIPTION
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
28 .Sh DESCRIPTION
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
29 This utility should be used at periodic intervals to clean up the SQLite
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
30 database. It will remove deprecated images.
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
31 .Pp
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
32 Like
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
33 .Xr imgpasterd 8
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
34 it can use environment variables or option to specify the database.
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
35 .Pp
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
36 Available options:
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
37 .Bl -tag -width Ds
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
38 .It Fl d Ar database-path
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
39 Specify an alternate path for the database.
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
40 .El
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
41 .\" USAGE
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
42 .Sh USAGE
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
43 This command should be placed in a cron job (or equivalent) at periodic
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
44 intervals. Since the minimal lifetime for an image is one hour a periodic job
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
45 every hour seems appropriate.
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
46 .Pp
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
47 Note: make sure to run the cron job in the same user as the pasterd service,
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
48 otherwise you may change file permissions.
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
49 .Pp
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
50 Example of cron job:
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
51 .Bd -literal -offset Ds
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
52 0 * * * * www imgpasterd-clean -d /var/paster/paster.db
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
53 .Ed
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
54 .\" ENVIRONMENT
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
55 .Sh ENVIRONMENT
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
56 The following environment variables are detected:
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
57 .Bl -tag -width Ds
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
58 .It Va IMGPASTERD_DATABASE_PATH No (string)
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
59 Path to the SQLite database.
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
60 .El
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
61 .\" AUTHORS
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
62 .Sh AUTHORS
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
63 .Nm
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
64 was written by David Demelier <markand@malikania.fr>
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
65 .\" SEE ALSO
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
66 .Sh SEE ALSO
f41e1b48510d misc: initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
67 .Xr imgpasterd 8