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

   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
  85 Supported options:
  86 .Bl -tag -width Ds
  87 .It Fl Fl version
  88 .It Fl h , Fl 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 Fl config-file= Ns Ar file
  96 configuration file
  97 .It Fl r Ar string , Fl 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 Fl config-file= Ns Ar file
 107 configuration file
 108 .It Xo
 109 .Fl r Ar string ,
 110 .Fl Fl realm= Ns Ar string
 111 .Xc
 112 realm
 113 .El
 114 .Pp
 115 Print 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
 119 start replay with this version
 120 .It Xo
 121 .Fl Fl end-version= Ns Ar version-number
 122 .Xc
 123 end replay with this version
 124 .It Fl c Ar file , Fl Fl config-file= Ns Ar file
 125 configuration file
 126 .It Fl r Ar string , Fl Fl realm= Ns Ar string
 127 realm
 128 .El
 129 .Pp
 130 Replay the changes from specified entries (or all if none is
 131 specified) 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
 135 configuration file
 136 .It Fl r Ar string , Fl Fl realm= Ns Ar string
 137 realm
 138 .El
 139 .Pp
 140 prints the version of the last log entry.
 141 .El
 142 .Sh SEE ALSO
 143 .Xr iprop 8