xref: /netbsd-src/crypto/external/bsd/heimdal/dist/lib/kadm5/iprop-log.8 (revision 6a493d6bc668897c91594964a732d38505b70cbb)
1.\"	$NetBSD: iprop-log.8,v 1.4 2011/04/28 14:29:53 wiz Exp $
2.\"
3.\" Id
4.\"
5.\" Copyright (c) 2005 - 2007 Kungliga Tekniska Högskolan
6.\" (Royal Institute of Technology, Stockholm, Sweden).
7.\" All rights reserved.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\"
13.\" 1. Redistributions of source code must retain the above copyright
14.\"    notice, this list of conditions and the following disclaimer.
15.\"
16.\" 2. Redistributions in binary form must reproduce the above copyright
17.\"    notice, this list of conditions and the following disclaimer in the
18.\"    documentation and/or other materials provided with the distribution.
19.\"
20.\" 3. Neither the name of the Institute nor the names of its contributors
21.\"    may be used to endorse or promote products derived from this software
22.\"    without specific prior written permission.
23.\"
24.\" THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
25.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
28.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
29.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
30.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
31.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
33.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34.\" SUCH DAMAGE.
35.\"
36.\"	Id
37.\"
38.Dd February 18, 2007
39.Dt IPROP-LOG 8
40.Os
41.Sh NAME
42.Nm iprop-log
43.Nd
44maintain the iprop log file
45.Sh SYNOPSIS
46.Nm
47.Op Fl -version
48.Op Fl h | Fl -help
49.Ar command
50.Pp
51.Nm iprop-log truncate
52.Oo Fl c Ar file \*(Ba Xo
53.Fl -config-file= Ns Ar file
54.Xc
55.Oc
56.Oo Fl r Ar string \*(Ba Xo
57.Fl -realm= Ns Ar string
58.Xc
59.Oc
60.Op Fl h | Fl -help
61.Pp
62.Nm iprop-log dump
63.Oo Fl c Ar file \*(Ba Xo
64.Fl -config-file= Ns Ar file
65.Xc
66.Oc
67.Oo Fl r Ar string \*(Ba Xo
68.Fl -realm= Ns Ar string
69.Xc
70.Oc
71.Op Fl h | Fl -help
72.Pp
73.Nm iprop-log replay
74.Op Fl -start-version= Ns Ar version-number
75.Op Fl -end-version= Ns Ar version-number
76.Oo Fl c Ar file \*(Ba Xo
77.Fl -config-file= Ns Ar file
78.Xc
79.Oc
80.Oo Fl r Ar string \*(Ba Xo
81.Fl -realm= Ns Ar string
82.Xc
83.Oc
84.Op Fl h | Fl -help
85.Sh DESCRIPTION
86Supported options:
87.Bl -tag -width Ds
88.It Fl -version
89.It Fl h , Fl -help
90.El
91.Pp
92command can be one of the following:
93.Bl -tag -width truncate
94.It truncate
95.Bl -tag -width Ds
96.It Fl c Ar file , Fl -config-file= Ns Ar file
97configuration file
98.It Fl r Ar string , Fl -realm= Ns Ar string
99realm
100.El
101.Pp
102Truncates the log. Sets the new logs version number for the to the
103last entry of the old log.  If the log is truncted by emptying the
104file, the log will start over at the first version (0).
105.It dump
106.Bl -tag -width Ds
107.It Fl c Ar file , Fl -config-file= Ns Ar file
108configuration file
109.It Fl r Ar string , Fl -realm= Ns Ar string
110realm
111.El
112.Pp
113Print out all entries in the log to standard output.
114.It replay
115.Bl -tag -width Ds
116.It Fl -start-version= Ns Ar version-number
117start replay with this version
118.It Fl -end-version= Ns Ar version-number
119end replay with this version
120.It Fl c Ar file , Fl -config-file= Ns Ar file
121configuration file
122.It Fl r Ar string , Fl -realm= Ns Ar string
123realm
124.El
125.Pp
126Replay the changes from specified entries (or all if none is
127specified) in the transaction log to the database.
128.It last-version
129.Bl -tag -width Ds
130.It Fl c Ar file , Fl -config-file= Ns Ar file
131configuration file
132.It Fl r Ar string , Fl -realm= Ns Ar string
133realm
134.El
135.Pp
136prints the version of the last log entry.
137.El
138.Sh SEE ALSO
139.Xr iprop 8
140