kproplog.8 3.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115
  1. .\" Man page generated from reStructuredText.
  2. .
  3. .TH "KPROPLOG" "8" " " "1.20.1" "MIT Kerberos"
  4. .SH NAME
  5. kproplog \- display the contents of the Kerberos principal update log
  6. .
  7. .nr rst2man-indent-level 0
  8. .
  9. .de1 rstReportMargin
  10. \\$1 \\n[an-margin]
  11. level \\n[rst2man-indent-level]
  12. level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
  13. -
  14. \\n[rst2man-indent0]
  15. \\n[rst2man-indent1]
  16. \\n[rst2man-indent2]
  17. ..
  18. .de1 INDENT
  19. .\" .rstReportMargin pre:
  20. . RS \\$1
  21. . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
  22. . nr rst2man-indent-level +1
  23. .\" .rstReportMargin post:
  24. ..
  25. .de UNINDENT
  26. . RE
  27. .\" indent \\n[an-margin]
  28. .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
  29. .nr rst2man-indent-level -1
  30. .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
  31. .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
  32. ..
  33. .SH SYNOPSIS
  34. .sp
  35. \fBkproplog\fP [\fB\-h\fP] [\fB\-e\fP \fInum\fP] [\-v]
  36. \fBkproplog\fP [\-R]
  37. .SH DESCRIPTION
  38. .sp
  39. The kproplog command displays the contents of the KDC database update
  40. log to standard output. It can be used to keep track of incremental
  41. updates to the principal database. The update log file contains the
  42. update log maintained by the kadmind(8) process on the primary
  43. KDC server and the kpropd(8) process on the replica KDC
  44. servers. When updates occur, they are logged to this file.
  45. Subsequently any KDC replica configured for incremental updates will
  46. request the current data from the primary KDC and update their log
  47. file with any updates returned.
  48. .sp
  49. The kproplog command requires read access to the update log file. It
  50. will display update entries only for the KDC it runs on.
  51. .sp
  52. If no options are specified, kproplog displays a summary of the update
  53. log. If invoked on the primary, kproplog also displays all of the
  54. update entries. If invoked on a replica KDC server, kproplog displays
  55. only a summary of the updates, which includes the serial number of the
  56. last update received and the associated time stamp of the last update.
  57. .SH OPTIONS
  58. .INDENT 0.0
  59. .TP
  60. \fB\-R\fP
  61. Reset the update log. This forces full resynchronization. If
  62. used on a replica then that replica will request a full resync.
  63. If used on the primary then all replicas will request full
  64. resyncs.
  65. .TP
  66. \fB\-h\fP
  67. Display a summary of the update log. This information includes
  68. the database version number, state of the database, the number of
  69. updates in the log, the time stamp of the first and last update,
  70. and the version number of the first and last update entry.
  71. .TP
  72. \fB\-e\fP \fInum\fP
  73. Display the last \fInum\fP update entries in the log. This is useful
  74. when debugging synchronization between KDC servers.
  75. .TP
  76. \fB\-v\fP
  77. Display individual attributes per update. An example of the
  78. output generated for one entry:
  79. .INDENT 7.0
  80. .INDENT 3.5
  81. .sp
  82. .nf
  83. .ft C
  84. Update Entry
  85. Update serial # : 4
  86. Update operation : Add
  87. Update principal : test@EXAMPLE.COM
  88. Update size : 424
  89. Update committed : True
  90. Update time stamp : Fri Feb 20 23:37:42 2004
  91. Attributes changed : 6
  92. Principal
  93. Key data
  94. Password last changed
  95. Modifying principal
  96. Modification time
  97. TL data
  98. .ft P
  99. .fi
  100. .UNINDENT
  101. .UNINDENT
  102. .UNINDENT
  103. .SH ENVIRONMENT
  104. .sp
  105. See kerberos(7) for a description of Kerberos environment
  106. variables.
  107. .SH SEE ALSO
  108. .sp
  109. kpropd(8), kerberos(7)
  110. .SH AUTHOR
  111. MIT
  112. .SH COPYRIGHT
  113. 1985-2022, MIT
  114. .\" Generated by docutils manpage writer.
  115. .