crypto/dist/heimdal/lib/kadm5/iprop-log.8

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