Annotation of src/usr.bin/skey/skeyprune.8, Revision 1.10
1.10 ! jmc 1: .\" $OpenBSD: skeyprune.8,v 1.9 2003/06/10 18:25:33 millert Exp $
1.1 millert 2: .\"
1.9 millert 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.
1.1 millert 16: .\"
1.7 millert 17: .Dd May 16, 2002
1.1 millert 18: .Dt SKEYPRUNE 8
1.2 millert 19: .Os
1.1 millert 20: .Sh NAME
21: .Nm skeyprune
1.10 ! jmc 22: .Nd prune zeroed and old entries from S/Key database
1.1 millert 23: .Sh SYNOPSIS
24: .Nm skeyprune
25: .Op Ar days
26: .Sh DESCRIPTION
27: .Nm skeyprune
1.6 millert 28: searches through the S/Key database,
1.7 millert 29: .Pa /etc/skey ,
30: and prunes out entries that have been zeroed out via
31: .Xr skeyinit 1
1.1 millert 32: as well as entries that have not been modified in
33: .Ar days
1.5 aaron 34: days.
35: If
1.1 millert 36: .Ar days
1.6 millert 37: is not specified, only invalid entries are pruned.
1.7 millert 38: .Pp
39: If a malformed entry is encountered, or if the file mode/type is incorrect,
40: an error is printed to the standard error.
1.8 jmc 41: .Sh FILES
42: .Bl -tag -width /etc/skey
43: .It Pa /etc/skey
44: directory containing S/Key user entries
45: .El
1.7 millert 46: .Sh ERRORS
47: The following errors are cause for concern.
48: .Bl -tag -width Ds
49: .It Can't cd to /etc/skey
50: The S/Key database directory,
51: .Pa /etc/skey ,
52: does not exist.
53: The superuser may create it by running
54: .Dq skeyinit -E .
55: .It Can't open user
56: The user's entry was found in
57: .Pa /etc/skey
58: but it could not be opened.
59: .It user is not a regular file
60: The user's entry is not a regular file.
61: .It Bad mode for user
62: The user's entry had a bad file mode (should be 0600).
63: .It Bad link count for user.
64: The user's entry had a bad link count (should be 1).
65: .It Invalid entry for user
66: The user's entry was not of the correct format, as specified by
67: .Xr skey 5 .
1.1 millert 68: .El
69: .Sh SEE ALSO
1.3 aaron 70: .Xr skey 1 ,
1.7 millert 71: .Xr skeyinit 1 ,
72: .Xr skey 5