fs_symlinks(5)                                               fs_symlinks(5)
                          Tunable Kernel Parameters



 NAME    [Toc]    [Back]
      fs_symlinks - maximum number of symbolic links used to resolve a path
      name

 VALUES    [Toc]    [Back]
    Failsafe
      20

    Default    [Toc]    [Back]
      20

    Allowed values    [Toc]    [Back]
      The minimum value allowed is 20.  The maximum value allowed is 1024,
      or 1K.

      Specify a positive integer value.

 DESCRIPTION    [Toc]    [Back]
      The fs_symlinks tunable represents the maximum number of symbolic
      links followed by the kernel when resolving a path name.  Applications
      that create symbolic links and/or parse path names should also now use
      this limit represented by fs_symlinks to be consistent with the
      kernel.

    Who Is Expected to Change This Tunable?
      Anyone expecting to run applications using path names that may expand
      to a large number of symbolic links.

    Restrictions on Changing    [Toc]    [Back]
      None.  The fs_symlinks tunable is dynamic (tuning will take effect
      immediately on the running system).

    When Should the Value of This Tunable Be Raised?
      This tunable value should be raised when applications are expected to
      create and/or parse path names that may expand to a large number of
      symbolic links.

    What are the Side Effects of Raising the Value?
      None.

    When Should the Value of This Tunable Be Lowered?
      This value rarely needs to be lowered, unless there is a reason to
      limit the number of symbolic links in an expanded path name.

    What are the Side Effects of Lowering the Value?
      The kernel will not be able to resolve path names with more symbolic
      links than the limit represented by fs_symlinks.

    What Other Tunable Values Should Be Changed at the Same Time?
      None.




 Hewlett-Packard Company            - 1 -      HP-UX 11i Version 2: Sep 2004






 fs_symlinks(5)                                               fs_symlinks(5)
                          Tunable Kernel Parameters



 WARNINGS    [Toc]    [Back]
      All HP-UX kernel tunable parameters are release specific.  This
      parameter may be removed or have its meaning changed in future
      releases of HP-UX.

      NOTE: The define MAXSYMLINKS, traditionally defined in <sys/param.h>,
      is now obsolete and should not be used.  This limit (number of
      symbolics links that may be expanded in a path name) is now available
      to applications via this new tunable parameter, fs_symlinks.  The
      interfaces provided by the tunable infrastructure should be used to
      obtain the value of fs_symlinks.  At the application level, use the
      gettune(2) or kctune(1M) interface.  Applications using the
      MAXSYMLINKS define may not be consistent with the kernel.  The
      MAXSYMLINKS define will be removed in post-HP-UX 11i Version 2
      releases.

      Installation of optional kernel software, from HP or other vendors,
      may cause changes to tunable parameter values.  After installation,
      some tunable parameters may no longer be at the default or recommended
      values.  For information about the effects of installation on tunable
      values, consult the documentation for the kernel software being
      installed. For information about optional kernel software that was
      factory installed on your system, see HP-UX Release Notes at
      http://docs.hp.com.

 AUTHOR    [Toc]    [Back]
      fs_symlinks was developed by HP.

 SEE ALSO    [Toc]    [Back]
      kctune(1M), sam(1M), gettune(2), settune(2), ulimit(2), setrlimit(2),
      maxfiles_lim(5), nfile(5).


 Hewlett-Packard Company            - 2 -      HP-UX 11i Version 2: Sep 2004