The
halt( )
entry point routine is called at system shutdown time
to do any cleanup that is necessary before
the kernel shutdown occurs.
Arguments
None
Return values
None
Usage
Use the
halt( )
routine to set or clear device registers
so that devices are ready for initialization
after a warm boot.
Be sure that all hardware and hardware controllers
are reset as they would be by a power cycle.
halt( )
is also commonly used to flush the cache
on the controller hardware for block I/O operations.
Context and synchronization
Blockable
context.
The driver can block but cannot do operations such as
copyout(D3)
that require access to
the requesting process's address space.
The
halt(D2)
entry point routine for DDI versions
prior to version 8 is identical to
the ODDI entry point routine.
For DDI 8 and later versions,
replace
halt( )
with a call to the CFG_SUSPEND
and CFG_REMOVE subfunctions of the
config(D2)
entry point routine.