unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

nischttl(1)                      User Commands                     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 running.

       Setting a high  ttl value allows objects to stay persistent  in  caches
       for  a longer period of time and can improve performance. 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. Set-
       ting 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. Pass-
       word 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 implementation.

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



EXIT STATUS
       The following exit values are returned:

       0        Successful operation.



       1        Operation failed.



ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWnisu


SEE ALSO
       nis+(1),  nischgrp(1),  nischmod(1),  nischown(1), nisdefaults(1), nis-
       match(1), nis_objects(3NSL), attributes(5)

NOTES
       NIS+ might not be supported in future releases of the SolarisTM Operat-
       ing  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.



SunOS 5.10                        10 Dec 2001                      nischttl(1)