1.\"	$NetBSD: iprop-log.8,v 1.5 2014/04/24 13:45:34 pettai 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 maintain the iprop log file
44.Sh SYNOPSIS
45.Nm
46.Op Fl Fl version
47.Op Fl h | Fl Fl help
48.Ar command
49.Pp
50.Nm iprop-log truncate
51.Oo Fl c Ar file \*(Ba Xo
52.Fl Fl config-file= Ns Ar file
53.Xc
54.Oc
55.Oo Fl r Ar string \*(Ba Xo
56.Fl Fl realm= Ns Ar string
57.Xc
58.Oc
59.Op Fl h | Fl Fl help
60.Pp
61.Nm iprop-log dump
62.Oo Fl c Ar file \*(Ba Xo
63.Fl Fl config-file= Ns Ar file
64.Xc
65.Oc
66.Oo Fl r Ar string \*(Ba Xo
67.Fl Fl realm= Ns Ar string
68.Xc
69.Oc
70.Op Fl h | Fl Fl help
71.Pp
72.Nm iprop-log replay
73.Op Fl Fl start-version= Ns Ar version-number
74.Op Fl Fl end-version= Ns Ar version-number
75.Oo Fl c Ar file \*(Ba Xo
76.Fl Fl config-file= Ns Ar file
77.Xc
78.Oc
79.Oo Fl r Ar string \*(Ba Xo
80.Fl Fl realm= Ns Ar string
81.Xc
82.Oc
83.Op Fl h | Fl Fl help
84.Sh DESCRIPTION
85Supported options:
86.Bl -tag -width Ds
87.It Fl Fl version
88.It Fl h , Fl Fl help
89.El
90.Pp
91command can be one of the following:
92.Bl -tag -width truncate
93.It truncate
94.Bl -tag -width Ds
95.It Fl c Ar file , Fl Fl config-file= Ns Ar file
96configuration file
97.It Fl r Ar string , Fl Fl realm= Ns Ar string
98realm
99.El
100.Pp
101Truncates the log. Sets the new logs version number for the to the
102last entry of the old log.  If the log is truncted by emptying the
103file, the log will start over at the first version (0).
104.It dump
105.Bl -tag -width Ds
106.It Fl c Ar file , Fl Fl config-file= Ns Ar file
107configuration file
108.It Xo
109.Fl r Ar string ,
110.Fl Fl realm= Ns Ar string
111.Xc
112realm
113.El
114.Pp
115Print out all entries in the log to standard output.
116.It replay
117.Bl -tag -width Ds
118.It Fl Fl start-version= Ns Ar version-number
119start replay with this version
120.It Xo
121.Fl Fl end-version= Ns Ar version-number
122.Xc
123end replay with this version
124.It Fl c Ar file , Fl Fl config-file= Ns Ar file
125configuration file
126.It Fl r Ar string , Fl Fl realm= Ns Ar string
127realm
128.El
129.Pp
130Replay the changes from specified entries (or all if none is
131specified) in the transaction log to the database.
132.It last-version
133.Bl -tag -width Ds
134.It Fl c Ar file , Fl Fl config-file= Ns Ar file
135configuration file
136.It Fl r Ar string , Fl Fl realm= Ns Ar string
137realm
138.El
139.Pp
140prints the version of the last log entry.
141.El
142.Sh SEE ALSO
143.Xr iprop 8
144