xref: /openbsd/usr.bin/skey/skeyprune.8 (revision 8529ddd3)
1.\" $OpenBSD: skeyprune.8,v 1.12 2014/02/12 16:58:44 schwarze Exp $
2.\"
3.\" Copyright (c) 1996, 2001, 2002 Todd C. Miller <Todd.Miller@courtesan.com>
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: February 12 2014 $
18.Dt SKEYPRUNE 8
19.Os
20.Sh NAME
21.Nm skeyprune
22.Nd prune zeroed and old entries from S/Key database
23.Sh SYNOPSIS
24.Nm skeyprune
25.Op Ar days
26.Sh DESCRIPTION
27.Nm skeyprune
28searches through the S/Key database,
29.Pa /etc/skey ,
30and prunes out entries that have been zeroed out via
31.Xr skeyinit 1
32as well as entries that have not been modified in
33.Ar days
34days.
35If
36.Ar days
37is not specified, only invalid entries are pruned.
38.Pp
39If a malformed entry is encountered, or if the file mode/type is incorrect,
40an error is printed to the standard error.
41.Sh FILES
42.Bl -tag -width /etc/skey
43.It Pa /etc/skey
44directory containing S/Key user entries
45.El
46.Sh DIAGNOSTICS
47The following errors are cause for concern.
48.Bl -tag -width Ds
49.It Can't cd to /etc/skey
50The S/Key database directory,
51.Pa /etc/skey ,
52does not exist.
53The superuser may create it by running
54.Dq skeyinit -E .
55.It Can't open user
56The user's entry was found in
57.Pa /etc/skey
58but it could not be opened.
59.It user is not a regular file
60The user's entry is not a regular file.
61.It Bad mode for user
62The user's entry had a bad file mode (should be 0600).
63.It Bad link count for user.
64The user's entry had a bad link count (should be 1).
65.It Invalid entry for user
66The user's entry was not of the correct format, as specified by
67.Xr skey 5 .
68.El
69.Sh SEE ALSO
70.Xr skey 1 ,
71.Xr skeyinit 1 ,
72.Xr skey 5
73