doc/rst_source/krb_admins/admin_commands/kproplog.rst

   1 .. _kproplog(8):
   2
   3 kproplog
   4 ===========
   5
   6
   7 SYNOPSIS
   8 ------------
   9
  10 **kproplog** [**-h**] [**-e** *num*] [-v]
  11
  12 DESCRIPTION
  13 ------------
  14
  15 The *kproplog* command displays the contents of the Kerberos principal update log to standard output.
  16 It can be used to keep track of the incremental updates to the principal database, when enabled.
  17 The update log file contains the update log maintained by the *kadmind* process on the master KDC server and the *kpropd* process on the slave KDC servers.
  18 When updates occur, they are logged to this file.
  19 Subsequently any KDC slave configured for incremental updates will request the current data from the master KDC and update their *principal.ulog* file with any updates returned.
  20
  21 The *kproplog* command can only be run on a KDC server by someone with privileges comparable to the superuser.
  22 It will display update entries for that server only.
  23
  24 If no options are specified, the summary of the update log is displayed.
  25 If invoked on the master, all of the update entries are also displayed.
  26 When invoked on a slave KDC server, only a summary of the updates are displayed, which includes the serial number of the last update received and the associated time stamp of the last update.
  27
  28 OPTIONS
  29 ------------
  30
  31        **-h**
  32              Display a summary of the update log. This information includes the database version number, state of the database,
  33              the number of updates in the log, the time stamp of the first and last update, and the version number of the first and last update entry.
  34
  35        **-e** *num*
  36              Display the last *num* update entries in the log.  This is useful when debugging synchronization between KDC servers.
  37
  38        **-v**
  39              Display individual attributes per update.  An example of the output generated for one entry::
  40
  41                Update Entry
  42                   Update serial # : 4
  43                   Update operation : Add
  44                   Update principal : test@EXAMPLE.COM
  45                   Update size : 424
  46                   Update committed : True
  47                   Update time stamp : Fri Feb 20 23:37:42 2004
  48                   Attributes changed : 6
  49                         Principal
  50                         Key data
  51                         Password last changed
  52                         Modifying principal
  53                         Modification time
  54                         TL data
  55
  56 SEE ALSO
  57 ------------
  58
  59 kpropd(8)
  60