xref: /illumos-gate/usr/src/man/man8/kpropd.8 (revision dd72704bd9e794056c558153663c739e2012d721)
te
Copyright 1987, 1989 by the Student Information Processing Board of the Massachusetts Institute of Technology. For copying and distribution information, please see the file kerberosv5/mit-sipb-copyright.h.
Portions Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.
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.
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.
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]
KPROPD 8 "Jul 11, 2005"
NAME
kpropd - Kerberos propagation daemon for slave KDCs
SYNOPSIS

/usr/lib/krb5/kpropd [-d] [-f temp_dbfile] [-F dbfile]
 [-p kdb_util] [-P port_number] [-r realm]
 [-s srv_tabfile] [-S] [-a acl_file]
DESCRIPTION

The kpropd command runs on the slave KDC server. It listens for update requests made by kprop(8) from the master KDC and periodically requests incremental updates from the master KDC.

When the slave receives a kprop request from the master, kpropd copies principal data to a temporary text file. Next, kpropd invokes kdb5_util(8) (unless a different database utility is selected) to load the text file in database format.

When the slave periodically requests incremental updates, kpropd update its principal.ulog file with any updates from the master. kproplog(8) can be used to view a summary of the update entry log on the slave KDC.

kpropd is not configured for incremental database propagation by default. These settings can be changed in the kdc.conf(5) file: sunw_dbprop_enable = [true | false]

Enables or disables incremental database propagation. Default is false.

sunw_dbprop_slave_poll = N[s, m, h]

Specifies how often the slave KDC polls for any updates that the master might have. Default is 2m (two minutes).

The kiprop/<hostname>@<REALM> principal must exist in the slave's keytab file to enable the master to authenticate incremental propagation requests from the slave. In this syntax, <hostname> is the slave KDC's host name and <REALM> is the realm in which the slave KDC resides.

OPTIONS

The following options are supported: -d

Enable debug mode. Default is debug mode disabled.

-f temp_dbfile

The location of the slave's temporary principal database file. Default is /var/krb5/from_master.

-F dbfile

The location of the slave's principal database file. Default is /var/krb5/principal.

-p kdb_util

The location of the Kerberos database utility used for loading principal databases. Default is /usr/sbin/kdb5_util.

-P port_number

Specifies the port number on which kpropd will listen. Default is 754 (service name: krb5_prop).

-r realm

Specifies from which Kerberos realm kpropd will receive information. Default is specified in /etc/krb5/krb5.conf.

-s srv_tabfile

The location of the service table file used to authenticate the kpropd daemon.

-S

Run the daemon in standalone mode, instead of having inetd listen for requests. Default is non-standalone mode.

-a acl_file

The location of the kpropd's access control list to verify if this server can run the kpropd daemon. The file contains a list of principal name(s) that will be receiving updates. Default is /etc/krb5/kpropd.acl.

FILES
/var/krb5/principal

Kerberos principal database.

/var/krb5/principal.ulog

The update log file.

/etc/krb5/kdc.conf

KDC configuration information.

/etc/krb5/kpropd.acl

List of principals of all the KDCs; resides on each slave KDC.

/var/krb5/from_master

Temporary file used by kpropd before loading this to the principal database.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
Interface Stability Evolving
SEE ALSO

kdc.conf (5), krb5.conf (5), attributes (7), kerberos (7), kdb5_util (8), kprop (8), kproplog (8)

NOTES

The kprop service is managed by the service management facility, smf(7), under the service identifier:

svc:/network/security/krb5_prop:default

Administrative actions on this service, such as enabling, disabling, or requesting restart, can be performed using svcadm(8). Responsibility for initiating and restarting this service is delegated to inetd(8). Use inetadm(8) to make configuration changes and to view configuration information for this service. The service's status can be queried using the svcs(1) command.