share/man/man1m/kproplog.1m

   1 '\" te
   2 .\" Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH KPROPLOG 1M "Oct 29, 2015"
   7 .SH NAME
   8 kproplog \- display the contents of the Kerberos principal update log
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/sbin/kproplog\fR [\fB-h\fR | \fB-e\fR \fInum\fR]
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBkproplog\fR displays the contents of the Kerberos principal update log
  19 to standard output. This command can be used to keep track of the incremental
  20 updates to the principal database, which is enabled by default. The
  21 \fB/var/krb5/principal.ulog\fR file contains the update log maintained by the
  22 \fBkadmind\fR(1M) process on the master KDC server and the \fBkpropd\fR(1M)
  23 process on the slave KDC servers. When updates occur, they are logged to this
  24 file. Subsequently any KDC slave configured for incremental updates will
  25 request the current data from the master KDC and update their
  26 \fBprincipal.ulog\fR file with any updates returned.
  27 .sp
  28 .LP
  29 The \fBkproplog\fR command can only be run on a KDC server by someone with
  30 privileges comparable to the superuser. It will display update entries for that
  31 server only.
  32 .sp
  33 .LP
  34 If no options are specified, the summary of the update log is displayed. If
  35 invoked on the master, all of the update entries are also displayed. When
  36 invoked on a slave KDC server, only a summary of the updates are displayed,
  37 which includes the serial number of the last update received and the associated
  38 time stamp of the last update.
  39 .SH OPTIONS
  40 .sp
  41 .LP
  42 The following options are supported:
  43 .sp
  44 .ne 2
  45 .na
  46 \fB\fB-h\fR\fR
  47 .ad
  48 .RS 11n
  49 Display a summary of the update log. This information includes the database
  50 version number, state of the database, the number of updates in the log, the
  51 time stamp of the first and last update, and the version number of the first
  52 and last update entry.
  53 .RE
  54
  55 .sp
  56 .ne 2
  57 .na
  58 \fB\fB-e\fR\ \fInum\fR\fR
  59 .ad
  60 .RS 11n
  61 Display the last \fInum\fR update entries in the log. This is useful when
  62 debugging synchronization between KDC servers.
  63 .RE
  64
  65 .sp
  66 .ne 2
  67 .na
  68 \fB\fB-v\fR\fR
  69 .ad
  70 .RS 11n
  71 Display individual attributes per update. An example of the output generated
  72 for one entry:
  73 .sp
  74 .in +2
  75 .nf
  76 Update Entry
  77     Update serial # : 4
  78     Update operation : Add
  79     Update principal : test@EXAMPLE.COM
  80     Update size : 424
  81     Update committed : True
  82     Update time stamp : Fri Feb 20 23:37:42 2004
  83     Attributes changed : 6
  84           Principal
  85           Key data
  86           Password last changed
  87           Modifying principal
  88           Modification time
  89           TL data
  90 .fi
  91 .in -2
  92
  93 .RE
  94
  95 .SH FILES
  96 .sp
  97 .ne 2
  98 .na
  99 \fB\fB/var/krb5/principal.ulog\fR\fR
 100 .ad
 101 .RS 28n
 102 The update log file for incremental propagation.
 103 .RE
 104
 105 .SH ATTRIBUTES
 106 .sp
 107 .LP
 108 See \fBattributes\fR(5) for descriptions of the following attributes:
 109 .sp
 110
 111 .sp
 112 .TS
 113 box;
 114 c | c
 115 l | l .
 116 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 117 _
 118 Interface Stability     Evolving
 119 .TE
 120
 121 .SH SEE ALSO
 122 .sp
 123 .LP
 124 \fBkpasswd\fR(1), \fBkadmin\fR(1M), \fBkadmind\fR(1M),
 125 \fBkdb5_util\fR(1M), \fBkprop\fR(1M), \fBkpropd\fR(1M), \fBkadm5.acl\fR(4),
 126 \fBkdc.conf\fR(4), \fBattributes\fR(5), \fBkerberos\fR(5)