HP-UX Reference (11i v1 05/09) - 1M System Administration Commands A-M (vol 3)

h
hotplugd(1M) hotplugd(1M)
NAME
hotplugd - PCI I/O hotplug (attention button) events daemon
SYNOPSIS
/usr/sbin/hotplugd
logfile openmode
DESCRIPTION
The
hotplugd daemon handles PCI I/O hotplug (also known as attention button, AB, or doorbell) events
that are generated by pressing the attention button corresponding to a PCI I/O slot.
Only one attention button event is processed by the system at any point in time. If more than one atten-
tion button is pressed, the events are put in a queue within the kernel.
This daemon invokes /usr/bin/olrad
to perform the various online addition or replacement opera-
tions (OLAR, OL*) on the slot on which the attention button has been pressed. The
Critical
Resources Analysis
(CRA) for the operation will be run from
/usr/bin/olrad.
/usr/bin/olrad
is only for internal use, and invoked only from the hotplugd
daemon.
The CRA checks for critical resources on all affected hardware paths associated with the specified slot, dur-
ing the OL* operation. It analyzes file systems, volumes, processes, networking, swap, and dump; and gen-
erates a report of affected resources. The CRA report will be logged in the
hotplugd
log file.
CRA lists the following severity levels.
CRA_SUCCESS no affected resources in use.
CRA_WARNINGS resources in use on affected device(s) but none are deemed critical.
CRA_DATA_CRITICAL probable data loss, only proceed with the user’s permission.
CRA_SYS_CRITICAL likely to bring down the user’s system.
CRA_ERROR some internal CRA error encountered.
Normally, hotplugd daemon is started by the
/sbin/init.d/pci_olar
startup script. See the Dae-
mon Startup subsection for details. Superuser privileges are necessary for the daemon Startup and Shut-
down.
If an attention button is pressed before the startup of the daemon, the event is dropped and no messages
are logged. Also see the DIAGNOSTICS section for messages that are logged in the system log file or the
hotplugd log file.
Currently, only the online addition and replacement functions are supported. Online deletion is not sup-
ported.
The blinking of the power LED is not supported on all hardware platforms.
During the attention button initiated operations, the power LED could remain in a blinking state under
certain situations. The /usr/bin/rad option -P could be used to RAIL the power led. See rad(1M).
Operands
The following operands are required. See also the Daemon Startup subsection.
logfile Log file where the daemon will log its messages. The standard output and standard error
of the
/usr/bin/olrad
command are also captured in this log file.
openmode Mode in which to open the logfile. It can be one of the following:
append Open the file in append mode. New log information is appended at the end of
logfile.
trunc Open the file and truncate it. If the logfile exists, its length is truncated to 0 and
the mode and owner are unchanged.
Daemon Startup
In the normal (and recommended) operation hotplugd is invoked through the startup script,
/sbin/init.d/pci_olar. The startup script reads the configuration file,
/etc/rc.config.d/pci_olar for the configuration file variables, HOTPLUGD_LOGFILE
and
HOTPLUGD_MODE, which are assigned to the logfile and openmode parameters, respectively. The installed
default values are:
HOTPLUGD_LOGFILE=/var/adm/hotplugd.log
HOTPLUGD_MODE=trunc
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1M−−317