HP-UX Reference (11i v1 05/09) - 1 User Commands N-Z (vol 2)

n
nischttl(1) nischttl(1)
NAME
nischttl - change the time to live value of an NIS+ object
SYNOPSIS
nischttl [ -AfLP ] time name ...
DESCRIPTION
nischttl changes the time to live value (
ttl) of the NIS+ objects or entries specified by name to time.
Entries are specified using indexed names (see nismatch(1)).
The time to live value is used by object caches to expire objects within their cache. When an object is read
into the cache, this value is added to the current time in seconds yielding the time when the cached object
would expire. The object may be returned from the cache as long as the current time is earlier than the
calculated expiration time. When the expiration time has been reached, the object will be flushed from the
cache.
The time to live time may be specified in seconds or in days, hours, minutes, seconds format. The latter
format uses a suffix letter of
d, h, m,ors to identify the units of time. See the examples below for usage.
The command will fail if the master NIS+ server is not running.
Options
-A Modify all tables in the concatenation path that match the search criterion specified in name. This
option implies the
-P switch.
-f Force the operation and fail silently if it does not succeed.
-L Follow links and change the time to live of the linked object or entries rather than the time to live of
the link itself.
-P Follow the concatenation path within a named table. This option only makes sense when either name
is an indexed name or the
-L switch is also specified and the named object is a link pointing to
entries.
EXAMPLES
Change the ttl of an object using the seconds format and the days, hours, minutes, seconds format (the
ttl of the second object is set to 1 day and 12 hours):
nischttl 184000 object
nischttl 1d12h object
Change the ttl for a password entry:
nischttl 1h30m ’[uid=99],passwd.org_dir’
Change the ttl of the object or entries pointed to by a link, and the ttl
of all entries in the hobbies
table:
nischttl -L 12h linkname
nischttl 3600 ’[],hobbies’
EXTERNAL INFLUENCES
Environment Variables
NIS_PATH If this variable is set and the NIS+ name is not fully qualified, each directory specified will
be searched until the object is found (see nisdefaults(1)).
RETURN VALUE
nischttl returns 0 on success and 1 on failure.
WARNINGS
HP-UX 11i Version 2 is the last HP-UX release on which NIS+ is supported.
LDAP is the recommended replacement for NIS+. HP fully supports the industry standard naming ser-
vices based on LDAP.
AUTHOR
nischttl was developed by Sun Microsystems, Inc.
Section 1−−622 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005