send a Power Management event message
[ -ha ]
[ -f pmspecial ]
[ -e eventsfile ] ...
class/type [ other ] ...
Power Management (PM) messages are sent using
An event (class/type), defined by a
is addressed from the process running pwrsend
and addressed to each of the specified destinations.
The options include:
Each destination address has one of the forms:
This message should be serviced by all addressed destinations,
not just the first which receives it.
A file defining some PM events. As many -e
options as necessary can be specified to define all relevant
PM events. If no -e options are specified,
then the default eventsfile(s) are those in the comma
(,) separated list defined by EVENTS in
/etc/default/pwr, or /etc/pwr/sys/events
when no list is defined.
The eventsfile format is described in
special file to which pwrsend sends PM events.
The default is /dev/pwr/pm. At most one -f
option can be specified.
This message is high-priority.
There must be at least one destination.
The maximum number of destinations depends on
the total size of the destination addresses.
apm=class , unit
The firmware identified by a BIOS-APM number:
either by a single direct identifier (device),
or via an implied identity (class plus unit).
The device is a complete peripheral identifier:
A class is a BIOS-APM firmware-defined
category of peripheral:
The entire system.
The BIOS-APM firmware itself.
The unit is one or more peripherals defined by the
BIOS-APM firmware within that class:
Video screen and keyboard (
Parallel I/O devices (
Serial I/O devices (
Hard and floppy discs (
Miscellaneous parts, including the CPU itself and the
BIOS-APM firmware (
which identifies a firmware-dependent peripheral category.
Every peripheral of that class.
A number, value,
which is mapped by the firmware to one or more peripherals in
The specified block (bdev) or character (cdev)
device with the same device number as file special;
or with the specified major and minor device
numbers. A major or minor of any
means all devices with a matching minor or major
device number (respectively).
major may be the internal name defined in the
first field, xnamex, of
of an installed driver,
meaning the major device number of that driver should be
action string, or the device driver or STREAMS
module with internal name string.
``Any'' process (typically meaning the
daemon) or just the process with
All STREAMS modules (any),
or just the STREAMS module identified by modid.
The event sent is defined in one of
argument is a longword appended to the event.
The values depend on the event and destinations.
Numeric values prefixed with
are assumed octal;
otherwise the number is assumed to be decimal.
A suffix of
multiplies by 1MB (1024 × 1024);
pwrsend is typically run by
This example sends event foo/bar with additional hexadecimal data
``0x65666966'' back the STREAMS pipe connected to
pwrd for the daemon itself to service:
pwrsend -f "$3" pid=$PWRD_PID foo/bar 0x65666966
BIOS-APM firmware from different manufacturers varies
considerably in both operation and efficacy.
What may be a safe or useful sequence of commands on one
machine may be ineffectual or worse on another.
It should be possible to specify the source address.
Typically, this is not the
process itself but its parent process (usually the script running
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003