Main Page | File List | Globals

activate_firmware documentation

Copyright

Copyright (c) 2004 International Business Machines Common Public License Version 1.0 (see COPYRIGHT)

Overview

Simple command to call the "ibm,activate-firmware" rtas call via librtas.so

The return codes for this command are as follows:
0 - Success!!
1 - This platform doesn't support concurrent activation of firmware.
2 - There's no new firmware ready to activate (RTAS returned -9001).
3 - You must have root authority to run this command.
4 - Hardware failure (RTAS returned -1).
5 - Memory/resource allocation error.
6 - General error.

For the specific mappings of librtas and rtas_call return codes (librtas return codes are in all caps) to the return codes listed above see the switch statement in the code. There are two values that can be returned by the rtas call but are not explicitly handled below and are handled by the default case statement. These are -2 (busy, try again) and 990x (extended delay). The librtas module intercepts these return codes and handles them itself, they should never be returned from librtas.

Author:
Nathan Fontenot <nfont@austin.ibm.com>

Generated on Mon Nov 21 16:24:45 2005 for activate_firmware by doxygen 1.3.8