nischttl(1)

NAME

     nischttl - change the time to live value of a 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 until 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, or s to identify the  units  of
     time. See the examples below for usage.

     The command will fail if the master NIS+ server is not  run-
     ning.

     Setting a high  ttl value allows objects to stay  persistent
     in  caches  for a longer period of time and can improve per-
     formance. However, when an  object  changes,  in  the  worst
     case,  the  number  of  seconds  in this attribute must pass
     before that change is visible to all clients. Setting a  ttl
     value  of  0  means  that the object should not be cached at
     all.

     A high  ttl value is a week, a low  value  is  less  than  a
     minute. Password entries should have  ttl values of about 12
     hours (easily allows one password change per day),   entries
     in the RPC table can have  ttl values of several weeks (this
     information is effectively unchanging).

     Only directory and group objects are cached in  this  imple-
     mentation.

OPTIONS

     The following options are supported:

     -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

     Example 1: Changing the ttl of an Object

     The following example shows how to 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.

     example% nischttl 184000 object
     example% nischttl 1d12h object

     Example 2: Changing the ttl for a password Entry

     This example shows how to change the   ttl  for  a  password
     entry.

     example% nischttl 1h30m '[uid=99],passwd.org_dir'

     Example 3: Changing the ttl of Entries Pointed to by a Link

     The next two examples change  the   ttl  of  the  object  or
     entries pointed to by a link, and the  ttl of all entries in
     the hobbies table.

     example% nischttl -L 12h linkname

     example% nischttl 3600 '[],hobbies'

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   nisde-
           faults(1).

EXIT STATUS

     The following exit values are returned:

     0     Successful operation.

     1     Operation failed.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWnisu                    |
    |_____________________________|_____________________________|

SEE ALSO

     nis+(1),  nischgrp(1),  nischmod(1),   nischown(1),   nisde-
     faults(1), nismatch(1), nis_objects(3NSL), attributes(5)

NOTES

     NIS+ might not  be  supported  in  future  releases  of  the
     SolarisTM  Operating Environment. Tools to aid the migration
     from NIS+ to LDAP are available in the Solaris  9  operating
     environment.      For      more      information,      visit
     http://www.sun.com/directory/nisplus/transition.html.