Man page generated from reStructuredText..
.
.nr rst2man-indent-level 0
.
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.rstReportMargin pre:. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.rstReportMargin post:..
. RE
indent \\n[an-margin] old: \\n[rst2man-indent\\n[rst2man-indent-level]].nr rst2man-indent-level -1
new: \\n[rst2man-indent\\n[rst2man-indent-level]]..
"KPROPD" "8" " " "1.22.1" "MIT Kerberos"
NAME
kpropd - Kerberos V5 replica KDC update server
SYNOPSIS
kpropd
[
-r realm]
[
-A admin_server]
[
-a acl_file]
[
-f replica_dumpfile]
[
-F principal_database]
[
-p kdb5_util_prog]
[
-P port]
[
--pid-file=
pid_file]
[
-D]
[
-d]
[
-s keytab_file]
DESCRIPTION
The
kpropd command runs on the replica KDC server. It listens for
update requests made by the
\%kprop program. If incremental
propagation is enabled, it periodically requests incremental updates
from the primary KDC.
When the replica receives a kprop request from the primary, kpropd
accepts the dumped KDC database and places it in a file, and then runs
\%kdb5_util to load the dumped database into the active
database which is used by
\%krb5kdc. This allows the primary
Kerberos server to use
\%kprop to propagate its database to
the replica servers. Upon a successful download of the KDC database
file, the replica Kerberos server will have an up-to-date KDC
database.
Where incremental propagation is not used, kpropd is commonly invoked
out of inetd(8) as a nowait service. This is done by adding a line to
the
/etc/inetd.conf file which looks like this:
NDENT 0.0 NDENT 3.5 .EX
kprop stream tcp nowait root /
usr/
local/
sbin/
kpropd kpropd
NINDENT NINDENT kpropd can also run as a standalone daemon, backgrounding itself and
waiting for connections on port 754 (or the port specified with the
-P option if given). Standalone mode is required for incremental
propagation. Starting in release 1.11, kpropd automatically detects
whether it was run from inetd and runs in standalone mode if it is
not. Prior to release 1.11, the
-S option is required to run
kpropd in standalone mode; this option is now accepted for backward
compatibility but does nothing.
Incremental propagation may be enabled with the
iprop_enable
variable in
\%kdc.conf. If incremental propagation is
enabled, the replica periodically polls the primary KDC for updates, at
an interval determined by the
iprop_replica_poll variable. If the
replica receives updates, kpropd updates its log file with any updates
from the primary.
\%kproplog can be used to view a summary of
the update entry log on the replica KDC. If incremental propagation
is enabled, the principal
kiprop/replicahostname@REALM (where
replicahostname is the name of the replica KDC host, and
REALM is
the name of the Kerberos realm) must be present in the replica\(aqs
keytab file.
\%kproplog can be used to force full replication when iprop is
enabled.
OPTIONS
NDENT 0.0
-r realm
Specifies the realm of the primary server.
-A admin_server
Specifies the server to be contacted for incremental updates; by
default, the primary admin server is contacted.
-f file
Specifies the filename where the dumped principal database file is
to be stored; by default the dumped database file is @LOCALSTATEDIR@/krb5kdc/from_master.
-F kerberos_db
Path to the Kerberos database file, if not the default.
-p
Allows the user to specify the pathname to the \%kdb5_util
program; by default the pathname used is @SBINDIR@/kdb5_util.
-D
In this mode, kpropd will not detach itself from the current job
and run in the background. Instead, it will run in the
foreground.
-d
Turn on debug mode. kpropd will print out debugging messages
during the database propogation and will run in the foreground
(implies -D).
-P
Allow for an alternate port number for kpropd to listen on. This
is only useful in combination with the -S option.
-a acl_file
Allows the user to specify the path to the kpropd.acl file; by
default the path used is @LOCALSTATEDIR@/krb5kdc/kpropd.acl.
--pid-file=pid_file
In standalone mode, write the process ID of the daemon into
pid_file.
-s keytab_file
Path to a keytab to use for acquiring acceptor credentials.
-x db_args
Database-specific arguments. See \%Database Options in \%kadmin for supported arguments.
NINDENT
FILES
NDENT 0.0
kpropd.acl Access file for kpropd; the default location is
/usr/local/var/krb5kdc/kpropd.acl. Each entry is a line
containing the principal of a host from which the local machine
will allow Kerberos database propagation via \%kprop.
NINDENT
ENVIRONMENT
See
\%kerberos for a description of Kerberos environment
variables.
SEE ALSO
\%kprop,
\%kdb5_util,
\%krb5kdc,
\%kerberos, inetd(8)
AUTHOR
MIT
COPYRIGHT
1985-2025, MIT
Generated by docutils manpage writer..