pmconfig(1M)

NAME

     pmconfig - Configure the Power Management system

SYNOPSIS

     /usr/sbin/pmconfig [-r]

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.

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

     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
     containing  the error is used. If user does not have permis-
     sion to change Power Management and/or  suspend-resume  con-
     figuration,  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.