pmconfig

 

---

 


 NAME
      pmconfig - Configure the Power Management system
 


 SYNOPSIS
      /usr/sbin/pmconfig [ -r ] | [ -f file ]
 


 DESCRIPTION
      The  pmconfig  utility  sets  the   Power   Management   and
      suspend-resume  configuration. User has permission to change
      Power Management configuration using pmconfig only if he  is
      allowed  to  do  so  according  to  PMCHANGEPERM  keyword of
      /etc/default/power.  User  has  permission  to  change   the
      suspend-resume   configuration  using pmconfig only if he is
      allowed to do so according to the CPRCHANGEPERM  keyword  of
      /etc/default/power.   See FILES section below for a descrip-
      tion of the  PMCHANGEPERM  and  CPRCHANGEPERM   keywords  of
      /etc/default/power.
 
      Based on user permissions, pmconfig first resets the   Power
      Management   and/or    suspend-resume   state  back  to  its
      default and then reads  the  new   Power  Management  and/or
      suspend-resume    configuration   from  /etc/power.conf  and
      issues the commands to activiate the new configuration.  The
      pmconfig  utility  is  run  at system boot. This utility can
      also be run from the command line after manual changes  have
      been  made  to the /etc/power.conf file. For editing changes
      made to the  /etc/power.conf file to take effect, users must
      run pmconfig.
 
      The preferred interface for changing  Power  Management  and
      suspend-resume configuration is dtpower(1M).
 


 OPTIONS
      The following options are supported:
 
      -r     Reset  Power Management and suspend-resume  state  to
            default  and  exit. User must have both  Power Manage-
            ment and suspend-resume  configuration permission  for
            this option.
 
      -f file
            Based on user permissions, pmconfig first resets  the
            Power  Management and/or  suspend-resume state back to
            its default and then reads the new   Power  Management
            and/or  suspend-resume configuration from file  instead  
            of  /etc/power.conf and issues the commands to activate 
            the new configuration. If pmconfig was successful  in  
            setting  the Power  Management  and/or   suspend-resume  
            configuration, the corresponding configuration in
            /etc/power.conf  is replaced with the configuration in
            file.
 


 EXIT STATUS
      The following exit values are returned:
 
      0     Upon successful completion
 
      >0    An error occurred
 


 FILES
      /etc/power.conf
            System  Power Management configuration file
 
      /etc/default/power
            File that controls  permissions  for  system's   Power
            Management    and    suspend-resume    features.   The
            PMCHANGEPERM keyboard controls  the  Power  Management
            configuration  permissions,  while  the  CPRCHANGEPERM
            keyword controls  the   suspend-resume   configuration
            permissions.
 
      Allowed values are:
 
      all   Any user can change the configuration.
 
      -     No one except super-user can change the configuration.
 
      <user1, user2,...>
            A  user in this user list or a super-user  can  change
            the  configuration.  The  user  list is a space and/or
            comma (,) separated list. You must enclose the list in
            < and > characters.
 
      console-owner
            A  user who owns the system console device node  or  a
            super-user can change the configuration.
 
      The  default  values  are   PMCHANGEPERM=console-owner   and
      CPRCHANGEPERM=console-owner.
 


 ATTRIBUTES
      See attributes(5) for descriptions of the  following  attri-
      butes:
 
      ____________________________________________________________
     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
     |_____________________________|_____________________________|
     | Availability                | SUNWpmu                     |
     |_____________________________|_____________________________|
     | Interface stability         | Unstable                    |
     |_____________________________|_____________________________|
 
 


 SEE ALSO
      dtpower(1M),   powerd(1M),   power.conf(4),   attributes(5),
      cpr(7), pm(7D)
 
      Using Power Management
 


 DIAGNOSTICS
      If the program cannot open the configuration file, it prints
      an   error   message  to  standard  error.  If  the  program
      encounters a syntax error  in  the  configuration  file,  it
      prints  an error message and the line number of the error in
      the  configuration file. It  then  skips  the  rest  of  the
      information  on  that  line and processes the next line. Any
      configuration information already processed on the line con-
      taining  the error is used. If user does not have permission
      to change Power Management and/or  suspend-resume configura-
      tion,  and  configuration  file  has  entries for which user
      doesn't have permission, it process the  entries  for  which
      user has permissions and prints error on rest.
 
 
 
 
 SunOS 5.8           Last change: 15 Sep 1999                    3
 
 
 

---