xref: /illumos-gate/usr/src/man/man8/tnd.8 (revision 6dde88b51419b99fe0aab8e56184c693945826b8)
te
Copyright (c) 2008, 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]
TND 8 "May 15, 2008"
NAME
tnd - trusted network daemon
SYNOPSIS

/usr/sbin/tnd [-p poll-interval]
DESCRIPTION

The tnd (trusted network daemon) initializes the kernel with trusted network databases and also reloads the databases on demand from an LDAP server and local files. tnd follows the order specified in the nsswitch.conf file when loading configuration databases. tnd is started at the beginning of the boot process.

tnd loads two databases into the kernel: the remote host database, tnrhdb and the remote-host template database, tnrhtp. These databases and their effect on the trusted network are described in their respective man pages. When the associated LDAP database or local databases are changed, tnd also updates the local kernel cache at the predetermined interval.

If a local trusted networking database file is modified, the administrator should run tnchkdb(8) to check the syntax, and should also run svcadm refresh svc:/network/tnd to initiate an immediate database scan by tnd.

tnd is intended to be started from an smf(7) script and to run in the global zone. The following signals cause specific svcadm actions: SIGHUP

Causes svcadm refresh svc:/network/tnd to be run. Initiates a rescan of the local and LDAP tnrhdb and tnrhtp databases. tnd updates the kernel database with any changes found.

SIGTERM

Causes svcadm disable svc:/network/tnd to be run. Terminates the tnd daemon. No changes are made to the kernel database.

Running tnd in debug mode is determined by the value of the following service management facility (SMF) property:

tnd/debug_level = 0

A value of 0, as above, prevents debug information from being collected; 1 turns on debugging. The default value is 0. Debug output is sent to the /var/tsol/tndlog log file.

OPTIONS
-p poll-interval

Set poll interval to poll-interval seconds. The default poll-interval is 1800 seconds (30 minutes).

EXAMPLES

Example 1 Changing the Poll Interval

The following command changes the polling interval to one hour, and puts this interval in the SMF repository. At the next boot, the tnd poll interval will be one hour.

# svccfg -s network/tnd setprop tnd/poll_interval=3600

The following command changes the polling interval, but does not update the repository. At the next boot, the tnd poll interval remains the default, 30 minutes.

# tnd -p 3600
FILES
/etc/security/tsol/tnrhdb

Trusted network remote-host database

/etc/security/tsol/tnrhtp

Trusted network remote-host templates

/etc/security/tsol/tnzonecfg

Trusted zone configuration database

/etc/nsswitch.conf

Configuration file for the name service switch

ATTRIBUTES

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

ATTRIBUTE TYPE ATTRIBUTE VALUE
Interface Stability See below.

The command invocation is Committed. The service is Private.

SEE ALSO

svcs (1), nsswitch.conf (5), attributes (7), smf (7), svcadm (8), tnchkdb (8), tnctl (8), tninfo (8)

How to Synchronize Kernel Cache With Network Databases in Solaris Trusted Extensions Administrator's Procedures

NOTES

The functionality described on this manual page is available only if the system is configured with Trusted Extensions.

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

svc:/network/tnd

The service's status can be queried by using svcs(1). Administrative actions on this service, such as requests to restart the daemon, can be performed using svcadm(8), as in:

svcadm restart svc:/network/tnd