2020-10-27 21:49:44 +08:00
|
|
|
What: /sys/class/firmware-attributes/*/attributes/*/
|
|
|
|
Date: February 2021
|
|
|
|
KernelVersion: 5.11
|
|
|
|
Contact: Divya Bharathi <Divya.Bharathi@Dell.com>,
|
|
|
|
Prasanth KSR <prasanth.ksr@dell.com>
|
2021-08-11 00:09:00 +08:00
|
|
|
Dell.Client.Kernel@dell.com
|
2020-10-27 21:49:44 +08:00
|
|
|
Description:
|
|
|
|
A sysfs interface for systems management software to enable
|
|
|
|
configuration capability on supported systems. This directory
|
|
|
|
exposes interfaces for interacting with configuration options.
|
|
|
|
|
|
|
|
Unless otherwise specified in an attribute description all attributes are optional
|
|
|
|
and will accept UTF-8 input.
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
type:
|
|
|
|
A file that can be read to obtain the type of attribute.
|
|
|
|
This attribute is mandatory.
|
2020-10-27 21:49:44 +08:00
|
|
|
|
|
|
|
The following are known types:
|
2020-10-29 17:31:23 +08:00
|
|
|
|
2020-10-27 21:49:44 +08:00
|
|
|
- enumeration: a set of pre-defined valid values
|
|
|
|
- integer: a range of numerical values
|
|
|
|
- string
|
|
|
|
|
|
|
|
All attribute types support the following values:
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
current_value:
|
|
|
|
A file that can be read to obtain the current
|
2020-10-27 21:49:44 +08:00
|
|
|
value of the <attr>.
|
|
|
|
|
|
|
|
This file can also be written to in order to update the value of a
|
|
|
|
<attr>
|
|
|
|
|
|
|
|
This attribute is mandatory.
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
default_value:
|
|
|
|
A file that can be read to obtain the default
|
2020-10-27 21:49:44 +08:00
|
|
|
value of the <attr>
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
display_name:
|
|
|
|
A file that can be read to obtain a user friendly
|
2020-10-27 21:49:44 +08:00
|
|
|
description of the at <attr>
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
display_name_language_code:
|
|
|
|
A file that can be read to obtain
|
2020-10-27 21:49:44 +08:00
|
|
|
the IETF language tag corresponding to the
|
|
|
|
"display_name" of the <attr>
|
|
|
|
|
|
|
|
"enumeration"-type specific properties:
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
possible_values:
|
|
|
|
A file that can be read to obtain the possible
|
2020-10-27 21:49:44 +08:00
|
|
|
values of the <attr>. Values are separated using
|
|
|
|
semi-colon (``;``).
|
|
|
|
|
|
|
|
"integer"-type specific properties:
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
min_value:
|
|
|
|
A file that can be read to obtain the lower
|
2020-10-27 21:49:44 +08:00
|
|
|
bound value of the <attr>
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
max_value:
|
|
|
|
A file that can be read to obtain the upper
|
2020-10-27 21:49:44 +08:00
|
|
|
bound value of the <attr>
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
scalar_increment:
|
|
|
|
A file that can be read to obtain the scalar value used for
|
2020-10-27 21:49:44 +08:00
|
|
|
increments of current_value this attribute accepts.
|
|
|
|
|
|
|
|
"string"-type specific properties:
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
max_length:
|
|
|
|
A file that can be read to obtain the maximum
|
2020-10-27 21:49:44 +08:00
|
|
|
length value of the <attr>
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
min_length:
|
|
|
|
A file that can be read to obtain the minimum
|
2020-10-27 21:49:44 +08:00
|
|
|
length value of the <attr>
|
|
|
|
|
|
|
|
Dell specific class extensions
|
2020-10-29 17:31:23 +08:00
|
|
|
------------------------------
|
2020-10-27 21:49:44 +08:00
|
|
|
|
|
|
|
On Dell systems the following additional attributes are available:
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
dell_modifier:
|
|
|
|
A file that can be read to obtain attribute-level
|
2020-10-27 21:49:44 +08:00
|
|
|
dependency rule. It says an attribute X will become read-only or
|
|
|
|
suppressed, if/if-not attribute Y is configured.
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
modifier rules can be in following format::
|
|
|
|
|
|
|
|
[ReadOnlyIf:<attribute>=<value>]
|
|
|
|
[ReadOnlyIfNot:<attribute>=<value>]
|
|
|
|
[SuppressIf:<attribute>=<value>]
|
|
|
|
[SuppressIfNot:<attribute>=<value>]
|
2020-10-27 21:49:44 +08:00
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
For example::
|
|
|
|
|
|
|
|
AutoOnFri/dell_modifier has value,
|
|
|
|
[SuppressIfNot:AutoOn=SelectDays]
|
2020-10-27 21:49:44 +08:00
|
|
|
|
|
|
|
This means AutoOnFri will be suppressed in BIOS setup if AutoOn
|
|
|
|
attribute is not "SelectDays" and its value will not be effective
|
|
|
|
through sysfs until this rule is met.
|
|
|
|
|
|
|
|
Enumeration attributes also support the following:
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
dell_value_modifier:
|
|
|
|
A file that can be read to obtain value-level dependency.
|
2020-10-27 21:49:44 +08:00
|
|
|
This file is similar to dell_modifier but here, an
|
|
|
|
attribute's current value will be forcefully changed based
|
|
|
|
dependent attributes value.
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
dell_value_modifier rules can be in following format::
|
|
|
|
|
|
|
|
<value>[ForceIf:<attribute>=<value>]
|
|
|
|
<value>[ForceIfNot:<attribute>=<value>]
|
|
|
|
|
|
|
|
For example:
|
|
|
|
|
|
|
|
LegacyOrom/dell_value_modifier has value:
|
|
|
|
Disabled[ForceIf:SecureBoot=Enabled]
|
2020-10-27 21:49:44 +08:00
|
|
|
|
|
|
|
This means LegacyOrom's current value will be forced to
|
|
|
|
"Disabled" in BIOS setup if SecureBoot is Enabled and its
|
|
|
|
value will not be effective through sysfs until this rule is
|
|
|
|
met.
|
|
|
|
|
|
|
|
What: /sys/class/firmware-attributes/*/authentication/
|
|
|
|
Date: February 2021
|
|
|
|
KernelVersion: 5.11
|
|
|
|
Contact: Divya Bharathi <Divya.Bharathi@Dell.com>,
|
|
|
|
Prasanth KSR <prasanth.ksr@dell.com>
|
2021-08-11 00:09:00 +08:00
|
|
|
Dell.Client.Kernel@dell.com
|
2020-10-29 17:31:23 +08:00
|
|
|
Description:
|
2020-10-27 21:49:44 +08:00
|
|
|
Devices support various authentication mechanisms which can be exposed
|
|
|
|
as a separate configuration object.
|
|
|
|
|
|
|
|
For example a "BIOS Admin" password and "System" Password can be set,
|
|
|
|
reset or cleared using these attributes.
|
2020-10-29 17:31:23 +08:00
|
|
|
|
2020-10-27 21:49:44 +08:00
|
|
|
- An "Admin" password is used for preventing modification to the BIOS
|
|
|
|
settings.
|
|
|
|
- A "System" password is required to boot a machine.
|
|
|
|
|
|
|
|
Change in any of these two authentication methods will also generate an
|
|
|
|
uevent KOBJ_CHANGE.
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
is_enabled:
|
|
|
|
A file that can be read to obtain a 0/1 flag to see if
|
2020-10-27 21:49:44 +08:00
|
|
|
<attr> authentication is enabled.
|
|
|
|
This attribute is mandatory.
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
role:
|
|
|
|
The type of authentication used.
|
2020-10-27 21:49:44 +08:00
|
|
|
This attribute is mandatory.
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
Known types:
|
|
|
|
bios-admin:
|
|
|
|
Representing BIOS administrator password
|
|
|
|
power-on:
|
|
|
|
Representing a password required to use
|
|
|
|
the system
|
|
|
|
|
|
|
|
mechanism:
|
|
|
|
The means of authentication. This attribute is mandatory.
|
2020-10-27 21:49:44 +08:00
|
|
|
Only supported type currently is "password".
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
max_password_length:
|
|
|
|
A file that can be read to obtain the
|
2020-10-27 21:49:44 +08:00
|
|
|
maximum length of the Password
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
min_password_length:
|
|
|
|
A file that can be read to obtain the
|
2020-10-27 21:49:44 +08:00
|
|
|
minimum length of the Password
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
current_password:
|
|
|
|
A write only value used for privileged access such as
|
2020-10-27 21:49:44 +08:00
|
|
|
setting attributes when a system or admin password is set
|
|
|
|
or resetting to a new password
|
|
|
|
|
|
|
|
This attribute is mandatory when mechanism == "password".
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
new_password:
|
|
|
|
A write only value that when used in tandem with
|
2020-10-27 21:49:44 +08:00
|
|
|
current_password will reset a system or admin password.
|
|
|
|
|
|
|
|
Note, password management is session specific. If Admin password is set,
|
|
|
|
same password must be written into current_password file (required for
|
|
|
|
password-validation) and must be cleared once the session is over.
|
2020-10-29 17:31:23 +08:00
|
|
|
For example::
|
|
|
|
|
2020-10-27 21:49:44 +08:00
|
|
|
echo "password" > current_password
|
|
|
|
echo "disabled" > TouchScreen/current_value
|
|
|
|
echo "" > current_password
|
|
|
|
|
|
|
|
Drivers may emit a CHANGE uevent when a password is set or unset
|
|
|
|
userspace may check it again.
|
|
|
|
|
2021-05-31 06:31:11 +08:00
|
|
|
On Dell and Lenovo systems, if Admin password is set, then all BIOS attributes
|
2020-10-27 21:49:44 +08:00
|
|
|
require password validation.
|
2021-05-31 06:31:11 +08:00
|
|
|
On Lenovo systems if you change the Admin password the new password is not active until
|
|
|
|
the next boot.
|
|
|
|
|
|
|
|
Lenovo specific class extensions
|
|
|
|
------------------------------
|
|
|
|
|
|
|
|
On Lenovo systems the following additional settings are available:
|
|
|
|
|
|
|
|
lenovo_encoding:
|
|
|
|
The encoding method that is used. This can be either "ascii"
|
|
|
|
or "scancode". Default is set to "ascii"
|
|
|
|
|
|
|
|
lenovo_kbdlang:
|
|
|
|
The keyboard language method that is used. This is generally a
|
|
|
|
two char code (e.g. "us", "fr", "gr") and may vary per platform.
|
|
|
|
Default is set to "us"
|
2020-10-27 21:49:44 +08:00
|
|
|
|
|
|
|
What: /sys/class/firmware-attributes/*/attributes/pending_reboot
|
|
|
|
Date: February 2021
|
|
|
|
KernelVersion: 5.11
|
|
|
|
Contact: Divya Bharathi <Divya.Bharathi@Dell.com>,
|
|
|
|
Prasanth KSR <prasanth.ksr@dell.com>
|
2021-08-11 00:09:00 +08:00
|
|
|
Dell.Client.Kernel@dell.com
|
2020-10-27 21:49:44 +08:00
|
|
|
Description:
|
|
|
|
A read-only attribute reads 1 if a reboot is necessary to apply
|
|
|
|
pending BIOS attribute changes. Also, an uevent_KOBJ_CHANGE is
|
|
|
|
generated when it changes to 1.
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
== =========================================
|
|
|
|
0 All BIOS attributes setting are current
|
|
|
|
1 A reboot is necessary to get pending BIOS
|
|
|
|
attribute changes applied
|
|
|
|
== =========================================
|
2020-10-27 21:49:44 +08:00
|
|
|
|
|
|
|
Note, userspace applications need to follow below steps for efficient
|
|
|
|
BIOS management,
|
2020-10-29 17:31:23 +08:00
|
|
|
|
2020-10-27 21:49:44 +08:00
|
|
|
1. Check if admin password is set. If yes, follow session method for
|
|
|
|
password management as briefed under authentication section above.
|
|
|
|
2. Before setting any attribute, check if it has any modifiers
|
|
|
|
or value_modifiers. If yes, incorporate them and then modify
|
|
|
|
attribute.
|
|
|
|
|
|
|
|
Drivers may emit a CHANGE uevent when this value changes and userspace
|
|
|
|
may check it again.
|
|
|
|
|
|
|
|
What: /sys/class/firmware-attributes/*/attributes/reset_bios
|
|
|
|
Date: February 2021
|
|
|
|
KernelVersion: 5.11
|
|
|
|
Contact: Divya Bharathi <Divya.Bharathi@Dell.com>,
|
|
|
|
Prasanth KSR <prasanth.ksr@dell.com>
|
2021-08-11 00:09:00 +08:00
|
|
|
Dell.Client.Kernel@dell.com
|
2020-10-27 21:49:44 +08:00
|
|
|
Description:
|
|
|
|
This attribute can be used to reset the BIOS Configuration.
|
|
|
|
Specifically, it tells which type of reset BIOS configuration is being
|
|
|
|
requested on the host.
|
|
|
|
|
|
|
|
Reading from it returns a list of supported options encoded as:
|
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
- 'builtinsafe' (Built in safe configuration profile)
|
|
|
|
- 'lastknowngood' (Last known good saved configuration profile)
|
|
|
|
- 'factory' (Default factory settings configuration profile)
|
|
|
|
- 'custom' (Custom saved configuration profile)
|
2020-10-27 21:49:44 +08:00
|
|
|
|
|
|
|
The currently selected option is printed in square brackets as
|
2020-10-29 17:31:23 +08:00
|
|
|
shown below::
|
2020-10-27 21:49:44 +08:00
|
|
|
|
2020-10-29 17:31:23 +08:00
|
|
|
# echo "factory" > /sys/class/firmware-attributes/*/device/attributes/reset_bios
|
|
|
|
# cat /sys/class/firmware-attributes/*/device/attributes/reset_bios
|
|
|
|
# builtinsafe lastknowngood [factory] custom
|
2020-10-27 21:49:44 +08:00
|
|
|
|
|
|
|
Note that any changes to this attribute requires a reboot
|
|
|
|
for changes to take effect.
|
2021-08-17 08:15:01 +08:00
|
|
|
|
|
|
|
What: /sys/class/firmware-attributes/*/attributes/debug_cmd
|
|
|
|
Date: July 2021
|
|
|
|
KernelVersion: 5.14
|
|
|
|
Contact: Mark Pearson <markpearson@lenovo.com>
|
|
|
|
Description:
|
|
|
|
This write only attribute can be used to send debug commands to the BIOS.
|
|
|
|
This should only be used when recommended by the BIOS vendor. Vendors may
|
|
|
|
use it to enable extra debug attributes or BIOS features for testing purposes.
|
|
|
|
|
|
|
|
Note that any changes to this attribute requires a reboot for changes to take effect.
|