ABI obsolete symbols¶

Documents interfaces that are still remaining in the kernel, but are marked to be removed at some later point in time.

The description of the interface will document the reason why it is obsolete and when it can be expected to be removed.

Symbols under /sys/bus¶

/sys/bus/platform/devices/INT34D2:00/northpeak

Defined on file sysfs-driver-intel_pmc_bxt

This interface allows userspace to enable and disable Northpeak through the PMC/SCU.

Format: %u.

/sys/bus/platform/devices/INT34D2:00/simplecmd

Defined on file sysfs-driver-intel_pmc_bxt

This interface allows userspace to send an arbitrary IPC command to the PMC/SCU.

Format: %d %d where first number is command and second number is subcommand.

/sys/bus/usb/devices/…/power/level

Defined on file sysfs-bus-usb

Each USB device directory will contain a file named power/level. This file holds a power-level setting for the device, either “on” or “auto”.

“on” means that the device is not allowed to autosuspend, although normal suspends for system sleep will still be honored. “auto” means the device will autosuspend and autoresume in the usual manner, according to the capabilities of its driver.

During normal use, devices should be left in the “auto” level. The “on” level is meant for administrative uses. If you want to suspend a device immediately but leave it free to wake up in response to I/O requests, you should write “0” to power/autosuspend.

Device not capable of proper suspend and resume should be left in the “on” level. Although the USB spec requires devices to support suspend/resume, many of them do not. In fact so many don’t that by default, the USB core initializes all non-hub devices in the “on” level. Some drivers may change this setting when they are bound.

This file is deprecated and will be removed after 2010. Use the power/control file instead; it does exactly the same thing.

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/arvo/roccatarvo<minor>/actual_profile

Defined on file sysfs-driver-hid-roccat-arvo

The integer value of this attribute ranges from 1-5. When read, this attribute returns the number of the actual profile which is also the profile that’s active on device startup. When written this attribute activates the selected profile immediately.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/arvo/roccatarvo<minor>/button

Defined on file sysfs-driver-hid-roccat-arvo

The keyboard can store short macros with consist of 1 button with several modifier keys internally. When written, this file lets one set the sequence for a specific button for a specific profile. Button and profile numbers are included in written data. The data has to be 24 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/arvo/roccatarvo<minor>/info

Defined on file sysfs-driver-hid-roccat-arvo

When read, this file returns some info about the device like the installed firmware version. The size of the data is 8 bytes in size. This file is readonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/arvo/roccatarvo<minor>/key_mask

Defined on file sysfs-driver-hid-roccat-arvo

The keyboard lets the user deactivate 5 certain keys like the windows and application keys, to protect the user from the outcome of accidentally pressing them. The integer value of this attribute has bits 0-4 set depending on the state of the corresponding key. When read, this file returns the current state of the buttons. When written, the given buttons are activated/deactivated immediately.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/arvo/roccatarvo<minor>/mode_key

Defined on file sysfs-driver-hid-roccat-arvo

The keyboard has a condensed layout without num-lock key. Instead it uses a mode-key which activates a gaming mode where the assignment of the number block changes. The integer value of this attribute ranges from 0 (OFF) to 1 (ON). When read, this file returns the actual state of the key. When written, the key is activated/deactivated immediately.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/actual_profile

Defined on file sysfs-driver-hid-roccat-isku

The integer value of this attribute ranges from 0-4. When read, this attribute returns the number of the actual profile. This value is persistent, so its equivalent to the profile that’s active when the device is powered on next time. When written, this file sets the number of the startup profile and the device activates this profile immediately.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/control

Defined on file sysfs-driver-hid-roccat-isku

When written, this file lets one select which data from which profile will be read next. The data has to be 3 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/info

Defined on file sysfs-driver-hid-roccat-isku

When read, this file returns general data like firmware version. The data is 6 bytes long. This file is readonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/key_mask

Defined on file sysfs-driver-hid-roccat-isku

When written, this file lets one deactivate certain keys like windows and application keys, to prevent accidental presses. Profile number for which this settings occur is included in written data. The data has to be 6 bytes long. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/keys_capslock

Defined on file sysfs-driver-hid-roccat-isku

When written, this file lets one set the function of the capslock key for a specific profile. Profile number is included in written data. The data has to be 6 bytes long. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/keys_easyzone

Defined on file sysfs-driver-hid-roccat-isku

When written, this file lets one set the function of the easyzone keys for a specific profile. Profile number is included in written data. The data has to be 65 bytes long. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/keys_function

Defined on file sysfs-driver-hid-roccat-isku

When written, this file lets one set the function of the function keys for a specific profile. Profile number is included in written data. The data has to be 41 bytes long. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/keys_macro

Defined on file sysfs-driver-hid-roccat-isku

When written, this file lets one set the function of the macro keys for a specific profile. Profile number is included in written data. The data has to be 35 bytes long. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/keys_media

Defined on file sysfs-driver-hid-roccat-isku

When written, this file lets one set the function of the media keys for a specific profile. Profile number is included in written data. The data has to be 29 bytes long. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/keys_thumbster

Defined on file sysfs-driver-hid-roccat-isku

When written, this file lets one set the function of the thumbster keys for a specific profile. Profile number is included in written data. The data has to be 23 bytes long. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/last_set

Defined on file sysfs-driver-hid-roccat-isku

When written, this file lets one set the time in secs since epoch in which the last configuration took place. The data has to be 20 bytes long.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/light

Defined on file sysfs-driver-hid-roccat-isku

When written, this file lets one set the backlight intensity for a specific profile. Profile number is included in written data. The data has to be 10 bytes long for Isku, IskuFX needs 16 bytes of data. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/macro

Defined on file sysfs-driver-hid-roccat-isku

When written, this file lets one store macros with max 500 keystrokes for a specific button for a specific profile. Button and profile numbers are included in written data. The data has to be 2083 bytes long. Before reading this file, control has to be written to select which profile and key to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/reset

Defined on file sysfs-driver-hid-roccat-isku

When written, this file lets one reset the device. The data has to be 3 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/talk

Defined on file sysfs-driver-hid-roccat-isku

When written, this file lets one trigger easyshift functionality from the host. The data has to be 16 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/talkfx

Defined on file sysfs-driver-hid-roccat-isku

When written, this file lets one trigger temporary color schemes from the host. The data has to be 16 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/actual_profile

Defined on file sysfs-driver-hid-roccat-koneplus

The integer value of this attribute ranges from 0-4. When read, this attribute returns the number of the actual profile. This value is persistent, so its equivalent to the profile that’s active when the mouse is powered on next time. When written, this file sets the number of the startup profile and the mouse activates this profile immediately.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/firmware_version

Defined on file sysfs-driver-hid-roccat-koneplus

When read, this file returns the raw integer version number of the firmware reported by the mouse. Using the integer value eases further usage in other programs. To receive the real version number the decimal point has to be shifted 2 positions to the left. E.g. a returned value of 121 means 1.21 This file is readonly. Please read binary attribute info which contains firmware version.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/info

Defined on file sysfs-driver-hid-roccat-koneplus

When read, this file returns general data like firmware version. When written, the device can be reset. The data is 8 bytes long.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/macro

Defined on file sysfs-driver-hid-roccat-koneplus

The mouse can store a macro with max 500 key/button strokes internally. When written, this file lets one set the sequence for a specific button for a specific profile. Button and profile numbers are included in written data. The data has to be 2082 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/profile[1-5]_buttons

Defined on file sysfs-driver-hid-roccat-koneplus

The mouse can store 5 profiles which can be switched by the press of a button. A profile is split in settings and buttons. profile_buttons holds information about button layout. When read, these files return the respective profile buttons. The returned data is 77 bytes in size. This file is readonly. Write control to select profile and read profile_buttons instead.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/profile[1-5]_settings

Defined on file sysfs-driver-hid-roccat-koneplus

The mouse can store 5 profiles which can be switched by the press of a button. A profile is split in settings and buttons. profile_settings holds information like resolution, sensitivity and light effects. When read, these files return the respective profile settings. The returned data is 43 bytes in size. This file is readonly. Write control to select profile and read profile_settings instead.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/profile_buttons

Defined on file sysfs-driver-hid-roccat-koneplus

The mouse can store 5 profiles which can be switched by the press of a button. A profile is split in settings and buttons. profile_buttons holds information about button layout. When written, this file lets one write the respective profile buttons back to the mouse. The data has to be 77 bytes long. The mouse will reject invalid data. Which profile to write is determined by the profile number contained in the data. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/profile_settings

Defined on file sysfs-driver-hid-roccat-koneplus

The mouse can store 5 profiles which can be switched by the press of a button. A profile is split in settings and buttons. profile_settings holds information like resolution, sensitivity and light effects. When written, this file lets one write the respective profile settings back to the mouse. The data has to be 43 bytes long. The mouse will reject invalid data. Which profile to write is determined by the profile number contained in the data. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/sensor

Defined on file sysfs-driver-hid-roccat-koneplus

The mouse has a tracking- and a distance-control-unit. These can be activated/deactivated and the lift-off distance can be set. The data has to be 6 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/startup_profile

Defined on file sysfs-driver-hid-roccat-koneplus

The integer value of this attribute ranges from 0-4. When read, this attribute returns the number of the actual profile. This value is persistent, so its equivalent to the profile that’s active when the mouse is powered on next time. When written, this file sets the number of the startup profile and the mouse activates this profile immediately. Please use actual_profile, it does the same thing.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/talk

Defined on file sysfs-driver-hid-roccat-koneplus

Used to active some easy* functions of the mouse from outside. The data has to be 16 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/tcu

Defined on file sysfs-driver-hid-roccat-koneplus

When written a calibration process for the tracking control unit can be initiated/cancelled. Also lets one read/write sensor registers. The data has to be 4 bytes long.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/tcu_image

Defined on file sysfs-driver-hid-roccat-koneplus

When read the mouse returns a 30x30 pixel image of the sampled underground. This works only in the course of a calibration process initiated with tcu. The returned data is 1028 bytes in size. This file is readonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/actual_profile

Defined on file sysfs-driver-hid-roccat-konepure

The mouse can store 5 profiles which can be switched by the press of a button. actual_profile holds number of actual profile. This value is persistent, so its value determines the profile that’s active when the mouse is powered on next time. When written, the mouse activates the set profile immediately. The data has to be 3 bytes long. The mouse will reject invalid data.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/control

Defined on file sysfs-driver-hid-roccat-konepure

When written, this file lets one select which data from which profile will be read next. The data has to be 3 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/info

Defined on file sysfs-driver-hid-roccat-konepure

When read, this file returns general data like firmware version. When written, the device can be reset. The data is 6 bytes long.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/macro

Defined on file sysfs-driver-hid-roccat-konepure

The mouse can store a macro with max 500 key/button strokes internally. When written, this file lets one set the sequence for a specific button for a specific profile. Button and profile numbers are included in written data. The data has to be 2082 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/profile_buttons

Defined on file sysfs-driver-hid-roccat-konepure

The mouse can store 5 profiles which can be switched by the press of a button. A profile is split in settings and buttons. profile_buttons holds information about button layout. When written, this file lets one write the respective profile buttons back to the mouse. The data has to be 59 bytes long. The mouse will reject invalid data. Which profile to write is determined by the profile number contained in the data. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/profile_settings

Defined on file sysfs-driver-hid-roccat-konepure

The mouse can store 5 profiles which can be switched by the press of a button. A profile is split in settings and buttons. profile_settings holds information like resolution, sensitivity and light effects. When written, this file lets one write the respective profile settings back to the mouse. The data has to be 31 bytes long. The mouse will reject invalid data. Which profile to write is determined by the profile number contained in the data. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/sensor

Defined on file sysfs-driver-hid-roccat-konepure

The mouse has a tracking- and a distance-control-unit. These can be activated/deactivated and the lift-off distance can be set. The data has to be 6 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/talk

Defined on file sysfs-driver-hid-roccat-konepure

Used to active some easy* functions of the mouse from outside. The data has to be 16 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/tcu

Defined on file sysfs-driver-hid-roccat-konepure

When written a calibration process for the tracking control unit can be initiated/cancelled. Also lets one read/write sensor registers. The data has to be 4 bytes long.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/tcu_image

Defined on file sysfs-driver-hid-roccat-konepure

When read the mouse returns a 30x30 pixel image of the sampled underground. This works only in the course of a calibration process initiated with tcu. The returned data is 1028 bytes in size. This file is readonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/actual_cpi

Defined on file sysfs-driver-hid-roccat-kovaplus

The integer value of this attribute ranges from 1-4. When read, this attribute returns the number of the active cpi level. This file is readonly. Has never been used. If bookkeeping is done, it’s done in userland tools.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/actual_profile

Defined on file sysfs-driver-hid-roccat-kovaplus

The integer value of this attribute ranges from 0-4. When read, this attribute returns the number of the active profile. When written, the mouse activates this profile immediately. The profile that’s active when powered down is the same that’s active when the mouse is powered on.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/actual_sensitivity_x

Defined on file sysfs-driver-hid-roccat-kovaplus

The integer value of this attribute ranges from 1-10. When read, this attribute returns the number of the actual sensitivity in x direction. This file is readonly. Has never been used. If bookkeeping is done, it’s done in userland tools.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/actual_sensitivity_y

Defined on file sysfs-driver-hid-roccat-kovaplus

The integer value of this attribute ranges from 1-10. When read, this attribute returns the number of the actual sensitivity in y direction. This file is readonly. Has never been used. If bookkeeping is done, it’s done in userland tools.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/firmware_version

Defined on file sysfs-driver-hid-roccat-kovaplus

When read, this file returns the raw integer version number of the firmware reported by the mouse. Using the integer value eases further usage in other programs. To receive the real version number the decimal point has to be shifted 2 positions to the left. E.g. a returned value of 121 means 1.21 This file is readonly. Obsoleted by binary sysfs attribute “info”.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/info

Defined on file sysfs-driver-hid-roccat-kovaplus

When read, this file returns general data like firmware version. When written, the device can be reset. The data is 6 bytes long.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/profile[1-5]_buttons

Defined on file sysfs-driver-hid-roccat-kovaplus

The mouse can store 5 profiles which can be switched by the press of a button. A profile is split in settings and buttons. profile_buttons holds information about button layout. When read, these files return the respective profile buttons. The returned data is 23 bytes in size. This file is readonly. Write control to select profile and read profile_buttons instead.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/profile[1-5]_settings

Defined on file sysfs-driver-hid-roccat-kovaplus

The mouse can store 5 profiles which can be switched by the press of a button. A profile is split in settings and buttons. profile_settings holds information like resolution, sensitivity and light effects. When read, these files return the respective profile settings. The returned data is 16 bytes in size. This file is readonly. Write control to select profile and read profile_settings instead.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/profile_buttons

Defined on file sysfs-driver-hid-roccat-kovaplus

The mouse can store 5 profiles which can be switched by the press of a button. A profile is split in settings and buttons. profile_buttons holds information about button layout. When written, this file lets one write the respective profile buttons back to the mouse. The data has to be 23 bytes long. The mouse will reject invalid data. Which profile to write is determined by the profile number contained in the data. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/profile_settings

Defined on file sysfs-driver-hid-roccat-kovaplus

The mouse can store 5 profiles which can be switched by the press of a button. A profile is split in settings and buttons. profile_settings holds information like resolution, sensitivity and light effects. When written, this file lets one write the respective profile settings back to the mouse. The data has to be 16 bytes long. The mouse will reject invalid data. Which profile to write is determined by the profile number contained in the data. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/actual_cpi

Defined on file sysfs-driver-hid-roccat-pyra

It is possible to switch the cpi setting of the mouse with the press of a button. When read, this file returns the raw number of the actual cpi setting reported by the mouse. This number has to be further processed to receive the real dpi value:

VALUE	DPI
1	400
2	800
4	1600

This file is readonly. Has never been used. If bookkeeping is done, it’s done in userland tools.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/actual_profile

Defined on file sysfs-driver-hid-roccat-pyra

When read, this file returns the number of the actual profile in range 0-4. This file is readonly. Please use binary attribute “settings” which provides this information.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/firmware_version

Defined on file sysfs-driver-hid-roccat-pyra

When read, this file returns the raw integer version number of the firmware reported by the mouse. Using the integer value eases further usage in other programs. To receive the real version number the decimal point has to be shifted 2 positions to the left. E.g. a returned value of 138 means 1.38 This file is readonly. Please use binary attribute “info” which provides this information.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/info

Defined on file sysfs-driver-hid-roccat-pyra

When read, this file returns general data like firmware version. When written, the device can be reset. The data is 6 bytes long.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile[1-5]_buttons

Defined on file sysfs-driver-hid-roccat-pyra

The mouse can store 5 profiles which can be switched by the press of a button. A profile is split in settings and buttons. profile_buttons holds information about button layout. When read, these files return the respective profile buttons. The returned data is 19 bytes in size. This file is readonly. Write control to select profile and read profile_buttons instead.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile[1-5]_settings

Defined on file sysfs-driver-hid-roccat-pyra

The mouse can store 5 profiles which can be switched by the press of a button. A profile is split in settings and buttons. profile_settings holds information like resolution, sensitivity and light effects. When read, these files return the respective profile settings. The returned data is 13 bytes in size. This file is readonly. Write control to select profile and read profile_settings instead.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile_buttons

Defined on file sysfs-driver-hid-roccat-pyra

The mouse can store 5 profiles which can be switched by the press of a button. A profile is split in settings and buttons. profile_buttons holds information about button layout. When written, this file lets one write the respective profile buttons back to the mouse. The data has to be 19 bytes long. The mouse will reject invalid data. Which profile to write is determined by the profile number contained in the data. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile_settings

Defined on file sysfs-driver-hid-roccat-pyra

The mouse can store 5 profiles which can be switched by the press of a button. A profile is split in settings and buttons. profile_settings holds information like resolution, sensitivity and light effects. When written, this file lets one write the respective profile settings back to the mouse. The data has to be 13 bytes long. The mouse will reject invalid data. Which profile to write is determined by the profile number contained in the data. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/settings

Defined on file sysfs-driver-hid-roccat-pyra

When read, this file returns the settings stored in the mouse. The size of the data is 3 bytes and holds information on the startup_profile. When written, this file lets write settings back to the mouse. The data has to be 3 bytes long. The mouse will reject invalid data.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/startup_profile

Defined on file sysfs-driver-hid-roccat-pyra

The integer value of this attribute ranges from 0-4. When read, this attribute returns the number of the profile that’s active when the mouse is powered on. This file is readonly. Please use binary attribute “settings” which provides this information.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/control

Defined on file sysfs-driver-hid-roccat-ryos

When written, this file lets one select which data from which profile will be read next. The data has to be 3 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/custom_lights

Defined on file sysfs-driver-hid-roccat-ryos

When written, this file lets one set the actual per-key lighting. This attribute is only valid for the pro variant. The data has to be 20 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/info

Defined on file sysfs-driver-hid-roccat-ryos

When read, this file returns general data like firmware version. The data is 8 bytes long. This file is readonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/key_mask

Defined on file sysfs-driver-hid-roccat-ryos

When written, this file lets one deactivate certain keys like windows and application keys, to prevent accidental presses. Profile index for which this settings occur is included in written data. The data has to be 6 bytes long. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/keys_easyzone

Defined on file sysfs-driver-hid-roccat-ryos

When written, this file lets one set the function of the easyzone keys for a specific profile. Profile index is included in written data. The data has to be 294 bytes long. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/keys_extra

Defined on file sysfs-driver-hid-roccat-ryos

When written, this file lets one set the function of the capslock and function keys for a specific profile. Profile index is included in written data. The data has to be 8 bytes long. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/keys_function

Defined on file sysfs-driver-hid-roccat-ryos

When written, this file lets one set the function of the function keys for a specific profile. Profile index is included in written data. The data has to be 95 bytes long. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/keys_macro

Defined on file sysfs-driver-hid-roccat-ryos

When written, this file lets one set the function of the macro keys for a specific profile. Profile index is included in written data. The data has to be 35 bytes long. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/keys_primary

Defined on file sysfs-driver-hid-roccat-ryos

When written, this file lets one set the default of all keys for a specific profile. Profile index is included in written data. The data has to be 125 bytes long. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/keys_thumbster

Defined on file sysfs-driver-hid-roccat-ryos

When written, this file lets one set the function of the thumbster keys for a specific profile. Profile index is included in written data. The data has to be 23 bytes long. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/light

Defined on file sysfs-driver-hid-roccat-ryos

When written, this file lets one set the backlight intensity for a specific profile. Profile index is included in written data. This attribute is only valid for the glow and pro variant. The data has to be 16 bytes long. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/light_control

Defined on file sysfs-driver-hid-roccat-ryos

When written, this file lets one switch between stored and custom light settings. This attribute is only valid for the pro variant. The data has to be 8 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/light_macro

Defined on file sysfs-driver-hid-roccat-ryos

When written, this file lets one set a light macro that is looped whenever the device gets in dimness mode. This attribute is only valid for the pro variant. The data has to be 2002 bytes long. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/macro

Defined on file sysfs-driver-hid-roccat-ryos

When written, this file lets one store macros with max 480 keystrokes for a specific button for a specific profile. Button and profile indexes are included in written data. The data has to be 2002 bytes long. Before reading this file, control has to be written to select which profile and key to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/profile

Defined on file sysfs-driver-hid-roccat-ryos

The mouse can store 5 profiles which can be switched by the press of a button. profile holds index of actual profile. This value is persistent, so its value determines the profile that’s active when the device is powered on next time. When written, the device activates the set profile immediately. The data has to be 3 bytes long. The device will reject invalid data.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/reset

Defined on file sysfs-driver-hid-roccat-ryos

When written, this file lets one reset the device. The data has to be 3 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/stored_lights

Defined on file sysfs-driver-hid-roccat-ryos

When written, this file lets one set per-key lighting for different layers. This attribute is only valid for the pro variant. The data has to be 1382 bytes long. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/talk

Defined on file sysfs-driver-hid-roccat-ryos

When written, this file lets one trigger easyshift functionality from the host. The data has to be 16 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/savu/roccatsavu<minor>/buttons

Defined on file sysfs-driver-hid-roccat-savu

The mouse can store 5 profiles which can be switched by the press of a button. A profile is split into general settings and button settings. The buttons variable holds information about button layout. When written, this file lets one write the respective profile buttons to the mouse. The data has to be 47 bytes long. The mouse will reject invalid data. Which profile to write is determined by the profile number contained in the data. Before reading this file, control has to be written to select which profile to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/savu/roccatsavu<minor>/control

Defined on file sysfs-driver-hid-roccat-savu

When written, this file lets one select which data from which profile will be read next. The data has to be 3 bytes long. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/savu/roccatsavu<minor>/general

Defined on file sysfs-driver-hid-roccat-savu

The mouse can store 5 profiles which can be switched by the press of a button. A profile is split into general settings and button settings. A profile holds information like resolution, sensitivity and light effects. When written, this file lets one write the respective profile settings back to the mouse. The data has to be 43 bytes long. The mouse will reject invalid data. Which profile to write is determined by the profile number contained in the data. This file is writeonly.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/savu/roccatsavu<minor>/info

Defined on file sysfs-driver-hid-roccat-savu

When read, this file returns general data like firmware version. When written, the device can be reset. The data is 8 bytes long.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/savu/roccatsavu<minor>/macro

Defined on file sysfs-driver-hid-roccat-savu

When written, this file lets one store macros with max 500 keystrokes for a specific button for a specific profile. Button and profile numbers are included in written data. The data has to be 2083 bytes long. Before reading this file, control has to be written to select which profile and key to read.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/savu/roccatsavu<minor>/profile

Defined on file sysfs-driver-hid-roccat-savu

The mouse can store 5 profiles which can be switched by the press of a button. profile holds number of actual profile. This value is persistent, so its value determines the profile that’s active when the mouse is powered on next time. When written, the mouse activates the set profile immediately. The data has to be 3 bytes long. The mouse will reject invalid data.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/savu/roccatsavu<minor>/sensor

Defined on file sysfs-driver-hid-roccat-savu

The mouse has a Avago ADNS-3090 sensor. This file allows reading and writing of the mouse sensors registers. The data has to be 4 bytes long.

Users: http://roccat.sourceforge.net

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/control

Defined on file sysfs-driver-hid-roccat-lua

When written, cpi, button and light settings can be configured. When read, actual cpi setting and sensor data are returned. The data has to be 8 bytes long.

Users: http://roccat.sourceforge.net

Symbols under /sys/class¶

/sys/class/dax/

Defined on file sysfs-class-dax

Device DAX is the device-centric analogue of Filesystem DAX (CONFIG_FS_DAX). It allows memory ranges to be allocated and mapped without need of an intervening file system. Device DAX is strict, precise and predictable. Specifically this interface:

Guarantees fault granularity with respect to a given page size (pte, pmd, or pud) set at configuration time.
Enforces deterministic behavior by being strict about what fault scenarios are supported.

The /sys/class/dax/ interface enumerates all the device-dax instances in the system. The ABI is deprecated and will be removed after 2020. It is replaced with the DAX bus interface /sys/bus/dax/ where device-dax instances can be found under /sys/bus/dax/devices/

/sys/class/gpio/

Defined on file sysfs-gpio

As a Kconfig option, individual GPIO signals may be accessed from userspace. GPIOs are only made available to userspace by an explicit “export” operation. If a given GPIO is not claimed for use by kernel code, it may be exported by userspace (and unexported later). Kernel code may export it for complete or partial access.

GPIOs are identified as they are inside the kernel, using integers in the range 0..INT_MAX. See Documentation/admin-guide/gpio for more information.

/sys/class/gpio
    /export ... asks the kernel to export a GPIO to userspace
    /unexport ... to return a GPIO to the kernel
    /gpioN ... for each exported GPIO #N OR
    /<LINE-NAME> ... for a properly named GPIO line
        /value ... always readable, writes fail for input GPIOs
        /direction ... r/w as: in, out (default low); write: high, low
        /edge ... r/w as: none, falling, rising, both
    /gpiochipN ... for each gpiochip; #N is its first GPIO
        /base ... (r/o) same as N
        /label ... (r/o) descriptive, not necessarily unique
        /ngpio ... (r/o) number of GPIOs; numbered N to N + (ngpio - 1)

This ABI is deprecated and will be removed after 2020. It is replaced with the GPIO character device.

/sys/class/typec/<port|partner|cable>/<dev>/mode<index>/

Defined on file sysfs-class-typec

Every supported mode will have its own directory. The name of a mode will be “mode<index>” (for example mode1), where <index> is the actual index to the mode VDO returned by Discover Modes USB power delivery command.

/sys/class/typec/<port|partner|cable>/<dev>/mode<index>/active

Defined on file sysfs-class-typec

Shows if the mode is active or not. The attribute can be used for entering/exiting the mode with partners and cable plugs, and with the port alternate modes it can be used for disabling support for specific alternate modes. Entering/exiting modes is supported as synchronous operation so write(2) to the attribute does not return until the enter/exit mode operation has finished. The attribute is notified when the mode is entered/exited so poll(2) on the attribute wakes up. Entering/exiting a mode will also generate uevent KOBJ_CHANGE.

Valid values: yes, no

/sys/class/typec/<port|partner|cable>/<dev>/mode<index>/description

Defined on file sysfs-class-typec

Shows description of the mode. The description is optional for the drivers, just like with the Billboard Devices.

/sys/class/typec/<port|partner|cable>/<dev>/mode<index>/vdo

Defined on file sysfs-class-typec

Shows the VDO in hexadecimal returned by Discover Modes command for this mode.

/sys/class/typec/<port|partner|cable>/<dev>/svid

Defined on file sysfs-class-typec

The SVID (Standard or Vendor ID) assigned by USB-IF for this alternate mode.

Symbols under /sys/devices¶

/sys/devices/system/cpu/cpuidle/current_governor_ro

Defined on file sysfs-cpuidle

current_governor_ro shows current using cpuidle governor, but read only. with the update that cpuidle governor can be changed at runtime in default, both current_governor and current_governor_ro co-exist under /sys/devices/system/cpu/cpuidle/ file, it’s duplicate so make current_governor_ro obselete.

Symbols under /sys/firmware¶

/sys/firmware/acpi/hotplug/force_remove

Defined on file sysfs-firmware-acpi

Since the force_remove is inherently broken and dangerous to use for some hotplugable resources like memory (because ignoring the offline failure might lead to memory corruption and crashes) enabling this knob is not safe and thus unsupported.

Symbols under /sys/fs¶

/sys/fs/selinux/checkreqprot

Defined on file sysfs-selinux-checkreqprot

The selinuxfs “checkreqprot” node allows SELinux to be configured to check the protection requested by userspace for mmap/mprotect calls instead of the actual protection applied by the kernel. This was a compatibility mechanism for legacy userspace and for the READ_IMPLIES_EXEC personality flag. However, if set to 1, it weakens security by allowing mappings to be made executable without authorization by policy. The default value of checkreqprot at boot was changed starting in Linux v4.4 to 0 (i.e. check the actual protection), and Android and Linux distributions have been explicitly writing a “0” to /sys/fs/selinux/checkreqprot during initialization for some time. Support for setting checkreqprot to 1 will be removed no sooner than June 2021, at which point the kernel will always cease using checkreqprot internally and will always check the actual protections being applied upon mmap/mprotect calls. The checkreqprot selinuxfs node will remain for backward compatibility but will discard writes of the “0” value and will reject writes of the “1” value when this mechanism is removed.

/sys/fs/selinux/disable

Defined on file sysfs-selinux-disable

The selinuxfs “disable” node allows SELinux to be disabled at runtime prior to a policy being loaded into the kernel. If disabled via this mechanism, SELinux will remain disabled until the system is rebooted.

The preferred method of disabling SELinux is via the “selinux=0” boot parameter, but the selinuxfs “disable” node was created to make it easier for systems with primitive bootloaders that did not allow for easy modification of the kernel command line. Unfortunately, allowing for SELinux to be disabled at runtime makes it difficult to secure the kernel’s LSM hooks using the “__ro_after_init” feature.

Thankfully, the need for the SELinux runtime disable appears to be gone, the default Kconfig configuration disables this selinuxfs node, and only one of the major distributions, Fedora, supports disabling SELinux at runtime. Fedora is in the process of removing the selinuxfs “disable” node and once that is complete we will start the slow process of removing this code from the kernel.

More information on /sys/fs/selinux/disable can be found under the CONFIG_SECURITY_SELINUX_DISABLE Kconfig option.

Symbols under /sys/kernel¶

/sys/kernel/fadump_enabled

Defined on file sysfs-kernel-fadump_enabled

read only Primarily used to identify whether the FADump is enabled in the kernel or not. User: Kdump service

/sys/kernel/fadump_registered

Defined on file sysfs-kernel-fadump_registered

read/write Helps to control the dump collect feature from userspace. Setting 1 to this file enables the system to collect the dump and 0 to disable it. User: Kdump service

/sys/kernel/fadump_release_mem

Defined on file sysfs-kernel-fadump_release_mem

write only This is a special sysfs file and only available when the system is booted to capture the vmcore using FADump. It is used to release the memory reserved by FADump to save the crash dump.

File /srv/docbuild/lib/git/linux/obsolete/sysfs-bus-usb¶

Has the following ABI:

/sys/bus/usb/devices/…/power/level

File /srv/docbuild/lib/git/linux/obsolete/sysfs-class-dax¶

Has the following ABI:

/sys/class/dax/

File /srv/docbuild/lib/git/linux/obsolete/sysfs-class-typec¶

These files are deprecated and will be removed. The same files are available under /sys/bus/typec (see testing/sysfs-bus-typec).

Has the following ABI:

File /srv/docbuild/lib/git/linux/obsolete/sysfs-cpuidle¶

Has the following ABI:

/sys/devices/system/cpu/cpuidle/current_governor_ro

File /srv/docbuild/lib/git/linux/obsolete/sysfs-driver-hid-roccat-arvo¶

Has the following ABI:

File /srv/docbuild/lib/git/linux/obsolete/sysfs-driver-hid-roccat-isku¶

Has the following ABI:

File /srv/docbuild/lib/git/linux/obsolete/sysfs-driver-hid-roccat-koneplus¶

Has the following ABI:

File /srv/docbuild/lib/git/linux/obsolete/sysfs-driver-hid-roccat-konepure¶

Has the following ABI:

File /srv/docbuild/lib/git/linux/obsolete/sysfs-driver-hid-roccat-kovaplus¶

Has the following ABI:

File /srv/docbuild/lib/git/linux/obsolete/sysfs-driver-hid-roccat-lua¶

Has the following ABI:

/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/control

File /srv/docbuild/lib/git/linux/obsolete/sysfs-driver-hid-roccat-pyra¶

Has the following ABI:

File /srv/docbuild/lib/git/linux/obsolete/sysfs-driver-hid-roccat-ryos¶

Has the following ABI:

File /srv/docbuild/lib/git/linux/obsolete/sysfs-driver-hid-roccat-savu¶

Has the following ABI:

File /srv/docbuild/lib/git/linux/obsolete/sysfs-driver-intel_pmc_bxt¶

These files allow sending arbitrary IPC commands to the PMC/SCU which may be dangerous. These will be removed eventually and should not be used in any new applications.

Has the following ABI: