ppm.conf revision 5cff782560a1c3cf913ba5574a5123a299f3315e
5cff782560a1c3cf913ba5574a5123a299f3315emh# CDDL HEADER START
5cff782560a1c3cf913ba5574a5123a299f3315emh# The contents of this file are subject to the terms of the
5cff782560a1c3cf913ba5574a5123a299f3315emh# Common Development and Distribution License (the "License").
5cff782560a1c3cf913ba5574a5123a299f3315emh# You may not use this file except in compliance with the License.
5cff782560a1c3cf913ba5574a5123a299f3315emh# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
5cff782560a1c3cf913ba5574a5123a299f3315emh# See the License for the specific language governing permissions
5cff782560a1c3cf913ba5574a5123a299f3315emh# and limitations under the License.
5cff782560a1c3cf913ba5574a5123a299f3315emh# When distributing Covered Code, include this CDDL HEADER in each
5cff782560a1c3cf913ba5574a5123a299f3315emh# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
5cff782560a1c3cf913ba5574a5123a299f3315emh# If applicable, add the following below this CDDL HEADER, with the
5cff782560a1c3cf913ba5574a5123a299f3315emh# fields enclosed by brackets "[]" replaced with your own identifying
5cff782560a1c3cf913ba5574a5123a299f3315emh# information: Portions Copyright [yyyy] [name of copyright owner]
5cff782560a1c3cf913ba5574a5123a299f3315emh# CDDL HEADER END
5cff782560a1c3cf913ba5574a5123a299f3315emh# Copyright 2007 Sun Microsystems, Inc. All rights reserved.
5cff782560a1c3cf913ba5574a5123a299f3315emh# Use is subject to license terms.
5cff782560a1c3cf913ba5574a5123a299f3315emh#pragma ident "%Z%%M% %I% %E% SMI"
5cff782560a1c3cf913ba5574a5123a299f3315emh# ppm configuration format
5cff782560a1c3cf913ba5574a5123a299f3315emh# "ppm-domains" - in form of "domain_xxx" where "xxx" string highlights
5cff782560a1c3cf913ba5574a5123a299f3315emh# the nature of the domain;
5cff782560a1c3cf913ba5574a5123a299f3315emh# "domain_xxx-model" - PM model: CPU
5cff782560a1c3cf913ba5574a5123a299f3315emh# "domain_xxx-propname" - a property name that is exported by device in
5cff782560a1c3cf913ba5574a5123a299f3315emh# a domain. Currently, it is used by PCI_PROP model to identify devices
5cff782560a1c3cf913ba5574a5123a299f3315emh# that are to have their clocks stopped when all power-manageable devices
5cff782560a1c3cf913ba5574a5123a299f3315emh# in the domain are at D3 power level.
5cff782560a1c3cf913ba5574a5123a299f3315emh# "domain-xxx-devices" - a list of prom path match patterns to match devices
5cff782560a1c3cf913ba5574a5123a299f3315emh# that fall into "domain_xxx", where wildcard '*' is allowed by observing
5cff782560a1c3cf913ba5574a5123a299f3315emh# the following expectations:
5cff782560a1c3cf913ba5574a5123a299f3315emh# . a single wildcard with exact match up to (but exclude) the wildcard
5cff782560a1c3cf913ba5574a5123a299f3315emh# which then terminates the match pattern;
5cff782560a1c3cf913ba5574a5123a299f3315emh# . a single wildcard that does not terminate a match pattern must
5cff782560a1c3cf913ba5574a5123a299f3315emh# match driver name (followed by '@');
5cff782560a1c3cf913ba5574a5123a299f3315emh# . with two wildcard occurences, the first is to match driver name,
5cff782560a1c3cf913ba5574a5123a299f3315emh# the second function id, as well as the last character of the match
5cff782560a1c3cf913ba5574a5123a299f3315emh# "domain-xxx-ctrl" - blank space separated definitions in the form of
5cff782560a1c3cf913ba5574a5123a299f3315emh# keyword=definition [keyword=definition...]
5cff782560a1c3cf913ba5574a5123a299f3315emh# The keywords are as follows, where 'method' must come before mask as it
5cff782560a1c3cf913ba5574a5123a299f3315emh# tells how to store 'mask' and 'val'. Missing 'val' defaults to 0.
5cff782560a1c3cf913ba5574a5123a299f3315emh# which keywords apply depends on cmd. There are two sets as shown below.
5cff782560a1c3cf913ba5574a5123a299f3315emh# Here is the first:
5cff782560a1c3cf913ba5574a5123a299f3315emh# cmd=[PCI_ON | PCI_OFF]
5cff782560a1c3cf913ba5574a5123a299f3315emh# path=<prompath> - control device's prom pathname (includes minor)
5cff782560a1c3cf913ba5574a5123a299f3315emh# method=[KIO|I2CKIO] This selects a method which may be
5cff782560a1c3cf913ba5574a5123a299f3315emh# an ioctl that sets a single value or an i2c ioctl that
5cff782560a1c3cf913ba5574a5123a299f3315emh# takes a value and a mask to access gpio register
5cff782560a1c3cf913ba5574a5123a299f3315emh# iord=<integer> - value of ioctl command for reading
5cff782560a1c3cf913ba5574a5123a299f3315emh# iowr=<integer> - value of ioctl command for writing
5cff782560a1c3cf913ba5574a5123a299f3315emh# val=<integer> - a single integer value, generally the value to which
5cff782560a1c3cf913ba5574a5123a299f3315emh# the relevant bits of a register will be set
5cff782560a1c3cf913ba5574a5123a299f3315emh# mask=<integer> - which bits of val are relevant (if method is I2CKIO)