3 .\" Copyright (c) 2005 - 2007 Kungliga Tekniska Högskolan
4 .\" (Royal Institute of Technology, Stockholm, Sweden).
5 .\" All rights reserved.
7 .\" Redistribution and use in source and binary forms, with or without
8 .\" modification, are permitted provided that the following conditions
11 .\" 1. Redistributions of source code must retain the above copyright
12 .\" notice, this list of conditions and the following disclaimer.
14 .\" 2. Redistributions in binary form must reproduce the above copyright
15 .\" notice, this list of conditions and the following disclaimer in the
16 .\" documentation and/or other materials provided with the distribution.
18 .\" 3. Neither the name of the Institute nor the names of its contributors
19 .\" may be used to endorse or promote products derived from this software
20 .\" without specific prior written permission.
22 .\" THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
23 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
26 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
41 .Nd examine and maintain the iprop log file
48 .Nm iprop-log truncate
49 .Oo Fl c Ar file \*(Ba Xo
50 .Fl Fl config-file= Ns Ar file
53 .Oo Fl r Ar string \*(Ba Xo
54 .Fl Fl realm= Ns Ar string
57 .Oo Fl K Ar integer \*(Ba Xo
58 .Fl Fl keep-entries= Ns Ar integer
61 .Oo Fl B Ar integer \*(Ba Xo
62 .Fl Fl max-bytes= Ns Ar integer
73 .Oo Fl c Ar file \*(Ba Xo
74 .Fl Fl config-file= Ns Ar file
77 .Oo Fl r Ar string \*(Ba Xo
78 .Fl Fl realm= Ns Ar string
93 .Op Fl Fl start-version= Ns Ar version-number
94 .Op Fl Fl end-version= Ns Ar version-number
95 .Oo Fl c Ar file \*(Ba Xo
96 .Fl Fl config-file= Ns Ar file
99 .Oo Fl r Ar string \*(Ba Xo
100 .Fl Fl realm= Ns Ar string
103 .Op Fl h | Fl Fl help
106 .Nm iprop-log last-version
107 .Oo Fl c Ar file \*(Ba Xo
108 .Fl Fl config-file= Ns Ar file
111 .Oo Fl r Ar string \*(Ba Xo
112 .Fl Fl realm= Ns Ar string
119 .Op Fl h | Fl Fl help
123 .Oo Fl c Ar file \*(Ba Xo
124 .Fl Fl config-file= Ns Ar file
127 .Oo Fl r Ar string \*(Ba Xo
128 .Fl Fl realm= Ns Ar string
131 .Op Fl h | Fl Fl help
137 .It Fl h , Fl Fl help
140 command can be one of the following:
141 .Bl -tag -width truncate
144 .It Fl c Ar file , Fl Fl config-file= Ns Ar file
146 .It Fl r Ar string , Fl Fl realm= Ns Ar string
150 .Fl Fl keep-entries= Ns Ar integer
154 .Fl Fl max-bytes= Ns Ar integer
164 is given, then the given, configured, or default log file will be
165 truncated and will start at version 1. This forces full propagations to
168 Otherwise the log will be truncated but some entries will be preserved,
173 options. The largest number of
175 entries that are available and fit in the given
177 option will be used. The
178 .Fl Fl keep-entries option defaults to 100, and the
180 option defaults to the
182 parameter in the configuration.
186 .It Fl c Ar file , Fl Fl config-file= Ns Ar file
190 .Fl Fl realm= Ns Ar string
203 Print out all entries in the given, configured, or default log file to
204 standard output. If the
206 option is used then don't lock the iprop log file. If the
208 option is used, then print the entries in reverse order
209 (this can be useful when the log is very large).
212 .It Fl Fl start-version= Ns Ar version-number
213 start replay with this version
215 .Fl Fl end-version= Ns Ar version-number
217 end replay with this version
218 .It Fl c Ar file , Fl Fl config-file= Ns Ar file
220 .It Fl r Ar string , Fl Fl realm= Ns Ar string
224 Replay the changes from specified entries (or all if none is specified)
225 in the given, configured, or default transaction log file to the
229 .It Fl c Ar file , Fl Fl config-file= Ns Ar file
231 .It Fl r Ar string , Fl Fl realm= Ns Ar string
239 prints the version of the last record in each of the given log files, or
240 the configured, or the default log file if none is given.
243 .It Fl c Ar file , Fl Fl config-file= Ns Ar file
245 .It Fl r Ar string , Fl Fl realm= Ns Ar string
249 Signals the ipropd-master daemon to send updates to slaves. Normally
250 kadmin does this every time it writes to the database, so this should