settune man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

settune(2)							    settune(2)

NAME
       settune() - set the value of a kernel tunable parameter

SYNOPSIS
DESCRIPTION
       This function sets the value of the kernel tunable parameter named tun‐
       able to the supplied value.  This new value takes  effect  immediately,
       except in the cases noted below.

       Some  parameters cannot be changed without rebooting the kernel.	 These
       parameters cannot be changed using

       Some parameters represent limits on resources that can be  consumed  by
       individual  processes.	In general, changes to these parameters do not
       affect processes that are running at the time the change is made;  they
       affect  only  new  programs  started (with or an equivalent) after that
       time.  Some specific parameters may be exceptions to this general rule;
       see the man pages for those parameters for details.

       Valid values for the flags parameter and their connotations are:
	      The value of the tunable parameter is set by the kernel.	The
		     value parameter to is ignored.

	      Sets the tunable parameter to the
		     value and turns off any automatic tuning done by the ker‐
		     nel.

       The call can give information about whether or not changes to a parame‐
       ter  are	 allowed or will require a reboot.  Some individual parameters
       may have specific notes regarding their behavior when changed;  consult
       the parameter man pages for details on each specific parameter.

   Security Restrictions
       The  actions  associated	 with  this system call require the privilege.
       Processes owned by the superuser have this privilege.  Processes	 owned
       by  other users may have this privilege, depending on system configura‐
       tion.  See privileges(5) for more information about  privileged	access
       on systems that support fine-grained privileges.

RETURN VALUE
       This function returns one of the following values:

	      The value of the specified parameter has been changed.

	      The  function  did  not complete successfully.  The value of the
	      specified
			     parameter has not been changed.

ERRORS
       If this function returns to indicate an error, the global variable will
       be  set	to  one	 of  the  following  values to indicate the error that
       occurred:

	      The specified tunable parameter does not exist.

	      tunable	     specifies an address that is inaccessible.

	      The caller does not have the
			     privilege.

	      The specified value is not within the acceptable range  for  the
	      specified
			     parameter.

	      The value of the parameter could not be changed immediately.

	      The  specified parameter cannot be changed without rebooting the
	      kernel.

	      The Kernel Registry Service was unavailable  or  encountered  an
	      error.

	      Insufficient memory to accommodate the new parameter value.

WARNINGS
       It  is possible to seriously degrade system performance, or even render
       a system unbootable, with incorrect tunable settings.   Use  care  when
       setting	tunable values.	 Always have a known working kernel configura‐
       tion saved as a backup; if the system fails to  boot  after  a  tunable
       change,	boot from that backup kernel configuration.  Keep good records
       of all tunable changes so that they can be  reversed  if	 they  degrade
       system performance.  Tunable changes made with are automatically logged
       to

       If the tunable being changed through is used in	expressions  that  set
       the  values  of other tunables, those expressions will not be re-evalu‐
       ated and those tunable values will not  be  updated.   Note  that  this
       behavior may change in future releases of HP-UX.	 If expression evalua‐
       tion is desired, use to set tunable values.

       Changes to parameter values made with may not remain  effective	across
       reboots.	  Note that this behavior may change in future releases of HP-
       UX.  If persistence across reboots is desired, use to set tunable  val‐
       ues.

AUTHOR
       was developed by Hewlett-Packard Company.

SEE ALSO
       kctune(1M), mk_kernel(1M), gettune(2), tuneinfo2(2), privileges(5), and
       the individual tunable parameter man pages in section 5.

								    settune(2)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net