mainline linux kernel 4.12.5
This commit is contained in:
commit
3673909c5b
3
.cocciconfig
Normal file
3
.cocciconfig
Normal file
|
@ -0,0 +1,3 @@
|
||||||
|
[spatch]
|
||||||
|
options = --timeout 200
|
||||||
|
options = --use-gitgrep
|
117
.gitignore
vendored
Normal file
117
.gitignore
vendored
Normal file
|
@ -0,0 +1,117 @@
|
||||||
|
#
|
||||||
|
# NOTE! Don't add files that are generated in specific
|
||||||
|
# subdirectories here. Add them in the ".gitignore" file
|
||||||
|
# in that subdirectory instead.
|
||||||
|
#
|
||||||
|
# NOTE! Please use 'git ls-files -i --exclude-standard'
|
||||||
|
# command after changing this file, to see if there are
|
||||||
|
# any tracked files which get ignored after the change.
|
||||||
|
#
|
||||||
|
# Normal rules
|
||||||
|
#
|
||||||
|
.*
|
||||||
|
*.o
|
||||||
|
*.o.*
|
||||||
|
*.a
|
||||||
|
*.s
|
||||||
|
*.ko
|
||||||
|
*.so
|
||||||
|
*.so.dbg
|
||||||
|
*.mod.c
|
||||||
|
*.i
|
||||||
|
*.lst
|
||||||
|
*.symtypes
|
||||||
|
*.order
|
||||||
|
*.elf
|
||||||
|
*.bin
|
||||||
|
*.tar
|
||||||
|
*.gz
|
||||||
|
*.bz2
|
||||||
|
*.lzma
|
||||||
|
*.xz
|
||||||
|
*.lz4
|
||||||
|
*.lzo
|
||||||
|
*.patch
|
||||||
|
*.gcno
|
||||||
|
*.ll
|
||||||
|
modules.builtin
|
||||||
|
Module.symvers
|
||||||
|
*.dwo
|
||||||
|
*.su
|
||||||
|
*.c.[012]*.*
|
||||||
|
|
||||||
|
#
|
||||||
|
# Top-level generic files
|
||||||
|
#
|
||||||
|
/tags
|
||||||
|
/TAGS
|
||||||
|
/linux
|
||||||
|
/vmlinux
|
||||||
|
/vmlinux.32
|
||||||
|
/vmlinux-gdb.py
|
||||||
|
/vmlinuz
|
||||||
|
/System.map
|
||||||
|
/Module.markers
|
||||||
|
|
||||||
|
#
|
||||||
|
# Debian directory (make deb-pkg)
|
||||||
|
#
|
||||||
|
/debian/
|
||||||
|
|
||||||
|
#
|
||||||
|
# tar directory (make tar*-pkg)
|
||||||
|
#
|
||||||
|
/tar-install/
|
||||||
|
|
||||||
|
#
|
||||||
|
# git files that we don't want to ignore even if they are dot-files
|
||||||
|
#
|
||||||
|
!.gitignore
|
||||||
|
!.mailmap
|
||||||
|
!.cocciconfig
|
||||||
|
|
||||||
|
#
|
||||||
|
# Generated include files
|
||||||
|
#
|
||||||
|
include/config
|
||||||
|
include/generated
|
||||||
|
arch/*/include/generated
|
||||||
|
|
||||||
|
# stgit generated dirs
|
||||||
|
patches-*
|
||||||
|
|
||||||
|
# quilt's files
|
||||||
|
patches
|
||||||
|
series
|
||||||
|
|
||||||
|
# cscope files
|
||||||
|
cscope.*
|
||||||
|
ncscope.*
|
||||||
|
|
||||||
|
# gnu global files
|
||||||
|
GPATH
|
||||||
|
GRTAGS
|
||||||
|
GSYMS
|
||||||
|
GTAGS
|
||||||
|
|
||||||
|
# id-utils files
|
||||||
|
ID
|
||||||
|
|
||||||
|
*.orig
|
||||||
|
*~
|
||||||
|
\#*#
|
||||||
|
|
||||||
|
#
|
||||||
|
# Leavings from module signing
|
||||||
|
#
|
||||||
|
extra_certificates
|
||||||
|
signing_key.pem
|
||||||
|
signing_key.priv
|
||||||
|
signing_key.x509
|
||||||
|
x509.genkey
|
||||||
|
|
||||||
|
# Kconfig presets
|
||||||
|
all.config
|
||||||
|
|
||||||
|
# Kdevelop4
|
||||||
|
*.kdev4
|
182
.mailmap
Normal file
182
.mailmap
Normal file
|
@ -0,0 +1,182 @@
|
||||||
|
#
|
||||||
|
# This list is used by git-shortlog to fix a few botched name translations
|
||||||
|
# in the git archive, either because the author's full name was messed up
|
||||||
|
# and/or not always written the same way, making contributions from the
|
||||||
|
# same person appearing not to be so or badly displayed.
|
||||||
|
#
|
||||||
|
# repo-abbrev: /pub/scm/linux/kernel/git/
|
||||||
|
#
|
||||||
|
|
||||||
|
Aaron Durbin <adurbin@google.com>
|
||||||
|
Adam Oldham <oldhamca@gmail.com>
|
||||||
|
Adam Radford <aradford@gmail.com>
|
||||||
|
Adrian Bunk <bunk@stusta.de>
|
||||||
|
Adriana Reus <adi.reus@gmail.com> <adriana.reus@intel.com>
|
||||||
|
Alan Cox <alan@lxorguk.ukuu.org.uk>
|
||||||
|
Alan Cox <root@hraefn.swansea.linux.org.uk>
|
||||||
|
Aleksey Gorelov <aleksey_gorelov@phoenix.com>
|
||||||
|
Al Viro <viro@ftp.linux.org.uk>
|
||||||
|
Al Viro <viro@zenIV.linux.org.uk>
|
||||||
|
Andreas Herrmann <aherrman@de.ibm.com>
|
||||||
|
Andrey Ryabinin <ryabinin.a.a@gmail.com> <a.ryabinin@samsung.com>
|
||||||
|
Andrew Morton <akpm@linux-foundation.org>
|
||||||
|
Andrew Vasquez <andrew.vasquez@qlogic.com>
|
||||||
|
Andy Adamson <andros@citi.umich.edu>
|
||||||
|
Antoine Tenart <antoine.tenart@free-electrons.com>
|
||||||
|
Antonio Ospite <ao2@ao2.it> <ao2@amarulasolutions.com>
|
||||||
|
Archit Taneja <archit@ti.com>
|
||||||
|
Arnaud Patard <arnaud.patard@rtp-net.org>
|
||||||
|
Arnd Bergmann <arnd@arndb.de>
|
||||||
|
Axel Dyks <xl@xlsigned.net>
|
||||||
|
Axel Lin <axel.lin@gmail.com>
|
||||||
|
Ben Gardner <bgardner@wabtec.com>
|
||||||
|
Ben M Cahill <ben.m.cahill@intel.com>
|
||||||
|
Björn Steinbrink <B.Steinbrink@gmx.de>
|
||||||
|
Boris Brezillon <boris.brezillon@free-electrons.com>
|
||||||
|
Boris Brezillon <boris.brezillon@free-electrons.com> <b.brezillon.dev@gmail.com>
|
||||||
|
Boris Brezillon <boris.brezillon@free-electrons.com> <b.brezillon@overkiz.com>
|
||||||
|
Brian Avery <b.avery@hp.com>
|
||||||
|
Brian King <brking@us.ibm.com>
|
||||||
|
Christoph Hellwig <hch@lst.de>
|
||||||
|
Christophe Ricard <christophe.ricard@gmail.com>
|
||||||
|
Corey Minyard <minyard@acm.org>
|
||||||
|
Damian Hobson-Garcia <dhobsong@igel.co.jp>
|
||||||
|
David Brownell <david-b@pacbell.net>
|
||||||
|
David Woodhouse <dwmw2@shinybook.infradead.org>
|
||||||
|
Dmitry Eremin-Solenikov <dbaryshkov@gmail.com>
|
||||||
|
Domen Puncer <domen@coderock.org>
|
||||||
|
Douglas Gilbert <dougg@torque.net>
|
||||||
|
Ed L. Cashin <ecashin@coraid.com>
|
||||||
|
Evgeniy Polyakov <johnpol@2ka.mipt.ru>
|
||||||
|
Felipe W Damasio <felipewd@terra.com.br>
|
||||||
|
Felix Kuhling <fxkuehl@gmx.de>
|
||||||
|
Felix Moeller <felix@derklecks.de>
|
||||||
|
Filipe Lautert <filipe@icewall.org>
|
||||||
|
Franck Bui-Huu <vagabon.xyz@gmail.com>
|
||||||
|
Frank Rowand <frowand.list@gmail.com> <frowand@mvista.com>
|
||||||
|
Frank Rowand <frowand.list@gmail.com> <frank.rowand@am.sony.com>
|
||||||
|
Frank Rowand <frowand.list@gmail.com> <frank.rowand@sonymobile.com>
|
||||||
|
Frank Zago <fzago@systemfabricworks.com>
|
||||||
|
Greg Kroah-Hartman <greg@echidna.(none)>
|
||||||
|
Greg Kroah-Hartman <gregkh@suse.de>
|
||||||
|
Greg Kroah-Hartman <greg@kroah.com>
|
||||||
|
Henk Vergonet <Henk.Vergonet@gmail.com>
|
||||||
|
Henrik Kretzschmar <henne@nachtwindheim.de>
|
||||||
|
Henrik Rydberg <rydberg@bitmath.org>
|
||||||
|
Herbert Xu <herbert@gondor.apana.org.au>
|
||||||
|
Jacob Shin <Jacob.Shin@amd.com>
|
||||||
|
James Bottomley <jejb@mulgrave.(none)>
|
||||||
|
James Bottomley <jejb@titanic.il.steeleye.com>
|
||||||
|
James E Wilson <wilson@specifix.com>
|
||||||
|
James Ketrenos <jketreno@io.(none)>
|
||||||
|
Javi Merino <javi.merino@kernel.org> <javi.merino@arm.com>
|
||||||
|
<javier@osg.samsung.com> <javier.martinez@collabora.co.uk>
|
||||||
|
Jean Tourrilhes <jt@hpl.hp.com>
|
||||||
|
Jeff Garzik <jgarzik@pretzel.yyz.us>
|
||||||
|
Jens Axboe <axboe@suse.de>
|
||||||
|
Jens Osterkamp <Jens.Osterkamp@de.ibm.com>
|
||||||
|
Johan Hovold <johan@kernel.org> <jhovold@gmail.com>
|
||||||
|
Johan Hovold <johan@kernel.org> <johan@hovoldconsulting.com>
|
||||||
|
John Paul Adrian Glaubitz <glaubitz@physik.fu-berlin.de>
|
||||||
|
John Stultz <johnstul@us.ibm.com>
|
||||||
|
<josh@joshtriplett.org> <josh@freedesktop.org>
|
||||||
|
<josh@joshtriplett.org> <josh@kernel.org>
|
||||||
|
<josh@joshtriplett.org> <josht@linux.vnet.ibm.com>
|
||||||
|
<josh@joshtriplett.org> <josht@us.ibm.com>
|
||||||
|
<josh@joshtriplett.org> <josht@vnet.ibm.com>
|
||||||
|
Juha Yrjola <at solidboot.com>
|
||||||
|
Juha Yrjola <juha.yrjola@nokia.com>
|
||||||
|
Juha Yrjola <juha.yrjola@solidboot.com>
|
||||||
|
Kay Sievers <kay.sievers@vrfy.org>
|
||||||
|
Kenneth W Chen <kenneth.w.chen@intel.com>
|
||||||
|
Konstantin Khlebnikov <koct9i@gmail.com> <k.khlebnikov@samsung.com>
|
||||||
|
Koushik <raghavendra.koushik@neterion.com>
|
||||||
|
Krzysztof Kozlowski <krzk@kernel.org> <k.kozlowski@samsung.com>
|
||||||
|
Krzysztof Kozlowski <krzk@kernel.org> <k.kozlowski.k@gmail.com>
|
||||||
|
Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
|
||||||
|
Leonid I Ananiev <leonid.i.ananiev@intel.com>
|
||||||
|
Linas Vepstas <linas@austin.ibm.com>
|
||||||
|
Linus Lüssing <linus.luessing@c0d3.blue> <linus.luessing@web.de>
|
||||||
|
Linus Lüssing <linus.luessing@c0d3.blue> <linus.luessing@ascom.ch>
|
||||||
|
Mark Brown <broonie@sirena.org.uk>
|
||||||
|
Martin Kepplinger <martink@posteo.de> <martin.kepplinger@theobroma-systems.com>
|
||||||
|
Martin Kepplinger <martink@posteo.de> <martin.kepplinger@ginzinger.com>
|
||||||
|
Matthieu CASTET <castet.matthieu@free.fr>
|
||||||
|
Mauro Carvalho Chehab <mchehab@kernel.org> <mchehab@brturbo.com.br>
|
||||||
|
Mauro Carvalho Chehab <mchehab@kernel.org> <maurochehab@gmail.com>
|
||||||
|
Mauro Carvalho Chehab <mchehab@kernel.org> <mchehab@infradead.org>
|
||||||
|
Mauro Carvalho Chehab <mchehab@kernel.org> <mchehab@redhat.com>
|
||||||
|
Mauro Carvalho Chehab <mchehab@kernel.org> <m.chehab@samsung.com>
|
||||||
|
Mauro Carvalho Chehab <mchehab@kernel.org> <mchehab@osg.samsung.com>
|
||||||
|
Mauro Carvalho Chehab <mchehab@kernel.org> <mchehab@s-opensource.com>
|
||||||
|
Matt Ranostay <mranostay@gmail.com> Matthew Ranostay <mranostay@embeddedalley.com>
|
||||||
|
Matt Ranostay <mranostay@gmail.com> <matt.ranostay@intel.com>
|
||||||
|
Matt Ranostay <matt.ranostay@konsulko.com> <matt@ranostay.consulting>
|
||||||
|
Mayuresh Janorkar <mayur@ti.com>
|
||||||
|
Michael Buesch <m@bues.ch>
|
||||||
|
Michel Dänzer <michel@tungstengraphics.com>
|
||||||
|
Mitesh shah <mshah@teja.com>
|
||||||
|
Mohit Kumar <mohit.kumar@st.com> <mohit.kumar.dhaka@gmail.com>
|
||||||
|
Morten Welinder <terra@gnome.org>
|
||||||
|
Morten Welinder <welinder@anemone.rentec.com>
|
||||||
|
Morten Welinder <welinder@darter.rentec.com>
|
||||||
|
Morten Welinder <welinder@troll.com>
|
||||||
|
Mythri P K <mythripk@ti.com>
|
||||||
|
Nguyen Anh Quynh <aquynh@gmail.com>
|
||||||
|
Paolo 'Blaisorblade' Giarrusso <blaisorblade@yahoo.it>
|
||||||
|
Patrick Mochel <mochel@digitalimplant.org>
|
||||||
|
Peter A Jonsson <pj@ludd.ltu.se>
|
||||||
|
Peter Oruba <peter@oruba.de>
|
||||||
|
Peter Oruba <peter.oruba@amd.com>
|
||||||
|
Pratyush Anand <pratyush.anand@gmail.com> <pratyush.anand@st.com>
|
||||||
|
Praveen BP <praveenbp@ti.com>
|
||||||
|
Qais Yousef <qsyousef@gmail.com> <qais.yousef@imgtec.com>
|
||||||
|
Rajesh Shah <rajesh.shah@intel.com>
|
||||||
|
Ralf Baechle <ralf@linux-mips.org>
|
||||||
|
Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
|
||||||
|
Randy Dunlap <rdunlap@infradead.org> <rdunlap@xenotime.net>
|
||||||
|
Rémi Denis-Courmont <rdenis@simphalempin.com>
|
||||||
|
Ricardo Ribalda Delgado <ricardo.ribalda@gmail.com>
|
||||||
|
Rudolf Marek <R.Marek@sh.cvut.cz>
|
||||||
|
Rui Saraiva <rmps@joel.ist.utl.pt>
|
||||||
|
Sachin P Sant <ssant@in.ibm.com>
|
||||||
|
Sarangdhar Joshi <spjoshi@codeaurora.org>
|
||||||
|
Sam Ravnborg <sam@mars.ravnborg.org>
|
||||||
|
Santosh Shilimkar <ssantosh@kernel.org>
|
||||||
|
Santosh Shilimkar <santosh.shilimkar@oracle.org>
|
||||||
|
Sascha Hauer <s.hauer@pengutronix.de>
|
||||||
|
S.Çağlar Onur <caglar@pardus.org.tr>
|
||||||
|
Sebastian Reichel <sre@kernel.org> <sre@debian.org>
|
||||||
|
Sebastian Reichel <sre@kernel.org> <sebastian.reichel@collabora.co.uk>
|
||||||
|
Shiraz Hashim <shiraz.linux.kernel@gmail.com> <shiraz.hashim@st.com>
|
||||||
|
Shuah Khan <shuah@kernel.org> <shuahkhan@gmail.com>
|
||||||
|
Shuah Khan <shuah@kernel.org> <shuah.khan@hp.com>
|
||||||
|
Shuah Khan <shuah@kernel.org> <shuahkh@osg.samsung.com>
|
||||||
|
Shuah Khan <shuah@kernel.org> <shuah.kh@samsung.com>
|
||||||
|
Simon Kelley <simon@thekelleys.org.uk>
|
||||||
|
Stéphane Witzmann <stephane.witzmann@ubpmes.univ-bpclermont.fr>
|
||||||
|
Stephen Hemminger <shemminger@osdl.org>
|
||||||
|
Subash Abhinov Kasiviswanathan <subashab@codeaurora.org>
|
||||||
|
Subhash Jadavani <subhashj@codeaurora.org>
|
||||||
|
Sudeep Holla <sudeep.holla@arm.com> Sudeep KarkadaNagesha <sudeep.karkadanagesha@arm.com>
|
||||||
|
Sumit Semwal <sumit.semwal@ti.com>
|
||||||
|
Tejun Heo <htejun@gmail.com>
|
||||||
|
Thomas Graf <tgraf@suug.ch>
|
||||||
|
Thomas Pedersen <twp@codeaurora.org>
|
||||||
|
Tony Luck <tony.luck@intel.com>
|
||||||
|
Tsuneo Yoshioka <Tsuneo.Yoshioka@f-secure.com>
|
||||||
|
Uwe Kleine-König <ukleinek@informatik.uni-freiburg.de>
|
||||||
|
Uwe Kleine-König <ukl@pengutronix.de>
|
||||||
|
Uwe Kleine-König <Uwe.Kleine-Koenig@digi.com>
|
||||||
|
Valdis Kletnieks <Valdis.Kletnieks@vt.edu>
|
||||||
|
Viresh Kumar <vireshk@kernel.org> <viresh.kumar@st.com>
|
||||||
|
Viresh Kumar <vireshk@kernel.org> <viresh.linux@gmail.com>
|
||||||
|
Viresh Kumar <vireshk@kernel.org> <viresh.kumar2@arm.com>
|
||||||
|
Vlad Dogaru <ddvlad@gmail.com> <vlad.dogaru@intel.com>
|
||||||
|
Vladimir Davydov <vdavydov.dev@gmail.com> <vdavydov@virtuozzo.com>
|
||||||
|
Vladimir Davydov <vdavydov.dev@gmail.com> <vdavydov@parallels.com>
|
||||||
|
Takashi YOSHII <takashi.yoshii.zj@renesas.com>
|
||||||
|
Yakir Yang <kuankuan.y@gmail.com> <ykk@rock-chips.com>
|
||||||
|
Yusuke Goda <goda.yusuke@renesas.com>
|
||||||
|
Gustavo Padovan <gustavo@las.ic.unicamp.br>
|
||||||
|
Gustavo Padovan <padovan@profusion.mobi>
|
356
COPYING
Normal file
356
COPYING
Normal file
|
@ -0,0 +1,356 @@
|
||||||
|
|
||||||
|
NOTE! This copyright does *not* cover user programs that use kernel
|
||||||
|
services by normal system calls - this is merely considered normal use
|
||||||
|
of the kernel, and does *not* fall under the heading of "derived work".
|
||||||
|
Also note that the GPL below is copyrighted by the Free Software
|
||||||
|
Foundation, but the instance of code that it refers to (the Linux
|
||||||
|
kernel) is copyrighted by me and others who actually wrote it.
|
||||||
|
|
||||||
|
Also note that the only valid version of the GPL as far as the kernel
|
||||||
|
is concerned is _this_ particular version of the license (ie v2, not
|
||||||
|
v2.2 or v3.x or whatever), unless explicitly otherwise stated.
|
||||||
|
|
||||||
|
Linus Torvalds
|
||||||
|
|
||||||
|
----------------------------------------
|
||||||
|
|
||||||
|
GNU GENERAL PUBLIC LICENSE
|
||||||
|
Version 2, June 1991
|
||||||
|
|
||||||
|
Copyright (C) 1989, 1991 Free Software Foundation, Inc.
|
||||||
|
51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
||||||
|
Everyone is permitted to copy and distribute verbatim copies
|
||||||
|
of this license document, but changing it is not allowed.
|
||||||
|
|
||||||
|
Preamble
|
||||||
|
|
||||||
|
The licenses for most software are designed to take away your
|
||||||
|
freedom to share and change it. By contrast, the GNU General Public
|
||||||
|
License is intended to guarantee your freedom to share and change free
|
||||||
|
software--to make sure the software is free for all its users. This
|
||||||
|
General Public License applies to most of the Free Software
|
||||||
|
Foundation's software and to any other program whose authors commit to
|
||||||
|
using it. (Some other Free Software Foundation software is covered by
|
||||||
|
the GNU Library General Public License instead.) You can apply it to
|
||||||
|
your programs, too.
|
||||||
|
|
||||||
|
When we speak of free software, we are referring to freedom, not
|
||||||
|
price. Our General Public Licenses are designed to make sure that you
|
||||||
|
have the freedom to distribute copies of free software (and charge for
|
||||||
|
this service if you wish), that you receive source code or can get it
|
||||||
|
if you want it, that you can change the software or use pieces of it
|
||||||
|
in new free programs; and that you know you can do these things.
|
||||||
|
|
||||||
|
To protect your rights, we need to make restrictions that forbid
|
||||||
|
anyone to deny you these rights or to ask you to surrender the rights.
|
||||||
|
These restrictions translate to certain responsibilities for you if you
|
||||||
|
distribute copies of the software, or if you modify it.
|
||||||
|
|
||||||
|
For example, if you distribute copies of such a program, whether
|
||||||
|
gratis or for a fee, you must give the recipients all the rights that
|
||||||
|
you have. You must make sure that they, too, receive or can get the
|
||||||
|
source code. And you must show them these terms so they know their
|
||||||
|
rights.
|
||||||
|
|
||||||
|
We protect your rights with two steps: (1) copyright the software, and
|
||||||
|
(2) offer you this license which gives you legal permission to copy,
|
||||||
|
distribute and/or modify the software.
|
||||||
|
|
||||||
|
Also, for each author's protection and ours, we want to make certain
|
||||||
|
that everyone understands that there is no warranty for this free
|
||||||
|
software. If the software is modified by someone else and passed on, we
|
||||||
|
want its recipients to know that what they have is not the original, so
|
||||||
|
that any problems introduced by others will not reflect on the original
|
||||||
|
authors' reputations.
|
||||||
|
|
||||||
|
Finally, any free program is threatened constantly by software
|
||||||
|
patents. We wish to avoid the danger that redistributors of a free
|
||||||
|
program will individually obtain patent licenses, in effect making the
|
||||||
|
program proprietary. To prevent this, we have made it clear that any
|
||||||
|
patent must be licensed for everyone's free use or not licensed at all.
|
||||||
|
|
||||||
|
The precise terms and conditions for copying, distribution and
|
||||||
|
modification follow.
|
||||||
|
|
||||||
|
GNU GENERAL PUBLIC LICENSE
|
||||||
|
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
|
||||||
|
|
||||||
|
0. This License applies to any program or other work which contains
|
||||||
|
a notice placed by the copyright holder saying it may be distributed
|
||||||
|
under the terms of this General Public License. The "Program", below,
|
||||||
|
refers to any such program or work, and a "work based on the Program"
|
||||||
|
means either the Program or any derivative work under copyright law:
|
||||||
|
that is to say, a work containing the Program or a portion of it,
|
||||||
|
either verbatim or with modifications and/or translated into another
|
||||||
|
language. (Hereinafter, translation is included without limitation in
|
||||||
|
the term "modification".) Each licensee is addressed as "you".
|
||||||
|
|
||||||
|
Activities other than copying, distribution and modification are not
|
||||||
|
covered by this License; they are outside its scope. The act of
|
||||||
|
running the Program is not restricted, and the output from the Program
|
||||||
|
is covered only if its contents constitute a work based on the
|
||||||
|
Program (independent of having been made by running the Program).
|
||||||
|
Whether that is true depends on what the Program does.
|
||||||
|
|
||||||
|
1. You may copy and distribute verbatim copies of the Program's
|
||||||
|
source code as you receive it, in any medium, provided that you
|
||||||
|
conspicuously and appropriately publish on each copy an appropriate
|
||||||
|
copyright notice and disclaimer of warranty; keep intact all the
|
||||||
|
notices that refer to this License and to the absence of any warranty;
|
||||||
|
and give any other recipients of the Program a copy of this License
|
||||||
|
along with the Program.
|
||||||
|
|
||||||
|
You may charge a fee for the physical act of transferring a copy, and
|
||||||
|
you may at your option offer warranty protection in exchange for a fee.
|
||||||
|
|
||||||
|
2. You may modify your copy or copies of the Program or any portion
|
||||||
|
of it, thus forming a work based on the Program, and copy and
|
||||||
|
distribute such modifications or work under the terms of Section 1
|
||||||
|
above, provided that you also meet all of these conditions:
|
||||||
|
|
||||||
|
a) You must cause the modified files to carry prominent notices
|
||||||
|
stating that you changed the files and the date of any change.
|
||||||
|
|
||||||
|
b) You must cause any work that you distribute or publish, that in
|
||||||
|
whole or in part contains or is derived from the Program or any
|
||||||
|
part thereof, to be licensed as a whole at no charge to all third
|
||||||
|
parties under the terms of this License.
|
||||||
|
|
||||||
|
c) If the modified program normally reads commands interactively
|
||||||
|
when run, you must cause it, when started running for such
|
||||||
|
interactive use in the most ordinary way, to print or display an
|
||||||
|
announcement including an appropriate copyright notice and a
|
||||||
|
notice that there is no warranty (or else, saying that you provide
|
||||||
|
a warranty) and that users may redistribute the program under
|
||||||
|
these conditions, and telling the user how to view a copy of this
|
||||||
|
License. (Exception: if the Program itself is interactive but
|
||||||
|
does not normally print such an announcement, your work based on
|
||||||
|
the Program is not required to print an announcement.)
|
||||||
|
|
||||||
|
These requirements apply to the modified work as a whole. If
|
||||||
|
identifiable sections of that work are not derived from the Program,
|
||||||
|
and can be reasonably considered independent and separate works in
|
||||||
|
themselves, then this License, and its terms, do not apply to those
|
||||||
|
sections when you distribute them as separate works. But when you
|
||||||
|
distribute the same sections as part of a whole which is a work based
|
||||||
|
on the Program, the distribution of the whole must be on the terms of
|
||||||
|
this License, whose permissions for other licensees extend to the
|
||||||
|
entire whole, and thus to each and every part regardless of who wrote it.
|
||||||
|
|
||||||
|
Thus, it is not the intent of this section to claim rights or contest
|
||||||
|
your rights to work written entirely by you; rather, the intent is to
|
||||||
|
exercise the right to control the distribution of derivative or
|
||||||
|
collective works based on the Program.
|
||||||
|
|
||||||
|
In addition, mere aggregation of another work not based on the Program
|
||||||
|
with the Program (or with a work based on the Program) on a volume of
|
||||||
|
a storage or distribution medium does not bring the other work under
|
||||||
|
the scope of this License.
|
||||||
|
|
||||||
|
3. You may copy and distribute the Program (or a work based on it,
|
||||||
|
under Section 2) in object code or executable form under the terms of
|
||||||
|
Sections 1 and 2 above provided that you also do one of the following:
|
||||||
|
|
||||||
|
a) Accompany it with the complete corresponding machine-readable
|
||||||
|
source code, which must be distributed under the terms of Sections
|
||||||
|
1 and 2 above on a medium customarily used for software interchange; or,
|
||||||
|
|
||||||
|
b) Accompany it with a written offer, valid for at least three
|
||||||
|
years, to give any third party, for a charge no more than your
|
||||||
|
cost of physically performing source distribution, a complete
|
||||||
|
machine-readable copy of the corresponding source code, to be
|
||||||
|
distributed under the terms of Sections 1 and 2 above on a medium
|
||||||
|
customarily used for software interchange; or,
|
||||||
|
|
||||||
|
c) Accompany it with the information you received as to the offer
|
||||||
|
to distribute corresponding source code. (This alternative is
|
||||||
|
allowed only for noncommercial distribution and only if you
|
||||||
|
received the program in object code or executable form with such
|
||||||
|
an offer, in accord with Subsection b above.)
|
||||||
|
|
||||||
|
The source code for a work means the preferred form of the work for
|
||||||
|
making modifications to it. For an executable work, complete source
|
||||||
|
code means all the source code for all modules it contains, plus any
|
||||||
|
associated interface definition files, plus the scripts used to
|
||||||
|
control compilation and installation of the executable. However, as a
|
||||||
|
special exception, the source code distributed need not include
|
||||||
|
anything that is normally distributed (in either source or binary
|
||||||
|
form) with the major components (compiler, kernel, and so on) of the
|
||||||
|
operating system on which the executable runs, unless that component
|
||||||
|
itself accompanies the executable.
|
||||||
|
|
||||||
|
If distribution of executable or object code is made by offering
|
||||||
|
access to copy from a designated place, then offering equivalent
|
||||||
|
access to copy the source code from the same place counts as
|
||||||
|
distribution of the source code, even though third parties are not
|
||||||
|
compelled to copy the source along with the object code.
|
||||||
|
|
||||||
|
4. You may not copy, modify, sublicense, or distribute the Program
|
||||||
|
except as expressly provided under this License. Any attempt
|
||||||
|
otherwise to copy, modify, sublicense or distribute the Program is
|
||||||
|
void, and will automatically terminate your rights under this License.
|
||||||
|
However, parties who have received copies, or rights, from you under
|
||||||
|
this License will not have their licenses terminated so long as such
|
||||||
|
parties remain in full compliance.
|
||||||
|
|
||||||
|
5. You are not required to accept this License, since you have not
|
||||||
|
signed it. However, nothing else grants you permission to modify or
|
||||||
|
distribute the Program or its derivative works. These actions are
|
||||||
|
prohibited by law if you do not accept this License. Therefore, by
|
||||||
|
modifying or distributing the Program (or any work based on the
|
||||||
|
Program), you indicate your acceptance of this License to do so, and
|
||||||
|
all its terms and conditions for copying, distributing or modifying
|
||||||
|
the Program or works based on it.
|
||||||
|
|
||||||
|
6. Each time you redistribute the Program (or any work based on the
|
||||||
|
Program), the recipient automatically receives a license from the
|
||||||
|
original licensor to copy, distribute or modify the Program subject to
|
||||||
|
these terms and conditions. You may not impose any further
|
||||||
|
restrictions on the recipients' exercise of the rights granted herein.
|
||||||
|
You are not responsible for enforcing compliance by third parties to
|
||||||
|
this License.
|
||||||
|
|
||||||
|
7. If, as a consequence of a court judgment or allegation of patent
|
||||||
|
infringement or for any other reason (not limited to patent issues),
|
||||||
|
conditions are imposed on you (whether by court order, agreement or
|
||||||
|
otherwise) that contradict the conditions of this License, they do not
|
||||||
|
excuse you from the conditions of this License. If you cannot
|
||||||
|
distribute so as to satisfy simultaneously your obligations under this
|
||||||
|
License and any other pertinent obligations, then as a consequence you
|
||||||
|
may not distribute the Program at all. For example, if a patent
|
||||||
|
license would not permit royalty-free redistribution of the Program by
|
||||||
|
all those who receive copies directly or indirectly through you, then
|
||||||
|
the only way you could satisfy both it and this License would be to
|
||||||
|
refrain entirely from distribution of the Program.
|
||||||
|
|
||||||
|
If any portion of this section is held invalid or unenforceable under
|
||||||
|
any particular circumstance, the balance of the section is intended to
|
||||||
|
apply and the section as a whole is intended to apply in other
|
||||||
|
circumstances.
|
||||||
|
|
||||||
|
It is not the purpose of this section to induce you to infringe any
|
||||||
|
patents or other property right claims or to contest validity of any
|
||||||
|
such claims; this section has the sole purpose of protecting the
|
||||||
|
integrity of the free software distribution system, which is
|
||||||
|
implemented by public license practices. Many people have made
|
||||||
|
generous contributions to the wide range of software distributed
|
||||||
|
through that system in reliance on consistent application of that
|
||||||
|
system; it is up to the author/donor to decide if he or she is willing
|
||||||
|
to distribute software through any other system and a licensee cannot
|
||||||
|
impose that choice.
|
||||||
|
|
||||||
|
This section is intended to make thoroughly clear what is believed to
|
||||||
|
be a consequence of the rest of this License.
|
||||||
|
|
||||||
|
8. If the distribution and/or use of the Program is restricted in
|
||||||
|
certain countries either by patents or by copyrighted interfaces, the
|
||||||
|
original copyright holder who places the Program under this License
|
||||||
|
may add an explicit geographical distribution limitation excluding
|
||||||
|
those countries, so that distribution is permitted only in or among
|
||||||
|
countries not thus excluded. In such case, this License incorporates
|
||||||
|
the limitation as if written in the body of this License.
|
||||||
|
|
||||||
|
9. The Free Software Foundation may publish revised and/or new versions
|
||||||
|
of the General Public License from time to time. Such new versions will
|
||||||
|
be similar in spirit to the present version, but may differ in detail to
|
||||||
|
address new problems or concerns.
|
||||||
|
|
||||||
|
Each version is given a distinguishing version number. If the Program
|
||||||
|
specifies a version number of this License which applies to it and "any
|
||||||
|
later version", you have the option of following the terms and conditions
|
||||||
|
either of that version or of any later version published by the Free
|
||||||
|
Software Foundation. If the Program does not specify a version number of
|
||||||
|
this License, you may choose any version ever published by the Free Software
|
||||||
|
Foundation.
|
||||||
|
|
||||||
|
10. If you wish to incorporate parts of the Program into other free
|
||||||
|
programs whose distribution conditions are different, write to the author
|
||||||
|
to ask for permission. For software which is copyrighted by the Free
|
||||||
|
Software Foundation, write to the Free Software Foundation; we sometimes
|
||||||
|
make exceptions for this. Our decision will be guided by the two goals
|
||||||
|
of preserving the free status of all derivatives of our free software and
|
||||||
|
of promoting the sharing and reuse of software generally.
|
||||||
|
|
||||||
|
NO WARRANTY
|
||||||
|
|
||||||
|
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
|
||||||
|
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
|
||||||
|
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
|
||||||
|
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
|
||||||
|
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
||||||
|
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
|
||||||
|
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
|
||||||
|
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
|
||||||
|
REPAIR OR CORRECTION.
|
||||||
|
|
||||||
|
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||||
|
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
|
||||||
|
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
|
||||||
|
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
|
||||||
|
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
|
||||||
|
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
|
||||||
|
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
|
||||||
|
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
|
||||||
|
POSSIBILITY OF SUCH DAMAGES.
|
||||||
|
|
||||||
|
END OF TERMS AND CONDITIONS
|
||||||
|
|
||||||
|
How to Apply These Terms to Your New Programs
|
||||||
|
|
||||||
|
If you develop a new program, and you want it to be of the greatest
|
||||||
|
possible use to the public, the best way to achieve this is to make it
|
||||||
|
free software which everyone can redistribute and change under these terms.
|
||||||
|
|
||||||
|
To do so, attach the following notices to the program. It is safest
|
||||||
|
to attach them to the start of each source file to most effectively
|
||||||
|
convey the exclusion of warranty; and each file should have at least
|
||||||
|
the "copyright" line and a pointer to where the full notice is found.
|
||||||
|
|
||||||
|
<one line to give the program's name and a brief idea of what it does.>
|
||||||
|
Copyright (C) <year> <name of author>
|
||||||
|
|
||||||
|
This program is free software; you can redistribute it and/or modify
|
||||||
|
it under the terms of the GNU General Public License as published by
|
||||||
|
the Free Software Foundation; either version 2 of the License, or
|
||||||
|
(at your option) any later version.
|
||||||
|
|
||||||
|
This program is distributed in the hope that it will be useful,
|
||||||
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
GNU General Public License for more details.
|
||||||
|
|
||||||
|
You should have received a copy of the GNU General Public License
|
||||||
|
along with this program; if not, write to the Free Software
|
||||||
|
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
||||||
|
|
||||||
|
|
||||||
|
Also add information on how to contact you by electronic and paper mail.
|
||||||
|
|
||||||
|
If the program is interactive, make it output a short notice like this
|
||||||
|
when it starts in an interactive mode:
|
||||||
|
|
||||||
|
Gnomovision version 69, Copyright (C) year name of author
|
||||||
|
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||||
|
This is free software, and you are welcome to redistribute it
|
||||||
|
under certain conditions; type `show c' for details.
|
||||||
|
|
||||||
|
The hypothetical commands `show w' and `show c' should show the appropriate
|
||||||
|
parts of the General Public License. Of course, the commands you use may
|
||||||
|
be called something other than `show w' and `show c'; they could even be
|
||||||
|
mouse-clicks or menu items--whatever suits your program.
|
||||||
|
|
||||||
|
You should also get your employer (if you work as a programmer) or your
|
||||||
|
school, if any, to sign a "copyright disclaimer" for the program, if
|
||||||
|
necessary. Here is a sample; alter the names:
|
||||||
|
|
||||||
|
Yoyodyne, Inc., hereby disclaims all copyright interest in the program
|
||||||
|
`Gnomovision' (which makes passes at compilers) written by James Hacker.
|
||||||
|
|
||||||
|
<signature of Ty Coon>, 1 April 1989
|
||||||
|
Ty Coon, President of Vice
|
||||||
|
|
||||||
|
This General Public License does not permit incorporating your program into
|
||||||
|
proprietary programs. If your program is a subroutine library, you may
|
||||||
|
consider it more useful to permit linking proprietary applications with the
|
||||||
|
library. If this is what you want to do, use the GNU Library General
|
||||||
|
Public License instead of this License.
|
2
Documentation/.gitignore
vendored
Normal file
2
Documentation/.gitignore
vendored
Normal file
|
@ -0,0 +1,2 @@
|
||||||
|
output
|
||||||
|
*.pyc
|
456
Documentation/00-INDEX
Normal file
456
Documentation/00-INDEX
Normal file
|
@ -0,0 +1,456 @@
|
||||||
|
|
||||||
|
This is a brief list of all the files in ./linux/Documentation and what
|
||||||
|
they contain. If you add a documentation file, please list it here in
|
||||||
|
alphabetical order as well, or risk being hunted down like a rabid dog.
|
||||||
|
Please keep the descriptions small enough to fit on one line.
|
||||||
|
Thanks -- Paul G.
|
||||||
|
|
||||||
|
Following translations are available on the WWW:
|
||||||
|
|
||||||
|
- Japanese, maintained by the JF Project (jf@listserv.linux.or.jp), at
|
||||||
|
http://linuxjf.sourceforge.jp/
|
||||||
|
|
||||||
|
00-INDEX
|
||||||
|
- this file.
|
||||||
|
ABI/
|
||||||
|
- info on kernel <-> userspace ABI and relative interface stability.
|
||||||
|
CodingStyle
|
||||||
|
- nothing here, just a pointer to process/coding-style.rst.
|
||||||
|
DMA-API.txt
|
||||||
|
- DMA API, pci_ API & extensions for non-consistent memory machines.
|
||||||
|
DMA-API-HOWTO.txt
|
||||||
|
- Dynamic DMA mapping Guide
|
||||||
|
DMA-ISA-LPC.txt
|
||||||
|
- How to do DMA with ISA (and LPC) devices.
|
||||||
|
DMA-attributes.txt
|
||||||
|
- listing of the various possible attributes a DMA region can have
|
||||||
|
DocBook/
|
||||||
|
- directory with DocBook templates etc. for kernel documentation.
|
||||||
|
EDID/
|
||||||
|
- directory with info on customizing EDID for broken gfx/displays.
|
||||||
|
IPMI.txt
|
||||||
|
- info on Linux Intelligent Platform Management Interface (IPMI) Driver.
|
||||||
|
IRQ-affinity.txt
|
||||||
|
- how to select which CPU(s) handle which interrupt events on SMP.
|
||||||
|
IRQ-domain.txt
|
||||||
|
- info on interrupt numbering and setting up IRQ domains.
|
||||||
|
IRQ.txt
|
||||||
|
- description of what an IRQ is.
|
||||||
|
Intel-IOMMU.txt
|
||||||
|
- basic info on the Intel IOMMU virtualization support.
|
||||||
|
Makefile
|
||||||
|
- It's not of interest for those who aren't touching the build system.
|
||||||
|
Makefile.sphinx
|
||||||
|
- It's not of interest for those who aren't touching the build system.
|
||||||
|
PCI/
|
||||||
|
- info related to PCI drivers.
|
||||||
|
RCU/
|
||||||
|
- directory with info on RCU (read-copy update).
|
||||||
|
SAK.txt
|
||||||
|
- info on Secure Attention Keys.
|
||||||
|
SM501.txt
|
||||||
|
- Silicon Motion SM501 multimedia companion chip
|
||||||
|
SubmittingPatches
|
||||||
|
- nothing here, just a pointer to process/coding-style.rst.
|
||||||
|
accounting/
|
||||||
|
- documentation on accounting and taskstats.
|
||||||
|
acpi/
|
||||||
|
- info on ACPI-specific hooks in the kernel.
|
||||||
|
admin-guide/
|
||||||
|
- info related to Linux users and system admins.
|
||||||
|
aoe/
|
||||||
|
- description of AoE (ATA over Ethernet) along with config examples.
|
||||||
|
arm/
|
||||||
|
- directory with info about Linux on the ARM architecture.
|
||||||
|
arm64/
|
||||||
|
- directory with info about Linux on the 64 bit ARM architecture.
|
||||||
|
auxdisplay/
|
||||||
|
- misc. LCD driver documentation (cfag12864b, ks0108).
|
||||||
|
backlight/
|
||||||
|
- directory with info on controlling backlights in flat panel displays
|
||||||
|
bcache.txt
|
||||||
|
- Block-layer cache on fast SSDs to improve slow (raid) I/O performance.
|
||||||
|
blackfin/
|
||||||
|
- directory with documentation for the Blackfin arch.
|
||||||
|
block/
|
||||||
|
- info on the Block I/O (BIO) layer.
|
||||||
|
blockdev/
|
||||||
|
- info on block devices & drivers
|
||||||
|
bt8xxgpio.txt
|
||||||
|
- info on how to modify a bt8xx video card for GPIO usage.
|
||||||
|
btmrvl.txt
|
||||||
|
- info on Marvell Bluetooth driver usage.
|
||||||
|
bus-devices/
|
||||||
|
- directory with info on TI GPMC (General Purpose Memory Controller)
|
||||||
|
bus-virt-phys-mapping.txt
|
||||||
|
- how to access I/O mapped memory from within device drivers.
|
||||||
|
cachetlb.txt
|
||||||
|
- describes the cache/TLB flushing interfaces Linux uses.
|
||||||
|
cdrom/
|
||||||
|
- directory with information on the CD-ROM drivers that Linux has.
|
||||||
|
cgroup-v1/
|
||||||
|
- cgroups v1 features, including cpusets and memory controller.
|
||||||
|
cgroup-v2.txt
|
||||||
|
- cgroups v2 features, including cpusets and memory controller.
|
||||||
|
circular-buffers.txt
|
||||||
|
- how to make use of the existing circular buffer infrastructure
|
||||||
|
clk.txt
|
||||||
|
- info on the common clock framework
|
||||||
|
cma/
|
||||||
|
- Continuous Memory Area (CMA) debugfs interface.
|
||||||
|
conf.py
|
||||||
|
- It's not of interest for those who aren't touching the build system.
|
||||||
|
connector/
|
||||||
|
- docs on the netlink based userspace<->kernel space communication mod.
|
||||||
|
console/
|
||||||
|
- documentation on Linux console drivers.
|
||||||
|
core-api/
|
||||||
|
- documentation on kernel core components.
|
||||||
|
cpu-freq/
|
||||||
|
- info on CPU frequency and voltage scaling.
|
||||||
|
cpu-hotplug.txt
|
||||||
|
- document describing CPU hotplug support in the Linux kernel.
|
||||||
|
cpu-load.txt
|
||||||
|
- document describing how CPU load statistics are collected.
|
||||||
|
cpuidle/
|
||||||
|
- info on CPU_IDLE, CPU idle state management subsystem.
|
||||||
|
cputopology.txt
|
||||||
|
- documentation on how CPU topology info is exported via sysfs.
|
||||||
|
crc32.txt
|
||||||
|
- brief tutorial on CRC computation
|
||||||
|
cris/
|
||||||
|
- directory with info about Linux on CRIS architecture.
|
||||||
|
crypto/
|
||||||
|
- directory with info on the Crypto API.
|
||||||
|
dcdbas.txt
|
||||||
|
- information on the Dell Systems Management Base Driver.
|
||||||
|
debugging-modules.txt
|
||||||
|
- some notes on debugging modules after Linux 2.6.3.
|
||||||
|
debugging-via-ohci1394.txt
|
||||||
|
- how to use firewire like a hardware debugger memory reader.
|
||||||
|
dell_rbu.txt
|
||||||
|
- document demonstrating the use of the Dell Remote BIOS Update driver.
|
||||||
|
dev-tools/
|
||||||
|
- directory with info on development tools for the kernel.
|
||||||
|
device-mapper/
|
||||||
|
- directory with info on Device Mapper.
|
||||||
|
dmaengine/
|
||||||
|
- the DMA engine and controller API guides.
|
||||||
|
devicetree/
|
||||||
|
- directory with info on device tree files used by OF/PowerPC/ARM
|
||||||
|
digsig.txt
|
||||||
|
-info on the Digital Signature Verification API
|
||||||
|
dma-buf-sharing.txt
|
||||||
|
- the DMA Buffer Sharing API Guide
|
||||||
|
docutils.conf
|
||||||
|
- nothing here. Just a configuration file for docutils.
|
||||||
|
dontdiff
|
||||||
|
- file containing a list of files that should never be diff'ed.
|
||||||
|
driver-api/
|
||||||
|
- the Linux driver implementer's API guide.
|
||||||
|
driver-model/
|
||||||
|
- directory with info about Linux driver model.
|
||||||
|
early-userspace/
|
||||||
|
- info about initramfs, klibc, and userspace early during boot.
|
||||||
|
efi-stub.txt
|
||||||
|
- How to use the EFI boot stub to bypass GRUB or elilo on EFI systems.
|
||||||
|
eisa.txt
|
||||||
|
- info on EISA bus support.
|
||||||
|
extcon/
|
||||||
|
- directory with porting guide for Android kernel switch driver.
|
||||||
|
isa.txt
|
||||||
|
- info on EISA bus support.
|
||||||
|
fault-injection/
|
||||||
|
- dir with docs about the fault injection capabilities infrastructure.
|
||||||
|
fb/
|
||||||
|
- directory with info on the frame buffer graphics abstraction layer.
|
||||||
|
features/
|
||||||
|
- status of feature implementation on different architectures.
|
||||||
|
filesystems/
|
||||||
|
- info on the vfs and the various filesystems that Linux supports.
|
||||||
|
firmware_class/
|
||||||
|
- request_firmware() hotplug interface info.
|
||||||
|
flexible-arrays.txt
|
||||||
|
- how to make use of flexible sized arrays in linux
|
||||||
|
fmc/
|
||||||
|
- information about the FMC bus abstraction
|
||||||
|
fpga/
|
||||||
|
- FPGA Manager Core.
|
||||||
|
frv/
|
||||||
|
- Fujitsu FR-V Linux documentation.
|
||||||
|
futex-requeue-pi.txt
|
||||||
|
- info on requeueing of tasks from a non-PI futex to a PI futex
|
||||||
|
gcc-plugins.txt
|
||||||
|
- GCC plugin infrastructure.
|
||||||
|
gpio/
|
||||||
|
- gpio related documentation
|
||||||
|
gpu/
|
||||||
|
- directory with information on GPU driver developer's guide.
|
||||||
|
hid/
|
||||||
|
- directory with information on human interface devices
|
||||||
|
highuid.txt
|
||||||
|
- notes on the change from 16 bit to 32 bit user/group IDs.
|
||||||
|
hwspinlock.txt
|
||||||
|
- hardware spinlock provides hardware assistance for synchronization
|
||||||
|
timers/
|
||||||
|
- info on the timer related topics
|
||||||
|
hw_random.txt
|
||||||
|
- info on Linux support for random number generator in i8xx chipsets.
|
||||||
|
hwmon/
|
||||||
|
- directory with docs on various hardware monitoring drivers.
|
||||||
|
i2c/
|
||||||
|
- directory with info about the I2C bus/protocol (2 wire, kHz speed).
|
||||||
|
x86/i386/
|
||||||
|
- directory with info about Linux on Intel 32 bit architecture.
|
||||||
|
ia64/
|
||||||
|
- directory with info about Linux on Intel 64 bit architecture.
|
||||||
|
ide/
|
||||||
|
- Information regarding the Enhanced IDE drive.
|
||||||
|
iio/
|
||||||
|
- info on industrial IIO configfs support.
|
||||||
|
index.rst
|
||||||
|
- main index for the documentation at ReST format.
|
||||||
|
infiniband/
|
||||||
|
- directory with documents concerning Linux InfiniBand support.
|
||||||
|
input/
|
||||||
|
- info on Linux input device support.
|
||||||
|
intel_txt.txt
|
||||||
|
- info on intel Trusted Execution Technology (intel TXT).
|
||||||
|
io-mapping.txt
|
||||||
|
- description of io_mapping functions in linux/io-mapping.h
|
||||||
|
io_ordering.txt
|
||||||
|
- info on ordering I/O writes to memory-mapped addresses.
|
||||||
|
ioctl/
|
||||||
|
- directory with documents describing various IOCTL calls.
|
||||||
|
iostats.txt
|
||||||
|
- info on I/O statistics Linux kernel provides.
|
||||||
|
irqflags-tracing.txt
|
||||||
|
- how to use the irq-flags tracing feature.
|
||||||
|
isapnp.txt
|
||||||
|
- info on Linux ISA Plug & Play support.
|
||||||
|
isdn/
|
||||||
|
- directory with info on the Linux ISDN support, and supported cards.
|
||||||
|
kbuild/
|
||||||
|
- directory with info about the kernel build process.
|
||||||
|
kernel-doc-nano-HOWTO.txt
|
||||||
|
- outdated info about kernel-doc documentation.
|
||||||
|
kdump/
|
||||||
|
- directory with mini HowTo on getting the crash dump code to work.
|
||||||
|
doc-guide/
|
||||||
|
- how to write and format reStructuredText kernel documentation
|
||||||
|
kernel-per-CPU-kthreads.txt
|
||||||
|
- List of all per-CPU kthreads and how they introduce jitter.
|
||||||
|
kobject.txt
|
||||||
|
- info of the kobject infrastructure of the Linux kernel.
|
||||||
|
kprobes.txt
|
||||||
|
- documents the kernel probes debugging feature.
|
||||||
|
kref.txt
|
||||||
|
- docs on adding reference counters (krefs) to kernel objects.
|
||||||
|
kselftest.txt
|
||||||
|
- small unittests for (some) individual codepaths in the kernel.
|
||||||
|
laptops/
|
||||||
|
- directory with laptop related info and laptop driver documentation.
|
||||||
|
ldm.txt
|
||||||
|
- a brief description of LDM (Windows Dynamic Disks).
|
||||||
|
leds/
|
||||||
|
- directory with info about LED handling under Linux.
|
||||||
|
livepatch/
|
||||||
|
- info on kernel live patching.
|
||||||
|
locking/
|
||||||
|
- directory with info about kernel locking primitives
|
||||||
|
lockup-watchdogs.txt
|
||||||
|
- info on soft and hard lockup detectors (aka nmi_watchdog).
|
||||||
|
logo.gif
|
||||||
|
- full colour GIF image of Linux logo (penguin - Tux).
|
||||||
|
logo.txt
|
||||||
|
- info on creator of above logo & site to get additional images from.
|
||||||
|
lzo.txt
|
||||||
|
- kernel LZO decompressor input formats
|
||||||
|
m68k/
|
||||||
|
- directory with info about Linux on Motorola 68k architecture.
|
||||||
|
mailbox.txt
|
||||||
|
- How to write drivers for the common mailbox framework (IPC).
|
||||||
|
md/
|
||||||
|
- directory with info about Linux Software RAID
|
||||||
|
media/
|
||||||
|
- info on media drivers: uAPI, kAPI and driver documentation.
|
||||||
|
memory-barriers.txt
|
||||||
|
- info on Linux kernel memory barriers.
|
||||||
|
memory-devices/
|
||||||
|
- directory with info on parts like the Texas Instruments EMIF driver
|
||||||
|
memory-hotplug.txt
|
||||||
|
- Hotpluggable memory support, how to use and current status.
|
||||||
|
men-chameleon-bus.txt
|
||||||
|
- info on MEN chameleon bus.
|
||||||
|
metag/
|
||||||
|
- directory with info about Linux on Meta architecture.
|
||||||
|
mic/
|
||||||
|
- Intel Many Integrated Core (MIC) architecture device driver.
|
||||||
|
mips/
|
||||||
|
- directory with info about Linux on MIPS architecture.
|
||||||
|
misc-devices/
|
||||||
|
- directory with info about devices using the misc dev subsystem
|
||||||
|
mmc/
|
||||||
|
- directory with info about the MMC subsystem
|
||||||
|
mn10300/
|
||||||
|
- directory with info about the mn10300 architecture port
|
||||||
|
mtd/
|
||||||
|
- directory with info about memory technology devices (flash)
|
||||||
|
namespaces/
|
||||||
|
- directory with various information about namespaces
|
||||||
|
netlabel/
|
||||||
|
- directory with information on the NetLabel subsystem.
|
||||||
|
networking/
|
||||||
|
- directory with info on various aspects of networking with Linux.
|
||||||
|
nfc/
|
||||||
|
- directory relating info about Near Field Communications support.
|
||||||
|
nios2/
|
||||||
|
- Linux on the Nios II architecture.
|
||||||
|
nommu-mmap.txt
|
||||||
|
- documentation about no-mmu memory mapping support.
|
||||||
|
numastat.txt
|
||||||
|
- info on how to read Numa policy hit/miss statistics in sysfs.
|
||||||
|
ntb.txt
|
||||||
|
- info on Non-Transparent Bridge (NTB) drivers.
|
||||||
|
nvdimm/
|
||||||
|
- info on non-volatile devices.
|
||||||
|
nvmem/
|
||||||
|
- info on non volatile memory framework.
|
||||||
|
output/
|
||||||
|
- default directory where html/LaTeX/pdf files will be written.
|
||||||
|
padata.txt
|
||||||
|
- An introduction to the "padata" parallel execution API
|
||||||
|
parisc/
|
||||||
|
- directory with info on using Linux on PA-RISC architecture.
|
||||||
|
parport-lowlevel.txt
|
||||||
|
- description and usage of the low level parallel port functions.
|
||||||
|
pcmcia/
|
||||||
|
- info on the Linux PCMCIA driver.
|
||||||
|
percpu-rw-semaphore.txt
|
||||||
|
- RCU based read-write semaphore optimized for locking for reading
|
||||||
|
perf/
|
||||||
|
- info about the APM X-Gene SoC Performance Monitoring Unit (PMU).
|
||||||
|
phy/
|
||||||
|
- ino on Samsung USB 2.0 PHY adaptation layer.
|
||||||
|
phy.txt
|
||||||
|
- Description of the generic PHY framework.
|
||||||
|
pi-futex.txt
|
||||||
|
- documentation on lightweight priority inheritance futexes.
|
||||||
|
pinctrl.txt
|
||||||
|
- info on pinctrl subsystem and the PINMUX/PINCONF and drivers
|
||||||
|
platform/
|
||||||
|
- List of supported hardware by compal and Dell laptop.
|
||||||
|
pnp.txt
|
||||||
|
- Linux Plug and Play documentation.
|
||||||
|
power/
|
||||||
|
- directory with info on Linux PCI power management.
|
||||||
|
powerpc/
|
||||||
|
- directory with info on using Linux with the PowerPC.
|
||||||
|
prctl/
|
||||||
|
- directory with info on the priveledge control subsystem
|
||||||
|
preempt-locking.txt
|
||||||
|
- info on locking under a preemptive kernel.
|
||||||
|
printk-formats.txt
|
||||||
|
- how to get printk format specifiers right
|
||||||
|
process/
|
||||||
|
- how to work with the mainline kernel development process.
|
||||||
|
pps/
|
||||||
|
- directory with information on the pulse-per-second support
|
||||||
|
pti/
|
||||||
|
- directory with info on Intel MID PTI.
|
||||||
|
ptp/
|
||||||
|
- directory with info on support for IEEE 1588 PTP clocks in Linux.
|
||||||
|
pwm.txt
|
||||||
|
- info on the pulse width modulation driver subsystem
|
||||||
|
rapidio/
|
||||||
|
- directory with info on RapidIO packet-based fabric interconnect
|
||||||
|
rbtree.txt
|
||||||
|
- info on what red-black trees are and what they are for.
|
||||||
|
remoteproc.txt
|
||||||
|
- info on how to handle remote processor (e.g. AMP) offloads/usage.
|
||||||
|
rfkill.txt
|
||||||
|
- info on the radio frequency kill switch subsystem/support.
|
||||||
|
robust-futex-ABI.txt
|
||||||
|
- documentation of the robust futex ABI.
|
||||||
|
robust-futexes.txt
|
||||||
|
- a description of what robust futexes are.
|
||||||
|
rpmsg.txt
|
||||||
|
- info on the Remote Processor Messaging (rpmsg) Framework
|
||||||
|
rtc.txt
|
||||||
|
- notes on how to use the Real Time Clock (aka CMOS clock) driver.
|
||||||
|
s390/
|
||||||
|
- directory with info on using Linux on the IBM S390.
|
||||||
|
scheduler/
|
||||||
|
- directory with info on the scheduler.
|
||||||
|
scsi/
|
||||||
|
- directory with info on Linux scsi support.
|
||||||
|
security/
|
||||||
|
- directory that contains security-related info
|
||||||
|
serial/
|
||||||
|
- directory with info on the low level serial API.
|
||||||
|
sgi-ioc4.txt
|
||||||
|
- description of the SGI IOC4 PCI (multi function) device.
|
||||||
|
sh/
|
||||||
|
- directory with info on porting Linux to a new architecture.
|
||||||
|
smsc_ece1099.txt
|
||||||
|
-info on the smsc Keyboard Scan Expansion/GPIO Expansion device.
|
||||||
|
sound/
|
||||||
|
- directory with info on sound card support.
|
||||||
|
spi/
|
||||||
|
- overview of Linux kernel Serial Peripheral Interface (SPI) support.
|
||||||
|
sphinx/
|
||||||
|
- no documentation here, just files required by Sphinx toolchain.
|
||||||
|
sphinx-static/
|
||||||
|
- no documentation here, just files required by Sphinx toolchain.
|
||||||
|
static-keys.txt
|
||||||
|
- info on how static keys allow debug code in hotpaths via patching
|
||||||
|
svga.txt
|
||||||
|
- short guide on selecting video modes at boot via VGA BIOS.
|
||||||
|
sync_file.txt
|
||||||
|
- Sync file API guide.
|
||||||
|
sysctl/
|
||||||
|
- directory with info on the /proc/sys/* files.
|
||||||
|
target/
|
||||||
|
- directory with info on generating TCM v4 fabric .ko modules
|
||||||
|
tee.txt
|
||||||
|
- info on the TEE subsystem and drivers
|
||||||
|
this_cpu_ops.txt
|
||||||
|
- List rationale behind and the way to use this_cpu operations.
|
||||||
|
thermal/
|
||||||
|
- directory with information on managing thermal issues (CPU/temp)
|
||||||
|
trace/
|
||||||
|
- directory with info on tracing technologies within linux
|
||||||
|
translations/
|
||||||
|
- translations of this document from English to another language
|
||||||
|
unaligned-memory-access.txt
|
||||||
|
- info on how to avoid arch breaking unaligned memory access in code.
|
||||||
|
unshare.txt
|
||||||
|
- description of the Linux unshare system call.
|
||||||
|
usb/
|
||||||
|
- directory with info regarding the Universal Serial Bus.
|
||||||
|
vfio.txt
|
||||||
|
- info on Virtual Function I/O used in guest/hypervisor instances.
|
||||||
|
video-output.txt
|
||||||
|
- sysfs class driver interface to enable/disable a video output device.
|
||||||
|
virtual/
|
||||||
|
- directory with information on the various linux virtualizations.
|
||||||
|
vm/
|
||||||
|
- directory with info on the Linux vm code.
|
||||||
|
w1/
|
||||||
|
- directory with documents regarding the 1-wire (w1) subsystem.
|
||||||
|
watchdog/
|
||||||
|
- how to auto-reboot Linux if it has "fallen and can't get up". ;-)
|
||||||
|
wimax/
|
||||||
|
- directory with info about Intel Wireless Wimax Connections
|
||||||
|
core-api/workqueue.rst
|
||||||
|
- information on the Concurrency Managed Workqueue implementation
|
||||||
|
x86/x86_64/
|
||||||
|
- directory with info on Linux support for AMD x86-64 (Hammer) machines.
|
||||||
|
xillybus.txt
|
||||||
|
- Overview and basic ui of xillybus driver
|
||||||
|
xtensa/
|
||||||
|
- directory with documents relating to arch/xtensa port/implementation
|
||||||
|
xz.txt
|
||||||
|
- how to make use of the XZ data compression within linux kernel
|
||||||
|
zorro.txt
|
||||||
|
- info on writing drivers for Zorro bus devices found on Amigas.
|
87
Documentation/ABI/README
Normal file
87
Documentation/ABI/README
Normal file
|
@ -0,0 +1,87 @@
|
||||||
|
This directory attempts to document the ABI between the Linux kernel and
|
||||||
|
userspace, and the relative stability of these interfaces. Due to the
|
||||||
|
everchanging nature of Linux, and the differing maturity levels, these
|
||||||
|
interfaces should be used by userspace programs in different ways.
|
||||||
|
|
||||||
|
We have four different levels of ABI stability, as shown by the four
|
||||||
|
different subdirectories in this location. Interfaces may change levels
|
||||||
|
of stability according to the rules described below.
|
||||||
|
|
||||||
|
The different levels of stability are:
|
||||||
|
|
||||||
|
stable/
|
||||||
|
This directory documents the interfaces that the developer has
|
||||||
|
defined to be stable. Userspace programs are free to use these
|
||||||
|
interfaces with no restrictions, and backward compatibility for
|
||||||
|
them will be guaranteed for at least 2 years. Most interfaces
|
||||||
|
(like syscalls) are expected to never change and always be
|
||||||
|
available.
|
||||||
|
|
||||||
|
testing/
|
||||||
|
This directory documents interfaces that are felt to be stable,
|
||||||
|
as the main development of this interface has been completed.
|
||||||
|
The interface can be changed to add new features, but the
|
||||||
|
current interface will not break by doing this, unless grave
|
||||||
|
errors or security problems are found in them. Userspace
|
||||||
|
programs can start to rely on these interfaces, but they must be
|
||||||
|
aware of changes that can occur before these interfaces move to
|
||||||
|
be marked stable. Programs that use these interfaces are
|
||||||
|
strongly encouraged to add their name to the description of
|
||||||
|
these interfaces, so that the kernel developers can easily
|
||||||
|
notify them if any changes occur (see the description of the
|
||||||
|
layout of the files below for details on how to do this.)
|
||||||
|
|
||||||
|
obsolete/
|
||||||
|
This directory 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.
|
||||||
|
|
||||||
|
removed/
|
||||||
|
This directory contains a list of the old interfaces that have
|
||||||
|
been removed from the kernel.
|
||||||
|
|
||||||
|
Every file in these directories will contain the following information:
|
||||||
|
|
||||||
|
What: Short description of the interface
|
||||||
|
Date: Date created
|
||||||
|
KernelVersion: Kernel version this feature first showed up in.
|
||||||
|
Contact: Primary contact for this interface (may be a mailing list)
|
||||||
|
Description: Long description of the interface and how to use it.
|
||||||
|
Users: All users of this interface who wish to be notified when
|
||||||
|
it changes. This is very important for interfaces in
|
||||||
|
the "testing" stage, so that kernel developers can work
|
||||||
|
with userspace developers to ensure that things do not
|
||||||
|
break in ways that are unacceptable. It is also
|
||||||
|
important to get feedback for these interfaces to make
|
||||||
|
sure they are working in a proper way and do not need to
|
||||||
|
be changed further.
|
||||||
|
|
||||||
|
|
||||||
|
How things move between levels:
|
||||||
|
|
||||||
|
Interfaces in stable may move to obsolete, as long as the proper
|
||||||
|
notification is given.
|
||||||
|
|
||||||
|
Interfaces may be removed from obsolete and the kernel as long as the
|
||||||
|
documented amount of time has gone by.
|
||||||
|
|
||||||
|
Interfaces in the testing state can move to the stable state when the
|
||||||
|
developers feel they are finished. They cannot be removed from the
|
||||||
|
kernel tree without going through the obsolete state first.
|
||||||
|
|
||||||
|
It's up to the developer to place their interfaces in the category they
|
||||||
|
wish for it to start out in.
|
||||||
|
|
||||||
|
|
||||||
|
Notable bits of non-ABI, which should not under any circumstances be considered
|
||||||
|
stable:
|
||||||
|
|
||||||
|
- Kconfig. Userspace should not rely on the presence or absence of any
|
||||||
|
particular Kconfig symbol, in /proc/config.gz, in the copy of .config
|
||||||
|
commonly installed to /boot, or in any invocation of the kernel build
|
||||||
|
process.
|
||||||
|
|
||||||
|
- Kernel-internal symbols. Do not rely on the presence, absence, location, or
|
||||||
|
type of any kernel symbol, either in System.map files or the kernel binary
|
||||||
|
itself. See Documentation/process/stable-api-nonsense.rst.
|
|
@ -0,0 +1,5 @@
|
||||||
|
What: /proc/sys/vm/nr_pdflush_threads
|
||||||
|
Date: June 2012
|
||||||
|
Contact: Wanpeng Li <liwp@linux.vnet.ibm.com>
|
||||||
|
Description: Since pdflush is replaced by per-BDI flusher, the interface of old pdflush
|
||||||
|
exported in /proc/sys/vm/ should be removed.
|
31
Documentation/ABI/obsolete/sysfs-bus-usb
Normal file
31
Documentation/ABI/obsolete/sysfs-bus-usb
Normal file
|
@ -0,0 +1,31 @@
|
||||||
|
What: /sys/bus/usb/devices/.../power/level
|
||||||
|
Date: March 2007
|
||||||
|
KernelVersion: 2.6.21
|
||||||
|
Contact: Alan Stern <stern@rowland.harvard.edu>
|
||||||
|
Description:
|
||||||
|
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.
|
53
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-arvo
Normal file
53
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-arvo
Normal file
|
@ -0,0 +1,53 @@
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/arvo/roccatarvo<minor>/actual_profile
|
||||||
|
Date: Januar 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/arvo/roccatarvo<minor>/button
|
||||||
|
Date: Januar 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/arvo/roccatarvo<minor>/info
|
||||||
|
Date: Januar 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/arvo/roccatarvo<minor>/key_mask
|
||||||
|
Date: Januar 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/arvo/roccatarvo<minor>/mode_key
|
||||||
|
Date: Januar 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
153
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-isku
Normal file
153
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-isku
Normal file
|
@ -0,0 +1,153 @@
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/actual_profile
|
||||||
|
Date: June 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/info
|
||||||
|
Date: June 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/key_mask
|
||||||
|
Date: June 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/keys_capslock
|
||||||
|
Date: June 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/keys_easyzone
|
||||||
|
Date: June 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/keys_function
|
||||||
|
Date: June 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/keys_macro
|
||||||
|
Date: June 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/keys_media
|
||||||
|
Date: June 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/keys_thumbster
|
||||||
|
Date: June 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/last_set
|
||||||
|
Date: June 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/light
|
||||||
|
Date: June 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/macro
|
||||||
|
Date: June 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/reset
|
||||||
|
Date: November 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/control
|
||||||
|
Date: June 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/talk
|
||||||
|
Date: June 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/isku/roccatisku<minor>/talkfx
|
||||||
|
Date: February 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
145
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-koneplus
Normal file
145
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-koneplus
Normal file
|
@ -0,0 +1,145 @@
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/actual_profile
|
||||||
|
Date: October 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/startup_profile
|
||||||
|
Date: October 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/firmware_version
|
||||||
|
Date: October 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/info
|
||||||
|
Date: November 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/macro
|
||||||
|
Date: October 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/profile_buttons
|
||||||
|
Date: August 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/profile[1-5]_buttons
|
||||||
|
Date: August 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/profile_settings
|
||||||
|
Date: October 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/profile[1-5]_settings
|
||||||
|
Date: August 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/sensor
|
||||||
|
Date: October 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/talk
|
||||||
|
Date: May 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/tcu
|
||||||
|
Date: October 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/koneplus/roccatkoneplus<minor>/tcu_image
|
||||||
|
Date: October 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
105
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-konepure
Normal file
105
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-konepure
Normal file
|
@ -0,0 +1,105 @@
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/actual_profile
|
||||||
|
Date: December 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/control
|
||||||
|
Date: December 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/info
|
||||||
|
Date: December 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/macro
|
||||||
|
Date: December 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/profile_buttons
|
||||||
|
Date: December 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/profile_settings
|
||||||
|
Date: December 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/sensor
|
||||||
|
Date: December 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/talk
|
||||||
|
Date: December 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/tcu
|
||||||
|
Date: December 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/konepure/roccatkonepure<minor>/tcu_image
|
||||||
|
Date: December 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
116
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-kovaplus
Normal file
116
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-kovaplus
Normal file
|
@ -0,0 +1,116 @@
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/actual_cpi
|
||||||
|
Date: January 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/actual_profile
|
||||||
|
Date: January 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/actual_sensitivity_x
|
||||||
|
Date: January 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/actual_sensitivity_y
|
||||||
|
Date: January 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/firmware_version
|
||||||
|
Date: January 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/info
|
||||||
|
Date: November 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/profile_buttons
|
||||||
|
Date: January 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/profile[1-5]_buttons
|
||||||
|
Date: January 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/profile_settings
|
||||||
|
Date: January 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/kovaplus/roccatkovaplus<minor>/profile[1-5]_settings
|
||||||
|
Date: January 2011
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
7
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-lua
Normal file
7
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-lua
Normal file
|
@ -0,0 +1,7 @@
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/control
|
||||||
|
Date: October 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
123
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra
Normal file
123
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra
Normal file
|
@ -0,0 +1,123 @@
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/actual_cpi
|
||||||
|
Date: August 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/actual_profile
|
||||||
|
Date: August 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/firmware_version
|
||||||
|
Date: August 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/info
|
||||||
|
Date: November 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile_buttons
|
||||||
|
Date: August 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile[1-5]_buttons
|
||||||
|
Date: August 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile_settings
|
||||||
|
Date: August 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile[1-5]_settings
|
||||||
|
Date: August 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/settings
|
||||||
|
Date: August 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/startup_profile
|
||||||
|
Date: August 2010
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
178
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-ryos
Normal file
178
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-ryos
Normal file
|
@ -0,0 +1,178 @@
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/control
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/profile
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/keys_primary
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/keys_function
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/keys_macro
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/keys_thumbster
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/keys_extra
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/keys_easyzone
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/key_mask
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/light
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/macro
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/info
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/reset
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/talk
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/light_control
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/stored_lights
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/custom_lights
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/ryos/roccatryos<minor>/light_macro
|
||||||
|
Date: October 2013
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
77
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-savu
Normal file
77
Documentation/ABI/obsolete/sysfs-driver-hid-roccat-savu
Normal file
|
@ -0,0 +1,77 @@
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/savu/roccatsavu<minor>/buttons
|
||||||
|
Date: Mai 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/savu/roccatsavu<minor>/control
|
||||||
|
Date: Mai 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/savu/roccatsavu<minor>/general
|
||||||
|
Date: Mai 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/savu/roccatsavu<minor>/info
|
||||||
|
Date: Mai 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/savu/roccatsavu<minor>/macro
|
||||||
|
Date: Mai 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/savu/roccatsavu<minor>/profile
|
||||||
|
Date: Mai 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/savu/roccatsavu<minor>/sensor
|
||||||
|
Date: July 2012
|
||||||
|
Contact: Stefan Achatz <erazor_de@users.sourceforge.net>
|
||||||
|
Description: 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
|
8
Documentation/ABI/obsolete/sysfs-firmware-acpi
Normal file
8
Documentation/ABI/obsolete/sysfs-firmware-acpi
Normal file
|
@ -0,0 +1,8 @@
|
||||||
|
What: /sys/firmware/acpi/hotplug/force_remove
|
||||||
|
Date: Mar 2017
|
||||||
|
Contact: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
|
||||||
|
Description:
|
||||||
|
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.
|
30
Documentation/ABI/obsolete/sysfs-gpio
Normal file
30
Documentation/ABI/obsolete/sysfs-gpio
Normal file
|
@ -0,0 +1,30 @@
|
||||||
|
What: /sys/class/gpio/
|
||||||
|
Date: July 2008
|
||||||
|
KernelVersion: 2.6.27
|
||||||
|
Contact: Linus Walleij <linusw@kernel.org>
|
||||||
|
Description:
|
||||||
|
|
||||||
|
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/gpio.txt 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.
|
12
Documentation/ABI/removed/devfs
Normal file
12
Documentation/ABI/removed/devfs
Normal file
|
@ -0,0 +1,12 @@
|
||||||
|
What: devfs
|
||||||
|
Date: July 2005 (scheduled), finally removed in kernel v2.6.18
|
||||||
|
Contact: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
|
||||||
|
Description:
|
||||||
|
devfs has been unmaintained for a number of years, has unfixable
|
||||||
|
races, contains a naming policy within the kernel that is
|
||||||
|
against the LSB, and can be replaced by using udev.
|
||||||
|
The files fs/devfs/*, include/linux/devfs_fs*.h were removed,
|
||||||
|
along with the assorted devfs function calls throughout the
|
||||||
|
kernel tree.
|
||||||
|
|
||||||
|
Users:
|
14
Documentation/ABI/removed/dv1394
Normal file
14
Documentation/ABI/removed/dv1394
Normal file
|
@ -0,0 +1,14 @@
|
||||||
|
What: dv1394 (a.k.a. "OHCI-DV I/O support" for FireWire)
|
||||||
|
Date: May 2010 (scheduled), finally removed in kernel v2.6.37
|
||||||
|
Contact: linux1394-devel@lists.sourceforge.net
|
||||||
|
Description:
|
||||||
|
/dev/dv1394/* were character device files, one for each FireWire
|
||||||
|
controller and for NTSC and PAL respectively, from which DV data
|
||||||
|
could be received by read() or transmitted by write(). A few
|
||||||
|
ioctl()s allowed limited control.
|
||||||
|
This special-purpose interface has been superseded by libraw1394 +
|
||||||
|
libiec61883 which are functionally equivalent, support HDV, and
|
||||||
|
transparently work on top of the newer firewire kernel drivers.
|
||||||
|
|
||||||
|
Users:
|
||||||
|
ffmpeg/libavformat (if configured for DV1394)
|
9
Documentation/ABI/removed/ip_queue
Normal file
9
Documentation/ABI/removed/ip_queue
Normal file
|
@ -0,0 +1,9 @@
|
||||||
|
What: ip_queue
|
||||||
|
Date: finally removed in kernel v3.5.0
|
||||||
|
Contact: Pablo Neira Ayuso <pablo@netfilter.org>
|
||||||
|
Description:
|
||||||
|
ip_queue has been replaced by nfnetlink_queue which provides
|
||||||
|
more advanced queueing mechanism to user-space. The ip_queue
|
||||||
|
module was already announced to become obsolete years ago.
|
||||||
|
|
||||||
|
Users:
|
8
Documentation/ABI/removed/net_dma
Normal file
8
Documentation/ABI/removed/net_dma
Normal file
|
@ -0,0 +1,8 @@
|
||||||
|
What: tcp_dma_copybreak sysctl
|
||||||
|
Date: Removed in kernel v3.13
|
||||||
|
Contact: Dan Williams <dan.j.williams@intel.com>
|
||||||
|
Description:
|
||||||
|
Formerly the lower limit, in bytes, of the size of socket reads
|
||||||
|
that will be offloaded to a DMA copy engine. Removed due to
|
||||||
|
coherency issues of the cpu potentially touching the buffers
|
||||||
|
while dma is in flight.
|
10
Documentation/ABI/removed/o2cb
Normal file
10
Documentation/ABI/removed/o2cb
Normal file
|
@ -0,0 +1,10 @@
|
||||||
|
What: /sys/o2cb symlink
|
||||||
|
Date: May 2011
|
||||||
|
KernelVersion: 3.0
|
||||||
|
Contact: ocfs2-devel@oss.oracle.com
|
||||||
|
Description: This is a symlink: /sys/o2cb to /sys/fs/o2cb. The symlink is
|
||||||
|
removed when new versions of ocfs2-tools which know to look
|
||||||
|
in /sys/fs/o2cb are sufficiently prevalent. Don't code new
|
||||||
|
software to look here, it should try /sys/fs/o2cb instead.
|
||||||
|
Users: ocfs2-tools. It's sufficient to mail proposed changes to
|
||||||
|
ocfs2-devel@oss.oracle.com.
|
15
Documentation/ABI/removed/raw1394
Normal file
15
Documentation/ABI/removed/raw1394
Normal file
|
@ -0,0 +1,15 @@
|
||||||
|
What: raw1394 (a.k.a. "Raw IEEE1394 I/O support" for FireWire)
|
||||||
|
Date: May 2010 (scheduled), finally removed in kernel v2.6.37
|
||||||
|
Contact: linux1394-devel@lists.sourceforge.net
|
||||||
|
Description:
|
||||||
|
/dev/raw1394 was a character device file that allowed low-level
|
||||||
|
access to FireWire buses. Its major drawbacks were its inability
|
||||||
|
to implement sensible device security policies, and its low level
|
||||||
|
of abstraction that required userspace clients to duplicate much
|
||||||
|
of the kernel's ieee1394 core functionality.
|
||||||
|
Replaced by /dev/fw*, i.e. the <linux/firewire-cdev.h> ABI of
|
||||||
|
firewire-core.
|
||||||
|
|
||||||
|
Users:
|
||||||
|
libraw1394 (works with firewire-cdev too, transparent to library ABI
|
||||||
|
users)
|
13
Documentation/ABI/removed/sysfs-class-rfkill
Normal file
13
Documentation/ABI/removed/sysfs-class-rfkill
Normal file
|
@ -0,0 +1,13 @@
|
||||||
|
rfkill - radio frequency (RF) connector kill switch support
|
||||||
|
|
||||||
|
For details to this subsystem look at Documentation/rfkill.txt.
|
||||||
|
|
||||||
|
What: /sys/class/rfkill/rfkill[0-9]+/claim
|
||||||
|
Date: 09-Jul-2007
|
||||||
|
KernelVersion v2.6.22
|
||||||
|
Contact: linux-wireless@vger.kernel.org
|
||||||
|
Description: This file was deprecated because there no longer was a way to
|
||||||
|
claim just control over a single rfkill instance.
|
||||||
|
This file was scheduled to be removed in 2012, and was removed
|
||||||
|
in 2016.
|
||||||
|
Values: 0: Kernel handles events
|
16
Documentation/ABI/removed/video1394
Normal file
16
Documentation/ABI/removed/video1394
Normal file
|
@ -0,0 +1,16 @@
|
||||||
|
What: video1394 (a.k.a. "OHCI-1394 Video support" for FireWire)
|
||||||
|
Date: May 2010 (scheduled), finally removed in kernel v2.6.37
|
||||||
|
Contact: linux1394-devel@lists.sourceforge.net
|
||||||
|
Description:
|
||||||
|
/dev/video1394/* were character device files, one for each FireWire
|
||||||
|
controller, which were used for isochronous I/O. It was added as an
|
||||||
|
alternative to raw1394's isochronous I/O functionality which had
|
||||||
|
performance issues in its first generation. Any video1394 user had
|
||||||
|
to use raw1394 + libraw1394 too because video1394 did not provide
|
||||||
|
asynchronous I/O for device discovery and configuration.
|
||||||
|
Replaced by /dev/fw*, i.e. the <linux/firewire-cdev.h> ABI of
|
||||||
|
firewire-core.
|
||||||
|
|
||||||
|
Users:
|
||||||
|
libdc1394 (works with firewire-cdev too, transparent to library ABI
|
||||||
|
users)
|
104
Documentation/ABI/stable/firewire-cdev
Normal file
104
Documentation/ABI/stable/firewire-cdev
Normal file
|
@ -0,0 +1,104 @@
|
||||||
|
What: /dev/fw[0-9]+
|
||||||
|
Date: May 2007
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: linux1394-devel@lists.sourceforge.net
|
||||||
|
Description:
|
||||||
|
The character device files /dev/fw* are the interface between
|
||||||
|
firewire-core and IEEE 1394 device drivers implemented in
|
||||||
|
userspace. The ioctl(2)- and read(2)-based ABI is defined and
|
||||||
|
documented in <linux/firewire-cdev.h>.
|
||||||
|
|
||||||
|
This ABI offers most of the features which firewire-core also
|
||||||
|
exposes to kernelspace IEEE 1394 drivers.
|
||||||
|
|
||||||
|
Each /dev/fw* is associated with one IEEE 1394 node, which can
|
||||||
|
be remote or local nodes. Operations on a /dev/fw* file have
|
||||||
|
different scope:
|
||||||
|
- The 1394 node which is associated with the file:
|
||||||
|
- Asynchronous request transmission
|
||||||
|
- Get the Configuration ROM
|
||||||
|
- Query node ID
|
||||||
|
- Query maximum speed of the path between this node
|
||||||
|
and local node
|
||||||
|
- The 1394 bus (i.e. "card") to which the node is attached to:
|
||||||
|
- Isochronous stream transmission and reception
|
||||||
|
- Asynchronous stream transmission and reception
|
||||||
|
- Asynchronous broadcast request transmission
|
||||||
|
- PHY packet transmission and reception
|
||||||
|
- Allocate, reallocate, deallocate isochronous
|
||||||
|
resources (channels, bandwidth) at the bus's IRM
|
||||||
|
- Query node IDs of local node, root node, IRM, bus
|
||||||
|
manager
|
||||||
|
- Query cycle time
|
||||||
|
- Bus reset initiation, bus reset event reception
|
||||||
|
- All 1394 buses:
|
||||||
|
- Allocation of IEEE 1212 address ranges on the local
|
||||||
|
link layers, reception of inbound requests to such
|
||||||
|
an address range, asynchronous response transmission
|
||||||
|
to inbound requests
|
||||||
|
- Addition of descriptors or directories to the local
|
||||||
|
nodes' Configuration ROM
|
||||||
|
|
||||||
|
Due to the different scope of operations and in order to let
|
||||||
|
userland implement different access permission models, some
|
||||||
|
operations are restricted to /dev/fw* files that are associated
|
||||||
|
with a local node:
|
||||||
|
- Addition of descriptors or directories to the local
|
||||||
|
nodes' Configuration ROM
|
||||||
|
- PHY packet transmission and reception
|
||||||
|
|
||||||
|
A /dev/fw* file remains associated with one particular node
|
||||||
|
during its entire life time. Bus topology changes, and hence
|
||||||
|
node ID changes, are tracked by firewire-core. ABI users do not
|
||||||
|
need to be aware of topology.
|
||||||
|
|
||||||
|
The following file operations are supported:
|
||||||
|
|
||||||
|
open(2)
|
||||||
|
Currently the only useful flags are O_RDWR.
|
||||||
|
|
||||||
|
ioctl(2)
|
||||||
|
Initiate various actions. Some take immediate effect, others
|
||||||
|
are performed asynchronously while or after the ioctl returns.
|
||||||
|
See the inline documentation in <linux/firewire-cdev.h> for
|
||||||
|
descriptions of all ioctls.
|
||||||
|
|
||||||
|
poll(2), select(2), epoll_wait(2) etc.
|
||||||
|
Watch for events to become available to be read.
|
||||||
|
|
||||||
|
read(2)
|
||||||
|
Receive various events. There are solicited events like
|
||||||
|
outbound asynchronous transaction completion or isochronous
|
||||||
|
buffer completion, and unsolicited events such as bus resets,
|
||||||
|
request reception, or PHY packet reception. Always use a read
|
||||||
|
buffer which is large enough to receive the largest event that
|
||||||
|
could ever arrive. See <linux/firewire-cdev.h> for descriptions
|
||||||
|
of all event types and for which ioctls affect reception of
|
||||||
|
events.
|
||||||
|
|
||||||
|
mmap(2)
|
||||||
|
Allocate a DMA buffer for isochronous reception or transmission
|
||||||
|
and map it into the process address space. The arguments should
|
||||||
|
be used as follows: addr = NULL, length = the desired buffer
|
||||||
|
size, i.e. number of packets times size of largest packet,
|
||||||
|
prot = at least PROT_READ for reception and at least PROT_WRITE
|
||||||
|
for transmission, flags = MAP_SHARED, fd = the handle to the
|
||||||
|
/dev/fw*, offset = 0.
|
||||||
|
|
||||||
|
Isochronous reception works in packet-per-buffer fashion except
|
||||||
|
for multichannel reception which works in buffer-fill mode.
|
||||||
|
|
||||||
|
munmap(2)
|
||||||
|
Unmap the isochronous I/O buffer from the process address space.
|
||||||
|
|
||||||
|
close(2)
|
||||||
|
Besides stopping and freeing I/O contexts that were associated
|
||||||
|
with the file descriptor, back out any changes to the local
|
||||||
|
nodes' Configuration ROM. Deallocate isochronous channels and
|
||||||
|
bandwidth at the IRM that were marked for kernel-assisted
|
||||||
|
re- and deallocation.
|
||||||
|
|
||||||
|
Users: libraw1394
|
||||||
|
libdc1394
|
||||||
|
libhinawa
|
||||||
|
tools like linux-firewire-utils, fwhack, ...
|
10
Documentation/ABI/stable/o2cb
Normal file
10
Documentation/ABI/stable/o2cb
Normal file
|
@ -0,0 +1,10 @@
|
||||||
|
What: /sys/fs/o2cb/ (was /sys/o2cb)
|
||||||
|
Date: Dec 2005
|
||||||
|
KernelVersion: 2.6.16
|
||||||
|
Contact: ocfs2-devel@oss.oracle.com
|
||||||
|
Description: Ocfs2-tools looks at 'interface-revision' for versioning
|
||||||
|
information. Each logmask/ file controls a set of debug prints
|
||||||
|
and can be written into with the strings "allow", "deny", or
|
||||||
|
"off". Reading the file returns the current state.
|
||||||
|
Users: ocfs2-tools. It's sufficient to mail proposed changes to
|
||||||
|
ocfs2-devel@oss.oracle.com.
|
10
Documentation/ABI/stable/syscalls
Normal file
10
Documentation/ABI/stable/syscalls
Normal file
|
@ -0,0 +1,10 @@
|
||||||
|
What: The kernel syscall interface
|
||||||
|
Description:
|
||||||
|
This interface matches much of the POSIX interface and is based
|
||||||
|
on it and other Unix based interfaces. It will only be added to
|
||||||
|
over time, and not have things removed from it.
|
||||||
|
|
||||||
|
Note that this interface is different for every architecture
|
||||||
|
that Linux supports. Please see the architecture-specific
|
||||||
|
documentation for details on the syscall numbers that are to be
|
||||||
|
mapped to each syscall.
|
22
Documentation/ABI/stable/sysfs-acpi-pmprofile
Normal file
22
Documentation/ABI/stable/sysfs-acpi-pmprofile
Normal file
|
@ -0,0 +1,22 @@
|
||||||
|
What: /sys/firmware/acpi/pm_profile
|
||||||
|
Date: 03-Nov-2011
|
||||||
|
KernelVersion: v3.2
|
||||||
|
Contact: linux-acpi@vger.kernel.org
|
||||||
|
Description: The ACPI pm_profile sysfs interface exports the platform
|
||||||
|
power management (and performance) requirement expectations
|
||||||
|
as provided by BIOS. The integer value is directly passed as
|
||||||
|
retrieved from the FADT ACPI table.
|
||||||
|
Values: For possible values see ACPI specification:
|
||||||
|
5.2.9 Fixed ACPI Description Table (FADT)
|
||||||
|
Field: Preferred_PM_Profile
|
||||||
|
|
||||||
|
Currently these values are defined by spec:
|
||||||
|
0 Unspecified
|
||||||
|
1 Desktop
|
||||||
|
2 Mobile
|
||||||
|
3 Workstation
|
||||||
|
4 Enterprise Server
|
||||||
|
5 SOHO Server
|
||||||
|
6 Appliance PC
|
||||||
|
7 Performance Server
|
||||||
|
>7 Reserved
|
133
Documentation/ABI/stable/sysfs-bus-firewire
Normal file
133
Documentation/ABI/stable/sysfs-bus-firewire
Normal file
|
@ -0,0 +1,133 @@
|
||||||
|
What: /sys/bus/firewire/devices/fw[0-9]+/
|
||||||
|
Date: May 2007
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: linux1394-devel@lists.sourceforge.net
|
||||||
|
Description:
|
||||||
|
IEEE 1394 node device attributes.
|
||||||
|
Read-only. Mutable during the node device's lifetime.
|
||||||
|
See IEEE 1212 for semantic definitions.
|
||||||
|
|
||||||
|
config_rom
|
||||||
|
Contents of the Configuration ROM register.
|
||||||
|
Binary attribute; an array of host-endian u32.
|
||||||
|
|
||||||
|
guid
|
||||||
|
The node's EUI-64 in the bus information block of
|
||||||
|
Configuration ROM.
|
||||||
|
Hexadecimal string representation of an u64.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/bus/firewire/devices/fw[0-9]+/units
|
||||||
|
Date: June 2009
|
||||||
|
KernelVersion: 2.6.31
|
||||||
|
Contact: linux1394-devel@lists.sourceforge.net
|
||||||
|
Description:
|
||||||
|
IEEE 1394 node device attribute.
|
||||||
|
Read-only. Mutable during the node device's lifetime.
|
||||||
|
See IEEE 1212 for semantic definitions.
|
||||||
|
|
||||||
|
units
|
||||||
|
Summary of all units present in an IEEE 1394 node.
|
||||||
|
Contains space-separated tuples of specifier_id and
|
||||||
|
version of each unit present in the node. Specifier_id
|
||||||
|
and version are hexadecimal string representations of
|
||||||
|
u24 of the respective unit directory entries.
|
||||||
|
Specifier_id and version within each tuple are separated
|
||||||
|
by a colon.
|
||||||
|
|
||||||
|
Users: udev rules to set ownership and access permissions or ACLs of
|
||||||
|
/dev/fw[0-9]+ character device files
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/bus/firewire/devices/fw[0-9]+/is_local
|
||||||
|
Date: July 2012
|
||||||
|
KernelVersion: 3.6
|
||||||
|
Contact: linux1394-devel@lists.sourceforge.net
|
||||||
|
Description:
|
||||||
|
IEEE 1394 node device attribute.
|
||||||
|
Read-only and immutable.
|
||||||
|
Values: 1: The sysfs entry represents a local node (a controller card).
|
||||||
|
0: The sysfs entry represents a remote node.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/bus/firewire/devices/fw[0-9]+[.][0-9]+/
|
||||||
|
Date: May 2007
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: linux1394-devel@lists.sourceforge.net
|
||||||
|
Description:
|
||||||
|
IEEE 1394 unit device attributes.
|
||||||
|
Read-only. Immutable during the unit device's lifetime.
|
||||||
|
See IEEE 1212 for semantic definitions.
|
||||||
|
|
||||||
|
modalias
|
||||||
|
Same as MODALIAS in the uevent at device creation.
|
||||||
|
|
||||||
|
rom_index
|
||||||
|
Offset of the unit directory within the parent device's
|
||||||
|
(node device's) Configuration ROM, in quadlets.
|
||||||
|
Decimal string representation.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/bus/firewire/devices/*/
|
||||||
|
Date: May 2007
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: linux1394-devel@lists.sourceforge.net
|
||||||
|
Description:
|
||||||
|
Attributes common to IEEE 1394 node devices and unit devices.
|
||||||
|
Read-only. Mutable during the node device's lifetime.
|
||||||
|
Immutable during the unit device's lifetime.
|
||||||
|
See IEEE 1212 for semantic definitions.
|
||||||
|
|
||||||
|
These attributes are only created if the root directory of an
|
||||||
|
IEEE 1394 node or the unit directory of an IEEE 1394 unit
|
||||||
|
actually contains according entries.
|
||||||
|
|
||||||
|
hardware_version
|
||||||
|
Hexadecimal string representation of an u24.
|
||||||
|
|
||||||
|
hardware_version_name
|
||||||
|
Contents of a respective textual descriptor leaf.
|
||||||
|
|
||||||
|
model
|
||||||
|
Hexadecimal string representation of an u24.
|
||||||
|
|
||||||
|
model_name
|
||||||
|
Contents of a respective textual descriptor leaf.
|
||||||
|
|
||||||
|
specifier_id
|
||||||
|
Hexadecimal string representation of an u24.
|
||||||
|
Mandatory in unit directories according to IEEE 1212.
|
||||||
|
|
||||||
|
vendor
|
||||||
|
Hexadecimal string representation of an u24.
|
||||||
|
Mandatory in the root directory according to IEEE 1212.
|
||||||
|
|
||||||
|
vendor_name
|
||||||
|
Contents of a respective textual descriptor leaf.
|
||||||
|
|
||||||
|
version
|
||||||
|
Hexadecimal string representation of an u24.
|
||||||
|
Mandatory in unit directories according to IEEE 1212.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/bus/firewire/drivers/sbp2/fw*/host*/target*/*:*:*:*/ieee1394_id
|
||||||
|
formerly
|
||||||
|
/sys/bus/ieee1394/drivers/sbp2/fw*/host*/target*/*:*:*:*/ieee1394_id
|
||||||
|
Date: Feb 2004
|
||||||
|
KernelVersion: 2.6.4
|
||||||
|
Contact: linux1394-devel@lists.sourceforge.net
|
||||||
|
Description:
|
||||||
|
SCSI target port identifier and logical unit identifier of a
|
||||||
|
logical unit of an SBP-2 target. The identifiers are specified
|
||||||
|
in SAM-2...SAM-4 annex A. They are persistent and world-wide
|
||||||
|
unique properties the SBP-2 attached target.
|
||||||
|
|
||||||
|
Read-only attribute, immutable during the target's lifetime.
|
||||||
|
Format, as exposed by firewire-sbp2 since 2.6.22, May 2007:
|
||||||
|
Colon-separated hexadecimal string representations of
|
||||||
|
u64 EUI-64 : u24 directory_ID : u16 LUN
|
||||||
|
without 0x prefixes, without whitespace. The former sbp2 driver
|
||||||
|
(removed in 2.6.37 after being superseded by firewire-sbp2) used
|
||||||
|
a somewhat shorter format which was not as close to SAM.
|
||||||
|
|
||||||
|
Users: udev rules to create /dev/disk/by-id/ symlinks
|
140
Documentation/ABI/stable/sysfs-bus-usb
Normal file
140
Documentation/ABI/stable/sysfs-bus-usb
Normal file
|
@ -0,0 +1,140 @@
|
||||||
|
What: /sys/bus/usb/devices/.../power/persist
|
||||||
|
Date: May 2007
|
||||||
|
KernelVersion: 2.6.23
|
||||||
|
Contact: Alan Stern <stern@rowland.harvard.edu>
|
||||||
|
Description:
|
||||||
|
USB device directories can contain a file named power/persist.
|
||||||
|
The file holds a boolean value (0 or 1) indicating whether or
|
||||||
|
not the "USB-Persist" facility is enabled for the device. For
|
||||||
|
hubs this facility is always enabled and their device
|
||||||
|
directories will not contain this file.
|
||||||
|
|
||||||
|
For more information, see Documentation/driver-api/usb/persist.rst.
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/.../power/autosuspend
|
||||||
|
Date: March 2007
|
||||||
|
KernelVersion: 2.6.21
|
||||||
|
Contact: Alan Stern <stern@rowland.harvard.edu>
|
||||||
|
Description:
|
||||||
|
Each USB device directory will contain a file named
|
||||||
|
power/autosuspend. This file holds the time (in seconds)
|
||||||
|
the device must be idle before it will be autosuspended.
|
||||||
|
0 means the device will be autosuspended as soon as
|
||||||
|
possible. Negative values will prevent the device from
|
||||||
|
being autosuspended at all, and writing a negative value
|
||||||
|
will resume the device if it is already suspended.
|
||||||
|
|
||||||
|
The autosuspend delay for newly-created devices is set to
|
||||||
|
the value of the usbcore.autosuspend module parameter.
|
||||||
|
|
||||||
|
What: /sys/bus/usb/device/.../power/connected_duration
|
||||||
|
Date: January 2008
|
||||||
|
KernelVersion: 2.6.25
|
||||||
|
Contact: Sarah Sharp <sarah.a.sharp@intel.com>
|
||||||
|
Description:
|
||||||
|
If CONFIG_PM is enabled, then this file is present. When read,
|
||||||
|
it returns the total time (in msec) that the USB device has been
|
||||||
|
connected to the machine. This file is read-only.
|
||||||
|
Users:
|
||||||
|
PowerTOP <powertop@lists.01.org>
|
||||||
|
https://01.org/powertop/
|
||||||
|
|
||||||
|
What: /sys/bus/usb/device/.../power/active_duration
|
||||||
|
Date: January 2008
|
||||||
|
KernelVersion: 2.6.25
|
||||||
|
Contact: Sarah Sharp <sarah.a.sharp@intel.com>
|
||||||
|
Description:
|
||||||
|
If CONFIG_PM is enabled, then this file is present. When read,
|
||||||
|
it returns the total time (in msec) that the USB device has been
|
||||||
|
active, i.e. not in a suspended state. This file is read-only.
|
||||||
|
|
||||||
|
Tools can use this file and the connected_duration file to
|
||||||
|
compute the percentage of time that a device has been active.
|
||||||
|
For example,
|
||||||
|
echo $((100 * `cat active_duration` / `cat connected_duration`))
|
||||||
|
will give an integer percentage. Note that this does not
|
||||||
|
account for counter wrap.
|
||||||
|
Users:
|
||||||
|
PowerTOP <powertop@lists.01.org>
|
||||||
|
https://01.org/powertop/
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/<busnum>-<port[.port]>...:<config num>-<interface num>/supports_autosuspend
|
||||||
|
Date: January 2008
|
||||||
|
KernelVersion: 2.6.27
|
||||||
|
Contact: Sarah Sharp <sarah.a.sharp@intel.com>
|
||||||
|
Description:
|
||||||
|
When read, this file returns 1 if the interface driver
|
||||||
|
for this interface supports autosuspend. It also
|
||||||
|
returns 1 if no driver has claimed this interface, as an
|
||||||
|
unclaimed interface will not stop the device from being
|
||||||
|
autosuspended if all other interface drivers are idle.
|
||||||
|
The file returns 0 if autosuspend support has not been
|
||||||
|
added to the driver.
|
||||||
|
Users:
|
||||||
|
USB PM tool
|
||||||
|
git://git.moblin.org/users/sarah/usb-pm-tool/
|
||||||
|
|
||||||
|
What: /sys/bus/usb/device/.../avoid_reset_quirk
|
||||||
|
Date: December 2009
|
||||||
|
Contact: Oliver Neukum <oliver@neukum.org>
|
||||||
|
Description:
|
||||||
|
Writing 1 to this file tells the kernel that this
|
||||||
|
device will morph into another mode when it is reset.
|
||||||
|
Drivers will not use reset for error handling for
|
||||||
|
such devices.
|
||||||
|
Users:
|
||||||
|
usb_modeswitch
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/.../devnum
|
||||||
|
KernelVersion: since at least 2.6.18
|
||||||
|
Description:
|
||||||
|
Device address on the USB bus.
|
||||||
|
Users:
|
||||||
|
libusb
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/.../bConfigurationValue
|
||||||
|
KernelVersion: since at least 2.6.18
|
||||||
|
Description:
|
||||||
|
bConfigurationValue of the *active* configuration for the
|
||||||
|
device. Writing 0 or -1 to bConfigurationValue will reset the
|
||||||
|
active configuration (unconfigure the device). Writing
|
||||||
|
another value will change the active configuration.
|
||||||
|
|
||||||
|
Note that some devices, in violation of the USB spec, have a
|
||||||
|
configuration with a value equal to 0. Writing 0 to
|
||||||
|
bConfigurationValue for these devices will install that
|
||||||
|
configuration, rather then unconfigure the device.
|
||||||
|
|
||||||
|
Writing -1 will always unconfigure the device.
|
||||||
|
Users:
|
||||||
|
libusb
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/.../busnum
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Description:
|
||||||
|
Bus-number of the USB-bus the device is connected to.
|
||||||
|
Users:
|
||||||
|
libusb
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/.../descriptors
|
||||||
|
KernelVersion: 2.6.26
|
||||||
|
Description:
|
||||||
|
Binary file containing cached descriptors of the device. The
|
||||||
|
binary data consists of the device descriptor followed by the
|
||||||
|
descriptors for each configuration of the device.
|
||||||
|
Note that the wTotalLength of the config descriptors can not
|
||||||
|
be trusted, as the device may have a smaller config descriptor
|
||||||
|
than it advertises. The bLength field of each (sub) descriptor
|
||||||
|
can be trusted, and can be used to seek forward one (sub)
|
||||||
|
descriptor at a time until the next config descriptor is found.
|
||||||
|
All descriptors read from this file are in bus-endian format
|
||||||
|
Users:
|
||||||
|
libusb
|
||||||
|
|
||||||
|
What: /sys/bus/usb/devices/.../speed
|
||||||
|
KernelVersion: since at least 2.6.18
|
||||||
|
Description:
|
||||||
|
Speed the device is connected with to the usb-host in
|
||||||
|
Mbit / second. IE one of 1.5 / 12 / 480 / 5000.
|
||||||
|
Users:
|
||||||
|
libusb
|
43
Documentation/ABI/stable/sysfs-bus-vmbus
Normal file
43
Documentation/ABI/stable/sysfs-bus-vmbus
Normal file
|
@ -0,0 +1,43 @@
|
||||||
|
What: /sys/bus/vmbus/devices/vmbus_*/id
|
||||||
|
Date: Jul 2009
|
||||||
|
KernelVersion: 2.6.31
|
||||||
|
Contact: K. Y. Srinivasan <kys@microsoft.com>
|
||||||
|
Description: The VMBus child_relid of the device's primary channel
|
||||||
|
Users: tools/hv/lsvmbus
|
||||||
|
|
||||||
|
What: /sys/bus/vmbus/devices/vmbus_*/class_id
|
||||||
|
Date: Jul 2009
|
||||||
|
KernelVersion: 2.6.31
|
||||||
|
Contact: K. Y. Srinivasan <kys@microsoft.com>
|
||||||
|
Description: The VMBus interface type GUID of the device
|
||||||
|
Users: tools/hv/lsvmbus
|
||||||
|
|
||||||
|
What: /sys/bus/vmbus/devices/vmbus_*/device_id
|
||||||
|
Date: Jul 2009
|
||||||
|
KernelVersion: 2.6.31
|
||||||
|
Contact: K. Y. Srinivasan <kys@microsoft.com>
|
||||||
|
Description: The VMBus interface instance GUID of the device
|
||||||
|
Users: tools/hv/lsvmbus
|
||||||
|
|
||||||
|
What: /sys/bus/vmbus/devices/vmbus_*/channel_vp_mapping
|
||||||
|
Date: Jul 2015
|
||||||
|
KernelVersion: 4.2.0
|
||||||
|
Contact: K. Y. Srinivasan <kys@microsoft.com>
|
||||||
|
Description: The mapping of which primary/sub channels are bound to which
|
||||||
|
Virtual Processors.
|
||||||
|
Format: <channel's child_relid:the bound cpu's number>
|
||||||
|
Users: tools/hv/lsvmbus
|
||||||
|
|
||||||
|
What: /sys/bus/vmbus/devices/vmbus_*/device
|
||||||
|
Date: Dec. 2015
|
||||||
|
KernelVersion: 4.5
|
||||||
|
Contact: K. Y. Srinivasan <kys@microsoft.com>
|
||||||
|
Description: The 16 bit device ID of the device
|
||||||
|
Users: tools/hv/lsvmbus and user level RDMA libraries
|
||||||
|
|
||||||
|
What: /sys/bus/vmbus/devices/vmbus_*/vendor
|
||||||
|
Date: Dec. 2015
|
||||||
|
KernelVersion: 4.5
|
||||||
|
Contact: K. Y. Srinivasan <kys@microsoft.com>
|
||||||
|
Description: The 16 bit vendor ID of the device
|
||||||
|
Users: tools/hv/lsvmbus and user level RDMA libraries
|
11
Documentation/ABI/stable/sysfs-bus-w1
Normal file
11
Documentation/ABI/stable/sysfs-bus-w1
Normal file
|
@ -0,0 +1,11 @@
|
||||||
|
What: /sys/bus/w1/devices/.../w1_master_timeout_us
|
||||||
|
Date: April 2015
|
||||||
|
Contact: Dmitry Khromov <dk@icelogic.net>
|
||||||
|
Description: Bus scanning interval, microseconds component.
|
||||||
|
Some of 1-Wire devices commonly associated with physical access
|
||||||
|
control systems are attached/generate presence for as short as
|
||||||
|
100 ms - hence the tens-to-hundreds milliseconds scan intervals
|
||||||
|
are required.
|
||||||
|
see Documentation/w1/w1.generic for detailed information.
|
||||||
|
Users: any user space application which wants to know bus scanning
|
||||||
|
interval
|
75
Documentation/ABI/stable/sysfs-bus-xen-backend
Normal file
75
Documentation/ABI/stable/sysfs-bus-xen-backend
Normal file
|
@ -0,0 +1,75 @@
|
||||||
|
What: /sys/bus/xen-backend/devices/*/devtype
|
||||||
|
Date: Feb 2009
|
||||||
|
KernelVersion: 2.6.38
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
The type of the device. e.g., one of: 'vbd' (block),
|
||||||
|
'vif' (network), or 'vfb' (framebuffer).
|
||||||
|
|
||||||
|
What: /sys/bus/xen-backend/devices/*/nodename
|
||||||
|
Date: Feb 2009
|
||||||
|
KernelVersion: 2.6.38
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
XenStore node (under /local/domain/NNN/) for this
|
||||||
|
backend device.
|
||||||
|
|
||||||
|
What: /sys/bus/xen-backend/devices/vbd-*/physical_device
|
||||||
|
Date: April 2011
|
||||||
|
KernelVersion: 3.0
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
The major:minor number (in hexidecimal) of the
|
||||||
|
physical device providing the storage for this backend
|
||||||
|
block device.
|
||||||
|
|
||||||
|
What: /sys/bus/xen-backend/devices/vbd-*/mode
|
||||||
|
Date: April 2011
|
||||||
|
KernelVersion: 3.0
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
Whether the block device is read-only ('r') or
|
||||||
|
read-write ('w').
|
||||||
|
|
||||||
|
What: /sys/bus/xen-backend/devices/vbd-*/statistics/f_req
|
||||||
|
Date: April 2011
|
||||||
|
KernelVersion: 3.0
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
Number of flush requests from the frontend.
|
||||||
|
|
||||||
|
What: /sys/bus/xen-backend/devices/vbd-*/statistics/oo_req
|
||||||
|
Date: April 2011
|
||||||
|
KernelVersion: 3.0
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
Number of requests delayed because the backend was too
|
||||||
|
busy processing previous requests.
|
||||||
|
|
||||||
|
What: /sys/bus/xen-backend/devices/vbd-*/statistics/rd_req
|
||||||
|
Date: April 2011
|
||||||
|
KernelVersion: 3.0
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
Number of read requests from the frontend.
|
||||||
|
|
||||||
|
What: /sys/bus/xen-backend/devices/vbd-*/statistics/rd_sect
|
||||||
|
Date: April 2011
|
||||||
|
KernelVersion: 3.0
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
Number of sectors read by the frontend.
|
||||||
|
|
||||||
|
What: /sys/bus/xen-backend/devices/vbd-*/statistics/wr_req
|
||||||
|
Date: April 2011
|
||||||
|
KernelVersion: 3.0
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
Number of write requests from the frontend.
|
||||||
|
|
||||||
|
What: /sys/bus/xen-backend/devices/vbd-*/statistics/wr_sect
|
||||||
|
Date: April 2011
|
||||||
|
KernelVersion: 3.0
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
Number of sectors written by the frontend.
|
56
Documentation/ABI/stable/sysfs-class-backlight
Normal file
56
Documentation/ABI/stable/sysfs-class-backlight
Normal file
|
@ -0,0 +1,56 @@
|
||||||
|
What: /sys/class/backlight/<backlight>/bl_power
|
||||||
|
Date: April 2005
|
||||||
|
KernelVersion: 2.6.12
|
||||||
|
Contact: Richard Purdie <rpurdie@rpsys.net>
|
||||||
|
Description:
|
||||||
|
Control BACKLIGHT power, values are FB_BLANK_* from fb.h
|
||||||
|
- FB_BLANK_UNBLANK (0) : power on.
|
||||||
|
- FB_BLANK_POWERDOWN (4) : power off
|
||||||
|
Users: HAL
|
||||||
|
|
||||||
|
What: /sys/class/backlight/<backlight>/brightness
|
||||||
|
Date: April 2005
|
||||||
|
KernelVersion: 2.6.12
|
||||||
|
Contact: Richard Purdie <rpurdie@rpsys.net>
|
||||||
|
Description:
|
||||||
|
Control the brightness for this <backlight>. Values
|
||||||
|
are between 0 and max_brightness. This file will also
|
||||||
|
show the brightness level stored in the driver, which
|
||||||
|
may not be the actual brightness (see actual_brightness).
|
||||||
|
Users: HAL
|
||||||
|
|
||||||
|
What: /sys/class/backlight/<backlight>/actual_brightness
|
||||||
|
Date: March 2006
|
||||||
|
KernelVersion: 2.6.17
|
||||||
|
Contact: Richard Purdie <rpurdie@rpsys.net>
|
||||||
|
Description:
|
||||||
|
Show the actual brightness by querying the hardware.
|
||||||
|
Users: HAL
|
||||||
|
|
||||||
|
What: /sys/class/backlight/<backlight>/max_brightness
|
||||||
|
Date: April 2005
|
||||||
|
KernelVersion: 2.6.12
|
||||||
|
Contact: Richard Purdie <rpurdie@rpsys.net>
|
||||||
|
Description:
|
||||||
|
Maximum brightness for <backlight>.
|
||||||
|
Users: HAL
|
||||||
|
|
||||||
|
What: /sys/class/backlight/<backlight>/type
|
||||||
|
Date: September 2010
|
||||||
|
KernelVersion: 2.6.37
|
||||||
|
Contact: Matthew Garrett <mjg@redhat.com>
|
||||||
|
Description:
|
||||||
|
The type of interface controlled by <backlight>.
|
||||||
|
"firmware": The driver uses a standard firmware interface
|
||||||
|
"platform": The driver uses a platform-specific interface
|
||||||
|
"raw": The driver controls hardware registers directly
|
||||||
|
|
||||||
|
In the general case, when multiple backlight
|
||||||
|
interfaces are available for a single device, firmware
|
||||||
|
control should be preferred to platform control should
|
||||||
|
be preferred to raw control. Using a firmware
|
||||||
|
interface reduces the probability of confusion with
|
||||||
|
the hardware and the OS independently updating the
|
||||||
|
backlight state. Platform interfaces are mostly a
|
||||||
|
holdover from pre-standardisation of firmware
|
||||||
|
interfaces.
|
88
Documentation/ABI/stable/sysfs-class-rfkill
Normal file
88
Documentation/ABI/stable/sysfs-class-rfkill
Normal file
|
@ -0,0 +1,88 @@
|
||||||
|
rfkill - radio frequency (RF) connector kill switch support
|
||||||
|
|
||||||
|
For details to this subsystem look at Documentation/rfkill.txt.
|
||||||
|
|
||||||
|
For the deprecated /sys/class/rfkill/*/claim knobs of this interface look in
|
||||||
|
Documentation/ABI/removed/sysfs-class-rfkill.
|
||||||
|
|
||||||
|
What: /sys/class/rfkill
|
||||||
|
Date: 09-Jul-2007
|
||||||
|
KernelVersion: v2.6.22
|
||||||
|
Contact: linux-wireless@vger.kernel.org,
|
||||||
|
Description: The rfkill class subsystem folder.
|
||||||
|
Each registered rfkill driver is represented by an rfkillX
|
||||||
|
subfolder (X being an integer > 0).
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/class/rfkill/rfkill[0-9]+/name
|
||||||
|
Date: 09-Jul-2007
|
||||||
|
KernelVersion v2.6.22
|
||||||
|
Contact: linux-wireless@vger.kernel.org
|
||||||
|
Description: Name assigned by driver to this key (interface or driver name).
|
||||||
|
Values: arbitrary string.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/class/rfkill/rfkill[0-9]+/type
|
||||||
|
Date: 09-Jul-2007
|
||||||
|
KernelVersion v2.6.22
|
||||||
|
Contact: linux-wireless@vger.kernel.org
|
||||||
|
Description: Driver type string ("wlan", "bluetooth", etc).
|
||||||
|
Values: See include/linux/rfkill.h.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/class/rfkill/rfkill[0-9]+/persistent
|
||||||
|
Date: 09-Jul-2007
|
||||||
|
KernelVersion v2.6.22
|
||||||
|
Contact: linux-wireless@vger.kernel.org
|
||||||
|
Description: Whether the soft blocked state is initialised from non-volatile
|
||||||
|
storage at startup.
|
||||||
|
Values: A numeric value.
|
||||||
|
0: false
|
||||||
|
1: true
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/class/rfkill/rfkill[0-9]+/state
|
||||||
|
Date: 09-Jul-2007
|
||||||
|
KernelVersion v2.6.22
|
||||||
|
Contact: linux-wireless@vger.kernel.org
|
||||||
|
Description: Current state of the transmitter.
|
||||||
|
This file was scheduled to be removed in 2014, but due to its
|
||||||
|
large number of users it will be sticking around for a bit
|
||||||
|
longer. Despite it being marked as stabe, the newer "hard" and
|
||||||
|
"soft" interfaces should be preffered, since it is not possible
|
||||||
|
to express the 'soft and hard block' state of the rfkill driver
|
||||||
|
through this interface. There will likely be another attempt to
|
||||||
|
remove it in the future.
|
||||||
|
Values: A numeric value.
|
||||||
|
0: RFKILL_STATE_SOFT_BLOCKED
|
||||||
|
transmitter is turned off by software
|
||||||
|
1: RFKILL_STATE_UNBLOCKED
|
||||||
|
transmitter is (potentially) active
|
||||||
|
2: RFKILL_STATE_HARD_BLOCKED
|
||||||
|
transmitter is forced off by something outside of
|
||||||
|
the driver's control.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/class/rfkill/rfkill[0-9]+/hard
|
||||||
|
Date: 12-March-2010
|
||||||
|
KernelVersion v2.6.34
|
||||||
|
Contact: linux-wireless@vger.kernel.org
|
||||||
|
Description: Current hardblock state. This file is read only.
|
||||||
|
Values: A numeric value.
|
||||||
|
0: inactive
|
||||||
|
The transmitter is (potentially) active.
|
||||||
|
1: active
|
||||||
|
The transmitter is forced off by something outside of
|
||||||
|
the driver's control.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/class/rfkill/rfkill[0-9]+/soft
|
||||||
|
Date: 12-March-2010
|
||||||
|
KernelVersion v2.6.34
|
||||||
|
Contact: linux-wireless@vger.kernel.org
|
||||||
|
Description: Current softblock state. This file is read and write.
|
||||||
|
Values: A numeric value.
|
||||||
|
0: inactive
|
||||||
|
The transmitter is (potentially) active.
|
||||||
|
1: active
|
||||||
|
The transmitter is turned off by software.
|
185
Documentation/ABI/stable/sysfs-class-tpm
Normal file
185
Documentation/ABI/stable/sysfs-class-tpm
Normal file
|
@ -0,0 +1,185 @@
|
||||||
|
What: /sys/class/tpm/tpmX/device/
|
||||||
|
Date: April 2005
|
||||||
|
KernelVersion: 2.6.12
|
||||||
|
Contact: tpmdd-devel@lists.sf.net
|
||||||
|
Description: The device/ directory under a specific TPM instance exposes
|
||||||
|
the properties of that TPM chip
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/class/tpm/tpmX/device/active
|
||||||
|
Date: April 2006
|
||||||
|
KernelVersion: 2.6.17
|
||||||
|
Contact: tpmdd-devel@lists.sf.net
|
||||||
|
Description: The "active" property prints a '1' if the TPM chip is accepting
|
||||||
|
commands. An inactive TPM chip still contains all the state of
|
||||||
|
an active chip (Storage Root Key, NVRAM, etc), and can be
|
||||||
|
visible to the OS, but will only accept a restricted set of
|
||||||
|
commands. See the TPM Main Specification part 2, Structures,
|
||||||
|
section 17 for more information on which commands are
|
||||||
|
available.
|
||||||
|
|
||||||
|
What: /sys/class/tpm/tpmX/device/cancel
|
||||||
|
Date: June 2005
|
||||||
|
KernelVersion: 2.6.13
|
||||||
|
Contact: tpmdd-devel@lists.sf.net
|
||||||
|
Description: The "cancel" property allows you to cancel the currently
|
||||||
|
pending TPM command. Writing any value to cancel will call the
|
||||||
|
TPM vendor specific cancel operation.
|
||||||
|
|
||||||
|
What: /sys/class/tpm/tpmX/device/caps
|
||||||
|
Date: April 2005
|
||||||
|
KernelVersion: 2.6.12
|
||||||
|
Contact: tpmdd-devel@lists.sf.net
|
||||||
|
Description: The "caps" property contains TPM manufacturer and version info.
|
||||||
|
|
||||||
|
Example output:
|
||||||
|
|
||||||
|
Manufacturer: 0x53544d20
|
||||||
|
TCG version: 1.2
|
||||||
|
Firmware version: 8.16
|
||||||
|
|
||||||
|
Manufacturer is a hex dump of the 4 byte manufacturer info
|
||||||
|
space in a TPM. TCG version shows the TCG TPM spec level that
|
||||||
|
the chip supports. Firmware version is that of the chip and
|
||||||
|
is manufacturer specific.
|
||||||
|
|
||||||
|
What: /sys/class/tpm/tpmX/device/durations
|
||||||
|
Date: March 2011
|
||||||
|
KernelVersion: 3.1
|
||||||
|
Contact: tpmdd-devel@lists.sf.net
|
||||||
|
Description: The "durations" property shows the 3 vendor-specific values
|
||||||
|
used to wait for a short, medium and long TPM command. All
|
||||||
|
TPM commands are categorized as short, medium or long in
|
||||||
|
execution time, so that the driver doesn't have to wait
|
||||||
|
any longer than necessary before starting to poll for a
|
||||||
|
result.
|
||||||
|
|
||||||
|
Example output:
|
||||||
|
|
||||||
|
3015000 4508000 180995000 [original]
|
||||||
|
|
||||||
|
Here the short, medium and long durations are displayed in
|
||||||
|
usecs. "[original]" indicates that the values are displayed
|
||||||
|
unmodified from when they were queried from the chip.
|
||||||
|
Durations can be modified in the case where a buggy chip
|
||||||
|
reports them in msec instead of usec and they need to be
|
||||||
|
scaled to be displayed in usecs. In this case "[adjusted]"
|
||||||
|
will be displayed in place of "[original]".
|
||||||
|
|
||||||
|
What: /sys/class/tpm/tpmX/device/enabled
|
||||||
|
Date: April 2006
|
||||||
|
KernelVersion: 2.6.17
|
||||||
|
Contact: tpmdd-devel@lists.sf.net
|
||||||
|
Description: The "enabled" property prints a '1' if the TPM chip is enabled,
|
||||||
|
meaning that it should be visible to the OS. This property
|
||||||
|
may be visible but produce a '0' after some operation that
|
||||||
|
disables the TPM.
|
||||||
|
|
||||||
|
What: /sys/class/tpm/tpmX/device/owned
|
||||||
|
Date: April 2006
|
||||||
|
KernelVersion: 2.6.17
|
||||||
|
Contact: tpmdd-devel@lists.sf.net
|
||||||
|
Description: The "owned" property produces a '1' if the TPM_TakeOwnership
|
||||||
|
ordinal has been executed successfully in the chip. A '0'
|
||||||
|
indicates that ownership hasn't been taken.
|
||||||
|
|
||||||
|
What: /sys/class/tpm/tpmX/device/pcrs
|
||||||
|
Date: April 2005
|
||||||
|
KernelVersion: 2.6.12
|
||||||
|
Contact: tpmdd-devel@lists.sf.net
|
||||||
|
Description: The "pcrs" property will dump the current value of all Platform
|
||||||
|
Configuration Registers in the TPM. Note that since these
|
||||||
|
values may be constantly changing, the output is only valid
|
||||||
|
for a snapshot in time.
|
||||||
|
|
||||||
|
Example output:
|
||||||
|
|
||||||
|
PCR-00: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
|
||||||
|
PCR-01: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
|
||||||
|
PCR-02: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
|
||||||
|
PCR-03: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
|
||||||
|
PCR-04: 3A 3F 78 0F 11 A4 B4 99 69 FC AA 80 CD 6E 39 57 C3 3B 22 75
|
||||||
|
...
|
||||||
|
|
||||||
|
The number of PCRs and hex bytes needed to represent a PCR
|
||||||
|
value will vary depending on TPM chip version. For TPM 1.1 and
|
||||||
|
1.2 chips, PCRs represent SHA-1 hashes, which are 20 bytes
|
||||||
|
long. Use the "caps" property to determine TPM version.
|
||||||
|
|
||||||
|
What: /sys/class/tpm/tpmX/device/pubek
|
||||||
|
Date: April 2005
|
||||||
|
KernelVersion: 2.6.12
|
||||||
|
Contact: tpmdd-devel@lists.sf.net
|
||||||
|
Description: The "pubek" property will return the TPM's public endorsement
|
||||||
|
key if possible. If the TPM has had ownership established and
|
||||||
|
is version 1.2, the pubek will not be available without the
|
||||||
|
owner's authorization. Since the TPM driver doesn't store any
|
||||||
|
secrets, it can't authorize its own request for the pubek,
|
||||||
|
making it unaccessible. The public endorsement key is gener-
|
||||||
|
ated at TPM manufacture time and exists for the life of the
|
||||||
|
chip.
|
||||||
|
|
||||||
|
Example output:
|
||||||
|
|
||||||
|
Algorithm: 00 00 00 01
|
||||||
|
Encscheme: 00 03
|
||||||
|
Sigscheme: 00 01
|
||||||
|
Parameters: 00 00 08 00 00 00 00 02 00 00 00 00
|
||||||
|
Modulus length: 256
|
||||||
|
Modulus:
|
||||||
|
B4 76 41 82 C9 20 2C 10 18 40 BC 8B E5 44 4C 6C
|
||||||
|
3A B2 92 0C A4 9B 2A 83 EB 5C 12 85 04 48 A0 B6
|
||||||
|
1E E4 81 84 CE B2 F2 45 1C F0 85 99 61 02 4D EB
|
||||||
|
86 C4 F7 F3 29 60 52 93 6B B2 E5 AB 8B A9 09 E3
|
||||||
|
D7 0E 7D CA 41 BF 43 07 65 86 3C 8C 13 7A D0 8B
|
||||||
|
82 5E 96 0B F8 1F 5F 34 06 DA A2 52 C1 A9 D5 26
|
||||||
|
0F F4 04 4B D9 3F 2D F2 AC 2F 74 64 1F 8B CD 3E
|
||||||
|
1E 30 38 6C 70 63 69 AB E2 50 DF 49 05 2E E1 8D
|
||||||
|
6F 78 44 DA 57 43 69 EE 76 6C 38 8A E9 8E A3 F0
|
||||||
|
A7 1F 3C A8 D0 12 15 3E CA 0E BD FA 24 CD 33 C6
|
||||||
|
47 AE A4 18 83 8E 22 39 75 93 86 E6 FD 66 48 B6
|
||||||
|
10 AD 94 14 65 F9 6A 17 78 BD 16 53 84 30 BF 70
|
||||||
|
E0 DC 65 FD 3C C6 B0 1E BF B9 C1 B5 6C EF B1 3A
|
||||||
|
F8 28 05 83 62 26 11 DC B4 6B 5A 97 FF 32 26 B6
|
||||||
|
F7 02 71 CF 15 AE 16 DD D1 C1 8E A8 CF 9B 50 7B
|
||||||
|
C3 91 FF 44 1E CF 7C 39 FE 17 77 21 20 BD CE 9B
|
||||||
|
|
||||||
|
Possible values:
|
||||||
|
|
||||||
|
Algorithm: TPM_ALG_RSA (1)
|
||||||
|
Encscheme: TPM_ES_RSAESPKCSv15 (2)
|
||||||
|
TPM_ES_RSAESOAEP_SHA1_MGF1 (3)
|
||||||
|
Sigscheme: TPM_SS_NONE (1)
|
||||||
|
Parameters, a byte string of 3 u32 values:
|
||||||
|
Key Length (bits): 00 00 08 00 (2048)
|
||||||
|
Num primes: 00 00 00 02 (2)
|
||||||
|
Exponent Size: 00 00 00 00 (0 means the
|
||||||
|
default exp)
|
||||||
|
Modulus Length: 256 (bytes)
|
||||||
|
Modulus: The 256 byte Endorsement Key modulus
|
||||||
|
|
||||||
|
What: /sys/class/tpm/tpmX/device/temp_deactivated
|
||||||
|
Date: April 2006
|
||||||
|
KernelVersion: 2.6.17
|
||||||
|
Contact: tpmdd-devel@lists.sf.net
|
||||||
|
Description: The "temp_deactivated" property returns a '1' if the chip has
|
||||||
|
been temporarily deactivated, usually until the next power
|
||||||
|
cycle. Whether a warm boot (reboot) will clear a TPM chip
|
||||||
|
from a temp_deactivated state is platform specific.
|
||||||
|
|
||||||
|
What: /sys/class/tpm/tpmX/device/timeouts
|
||||||
|
Date: March 2011
|
||||||
|
KernelVersion: 3.1
|
||||||
|
Contact: tpmdd-devel@lists.sf.net
|
||||||
|
Description: The "timeouts" property shows the 4 vendor-specific values
|
||||||
|
for the TPM's interface spec timeouts. The use of these
|
||||||
|
timeouts is defined by the TPM interface spec that the chip
|
||||||
|
conforms to.
|
||||||
|
|
||||||
|
Example output:
|
||||||
|
|
||||||
|
750000 750000 750000 750000 [original]
|
||||||
|
|
||||||
|
The four timeout values are shown in usecs, with a trailing
|
||||||
|
"[original]" or "[adjusted]" depending on whether the values
|
||||||
|
were scaled by the driver to be reported in usec from msecs.
|
221
Documentation/ABI/stable/sysfs-class-ubi
Normal file
221
Documentation/ABI/stable/sysfs-class-ubi
Normal file
|
@ -0,0 +1,221 @@
|
||||||
|
What: /sys/class/ubi/
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
The ubi/ class sub-directory belongs to the UBI subsystem and
|
||||||
|
provides general UBI information, per-UBI device information
|
||||||
|
and per-UBI volume information.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/version
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
This file contains version of the latest supported UBI on-media
|
||||||
|
format. Currently it is 1, and there is no plan to change this.
|
||||||
|
However, if in the future UBI needs on-flash format changes
|
||||||
|
which cannot be done in a compatible manner, a new format
|
||||||
|
version will be added. So this is a mechanism for possible
|
||||||
|
future backward-compatible (but forward-incompatible)
|
||||||
|
improvements.
|
||||||
|
|
||||||
|
What: /sys/class/ubiX/
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
The /sys/class/ubi0, /sys/class/ubi1, etc directories describe
|
||||||
|
UBI devices (UBI device 0, 1, etc). They contain general UBI
|
||||||
|
device information and per UBI volume information (each UBI
|
||||||
|
device may have many UBI volumes)
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/avail_eraseblocks
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Amount of available logical eraseblock. For example, one may
|
||||||
|
create a new UBI volume which has this amount of logical
|
||||||
|
eraseblocks.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/bad_peb_count
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Count of bad physical eraseblocks on the underlying MTD device.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/bgt_enabled
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Contains ASCII "0\n" if the UBI background thread is disabled,
|
||||||
|
and ASCII "1\n" if it is enabled.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/dev
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Major and minor numbers of the character device corresponding
|
||||||
|
to this UBI device (in <major>:<minor> format).
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/eraseblock_size
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Maximum logical eraseblock size this UBI device may provide. UBI
|
||||||
|
volumes may have smaller logical eraseblock size because of their
|
||||||
|
alignment.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/max_ec
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Maximum physical eraseblock erase counter value.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/max_vol_count
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Maximum number of volumes which this UBI device may have.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/min_io_size
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Minimum input/output unit size. All the I/O may only be done
|
||||||
|
in fractions of the contained number.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/mtd_num
|
||||||
|
Date: January 2008
|
||||||
|
KernelVersion: 2.6.25
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Number of the underlying MTD device.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/reserved_for_bad
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Number of physical eraseblocks reserved for bad block handling.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/ro_mode
|
||||||
|
Date: April 2016
|
||||||
|
KernelVersion: 4.7
|
||||||
|
Contact: linux-mtd@lists.infradead.org
|
||||||
|
Description:
|
||||||
|
Contains ASCII "1\n" if the read-only flag is set on this
|
||||||
|
device, and "0\n" if it is cleared. UBI devices mark themselves
|
||||||
|
as read-only when they detect an unrecoverable error.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/total_eraseblocks
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Total number of good (not marked as bad) physical eraseblocks on
|
||||||
|
the underlying MTD device.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/volumes_count
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Count of volumes on this UBI device.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/ubiX_Y/
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
The /sys/class/ubi/ubiX/ubiX_0/, /sys/class/ubi/ubiX/ubiX_1/,
|
||||||
|
etc directories describe UBI volumes on UBI device X (volumes
|
||||||
|
0, 1, etc).
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/ubiX_Y/alignment
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Volume alignment - the value the logical eraseblock size of
|
||||||
|
this volume has to be aligned on. For example, 2048 means that
|
||||||
|
logical eraseblock size is multiple of 2048. In other words,
|
||||||
|
volume logical eraseblock size is UBI device logical eraseblock
|
||||||
|
size aligned to the alignment value.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/ubiX_Y/corrupted
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Contains ASCII "0\n" if the UBI volume is OK, and ASCII "1\n"
|
||||||
|
if it is corrupted (e.g., due to an interrupted volume update).
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/ubiX_Y/data_bytes
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
The amount of data this volume contains. This value makes sense
|
||||||
|
only for static volumes, and for dynamic volume it equivalent
|
||||||
|
to the total volume size in bytes.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/ubiX_Y/dev
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Major and minor numbers of the character device corresponding
|
||||||
|
to this UBI volume (in <major>:<minor> format).
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/ubiX_Y/name
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Volume name.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/ubiX_Y/reserved_ebs
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Count of physical eraseblock reserved for this volume.
|
||||||
|
Equivalent to the volume size in logical eraseblocks.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/ubiX_Y/type
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Volume type. Contains ASCII "dynamic\n" for dynamic volumes and
|
||||||
|
"static\n" for static volumes.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/ubiX_Y/upd_marker
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Contains ASCII "0\n" if the update marker is not set for this
|
||||||
|
volume, and "1\n" if it is set. The update marker is set when
|
||||||
|
volume update starts, and cleaned when it ends. So the presence
|
||||||
|
of the update marker indicates that the volume is being updated
|
||||||
|
at the moment of the update was interrupted. The later may be
|
||||||
|
checked using the "corrupted" sysfs file.
|
||||||
|
|
||||||
|
What: /sys/class/ubi/ubiX/ubiX_Y/usable_eb_size
|
||||||
|
Date: July 2006
|
||||||
|
KernelVersion: 2.6.22
|
||||||
|
Contact: Artem Bityutskiy <dedekind@infradead.org>
|
||||||
|
Description:
|
||||||
|
Logical eraseblock size of this volume. Equivalent to logical
|
||||||
|
eraseblock size of the device aligned on the volume alignment
|
||||||
|
value.
|
93
Documentation/ABI/stable/sysfs-class-udc
Normal file
93
Documentation/ABI/stable/sysfs-class-udc
Normal file
|
@ -0,0 +1,93 @@
|
||||||
|
What: /sys/class/udc/<udc>/a_alt_hnp_support
|
||||||
|
Date: June 2011
|
||||||
|
KernelVersion: 3.1
|
||||||
|
Contact: Felipe Balbi <balbi@kernel.org>
|
||||||
|
Description:
|
||||||
|
Indicates if an OTG A-Host supports HNP at an alternate port.
|
||||||
|
Users:
|
||||||
|
|
||||||
|
What: /sys/class/udc/<udc>/a_hnp_support
|
||||||
|
Date: June 2011
|
||||||
|
KernelVersion: 3.1
|
||||||
|
Contact: Felipe Balbi <balbi@kernel.org>
|
||||||
|
Description:
|
||||||
|
Indicates if an OTG A-Host supports HNP at this port.
|
||||||
|
Users:
|
||||||
|
|
||||||
|
What: /sys/class/udc/<udc>/b_hnp_enable
|
||||||
|
Date: June 2011
|
||||||
|
KernelVersion: 3.1
|
||||||
|
Contact: Felipe Balbi <balbi@kernel.org>
|
||||||
|
Description:
|
||||||
|
Indicates if an OTG A-Host enabled HNP support.
|
||||||
|
Users:
|
||||||
|
|
||||||
|
What: /sys/class/udc/<udc>/current_speed
|
||||||
|
Date: June 2011
|
||||||
|
KernelVersion: 3.1
|
||||||
|
Contact: Felipe Balbi <balbi@kernel.org>
|
||||||
|
Description:
|
||||||
|
Indicates the current negotiated speed at this port.
|
||||||
|
Users:
|
||||||
|
|
||||||
|
What: /sys/class/udc/<udc>/is_a_peripheral
|
||||||
|
Date: June 2011
|
||||||
|
KernelVersion: 3.1
|
||||||
|
Contact: Felipe Balbi <balbi@kernel.org>
|
||||||
|
Description:
|
||||||
|
Indicates that this port is the default Host on an OTG session
|
||||||
|
but HNP was used to switch roles.
|
||||||
|
Users:
|
||||||
|
|
||||||
|
What: /sys/class/udc/<udc>/is_otg
|
||||||
|
Date: June 2011
|
||||||
|
KernelVersion: 3.1
|
||||||
|
Contact: Felipe Balbi <balbi@kernel.org>
|
||||||
|
Description:
|
||||||
|
Indicates that this port support OTG.
|
||||||
|
Users:
|
||||||
|
|
||||||
|
What: /sys/class/udc/<udc>/maximum_speed
|
||||||
|
Date: June 2011
|
||||||
|
KernelVersion: 3.1
|
||||||
|
Contact: Felipe Balbi <balbi@kernel.org>
|
||||||
|
Description:
|
||||||
|
Indicates the maximum USB speed supported by this port.
|
||||||
|
Users:
|
||||||
|
|
||||||
|
What: /sys/class/udc/<udc>/maximum_speed
|
||||||
|
Date: June 2011
|
||||||
|
KernelVersion: 3.1
|
||||||
|
Contact: Felipe Balbi <balbi@kernel.org>
|
||||||
|
Description:
|
||||||
|
Indicates the maximum USB speed supported by this port.
|
||||||
|
Users:
|
||||||
|
|
||||||
|
What: /sys/class/udc/<udc>/soft_connect
|
||||||
|
Date: June 2011
|
||||||
|
KernelVersion: 3.1
|
||||||
|
Contact: Felipe Balbi <balbi@kernel.org>
|
||||||
|
Description:
|
||||||
|
Allows users to disconnect data pullup resistors thus causing a
|
||||||
|
logical disconnection from the USB Host.
|
||||||
|
Users:
|
||||||
|
|
||||||
|
What: /sys/class/udc/<udc>/srp
|
||||||
|
Date: June 2011
|
||||||
|
KernelVersion: 3.1
|
||||||
|
Contact: Felipe Balbi <balbi@kernel.org>
|
||||||
|
Description:
|
||||||
|
Allows users to manually start Session Request Protocol.
|
||||||
|
Users:
|
||||||
|
|
||||||
|
What: /sys/class/udc/<udc>/state
|
||||||
|
Date: June 2011
|
||||||
|
KernelVersion: 3.1
|
||||||
|
Contact: Felipe Balbi <balbi@kernel.org>
|
||||||
|
Description:
|
||||||
|
Indicates current state of the USB Device Controller. Valid
|
||||||
|
states are: 'not-attached', 'attached', 'powered',
|
||||||
|
'reconnecting', 'unauthenticated', 'default', 'addressed',
|
||||||
|
'configured', and 'suspended'; however not all USB Device
|
||||||
|
Controllers support reporting all states.
|
||||||
|
Users:
|
24
Documentation/ABI/stable/sysfs-devices
Normal file
24
Documentation/ABI/stable/sysfs-devices
Normal file
|
@ -0,0 +1,24 @@
|
||||||
|
# Note: This documents additional properties of any device beyond what
|
||||||
|
# is documented in Documentation/sysfs-rules.txt
|
||||||
|
|
||||||
|
What: /sys/devices/*/of_node
|
||||||
|
Date: February 2015
|
||||||
|
Contact: Device Tree mailing list <devicetree@vger.kernel.org>
|
||||||
|
Description:
|
||||||
|
Any device associated with a device-tree node will have
|
||||||
|
an of_path symlink pointing to the corresponding device
|
||||||
|
node in /sys/firmware/devicetree/
|
||||||
|
|
||||||
|
What: /sys/devices/*/devspec
|
||||||
|
Date: October 2016
|
||||||
|
Contact: Device Tree mailing list <devicetree@vger.kernel.org>
|
||||||
|
Description:
|
||||||
|
If CONFIG_OF is enabled, then this file is present. When
|
||||||
|
read, it returns full name of the device node.
|
||||||
|
|
||||||
|
What: /sys/devices/*/obppath
|
||||||
|
Date: October 2016
|
||||||
|
Contact: Device Tree mailing list <devicetree@vger.kernel.org>
|
||||||
|
Description:
|
||||||
|
If CONFIG_OF is enabled, then this file is present. When
|
||||||
|
read, it returns full name of the device node.
|
93
Documentation/ABI/stable/sysfs-devices-node
Normal file
93
Documentation/ABI/stable/sysfs-devices-node
Normal file
|
@ -0,0 +1,93 @@
|
||||||
|
What: /sys/devices/system/node/possible
|
||||||
|
Date: October 2002
|
||||||
|
Contact: Linux Memory Management list <linux-mm@kvack.org>
|
||||||
|
Description:
|
||||||
|
Nodes that could be possibly become online at some point.
|
||||||
|
|
||||||
|
What: /sys/devices/system/node/online
|
||||||
|
Date: October 2002
|
||||||
|
Contact: Linux Memory Management list <linux-mm@kvack.org>
|
||||||
|
Description:
|
||||||
|
Nodes that are online.
|
||||||
|
|
||||||
|
What: /sys/devices/system/node/has_normal_memory
|
||||||
|
Date: October 2002
|
||||||
|
Contact: Linux Memory Management list <linux-mm@kvack.org>
|
||||||
|
Description:
|
||||||
|
Nodes that have regular memory.
|
||||||
|
|
||||||
|
What: /sys/devices/system/node/has_cpu
|
||||||
|
Date: October 2002
|
||||||
|
Contact: Linux Memory Management list <linux-mm@kvack.org>
|
||||||
|
Description:
|
||||||
|
Nodes that have one or more CPUs.
|
||||||
|
|
||||||
|
What: /sys/devices/system/node/has_high_memory
|
||||||
|
Date: October 2002
|
||||||
|
Contact: Linux Memory Management list <linux-mm@kvack.org>
|
||||||
|
Description:
|
||||||
|
Nodes that have regular or high memory.
|
||||||
|
Depends on CONFIG_HIGHMEM.
|
||||||
|
|
||||||
|
What: /sys/devices/system/node/nodeX
|
||||||
|
Date: October 2002
|
||||||
|
Contact: Linux Memory Management list <linux-mm@kvack.org>
|
||||||
|
Description:
|
||||||
|
When CONFIG_NUMA is enabled, this is a directory containing
|
||||||
|
information on node X such as what CPUs are local to the
|
||||||
|
node. Each file is detailed next.
|
||||||
|
|
||||||
|
What: /sys/devices/system/node/nodeX/cpumap
|
||||||
|
Date: October 2002
|
||||||
|
Contact: Linux Memory Management list <linux-mm@kvack.org>
|
||||||
|
Description:
|
||||||
|
The node's cpumap.
|
||||||
|
|
||||||
|
What: /sys/devices/system/node/nodeX/cpulist
|
||||||
|
Date: October 2002
|
||||||
|
Contact: Linux Memory Management list <linux-mm@kvack.org>
|
||||||
|
Description:
|
||||||
|
The CPUs associated to the node.
|
||||||
|
|
||||||
|
What: /sys/devices/system/node/nodeX/meminfo
|
||||||
|
Date: October 2002
|
||||||
|
Contact: Linux Memory Management list <linux-mm@kvack.org>
|
||||||
|
Description:
|
||||||
|
Provides information about the node's distribution and memory
|
||||||
|
utilization. Similar to /proc/meminfo, see Documentation/filesystems/proc.txt
|
||||||
|
|
||||||
|
What: /sys/devices/system/node/nodeX/numastat
|
||||||
|
Date: October 2002
|
||||||
|
Contact: Linux Memory Management list <linux-mm@kvack.org>
|
||||||
|
Description:
|
||||||
|
The node's hit/miss statistics, in units of pages.
|
||||||
|
See Documentation/numastat.txt
|
||||||
|
|
||||||
|
What: /sys/devices/system/node/nodeX/distance
|
||||||
|
Date: October 2002
|
||||||
|
Contact: Linux Memory Management list <linux-mm@kvack.org>
|
||||||
|
Description:
|
||||||
|
Distance between the node and all the other nodes
|
||||||
|
in the system.
|
||||||
|
|
||||||
|
What: /sys/devices/system/node/nodeX/vmstat
|
||||||
|
Date: October 2002
|
||||||
|
Contact: Linux Memory Management list <linux-mm@kvack.org>
|
||||||
|
Description:
|
||||||
|
The node's zoned virtual memory statistics.
|
||||||
|
This is a superset of numastat.
|
||||||
|
|
||||||
|
What: /sys/devices/system/node/nodeX/compact
|
||||||
|
Date: February 2010
|
||||||
|
Contact: Mel Gorman <mel@csn.ul.ie>
|
||||||
|
Description:
|
||||||
|
When this file is written to, all memory within that node
|
||||||
|
will be compacted. When it completes, memory will be freed
|
||||||
|
into blocks which have as many contiguous pages as possible
|
||||||
|
|
||||||
|
What: /sys/devices/system/node/nodeX/hugepages/hugepages-<size>/
|
||||||
|
Date: December 2009
|
||||||
|
Contact: Lee Schermerhorn <lee.schermerhorn@hp.com>
|
||||||
|
Description:
|
||||||
|
The node's huge page size control/query attributes.
|
||||||
|
See Documentation/vm/hugetlbpage.txt
|
25
Documentation/ABI/stable/sysfs-devices-system-cpu
Normal file
25
Documentation/ABI/stable/sysfs-devices-system-cpu
Normal file
|
@ -0,0 +1,25 @@
|
||||||
|
What: /sys/devices/system/cpu/dscr_default
|
||||||
|
Date: 13-May-2014
|
||||||
|
KernelVersion: v3.15.0
|
||||||
|
Contact:
|
||||||
|
Description: Writes are equivalent to writing to
|
||||||
|
/sys/devices/system/cpu/cpuN/dscr on all CPUs.
|
||||||
|
Reads return the last written value or 0.
|
||||||
|
This value is not a global default: it is a way to set
|
||||||
|
all per-CPU defaults at the same time.
|
||||||
|
Values: 64 bit unsigned integer (bit field)
|
||||||
|
|
||||||
|
What: /sys/devices/system/cpu/cpu[0-9]+/dscr
|
||||||
|
Date: 13-May-2014
|
||||||
|
KernelVersion: v3.15.0
|
||||||
|
Contact:
|
||||||
|
Description: Default value for the Data Stream Control Register (DSCR) on
|
||||||
|
a CPU.
|
||||||
|
This default value is used when the kernel is executing and
|
||||||
|
for any process that has not set the DSCR itself.
|
||||||
|
If a process ever sets the DSCR (via direct access to the
|
||||||
|
SPR) that value will be persisted for that process and used
|
||||||
|
on any CPU where it executes (overriding the value described
|
||||||
|
here).
|
||||||
|
If set by a process it will be inherited by child processes.
|
||||||
|
Values: 64 bit unsigned integer (bit field)
|
77
Documentation/ABI/stable/sysfs-devices-system-xen_memory
Normal file
77
Documentation/ABI/stable/sysfs-devices-system-xen_memory
Normal file
|
@ -0,0 +1,77 @@
|
||||||
|
What: /sys/devices/system/xen_memory/xen_memory0/max_retry_count
|
||||||
|
Date: May 2011
|
||||||
|
KernelVersion: 2.6.39
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
The maximum number of times the balloon driver will
|
||||||
|
attempt to increase the balloon before giving up. See
|
||||||
|
also 'retry_count' below.
|
||||||
|
A value of zero means retry forever and is the default one.
|
||||||
|
|
||||||
|
What: /sys/devices/system/xen_memory/xen_memory0/max_schedule_delay
|
||||||
|
Date: May 2011
|
||||||
|
KernelVersion: 2.6.39
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
The limit that 'schedule_delay' (see below) will be
|
||||||
|
increased to. The default value is 32 seconds.
|
||||||
|
|
||||||
|
What: /sys/devices/system/xen_memory/xen_memory0/retry_count
|
||||||
|
Date: May 2011
|
||||||
|
KernelVersion: 2.6.39
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
The current number of times that the balloon driver
|
||||||
|
has attempted to increase the size of the balloon.
|
||||||
|
The default value is one. With max_retry_count being
|
||||||
|
zero (unlimited), this means that the driver will attempt
|
||||||
|
to retry with a 'schedule_delay' delay.
|
||||||
|
|
||||||
|
What: /sys/devices/system/xen_memory/xen_memory0/schedule_delay
|
||||||
|
Date: May 2011
|
||||||
|
KernelVersion: 2.6.39
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
The time (in seconds) to wait between attempts to
|
||||||
|
increase the balloon. Each time the balloon cannot be
|
||||||
|
increased, 'schedule_delay' is increased (until
|
||||||
|
'max_schedule_delay' is reached at which point it
|
||||||
|
will use the max value).
|
||||||
|
|
||||||
|
What: /sys/devices/system/xen_memory/xen_memory0/target
|
||||||
|
Date: April 2008
|
||||||
|
KernelVersion: 2.6.26
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
The target number of pages to adjust this domain's
|
||||||
|
memory reservation to.
|
||||||
|
|
||||||
|
What: /sys/devices/system/xen_memory/xen_memory0/target_kb
|
||||||
|
Date: April 2008
|
||||||
|
KernelVersion: 2.6.26
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
As target above, except the value is in KiB.
|
||||||
|
|
||||||
|
What: /sys/devices/system/xen_memory/xen_memory0/info/current_kb
|
||||||
|
Date: April 2008
|
||||||
|
KernelVersion: 2.6.26
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
Current size (in KiB) of this domain's memory
|
||||||
|
reservation.
|
||||||
|
|
||||||
|
What: /sys/devices/system/xen_memory/xen_memory0/info/high_kb
|
||||||
|
Date: April 2008
|
||||||
|
KernelVersion: 2.6.26
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
Amount (in KiB) of high memory in the balloon.
|
||||||
|
|
||||||
|
What: /sys/devices/system/xen_memory/xen_memory0/info/low_kb
|
||||||
|
Date: April 2008
|
||||||
|
KernelVersion: 2.6.26
|
||||||
|
Contact: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
|
||||||
|
Description:
|
||||||
|
Amount (in KiB) of low (or normal) memory in the
|
||||||
|
balloon.
|
189
Documentation/ABI/stable/sysfs-driver-ib_srp
Normal file
189
Documentation/ABI/stable/sysfs-driver-ib_srp
Normal file
|
@ -0,0 +1,189 @@
|
||||||
|
What: /sys/class/infiniband_srp/srp-<hca>-<port_number>/add_target
|
||||||
|
Date: January 2, 2006
|
||||||
|
KernelVersion: 2.6.15
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: Interface for making ib_srp connect to a new target.
|
||||||
|
One can request ib_srp to connect to a new target by writing
|
||||||
|
a comma-separated list of login parameters to this sysfs
|
||||||
|
attribute. The supported parameters are:
|
||||||
|
* id_ext, a 16-digit hexadecimal number specifying the eight
|
||||||
|
byte identifier extension in the 16-byte SRP target port
|
||||||
|
identifier. The target port identifier is sent by ib_srp
|
||||||
|
to the target in the SRP_LOGIN_REQ request.
|
||||||
|
* ioc_guid, a 16-digit hexadecimal number specifying the eight
|
||||||
|
byte I/O controller GUID portion of the 16-byte target port
|
||||||
|
identifier.
|
||||||
|
* dgid, a 32-digit hexadecimal number specifying the
|
||||||
|
destination GID.
|
||||||
|
* pkey, a four-digit hexadecimal number specifying the
|
||||||
|
InfiniBand partition key.
|
||||||
|
* service_id, a 16-digit hexadecimal number specifying the
|
||||||
|
InfiniBand service ID used to establish communication with
|
||||||
|
the SRP target. How to find out the value of the service ID
|
||||||
|
is specified in the documentation of the SRP target.
|
||||||
|
* max_sect, a decimal number specifying the maximum number of
|
||||||
|
512-byte sectors to be transferred via a single SCSI command.
|
||||||
|
* max_cmd_per_lun, a decimal number specifying the maximum
|
||||||
|
number of outstanding commands for a single LUN.
|
||||||
|
* io_class, a hexadecimal number specifying the SRP I/O class.
|
||||||
|
Must be either 0xff00 (rev 10) or 0x0100 (rev 16a). The I/O
|
||||||
|
class defines the format of the SRP initiator and target
|
||||||
|
port identifiers.
|
||||||
|
* initiator_ext, a 16-digit hexadecimal number specifying the
|
||||||
|
identifier extension portion of the SRP initiator port
|
||||||
|
identifier. This data is sent by the initiator to the target
|
||||||
|
in the SRP_LOGIN_REQ request.
|
||||||
|
* cmd_sg_entries, a number in the range 1..255 that specifies
|
||||||
|
the maximum number of data buffer descriptors stored in the
|
||||||
|
SRP_CMD information unit itself. With allow_ext_sg=0 the
|
||||||
|
parameter cmd_sg_entries defines the maximum S/G list length
|
||||||
|
for a single SRP_CMD, and commands whose S/G list length
|
||||||
|
exceeds this limit after S/G list collapsing will fail.
|
||||||
|
* allow_ext_sg, whether ib_srp is allowed to include a partial
|
||||||
|
memory descriptor list in an SRP_CMD instead of the entire
|
||||||
|
list. If a partial memory descriptor list has been included
|
||||||
|
in an SRP_CMD the remaining memory descriptors are
|
||||||
|
communicated from initiator to target via an additional RDMA
|
||||||
|
transfer. Setting allow_ext_sg to 1 increases the maximum
|
||||||
|
amount of data that can be transferred between initiator and
|
||||||
|
target via a single SCSI command. Since not all SRP target
|
||||||
|
implementations support partial memory descriptor lists the
|
||||||
|
default value for this option is 0.
|
||||||
|
* sg_tablesize, a number in the range 1..2048 specifying the
|
||||||
|
maximum S/G list length the SCSI layer is allowed to pass to
|
||||||
|
ib_srp. Specifying a value that exceeds cmd_sg_entries is
|
||||||
|
only safe with partial memory descriptor list support enabled
|
||||||
|
(allow_ext_sg=1).
|
||||||
|
* comp_vector, a number in the range 0..n-1 specifying the
|
||||||
|
MSI-X completion vector of the first RDMA channel. Some
|
||||||
|
HCA's allocate multiple (n) MSI-X vectors per HCA port. If
|
||||||
|
the IRQ affinity masks of these interrupts have been
|
||||||
|
configured such that each MSI-X interrupt is handled by a
|
||||||
|
different CPU then the comp_vector parameter can be used to
|
||||||
|
spread the SRP completion workload over multiple CPU's.
|
||||||
|
* tl_retry_count, a number in the range 2..7 specifying the
|
||||||
|
IB RC retry count.
|
||||||
|
* queue_size, the maximum number of commands that the
|
||||||
|
initiator is allowed to queue per SCSI host. The default
|
||||||
|
value for this parameter is 62. The lowest supported value
|
||||||
|
is 2.
|
||||||
|
|
||||||
|
What: /sys/class/infiniband_srp/srp-<hca>-<port_number>/ibdev
|
||||||
|
Date: January 2, 2006
|
||||||
|
KernelVersion: 2.6.15
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: HCA name (<hca>).
|
||||||
|
|
||||||
|
What: /sys/class/infiniband_srp/srp-<hca>-<port_number>/port
|
||||||
|
Date: January 2, 2006
|
||||||
|
KernelVersion: 2.6.15
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: HCA port number (<port_number>).
|
||||||
|
|
||||||
|
What: /sys/class/scsi_host/host<n>/allow_ext_sg
|
||||||
|
Date: May 19, 2011
|
||||||
|
KernelVersion: 2.6.39
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: Whether ib_srp is allowed to include a partial memory
|
||||||
|
descriptor list in an SRP_CMD when communicating with an SRP
|
||||||
|
target.
|
||||||
|
|
||||||
|
What: /sys/class/scsi_host/host<n>/ch_count
|
||||||
|
Date: April 1, 2015
|
||||||
|
KernelVersion: 3.19
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: Number of RDMA channels used for communication with the SRP
|
||||||
|
target.
|
||||||
|
|
||||||
|
What: /sys/class/scsi_host/host<n>/cmd_sg_entries
|
||||||
|
Date: May 19, 2011
|
||||||
|
KernelVersion: 2.6.39
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: Maximum number of data buffer descriptors that may be sent to
|
||||||
|
the target in a single SRP_CMD request.
|
||||||
|
|
||||||
|
What: /sys/class/scsi_host/host<n>/comp_vector
|
||||||
|
Date: September 2, 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: Completion vector used for the first RDMA channel.
|
||||||
|
|
||||||
|
What: /sys/class/scsi_host/host<n>/dgid
|
||||||
|
Date: June 17, 2006
|
||||||
|
KernelVersion: 2.6.17
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: InfiniBand destination GID used for communication with the SRP
|
||||||
|
target. Differs from orig_dgid if port redirection has happened.
|
||||||
|
|
||||||
|
What: /sys/class/scsi_host/host<n>/id_ext
|
||||||
|
Date: June 17, 2006
|
||||||
|
KernelVersion: 2.6.17
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: Eight-byte identifier extension portion of the 16-byte target
|
||||||
|
port identifier.
|
||||||
|
|
||||||
|
What: /sys/class/scsi_host/host<n>/ioc_guid
|
||||||
|
Date: June 17, 2006
|
||||||
|
KernelVersion: 2.6.17
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: Eight-byte I/O controller GUID portion of the 16-byte target
|
||||||
|
port identifier.
|
||||||
|
|
||||||
|
What: /sys/class/scsi_host/host<n>/local_ib_device
|
||||||
|
Date: November 29, 2006
|
||||||
|
KernelVersion: 2.6.19
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: Name of the InfiniBand HCA used for communicating with the
|
||||||
|
SRP target.
|
||||||
|
|
||||||
|
What: /sys/class/scsi_host/host<n>/local_ib_port
|
||||||
|
Date: November 29, 2006
|
||||||
|
KernelVersion: 2.6.19
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: Number of the HCA port used for communicating with the
|
||||||
|
SRP target.
|
||||||
|
|
||||||
|
What: /sys/class/scsi_host/host<n>/orig_dgid
|
||||||
|
Date: June 17, 2006
|
||||||
|
KernelVersion: 2.6.17
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: InfiniBand destination GID specified in the parameters
|
||||||
|
written to the add_target sysfs attribute.
|
||||||
|
|
||||||
|
What: /sys/class/scsi_host/host<n>/pkey
|
||||||
|
Date: June 17, 2006
|
||||||
|
KernelVersion: 2.6.17
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: A 16-bit number representing the InfiniBand partition key used
|
||||||
|
for communication with the SRP target.
|
||||||
|
|
||||||
|
What: /sys/class/scsi_host/host<n>/req_lim
|
||||||
|
Date: October 20, 2010
|
||||||
|
KernelVersion: 2.6.36
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: Number of requests ib_srp can send to the target before it has
|
||||||
|
to wait for more credits. For more information see also the
|
||||||
|
SRP credit algorithm in the SRP specification.
|
||||||
|
|
||||||
|
What: /sys/class/scsi_host/host<n>/service_id
|
||||||
|
Date: June 17, 2006
|
||||||
|
KernelVersion: 2.6.17
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: InfiniBand service ID used for establishing communication with
|
||||||
|
the SRP target.
|
||||||
|
|
||||||
|
What: /sys/class/scsi_host/host<n>/sgid
|
||||||
|
Date: February 1, 2014
|
||||||
|
KernelVersion: 3.13
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: InfiniBand GID of the source port used for communication with
|
||||||
|
the SRP target.
|
||||||
|
|
||||||
|
What: /sys/class/scsi_host/host<n>/zero_req_lim
|
||||||
|
Date: September 20, 2006
|
||||||
|
KernelVersion: 2.6.18
|
||||||
|
Contact: linux-rdma@vger.kernel.org
|
||||||
|
Description: Number of times the initiator had to wait before sending a
|
||||||
|
request to the target because it ran out of credits. For more
|
||||||
|
information see also the SRP credit algorithm in the SRP
|
||||||
|
specification.
|
8
Documentation/ABI/stable/sysfs-driver-qla2xxx
Normal file
8
Documentation/ABI/stable/sysfs-driver-qla2xxx
Normal file
|
@ -0,0 +1,8 @@
|
||||||
|
What: /sys/bus/pci/drivers/qla2xxx/.../devices/*
|
||||||
|
Date: September 2009
|
||||||
|
Contact: QLogic Linux Driver <linux-driver@qlogic.com>
|
||||||
|
Description: qla2xxx-udev.sh currently looks for uevent CHANGE events to
|
||||||
|
signal a firmware-dump has been generated by the driver and is
|
||||||
|
ready for retrieval.
|
||||||
|
Users: qla2xxx-udev.sh. Proposed changes should be mailed to
|
||||||
|
linux-driver@qlogic.com
|
62
Documentation/ABI/stable/sysfs-driver-usb-usbtmc
Normal file
62
Documentation/ABI/stable/sysfs-driver-usb-usbtmc
Normal file
|
@ -0,0 +1,62 @@
|
||||||
|
What: /sys/bus/usb/drivers/usbtmc/*/interface_capabilities
|
||||||
|
What: /sys/bus/usb/drivers/usbtmc/*/device_capabilities
|
||||||
|
Date: August 2008
|
||||||
|
Contact: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
|
||||||
|
Description:
|
||||||
|
These files show the various USB TMC capabilities as described
|
||||||
|
by the device itself. The full description of the bitfields
|
||||||
|
can be found in the USB TMC documents from the USB-IF entitled
|
||||||
|
"Universal Serial Bus Test and Measurement Class Specification
|
||||||
|
(USBTMC) Revision 1.0" section 4.2.1.8.
|
||||||
|
|
||||||
|
The files are read only.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/bus/usb/drivers/usbtmc/*/usb488_interface_capabilities
|
||||||
|
What: /sys/bus/usb/drivers/usbtmc/*/usb488_device_capabilities
|
||||||
|
Date: August 2008
|
||||||
|
Contact: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
|
||||||
|
Description:
|
||||||
|
These files show the various USB TMC capabilities as described
|
||||||
|
by the device itself. The full description of the bitfields
|
||||||
|
can be found in the USB TMC documents from the USB-IF entitled
|
||||||
|
"Universal Serial Bus Test and Measurement Class, Subclass
|
||||||
|
USB488 Specification (USBTMC-USB488) Revision 1.0" section
|
||||||
|
4.2.2.
|
||||||
|
|
||||||
|
The files are read only.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/bus/usb/drivers/usbtmc/*/TermChar
|
||||||
|
Date: August 2008
|
||||||
|
Contact: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
|
||||||
|
Description:
|
||||||
|
This file is the TermChar value to be sent to the USB TMC
|
||||||
|
device as described by the document, "Universal Serial Bus Test
|
||||||
|
and Measurement Class Specification
|
||||||
|
(USBTMC) Revision 1.0" as published by the USB-IF.
|
||||||
|
|
||||||
|
Note that the TermCharEnabled file determines if this value is
|
||||||
|
sent to the device or not.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/bus/usb/drivers/usbtmc/*/TermCharEnabled
|
||||||
|
Date: August 2008
|
||||||
|
Contact: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
|
||||||
|
Description:
|
||||||
|
This file determines if the TermChar is to be sent to the
|
||||||
|
device on every transaction or not. For more details about
|
||||||
|
this, please see the document, "Universal Serial Bus Test and
|
||||||
|
Measurement Class Specification (USBTMC) Revision 1.0" as
|
||||||
|
published by the USB-IF.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/bus/usb/drivers/usbtmc/*/auto_abort
|
||||||
|
Date: August 2008
|
||||||
|
Contact: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
|
||||||
|
Description:
|
||||||
|
This file determines if the transaction of the USB TMC
|
||||||
|
device is to be automatically aborted if there is any error.
|
||||||
|
For more details about this, please see the document,
|
||||||
|
"Universal Serial Bus Test and Measurement Class Specification
|
||||||
|
(USBTMC) Revision 1.0" as published by the USB-IF.
|
15
Documentation/ABI/stable/sysfs-driver-w1_ds28e04
Normal file
15
Documentation/ABI/stable/sysfs-driver-w1_ds28e04
Normal file
|
@ -0,0 +1,15 @@
|
||||||
|
What: /sys/bus/w1/devices/.../pio
|
||||||
|
Date: May 2012
|
||||||
|
Contact: Markus Franke <franm@hrz.tu-chemnitz.de>
|
||||||
|
Description: read/write the contents of the two PIO's of the DS28E04-100
|
||||||
|
see Documentation/w1/slaves/w1_ds28e04 for detailed information
|
||||||
|
Users: any user space application which wants to communicate with DS28E04-100
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/bus/w1/devices/.../eeprom
|
||||||
|
Date: May 2012
|
||||||
|
Contact: Markus Franke <franm@hrz.tu-chemnitz.de>
|
||||||
|
Description: read/write the contents of the EEPROM memory of the DS28E04-100
|
||||||
|
see Documentation/w1/slaves/w1_ds28e04 for detailed information
|
||||||
|
Users: any user space application which wants to communicate with DS28E04-100
|
6
Documentation/ABI/stable/sysfs-driver-w1_ds28ea00
Normal file
6
Documentation/ABI/stable/sysfs-driver-w1_ds28ea00
Normal file
|
@ -0,0 +1,6 @@
|
||||||
|
What: /sys/bus/w1/devices/.../w1_seq
|
||||||
|
Date: Apr 2015
|
||||||
|
Contact: Matt Campbell <mattrcampbell@gmail.com>
|
||||||
|
Description: Support for the DS28EA00 chain sequence function
|
||||||
|
see Documentation/w1/slaves/w1_therm for detailed information
|
||||||
|
Users: any user space application which wants to communicate with DS28EA00
|
75
Documentation/ABI/stable/sysfs-firmware-efi-vars
Normal file
75
Documentation/ABI/stable/sysfs-firmware-efi-vars
Normal file
|
@ -0,0 +1,75 @@
|
||||||
|
What: /sys/firmware/efi/vars
|
||||||
|
Date: April 2004
|
||||||
|
Contact: Matt Domsch <Matt_Domsch@dell.com>
|
||||||
|
Description:
|
||||||
|
This directory exposes interfaces for interactive with
|
||||||
|
EFI variables. For more information on EFI variables,
|
||||||
|
see 'Variable Services' in the UEFI specification
|
||||||
|
(section 7.2 in specification version 2.3 Errata D).
|
||||||
|
|
||||||
|
In summary, EFI variables are named, and are classified
|
||||||
|
into separate namespaces through the use of a vendor
|
||||||
|
GUID. They also have an arbitrary binary value
|
||||||
|
associated with them.
|
||||||
|
|
||||||
|
The efivars module enumerates these variables and
|
||||||
|
creates a separate directory for each one found. Each
|
||||||
|
directory has a name of the form "<key>-<vendor guid>"
|
||||||
|
and contains the following files:
|
||||||
|
|
||||||
|
attributes: A read-only text file enumerating the
|
||||||
|
EFI variable flags. Potential values
|
||||||
|
include:
|
||||||
|
|
||||||
|
EFI_VARIABLE_NON_VOLATILE
|
||||||
|
EFI_VARIABLE_BOOTSERVICE_ACCESS
|
||||||
|
EFI_VARIABLE_RUNTIME_ACCESS
|
||||||
|
EFI_VARIABLE_HARDWARE_ERROR_RECORD
|
||||||
|
EFI_VARIABLE_AUTHENTICATED_WRITE_ACCESS
|
||||||
|
|
||||||
|
See the EFI documentation for an
|
||||||
|
explanation of each of these variables.
|
||||||
|
|
||||||
|
data: A read-only binary file that can be read
|
||||||
|
to attain the value of the EFI variable
|
||||||
|
|
||||||
|
guid: The vendor GUID of the variable. This
|
||||||
|
should always match the GUID in the
|
||||||
|
variable's name.
|
||||||
|
|
||||||
|
raw_var: A binary file that can be read to obtain
|
||||||
|
a structure that contains everything
|
||||||
|
there is to know about the variable.
|
||||||
|
For structure definition see "struct
|
||||||
|
efi_variable" in the kernel sources.
|
||||||
|
|
||||||
|
This file can also be written to in
|
||||||
|
order to update the value of a variable.
|
||||||
|
For this to work however, all fields of
|
||||||
|
the "struct efi_variable" passed must
|
||||||
|
match byte for byte with the structure
|
||||||
|
read out of the file, save for the value
|
||||||
|
portion.
|
||||||
|
|
||||||
|
**Note** the efi_variable structure
|
||||||
|
read/written with this file contains a
|
||||||
|
'long' type that may change widths
|
||||||
|
depending on your underlying
|
||||||
|
architecture.
|
||||||
|
|
||||||
|
size: As ASCII representation of the size of
|
||||||
|
the variable's value.
|
||||||
|
|
||||||
|
|
||||||
|
In addition, two other magic binary files are provided
|
||||||
|
in the top-level directory and are used for adding and
|
||||||
|
removing variables:
|
||||||
|
|
||||||
|
new_var: Takes a "struct efi_variable" and
|
||||||
|
instructs the EFI firmware to create a
|
||||||
|
new variable.
|
||||||
|
|
||||||
|
del_var: Takes a "struct efi_variable" and
|
||||||
|
instructs the EFI firmware to remove any
|
||||||
|
variable that has a matching vendor GUID
|
||||||
|
and variable key name.
|
41
Documentation/ABI/stable/sysfs-firmware-opal-dump
Normal file
41
Documentation/ABI/stable/sysfs-firmware-opal-dump
Normal file
|
@ -0,0 +1,41 @@
|
||||||
|
What: /sys/firmware/opal/dump
|
||||||
|
Date: Feb 2014
|
||||||
|
Contact: Stewart Smith <stewart@linux.vnet.ibm.com>
|
||||||
|
Description:
|
||||||
|
This directory exposes interfaces for interacting with
|
||||||
|
the FSP and platform dumps through OPAL firmware interface.
|
||||||
|
|
||||||
|
This is only for the powerpc/powernv platform.
|
||||||
|
|
||||||
|
initiate_dump: When '1' is written to it,
|
||||||
|
we will initiate a dump.
|
||||||
|
Read this file for supported commands.
|
||||||
|
|
||||||
|
0xXX-0xYYYY: A directory for dump of type 0xXX and
|
||||||
|
id 0xYYYY (in hex). The name of this
|
||||||
|
directory should not be relied upon to
|
||||||
|
be in this format, only that it's unique
|
||||||
|
among all dumps. For determining the type
|
||||||
|
and ID of the dump, use the id and type files.
|
||||||
|
Do not rely on any particular size of dump
|
||||||
|
type or dump id.
|
||||||
|
|
||||||
|
Each dump has the following files:
|
||||||
|
id: An ASCII representation of the dump ID
|
||||||
|
in hex (e.g. '0x01')
|
||||||
|
type: An ASCII representation of the type of
|
||||||
|
dump in the format "0x%x %s" with the ID
|
||||||
|
in hex and a description of the dump type
|
||||||
|
(or 'unknown').
|
||||||
|
Type '0xffffffff unknown' is used when
|
||||||
|
we could not get the type from firmware.
|
||||||
|
e.g. '0x02 System/Platform Dump'
|
||||||
|
dump: A binary file containing the dump.
|
||||||
|
The size of the dump is the size of this file.
|
||||||
|
acknowledge: When 'ack' is written to this, we will
|
||||||
|
acknowledge that we've retrieved the
|
||||||
|
dump to the service processor. It will
|
||||||
|
then remove it, making the dump
|
||||||
|
inaccessible.
|
||||||
|
Reading this file will get a list of
|
||||||
|
supported actions.
|
60
Documentation/ABI/stable/sysfs-firmware-opal-elog
Normal file
60
Documentation/ABI/stable/sysfs-firmware-opal-elog
Normal file
|
@ -0,0 +1,60 @@
|
||||||
|
What: /sys/firmware/opal/elog
|
||||||
|
Date: Feb 2014
|
||||||
|
Contact: Stewart Smith <stewart@linux.vnet.ibm.com>
|
||||||
|
Description:
|
||||||
|
This directory exposes error log entries retrieved
|
||||||
|
through the OPAL firmware interface.
|
||||||
|
|
||||||
|
Each error log is identified by a unique ID and will
|
||||||
|
exist until explicitly acknowledged to firmware.
|
||||||
|
|
||||||
|
Each log entry has a directory in /sys/firmware/opal/elog.
|
||||||
|
|
||||||
|
Log entries may be purged by the service processor
|
||||||
|
before retrieved by firmware or retrieved/acknowledged by
|
||||||
|
Linux if there is no room for more log entries.
|
||||||
|
|
||||||
|
In the event that Linux has retrieved the log entries
|
||||||
|
but not explicitly acknowledged them to firmware and
|
||||||
|
the service processor needs more room for log entries,
|
||||||
|
the only remaining copy of a log message may be in
|
||||||
|
Linux.
|
||||||
|
|
||||||
|
Typically, a user space daemon will monitor for new
|
||||||
|
entries, read them out and acknowledge them.
|
||||||
|
|
||||||
|
The service processor may be able to store more log
|
||||||
|
entries than firmware can, so after you acknowledge
|
||||||
|
an event from Linux you may instantly get another one
|
||||||
|
from the queue that was generated some time in the past.
|
||||||
|
|
||||||
|
The raw log format is a binary format. We currently
|
||||||
|
do not parse this at all in kernel, leaving it up to
|
||||||
|
user space to solve the problem. In future, we may
|
||||||
|
do more parsing in kernel and add more files to make
|
||||||
|
it easier for simple user space processes to extract
|
||||||
|
more information.
|
||||||
|
|
||||||
|
For each log entry (directory), there are the following
|
||||||
|
files:
|
||||||
|
|
||||||
|
id: An ASCII representation of the ID of the
|
||||||
|
error log, in hex - e.g. "0x01".
|
||||||
|
|
||||||
|
type: An ASCII representation of the type id and
|
||||||
|
description of the type of error log.
|
||||||
|
Currently just "0x00 PEL" - platform error log.
|
||||||
|
In the future there may be additional types.
|
||||||
|
|
||||||
|
raw: A read-only binary file that can be read
|
||||||
|
to get the raw log entry. These are
|
||||||
|
<16kb, often just hundreds of bytes and
|
||||||
|
"average" 2kb.
|
||||||
|
|
||||||
|
acknowledge: Writing 'ack' to this file will acknowledge
|
||||||
|
the error log to firmware (and in turn
|
||||||
|
the service processor, if applicable).
|
||||||
|
Shortly after acknowledging it, the log
|
||||||
|
entry will be removed from sysfs.
|
||||||
|
Reading this file will list the supported
|
||||||
|
operations (currently just acknowledge).
|
87
Documentation/ABI/stable/sysfs-fs-orangefs
Normal file
87
Documentation/ABI/stable/sysfs-fs-orangefs
Normal file
|
@ -0,0 +1,87 @@
|
||||||
|
What: /sys/fs/orangefs/perf_counters/*
|
||||||
|
Date: Jun 2015
|
||||||
|
Contact: Mike Marshall <hubcap@omnibond.com>
|
||||||
|
Description:
|
||||||
|
Counters and settings for various caches.
|
||||||
|
Read only.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/fs/orangefs/perf_counter_reset
|
||||||
|
Date: June 2015
|
||||||
|
Contact: Mike Marshall <hubcap@omnibond.com>
|
||||||
|
Description:
|
||||||
|
echo a 0 or a 1 into perf_counter_reset to
|
||||||
|
reset all the counters in
|
||||||
|
/sys/fs/orangefs/perf_counters
|
||||||
|
except ones with PINT_PERF_PRESERVE set.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/fs/orangefs/perf_time_interval_secs
|
||||||
|
Date: Jun 2015
|
||||||
|
Contact: Mike Marshall <hubcap@omnibond.com>
|
||||||
|
Description:
|
||||||
|
Length of perf counter intervals in
|
||||||
|
seconds.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/fs/orangefs/perf_history_size
|
||||||
|
Date: Jun 2015
|
||||||
|
Contact: Mike Marshall <hubcap@omnibond.com>
|
||||||
|
Description:
|
||||||
|
The perf_counters cache statistics have N, or
|
||||||
|
perf_history_size, samples. The default is
|
||||||
|
one.
|
||||||
|
|
||||||
|
Every perf_time_interval_secs the (first)
|
||||||
|
samples are reset.
|
||||||
|
|
||||||
|
If N is greater than one, the "current" set
|
||||||
|
of samples is reset, and the samples from the
|
||||||
|
other N-1 intervals remain available.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/fs/orangefs/op_timeout_secs
|
||||||
|
Date: Jun 2015
|
||||||
|
Contact: Mike Marshall <hubcap@omnibond.com>
|
||||||
|
Description:
|
||||||
|
Service operation timeout in seconds.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/fs/orangefs/slot_timeout_secs
|
||||||
|
Date: Jun 2015
|
||||||
|
Contact: Mike Marshall <hubcap@omnibond.com>
|
||||||
|
Description:
|
||||||
|
"Slot" timeout in seconds. A "slot"
|
||||||
|
is an indexed buffer in the shared
|
||||||
|
memory segment used for communication
|
||||||
|
between the kernel module and userspace.
|
||||||
|
Slots are requested and waited for,
|
||||||
|
the wait times out after slot_timeout_secs.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/fs/orangefs/acache/*
|
||||||
|
Date: Jun 2015
|
||||||
|
Contact: Mike Marshall <hubcap@omnibond.com>
|
||||||
|
Description:
|
||||||
|
Attribute cache configurable settings.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/fs/orangefs/ncache/*
|
||||||
|
Date: Jun 2015
|
||||||
|
Contact: Mike Marshall <hubcap@omnibond.com>
|
||||||
|
Description:
|
||||||
|
Name cache configurable settings.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/fs/orangefs/capcache/*
|
||||||
|
Date: Jun 2015
|
||||||
|
Contact: Mike Marshall <hubcap@omnibond.com>
|
||||||
|
Description:
|
||||||
|
Capability cache configurable settings.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/fs/orangefs/ccache/*
|
||||||
|
Date: Jun 2015
|
||||||
|
Contact: Mike Marshall <hubcap@omnibond.com>
|
||||||
|
Description:
|
||||||
|
Credential cache configurable settings.
|
34
Documentation/ABI/stable/sysfs-module
Normal file
34
Documentation/ABI/stable/sysfs-module
Normal file
|
@ -0,0 +1,34 @@
|
||||||
|
What: /sys/module
|
||||||
|
Description:
|
||||||
|
The /sys/module tree consists of the following structure:
|
||||||
|
|
||||||
|
/sys/module/MODULENAME
|
||||||
|
The name of the module that is in the kernel. This
|
||||||
|
module name will always show up if the module is loaded as a
|
||||||
|
dynamic module. If it is built directly into the kernel, it
|
||||||
|
will only show up if it has a version or at least one
|
||||||
|
parameter.
|
||||||
|
|
||||||
|
Note: The conditions of creation in the built-in case are not
|
||||||
|
by design and may be removed in the future.
|
||||||
|
|
||||||
|
/sys/module/MODULENAME/parameters
|
||||||
|
This directory contains individual files that are each
|
||||||
|
individual parameters of the module that are able to be
|
||||||
|
changed at runtime. See the individual module
|
||||||
|
documentation as to the contents of these parameters and
|
||||||
|
what they accomplish.
|
||||||
|
|
||||||
|
Note: The individual parameter names and values are not
|
||||||
|
considered stable, only the fact that they will be
|
||||||
|
placed in this location within sysfs. See the
|
||||||
|
individual driver documentation for details as to the
|
||||||
|
stability of the different parameters.
|
||||||
|
|
||||||
|
/sys/module/MODULENAME/refcnt
|
||||||
|
If the module is able to be unloaded from the kernel, this file
|
||||||
|
will contain the current reference count of the module.
|
||||||
|
|
||||||
|
Note: If the module is built into the kernel, or if the
|
||||||
|
CONFIG_MODULE_UNLOAD kernel configuration value is not enabled,
|
||||||
|
this file will not be present.
|
58
Documentation/ABI/stable/sysfs-transport-srp
Normal file
58
Documentation/ABI/stable/sysfs-transport-srp
Normal file
|
@ -0,0 +1,58 @@
|
||||||
|
What: /sys/class/srp_remote_ports/port-<h>:<n>/delete
|
||||||
|
Date: June 1, 2012
|
||||||
|
KernelVersion: 3.7
|
||||||
|
Contact: linux-scsi@vger.kernel.org, linux-rdma@vger.kernel.org
|
||||||
|
Description: Instructs an SRP initiator to disconnect from a target and to
|
||||||
|
remove all LUNs imported from that target.
|
||||||
|
|
||||||
|
What: /sys/class/srp_remote_ports/port-<h>:<n>/dev_loss_tmo
|
||||||
|
Date: February 1, 2014
|
||||||
|
KernelVersion: 3.13
|
||||||
|
Contact: linux-scsi@vger.kernel.org, linux-rdma@vger.kernel.org
|
||||||
|
Description: Number of seconds the SCSI layer will wait after a transport
|
||||||
|
layer error has been observed before removing a target port.
|
||||||
|
Zero means immediate removal. Setting this attribute to "off"
|
||||||
|
will disable the dev_loss timer.
|
||||||
|
|
||||||
|
What: /sys/class/srp_remote_ports/port-<h>:<n>/fast_io_fail_tmo
|
||||||
|
Date: February 1, 2014
|
||||||
|
KernelVersion: 3.13
|
||||||
|
Contact: linux-scsi@vger.kernel.org, linux-rdma@vger.kernel.org
|
||||||
|
Description: Number of seconds the SCSI layer will wait after a transport
|
||||||
|
layer error has been observed before failing I/O. Zero means
|
||||||
|
failing I/O immediately. Setting this attribute to "off" will
|
||||||
|
disable the fast_io_fail timer.
|
||||||
|
|
||||||
|
What: /sys/class/srp_remote_ports/port-<h>:<n>/port_id
|
||||||
|
Date: June 27, 2007
|
||||||
|
KernelVersion: 2.6.24
|
||||||
|
Contact: linux-scsi@vger.kernel.org
|
||||||
|
Description: 16-byte local SRP port identifier in hexadecimal format. An
|
||||||
|
example: 4c:49:4e:55:58:20:56:49:4f:00:00:00:00:00:00:00.
|
||||||
|
|
||||||
|
What: /sys/class/srp_remote_ports/port-<h>:<n>/reconnect_delay
|
||||||
|
Date: February 1, 2014
|
||||||
|
KernelVersion: 3.13
|
||||||
|
Contact: linux-scsi@vger.kernel.org, linux-rdma@vger.kernel.org
|
||||||
|
Description: Number of seconds the SCSI layer will wait after a reconnect
|
||||||
|
attempt failed before retrying. Setting this attribute to
|
||||||
|
"off" will disable time-based reconnecting.
|
||||||
|
|
||||||
|
What: /sys/class/srp_remote_ports/port-<h>:<n>/roles
|
||||||
|
Date: June 27, 2007
|
||||||
|
KernelVersion: 2.6.24
|
||||||
|
Contact: linux-scsi@vger.kernel.org
|
||||||
|
Description: Role of the remote port. Either "SRP Initiator" or "SRP Target".
|
||||||
|
|
||||||
|
What: /sys/class/srp_remote_ports/port-<h>:<n>/state
|
||||||
|
Date: February 1, 2014
|
||||||
|
KernelVersion: 3.13
|
||||||
|
Contact: linux-scsi@vger.kernel.org, linux-rdma@vger.kernel.org
|
||||||
|
Description: State of the transport layer used for communication with the
|
||||||
|
remote port. "running" if the transport layer is operational;
|
||||||
|
"blocked" if a transport layer error has been encountered but
|
||||||
|
the fast_io_fail_tmo timer has not yet fired; "fail-fast"
|
||||||
|
after the fast_io_fail_tmo timer has fired and before the
|
||||||
|
"dev_loss_tmo" timer has fired; "lost" after the
|
||||||
|
"dev_loss_tmo" timer has fired and before the port is finally
|
||||||
|
removed.
|
4
Documentation/ABI/stable/thermal-notification
Normal file
4
Documentation/ABI/stable/thermal-notification
Normal file
|
@ -0,0 +1,4 @@
|
||||||
|
What: A notification mechanism for thermal related events
|
||||||
|
Description:
|
||||||
|
This interface enables notification for thermal related events.
|
||||||
|
The notification is in the form of a netlink event.
|
28
Documentation/ABI/stable/vdso
Normal file
28
Documentation/ABI/stable/vdso
Normal file
|
@ -0,0 +1,28 @@
|
||||||
|
On some architectures, when the kernel loads any userspace program it
|
||||||
|
maps an ELF DSO into that program's address space. This DSO is called
|
||||||
|
the vDSO and it often contains useful and highly-optimized alternatives
|
||||||
|
to real syscalls.
|
||||||
|
|
||||||
|
These functions are called just like ordinary C function according to
|
||||||
|
your platform's ABI. Call them from a sensible context. (For example,
|
||||||
|
if you set CS on x86 to something strange, the vDSO functions are
|
||||||
|
within their rights to crash.) In addition, if you pass a bad
|
||||||
|
pointer to a vDSO function, you might get SIGSEGV instead of -EFAULT.
|
||||||
|
|
||||||
|
To find the DSO, parse the auxiliary vector passed to the program's
|
||||||
|
entry point. The AT_SYSINFO_EHDR entry will point to the vDSO.
|
||||||
|
|
||||||
|
The vDSO uses symbol versioning; whenever you request a symbol from the
|
||||||
|
vDSO, specify the version you are expecting.
|
||||||
|
|
||||||
|
Programs that dynamically link to glibc will use the vDSO automatically.
|
||||||
|
Otherwise, you can use the reference parser in
|
||||||
|
tools/testing/selftests/vDSO/parse_vdso.c.
|
||||||
|
|
||||||
|
Unless otherwise noted, the set of symbols with any given version and the
|
||||||
|
ABI of those symbols is considered stable. It may vary across architectures,
|
||||||
|
though.
|
||||||
|
|
||||||
|
(As of this writing, this ABI documentation as been confirmed for x86_64.
|
||||||
|
The maintainers of the other vDSO-using architectures should confirm
|
||||||
|
that it is correct for their architecture.)
|
36
Documentation/ABI/testing/configfs-acpi
Normal file
36
Documentation/ABI/testing/configfs-acpi
Normal file
|
@ -0,0 +1,36 @@
|
||||||
|
What: /config/acpi
|
||||||
|
Date: July 2016
|
||||||
|
KernelVersion: 4.8
|
||||||
|
Contact: linux-acpi@vger.kernel.org
|
||||||
|
Description:
|
||||||
|
This represents the ACPI subsystem entry point directory. It
|
||||||
|
contains sub-groups corresponding to ACPI configurable options.
|
||||||
|
|
||||||
|
What: /config/acpi/table
|
||||||
|
Date: July 2016
|
||||||
|
KernelVersion: 4.8
|
||||||
|
Description:
|
||||||
|
|
||||||
|
This group contains the configuration for user defined ACPI
|
||||||
|
tables. The attributes of a user define table are:
|
||||||
|
|
||||||
|
aml - a binary attribute that the user can use to
|
||||||
|
fill in the ACPI aml definitions. Once the aml
|
||||||
|
data is written to this file and the file is
|
||||||
|
closed the table will be loaded and ACPI devices
|
||||||
|
will be enumerated. To check if the operation is
|
||||||
|
successful the user must check the error code
|
||||||
|
for close(). If the operation is successful,
|
||||||
|
subsequent writes to this attribute will fail.
|
||||||
|
|
||||||
|
The rest of the attributes are read-only and are valid only
|
||||||
|
after the table has been loaded by filling the aml entry:
|
||||||
|
|
||||||
|
signature - ASCII table signature
|
||||||
|
length - length of table in bytes, including the header
|
||||||
|
revision - ACPI Specification minor version number
|
||||||
|
oem_id - ASCII OEM identification
|
||||||
|
oem_table_id - ASCII OEM table identification
|
||||||
|
oem_revision - OEM revision number
|
||||||
|
asl_compiler_id - ASCII ASL compiler vendor ID
|
||||||
|
asl_compiler_revision - ASL compiler version
|
34
Documentation/ABI/testing/configfs-iio
Normal file
34
Documentation/ABI/testing/configfs-iio
Normal file
|
@ -0,0 +1,34 @@
|
||||||
|
What: /config/iio
|
||||||
|
Date: October 2015
|
||||||
|
KernelVersion: 4.4
|
||||||
|
Contact: linux-iio@vger.kernel.org
|
||||||
|
Description:
|
||||||
|
This represents Industrial IO configuration entry point
|
||||||
|
directory. It contains sub-groups corresponding to IIO
|
||||||
|
objects.
|
||||||
|
|
||||||
|
What: /config/iio/triggers
|
||||||
|
Date: October 2015
|
||||||
|
KernelVersion: 4.4
|
||||||
|
Description:
|
||||||
|
Industrial IO software triggers directory.
|
||||||
|
|
||||||
|
What: /config/iio/triggers/hrtimers
|
||||||
|
Date: October 2015
|
||||||
|
KernelVersion: 4.4
|
||||||
|
Description:
|
||||||
|
High resolution timers directory. Creating a directory here
|
||||||
|
will result in creating a hrtimer trigger in the IIO subsystem.
|
||||||
|
|
||||||
|
What: /config/iio/devices
|
||||||
|
Date: April 2016
|
||||||
|
KernelVersion: 4.7
|
||||||
|
Description:
|
||||||
|
Industrial IO software devices directory.
|
||||||
|
|
||||||
|
What: /config/iio/devices/dummy
|
||||||
|
Date: April 2016
|
||||||
|
KernelVersion: 4.7
|
||||||
|
Description:
|
||||||
|
Dummy IIO devices directory. Creating a directory here will result
|
||||||
|
in creating a dummy IIO device in the IIO subystem.
|
30
Documentation/ABI/testing/configfs-rdma_cm
Normal file
30
Documentation/ABI/testing/configfs-rdma_cm
Normal file
|
@ -0,0 +1,30 @@
|
||||||
|
What: /config/rdma_cm
|
||||||
|
Date: November 29, 2015
|
||||||
|
KernelVersion: 4.4.0
|
||||||
|
Description: Interface is used to configure RDMA-cable HCAs in respect to
|
||||||
|
RDMA-CM attributes.
|
||||||
|
|
||||||
|
Attributes are visible only when configfs is mounted. To mount
|
||||||
|
configfs in /config directory use:
|
||||||
|
# mount -t configfs none /config/
|
||||||
|
|
||||||
|
In order to set parameters related to a specific HCA, a directory
|
||||||
|
for this HCA has to be created:
|
||||||
|
mkdir -p /config/rdma_cm/<hca>
|
||||||
|
|
||||||
|
|
||||||
|
What: /config/rdma_cm/<hca>/ports/<port-num>/default_roce_mode
|
||||||
|
Date: November 29, 2015
|
||||||
|
KernelVersion: 4.4.0
|
||||||
|
Description: RDMA-CM based connections from HCA <hca> at port <port-num>
|
||||||
|
will be initiated with this RoCE type as default.
|
||||||
|
The possible RoCE types are either "IB/RoCE v1" or "RoCE v2".
|
||||||
|
This parameter has RW access.
|
||||||
|
|
||||||
|
What: /config/rdma_cm/<hca>/ports/<port-num>/default_roce_tos
|
||||||
|
Date: February 7, 2017
|
||||||
|
KernelVersion: 4.11.0
|
||||||
|
Description: RDMA-CM QPs from HCA <hca> at port <port-num>
|
||||||
|
will be created with this TOS as default.
|
||||||
|
This can be overridden by using the rdma_set_option API.
|
||||||
|
The possible RoCE TOS values are 0-255.
|
31
Documentation/ABI/testing/configfs-spear-pcie-gadget
Normal file
31
Documentation/ABI/testing/configfs-spear-pcie-gadget
Normal file
|
@ -0,0 +1,31 @@
|
||||||
|
What: /config/pcie-gadget
|
||||||
|
Date: Feb 2011
|
||||||
|
KernelVersion: 2.6.37
|
||||||
|
Contact: Pratyush Anand <pratyush.anand@gmail.com>
|
||||||
|
Description:
|
||||||
|
|
||||||
|
Interface is used to configure selected dual mode PCIe controller
|
||||||
|
as device and then program its various registers to configure it
|
||||||
|
as a particular device type.
|
||||||
|
This interfaces can be used to show spear's PCIe device capability.
|
||||||
|
|
||||||
|
Nodes are only visible when configfs is mounted. To mount configfs
|
||||||
|
in /config directory use:
|
||||||
|
# mount -t configfs none /config/
|
||||||
|
|
||||||
|
For nth PCIe Device Controller
|
||||||
|
/config/pcie-gadget.n/
|
||||||
|
link ... used to enable ltssm and read its status.
|
||||||
|
int_type ...used to configure and read type of supported
|
||||||
|
interrupt
|
||||||
|
no_of_msi ... used to configure number of MSI vector needed and
|
||||||
|
to read no of MSI granted.
|
||||||
|
inta ... write 1 to assert INTA and 0 to de-assert.
|
||||||
|
send_msi ... write MSI vector to be sent.
|
||||||
|
vendor_id ... used to write and read vendor id (hex)
|
||||||
|
device_id ... used to write and read device id (hex)
|
||||||
|
bar0_size ... used to write and read bar0_size
|
||||||
|
bar0_address ... used to write and read bar0 mapped area in hex.
|
||||||
|
bar0_rw_offset ... used to write and read offset of bar0 where
|
||||||
|
bar0_data will be written or read.
|
||||||
|
bar0_data ... used to write and read data at bar0_rw_offset.
|
48
Documentation/ABI/testing/configfs-stp-policy
Normal file
48
Documentation/ABI/testing/configfs-stp-policy
Normal file
|
@ -0,0 +1,48 @@
|
||||||
|
What: /config/stp-policy
|
||||||
|
Date: June 2015
|
||||||
|
KernelVersion: 4.3
|
||||||
|
Description:
|
||||||
|
This group contains policies mandating Master/Channel allocation
|
||||||
|
for software sources wishing to send trace data over an STM
|
||||||
|
device.
|
||||||
|
|
||||||
|
What: /config/stp-policy/<device>.<policy>
|
||||||
|
Date: June 2015
|
||||||
|
KernelVersion: 4.3
|
||||||
|
Description:
|
||||||
|
This group is the root of a policy; its name is a concatenation
|
||||||
|
of an stm device name to which this policy applies and an
|
||||||
|
arbitrary string. If <device> part doesn't match an existing
|
||||||
|
stm device, mkdir will fail with ENODEV; if that device already
|
||||||
|
has a policy assigned to it, mkdir will fail with EBUSY.
|
||||||
|
|
||||||
|
What: /config/stp-policy/<device>.<policy>/device
|
||||||
|
Date: June 2015
|
||||||
|
KernelVersion: 4.3
|
||||||
|
Description:
|
||||||
|
STM device to which this policy applies, read only. Same as the
|
||||||
|
<device> component of its parent directory.
|
||||||
|
|
||||||
|
What: /config/stp-policy/<device>.<policy>/<node>
|
||||||
|
Date: June 2015
|
||||||
|
KernelVersion: 4.3
|
||||||
|
Description:
|
||||||
|
Policy node is a string identifier that software clients will
|
||||||
|
use to request a master/channel to be allocated and assigned to
|
||||||
|
them.
|
||||||
|
|
||||||
|
What: /config/stp-policy/<device>.<policy>/<node>/masters
|
||||||
|
Date: June 2015
|
||||||
|
KernelVersion: 4.3
|
||||||
|
Description:
|
||||||
|
Range of masters from which to allocate for users of this node.
|
||||||
|
Write two numbers: the first master and the last master number.
|
||||||
|
|
||||||
|
What: /config/stp-policy/<device>.<policy>/<node>/channels
|
||||||
|
Date: June 2015
|
||||||
|
KernelVersion: 4.3
|
||||||
|
Description:
|
||||||
|
Range of channels from which to allocate for users of this node.
|
||||||
|
Write two numbers: the first channel and the last channel
|
||||||
|
number.
|
||||||
|
|
126
Documentation/ABI/testing/configfs-usb-gadget
Normal file
126
Documentation/ABI/testing/configfs-usb-gadget
Normal file
|
@ -0,0 +1,126 @@
|
||||||
|
What: /config/usb-gadget
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
This group contains sub-groups corresponding to created
|
||||||
|
USB gadgets.
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
|
||||||
|
The attributes of a gadget:
|
||||||
|
|
||||||
|
UDC - bind a gadget to UDC/unbind a gadget;
|
||||||
|
write UDC's name found in /sys/class/udc/*
|
||||||
|
to bind a gadget, empty string "" to unbind.
|
||||||
|
|
||||||
|
bDeviceClass - USB device class code
|
||||||
|
bDeviceSubClass - USB device subclass code
|
||||||
|
bDeviceProtocol - USB device protocol code
|
||||||
|
bMaxPacketSize0 - maximum endpoint 0 packet size
|
||||||
|
bcdDevice - bcd device release number
|
||||||
|
bcdUSB - bcd USB specification version number
|
||||||
|
idProduct - product ID
|
||||||
|
idVendor - vendor ID
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/configs
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
This group contains a USB gadget's configurations
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/configs/config
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
The attributes of a configuration:
|
||||||
|
|
||||||
|
bmAttributes - configuration characteristics
|
||||||
|
MaxPower - maximum power consumption from the bus
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/configs/config/strings
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
This group contains subdirectories for language-specific
|
||||||
|
strings for this configuration.
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/configs/config/strings/language
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
configuration - configuration description
|
||||||
|
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
This group contains functions available to this USB gadget.
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/<func>.<inst>/interface.<n>
|
||||||
|
Date: May 2014
|
||||||
|
KernelVersion: 3.16
|
||||||
|
Description:
|
||||||
|
This group contains "Feature Descriptors" specific for one
|
||||||
|
gadget's USB interface or one interface group described
|
||||||
|
by an IAD.
|
||||||
|
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
compatible_id - 8-byte string for "Compatible ID"
|
||||||
|
sub_compatible_id - 8-byte string for "Sub Compatible ID"
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/<func>.<inst>/interface.<n>/<property>
|
||||||
|
Date: May 2014
|
||||||
|
KernelVersion: 3.16
|
||||||
|
Description:
|
||||||
|
This group contains "Extended Property Descriptors" specific for one
|
||||||
|
gadget's USB interface or one interface group described
|
||||||
|
by an IAD.
|
||||||
|
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
type - value 1..7 for interpreting the data
|
||||||
|
1: unicode string
|
||||||
|
2: unicode string with environment variable
|
||||||
|
3: binary
|
||||||
|
4: little-endian 32-bit
|
||||||
|
5: big-endian 32-bit
|
||||||
|
6: unicode string with a symbolic link
|
||||||
|
7: multiple unicode strings
|
||||||
|
data - blob of data to be interpreted depending on
|
||||||
|
type
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/strings
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
This group contains subdirectories for language-specific
|
||||||
|
strings for this gadget.
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/strings/language
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
serialnumber - gadget's serial number (string)
|
||||||
|
product - gadget's product description
|
||||||
|
manufacturer - gadget's manufacturer description
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/os_desc
|
||||||
|
Date: May 2014
|
||||||
|
KernelVersion: 3.16
|
||||||
|
Description:
|
||||||
|
This group contains "OS String" extension handling attributes.
|
||||||
|
|
||||||
|
use - flag turning "OS Desctiptors" support on/off
|
||||||
|
b_vendor_code - one-byte value used for custom per-device and
|
||||||
|
per-interface requests
|
||||||
|
qw_sign - an identifier to be reported as "OS String"
|
||||||
|
proper
|
8
Documentation/ABI/testing/configfs-usb-gadget-acm
Normal file
8
Documentation/ABI/testing/configfs-usb-gadget-acm
Normal file
|
@ -0,0 +1,8 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/acm.name
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
|
||||||
|
This item contains just one readonly attribute: port_num.
|
||||||
|
It contains the port number of the /dev/ttyGS<n> device
|
||||||
|
associated with acm function's instance "name".
|
16
Documentation/ABI/testing/configfs-usb-gadget-ecm
Normal file
16
Documentation/ABI/testing/configfs-usb-gadget-ecm
Normal file
|
@ -0,0 +1,16 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/ecm.name
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
ifname - network device interface name associated with
|
||||||
|
this function instance
|
||||||
|
qmult - queue length multiplier for high and
|
||||||
|
super speed
|
||||||
|
host_addr - MAC address of host's end of this
|
||||||
|
Ethernet over USB link
|
||||||
|
dev_addr - MAC address of device's end of this
|
||||||
|
Ethernet over USB link
|
||||||
|
|
||||||
|
|
14
Documentation/ABI/testing/configfs-usb-gadget-eem
Normal file
14
Documentation/ABI/testing/configfs-usb-gadget-eem
Normal file
|
@ -0,0 +1,14 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/eem.name
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
ifname - network device interface name associated with
|
||||||
|
this function instance
|
||||||
|
qmult - queue length multiplier for high and
|
||||||
|
super speed
|
||||||
|
host_addr - MAC address of host's end of this
|
||||||
|
Ethernet over USB link
|
||||||
|
dev_addr - MAC address of device's end of this
|
||||||
|
Ethernet over USB link
|
9
Documentation/ABI/testing/configfs-usb-gadget-ffs
Normal file
9
Documentation/ABI/testing/configfs-usb-gadget-ffs
Normal file
|
@ -0,0 +1,9 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/ffs.name
|
||||||
|
Date: Nov 2013
|
||||||
|
KernelVersion: 3.13
|
||||||
|
Description: The purpose of this directory is to create and remove it.
|
||||||
|
|
||||||
|
A corresponding USB function instance is created/removed.
|
||||||
|
There are no attributes here.
|
||||||
|
|
||||||
|
All parameters are set through FunctionFS.
|
11
Documentation/ABI/testing/configfs-usb-gadget-hid
Normal file
11
Documentation/ABI/testing/configfs-usb-gadget-hid
Normal file
|
@ -0,0 +1,11 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/hid.name
|
||||||
|
Date: Nov 2014
|
||||||
|
KernelVersion: 3.19
|
||||||
|
Description:
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
protocol - HID protocol to use
|
||||||
|
report_desc - blob corresponding to HID report descriptors
|
||||||
|
except the data passed through /dev/hidg<N>
|
||||||
|
report_length - HID report length
|
||||||
|
subclass - HID device subclass to use
|
8
Documentation/ABI/testing/configfs-usb-gadget-loopback
Normal file
8
Documentation/ABI/testing/configfs-usb-gadget-loopback
Normal file
|
@ -0,0 +1,8 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/Loopback.name
|
||||||
|
Date: Nov 2013
|
||||||
|
KernelVersion: 3.13
|
||||||
|
Description:
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
qlen - depth of loopback queue
|
||||||
|
buflen - buffer length
|
31
Documentation/ABI/testing/configfs-usb-gadget-mass-storage
Normal file
31
Documentation/ABI/testing/configfs-usb-gadget-mass-storage
Normal file
|
@ -0,0 +1,31 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/mass_storage.name
|
||||||
|
Date: Oct 2013
|
||||||
|
KernelVersion: 3.13
|
||||||
|
Description:
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
stall - Set to permit function to halt bulk endpoints.
|
||||||
|
Disabled on some USB devices known not to work
|
||||||
|
correctly. You should set it to true.
|
||||||
|
num_buffers - Number of pipeline buffers. Valid numbers
|
||||||
|
are 2..4. Available only if
|
||||||
|
CONFIG_USB_GADGET_DEBUG_FILES is set.
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/mass_storage.name/lun.name
|
||||||
|
Date: Oct 2013
|
||||||
|
KernelVersion: 3.13
|
||||||
|
Description:
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
file - The path to the backing file for the LUN.
|
||||||
|
Required if LUN is not marked as removable.
|
||||||
|
ro - Flag specifying access to the LUN shall be
|
||||||
|
read-only. This is implied if CD-ROM emulation
|
||||||
|
is enabled as well as when it was impossible
|
||||||
|
to open "filename" in R/W mode.
|
||||||
|
removable - Flag specifying that LUN shall be indicated as
|
||||||
|
being removable.
|
||||||
|
cdrom - Flag specifying that LUN shall be reported as
|
||||||
|
being a CD-ROM.
|
||||||
|
nofua - Flag specifying that FUA flag
|
||||||
|
in SCSI WRITE(10,12)
|
12
Documentation/ABI/testing/configfs-usb-gadget-midi
Normal file
12
Documentation/ABI/testing/configfs-usb-gadget-midi
Normal file
|
@ -0,0 +1,12 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/midi.name
|
||||||
|
Date: Nov 2014
|
||||||
|
KernelVersion: 3.19
|
||||||
|
Description:
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
index - index value for the USB MIDI adapter
|
||||||
|
id - ID string for the USB MIDI adapter
|
||||||
|
buflen - MIDI buffer length
|
||||||
|
qlen - USB read request queue length
|
||||||
|
in_ports - number of MIDI input ports
|
||||||
|
out_ports - number of MIDI output ports
|
15
Documentation/ABI/testing/configfs-usb-gadget-ncm
Normal file
15
Documentation/ABI/testing/configfs-usb-gadget-ncm
Normal file
|
@ -0,0 +1,15 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/ncm.name
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
ifname - network device interface name associated with
|
||||||
|
this function instance
|
||||||
|
qmult - queue length multiplier for high and
|
||||||
|
super speed
|
||||||
|
host_addr - MAC address of host's end of this
|
||||||
|
Ethernet over USB link
|
||||||
|
dev_addr - MAC address of device's end of this
|
||||||
|
Ethernet over USB link
|
||||||
|
|
9
Documentation/ABI/testing/configfs-usb-gadget-obex
Normal file
9
Documentation/ABI/testing/configfs-usb-gadget-obex
Normal file
|
@ -0,0 +1,9 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/obex.name
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
|
||||||
|
This item contains just one readonly attribute: port_num.
|
||||||
|
It contains the port number of the /dev/ttyGS<n> device
|
||||||
|
associated with obex function's instance "name".
|
||||||
|
|
8
Documentation/ABI/testing/configfs-usb-gadget-phonet
Normal file
8
Documentation/ABI/testing/configfs-usb-gadget-phonet
Normal file
|
@ -0,0 +1,8 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/phonet.name
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
|
||||||
|
This item contains just one readonly attribute: ifname.
|
||||||
|
It contains the network interface name assigned during
|
||||||
|
network device registration.
|
9
Documentation/ABI/testing/configfs-usb-gadget-printer
Normal file
9
Documentation/ABI/testing/configfs-usb-gadget-printer
Normal file
|
@ -0,0 +1,9 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/printer.name
|
||||||
|
Date: Apr 2015
|
||||||
|
KernelVersion: 4.1
|
||||||
|
Description:
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
pnp_string - Data to be passed to the host in pnp string
|
||||||
|
q_len - Number of requests per endpoint
|
||||||
|
|
14
Documentation/ABI/testing/configfs-usb-gadget-rndis
Normal file
14
Documentation/ABI/testing/configfs-usb-gadget-rndis
Normal file
|
@ -0,0 +1,14 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/rndis.name
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
ifname - network device interface name associated with
|
||||||
|
this function instance
|
||||||
|
qmult - queue length multiplier for high and
|
||||||
|
super speed
|
||||||
|
host_addr - MAC address of host's end of this
|
||||||
|
Ethernet over USB link
|
||||||
|
dev_addr - MAC address of device's end of this
|
||||||
|
Ethernet over USB link
|
9
Documentation/ABI/testing/configfs-usb-gadget-serial
Normal file
9
Documentation/ABI/testing/configfs-usb-gadget-serial
Normal file
|
@ -0,0 +1,9 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/gser.name
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
|
||||||
|
This item contains just one readonly attribute: port_num.
|
||||||
|
It contains the port number of the /dev/ttyGS<n> device
|
||||||
|
associated with gser function's instance "name".
|
||||||
|
|
14
Documentation/ABI/testing/configfs-usb-gadget-sourcesink
Normal file
14
Documentation/ABI/testing/configfs-usb-gadget-sourcesink
Normal file
|
@ -0,0 +1,14 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/SourceSink.name
|
||||||
|
Date: Nov 2013
|
||||||
|
KernelVersion: 3.13
|
||||||
|
Description:
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
pattern - 0 (all zeros), 1 (mod63), 2 (none)
|
||||||
|
isoc_interval - 1..16
|
||||||
|
isoc_maxpacket - 0 - 1023 (fs), 0 - 1024 (hs/ss)
|
||||||
|
isoc_mult - 0..2 (hs/ss only)
|
||||||
|
isoc_maxburst - 0..15 (ss only)
|
||||||
|
buflen - buffer length
|
||||||
|
bulk_qlen - depth of queue for bulk
|
||||||
|
iso_qlen - depth of queue for iso
|
14
Documentation/ABI/testing/configfs-usb-gadget-subset
Normal file
14
Documentation/ABI/testing/configfs-usb-gadget-subset
Normal file
|
@ -0,0 +1,14 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/geth.name
|
||||||
|
Date: Jun 2013
|
||||||
|
KernelVersion: 3.11
|
||||||
|
Description:
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
ifname - network device interface name associated with
|
||||||
|
this function instance
|
||||||
|
qmult - queue length multiplier for high and
|
||||||
|
super speed
|
||||||
|
host_addr - MAC address of host's end of this
|
||||||
|
Ethernet over USB link
|
||||||
|
dev_addr - MAC address of device's end of this
|
||||||
|
Ethernet over USB link
|
6
Documentation/ABI/testing/configfs-usb-gadget-tcm
Normal file
6
Documentation/ABI/testing/configfs-usb-gadget-tcm
Normal file
|
@ -0,0 +1,6 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/tcm.name
|
||||||
|
Date: Dec 2015
|
||||||
|
KernelVersion: 4.5
|
||||||
|
Description:
|
||||||
|
There are no attributes because all the configuration
|
||||||
|
is performed in the "target" subsystem of configfs.
|
12
Documentation/ABI/testing/configfs-usb-gadget-uac1
Normal file
12
Documentation/ABI/testing/configfs-usb-gadget-uac1
Normal file
|
@ -0,0 +1,12 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/uac1.name
|
||||||
|
Date: Sep 2014
|
||||||
|
KernelVersion: 3.18
|
||||||
|
Description:
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
audio_buf_size - audio buffer size
|
||||||
|
fn_cap - capture pcm device file name
|
||||||
|
fn_cntl - control device file name
|
||||||
|
fn_play - playback pcm device file name
|
||||||
|
req_buf_size - ISO OUT endpoint request buffer size
|
||||||
|
req_count - ISO OUT endpoint request count
|
12
Documentation/ABI/testing/configfs-usb-gadget-uac2
Normal file
12
Documentation/ABI/testing/configfs-usb-gadget-uac2
Normal file
|
@ -0,0 +1,12 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/uac2.name
|
||||||
|
Date: Sep 2014
|
||||||
|
KernelVersion: 3.18
|
||||||
|
Description:
|
||||||
|
The attributes:
|
||||||
|
|
||||||
|
c_chmask - capture channel mask
|
||||||
|
c_srate - capture sampling rate
|
||||||
|
c_ssize - capture sample size (bytes)
|
||||||
|
p_chmask - playback channel mask
|
||||||
|
p_srate - playback sampling rate
|
||||||
|
p_ssize - playback sample size (bytes)
|
265
Documentation/ABI/testing/configfs-usb-gadget-uvc
Normal file
265
Documentation/ABI/testing/configfs-usb-gadget-uvc
Normal file
|
@ -0,0 +1,265 @@
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: UVC function directory
|
||||||
|
|
||||||
|
streaming_maxburst - 0..15 (ss only)
|
||||||
|
streaming_maxpacket - 1..1023 (fs), 1..3072 (hs/ss)
|
||||||
|
streaming_interval - 1..16
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/control
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Control descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/control/class
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Class descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/control/class/ss
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Super speed control class descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/control/class/fs
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Full speed control class descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/control/terminal
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Terminal descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/control/terminal/output
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Output terminal descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/control/terminal/output/default
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Default output terminal descriptors
|
||||||
|
|
||||||
|
All attributes read only:
|
||||||
|
iTerminal - index of string descriptor
|
||||||
|
bSourceID - id of the terminal to which this terminal
|
||||||
|
is connected
|
||||||
|
bAssocTerminal - id of the input terminal to which this output
|
||||||
|
terminal is associated
|
||||||
|
wTerminalType - terminal type
|
||||||
|
bTerminalID - a non-zero id of this terminal
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/control/terminal/camera
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Camera terminal descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/control/terminal/camera/default
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Default camera terminal descriptors
|
||||||
|
|
||||||
|
All attributes read only:
|
||||||
|
bmControls - bitmap specifying which controls are
|
||||||
|
supported for the video stream
|
||||||
|
wOcularFocalLength - the value of Locular
|
||||||
|
wObjectiveFocalLengthMax- the value of Lmin
|
||||||
|
wObjectiveFocalLengthMin- the value of Lmax
|
||||||
|
iTerminal - index of string descriptor
|
||||||
|
bAssocTerminal - id of the output terminal to which
|
||||||
|
this terminal is connected
|
||||||
|
wTerminalType - terminal type
|
||||||
|
bTerminalID - a non-zero id of this terminal
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/control/processing
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Processing unit descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/control/processing/default
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Default processing unit descriptors
|
||||||
|
|
||||||
|
All attributes read only:
|
||||||
|
iProcessing - index of string descriptor
|
||||||
|
bmControls - bitmap specifying which controls are
|
||||||
|
supported for the video stream
|
||||||
|
wMaxMultiplier - maximum digital magnification x100
|
||||||
|
bSourceID - id of the terminal to which this unit is
|
||||||
|
connected
|
||||||
|
bUnitID - a non-zero id of this unit
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/control/header
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Control header descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/control/header/name
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Specific control header descriptors
|
||||||
|
|
||||||
|
dwClockFrequency
|
||||||
|
bcdUVC
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/streaming
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Streaming descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/class
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Streaming class descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/class/ss
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Super speed streaming class descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/class/hs
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: High speed streaming class descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/class/fs
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Full speed streaming class descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/color_matching
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Color matching descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/color_matching/default
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Default color matching descriptors
|
||||||
|
|
||||||
|
All attributes read only:
|
||||||
|
bMatrixCoefficients - matrix used to compute luma and
|
||||||
|
chroma values from the color primaries
|
||||||
|
bTransferCharacteristics- optoelectronic transfer
|
||||||
|
characteristic of the source picutre,
|
||||||
|
also called the gamma function
|
||||||
|
bColorPrimaries - color primaries and the reference
|
||||||
|
white
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/mjpeg
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: MJPEG format descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/mjpeg/name
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Specific MJPEG format descriptors
|
||||||
|
|
||||||
|
All attributes read only,
|
||||||
|
except bmaControls and bDefaultFrameIndex:
|
||||||
|
bmaControls - this format's data for bmaControls in
|
||||||
|
the streaming header
|
||||||
|
bmInterfaceFlags - specifies interlace information,
|
||||||
|
read-only
|
||||||
|
bAspectRatioY - the X dimension of the picture aspect
|
||||||
|
ratio, read-only
|
||||||
|
bAspectRatioX - the Y dimension of the picture aspect
|
||||||
|
ratio, read-only
|
||||||
|
bmFlags - characteristics of this format,
|
||||||
|
read-only
|
||||||
|
bDefaultFrameIndex - optimum frame index for this stream
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/mjpeg/name/name
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Specific MJPEG frame descriptors
|
||||||
|
|
||||||
|
dwFrameInterval - indicates how frame interval can be
|
||||||
|
programmed; a number of values
|
||||||
|
separated by newline can be specified
|
||||||
|
dwDefaultFrameInterval - the frame interval the device would
|
||||||
|
like to use as default
|
||||||
|
dwMaxVideoFrameBufferSize- the maximum number of bytes the
|
||||||
|
compressor will produce for a video
|
||||||
|
frame or still image
|
||||||
|
dwMaxBitRate - the maximum bit rate at the shortest
|
||||||
|
frame interval in bps
|
||||||
|
dwMinBitRate - the minimum bit rate at the longest
|
||||||
|
frame interval in bps
|
||||||
|
wHeight - height of decoded bitmap frame in px
|
||||||
|
wWidth - width of decoded bitmam frame in px
|
||||||
|
bmCapabilities - still image support, fixed frame-rate
|
||||||
|
support
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/uncompressed
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Uncompressed format descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/uncompressed/name
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Specific uncompressed format descriptors
|
||||||
|
|
||||||
|
bmaControls - this format's data for bmaControls in
|
||||||
|
the streaming header
|
||||||
|
bmInterfaceFlags - specifies interlace information,
|
||||||
|
read-only
|
||||||
|
bAspectRatioY - the X dimension of the picture aspect
|
||||||
|
ratio, read-only
|
||||||
|
bAspectRatioX - the Y dimension of the picture aspect
|
||||||
|
ratio, read-only
|
||||||
|
bDefaultFrameIndex - optimum frame index for this stream
|
||||||
|
bBitsPerPixel - number of bits per pixel used to
|
||||||
|
specify color in the decoded video
|
||||||
|
frame
|
||||||
|
guidFormat - globally unique id used to identify
|
||||||
|
stream-encoding format
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/uncompressed/name/name
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Specific uncompressed frame descriptors
|
||||||
|
|
||||||
|
dwFrameInterval - indicates how frame interval can be
|
||||||
|
programmed; a number of values
|
||||||
|
separated by newline can be specified
|
||||||
|
dwDefaultFrameInterval - the frame interval the device would
|
||||||
|
like to use as default
|
||||||
|
dwMaxVideoFrameBufferSize- the maximum number of bytes the
|
||||||
|
compressor will produce for a video
|
||||||
|
frame or still image
|
||||||
|
dwMaxBitRate - the maximum bit rate at the shortest
|
||||||
|
frame interval in bps
|
||||||
|
dwMinBitRate - the minimum bit rate at the longest
|
||||||
|
frame interval in bps
|
||||||
|
wHeight - height of decoded bitmap frame in px
|
||||||
|
wWidth - width of decoded bitmam frame in px
|
||||||
|
bmCapabilities - still image support, fixed frame-rate
|
||||||
|
support
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/header
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Streaming header descriptors
|
||||||
|
|
||||||
|
What: /config/usb-gadget/gadget/functions/uvc.name/streaming/header/name
|
||||||
|
Date: Dec 2014
|
||||||
|
KernelVersion: 4.0
|
||||||
|
Description: Specific streaming header descriptors
|
||||||
|
|
||||||
|
All attributes read only:
|
||||||
|
bTriggerUsage - how the host software will respond to
|
||||||
|
a hardware trigger interrupt event
|
||||||
|
bTriggerSupport - flag specifying if hardware
|
||||||
|
triggering is supported
|
||||||
|
bStillCaptureMethod - method of still image caputre
|
||||||
|
supported
|
||||||
|
bTerminalLink - id of the output terminal to which
|
||||||
|
the video endpoint of this interface
|
||||||
|
is connected
|
||||||
|
bmInfo - capabilities of this video streaming
|
||||||
|
interface
|
91
Documentation/ABI/testing/debugfs-driver-genwqe
Normal file
91
Documentation/ABI/testing/debugfs-driver-genwqe
Normal file
|
@ -0,0 +1,91 @@
|
||||||
|
What: /sys/kernel/debug/genwqe/genwqe<n>_card/ddcb_info
|
||||||
|
Date: Oct 2013
|
||||||
|
Contact: haver@linux.vnet.ibm.com
|
||||||
|
Description: DDCB queue dump used for debugging queueing problems.
|
||||||
|
|
||||||
|
What: /sys/kernel/debug/genwqe/genwqe<n>_card/curr_regs
|
||||||
|
Date: Oct 2013
|
||||||
|
Contact: haver@linux.vnet.ibm.com
|
||||||
|
Description: Dump of the current error registers.
|
||||||
|
Only available for PF.
|
||||||
|
|
||||||
|
What: /sys/kernel/debug/genwqe/genwqe<n>_card/curr_dbg_uid0
|
||||||
|
Date: Oct 2013
|
||||||
|
Contact: haver@linux.vnet.ibm.com
|
||||||
|
Description: Internal chip state of UID0 (unit id 0).
|
||||||
|
Only available for PF.
|
||||||
|
|
||||||
|
What: /sys/kernel/debug/genwqe/genwqe<n>_card/curr_dbg_uid1
|
||||||
|
Date: Oct 2013
|
||||||
|
Contact: haver@linux.vnet.ibm.com
|
||||||
|
Description: Internal chip state of UID1.
|
||||||
|
Only available for PF.
|
||||||
|
|
||||||
|
What: /sys/kernel/debug/genwqe/genwqe<n>_card/curr_dbg_uid2
|
||||||
|
Date: Oct 2013
|
||||||
|
Contact: haver@linux.vnet.ibm.com
|
||||||
|
Description: Internal chip state of UID2.
|
||||||
|
Only available for PF.
|
||||||
|
|
||||||
|
What: /sys/kernel/debug/genwqe/genwqe<n>_card/prev_regs
|
||||||
|
Date: Oct 2013
|
||||||
|
Contact: haver@linux.vnet.ibm.com
|
||||||
|
Description: Dump of the error registers before the last reset of
|
||||||
|
the card occured.
|
||||||
|
Only available for PF.
|
||||||
|
|
||||||
|
What: /sys/kernel/debug/genwqe/genwqe<n>_card/prev_dbg_uid0
|
||||||
|
Date: Oct 2013
|
||||||
|
Contact: haver@linux.vnet.ibm.com
|
||||||
|
Description: Internal chip state of UID0 before card was reset.
|
||||||
|
Only available for PF.
|
||||||
|
|
||||||
|
What: /sys/kernel/debug/genwqe/genwqe<n>_card/prev_dbg_uid1
|
||||||
|
Date: Oct 2013
|
||||||
|
Contact: haver@linux.vnet.ibm.com
|
||||||
|
Description: Internal chip state of UID1 before card was reset.
|
||||||
|
Only available for PF.
|
||||||
|
|
||||||
|
What: /sys/kernel/debug/genwqe/genwqe<n>_card/prev_dbg_uid2
|
||||||
|
Date: Oct 2013
|
||||||
|
Contact: haver@linux.vnet.ibm.com
|
||||||
|
Description: Internal chip state of UID2 before card was reset.
|
||||||
|
Only available for PF.
|
||||||
|
|
||||||
|
What: /sys/kernel/debug/genwqe/genwqe<n>_card/info
|
||||||
|
Date: Oct 2013
|
||||||
|
Contact: haver@linux.vnet.ibm.com
|
||||||
|
Description: Comprehensive summary of bitstream version and software
|
||||||
|
version. Used bitstream and bitstream clocking information.
|
||||||
|
|
||||||
|
What: /sys/kernel/debug/genwqe/genwqe<n>_card/err_inject
|
||||||
|
Date: Oct 2013
|
||||||
|
Contact: haver@linux.vnet.ibm.com
|
||||||
|
Description: Possibility to inject error cases to ensure that the drivers
|
||||||
|
error handling code works well.
|
||||||
|
|
||||||
|
What: /sys/kernel/debug/genwqe/genwqe<n>_card/vf<0..14>_jobtimeout_msec
|
||||||
|
Date: Oct 2013
|
||||||
|
Contact: haver@linux.vnet.ibm.com
|
||||||
|
Description: Default VF timeout 250ms. Testing might require 1000ms.
|
||||||
|
Using 0 will use the cards default value (whatever that is).
|
||||||
|
|
||||||
|
The timeout depends on the max number of available cards
|
||||||
|
in the system and the maximum allowed queue size.
|
||||||
|
|
||||||
|
The driver ensures that the settings are done just before
|
||||||
|
the VFs get enabled. Changing the timeouts in flight is not
|
||||||
|
possible.
|
||||||
|
Only available for PF.
|
||||||
|
|
||||||
|
What: /sys/kernel/debug/genwqe/genwqe<n>_card/jobtimer
|
||||||
|
Date: Oct 2013
|
||||||
|
Contact: haver@linux.vnet.ibm.com
|
||||||
|
Description: Dump job timeout register values for PF and VFs.
|
||||||
|
Only available for PF.
|
||||||
|
|
||||||
|
What: /sys/kernel/debug/genwqe/genwqe<n>_card/queue_working_time
|
||||||
|
Date: Dec 2013
|
||||||
|
Contact: haver@linux.vnet.ibm.com
|
||||||
|
Description: Dump queue working time register values for PF and VFs.
|
||||||
|
Only available for PF.
|
20
Documentation/ABI/testing/debugfs-ec
Normal file
20
Documentation/ABI/testing/debugfs-ec
Normal file
|
@ -0,0 +1,20 @@
|
||||||
|
What: /sys/kernel/debug/ec/*/{gpe,use_global_lock,io}
|
||||||
|
Date: July 2010
|
||||||
|
Contact: Thomas Renninger <trenn@suse.de>
|
||||||
|
Description:
|
||||||
|
|
||||||
|
General information like which GPE is assigned to the EC and whether
|
||||||
|
the global lock should get used.
|
||||||
|
Knowing the EC GPE one can watch the amount of HW events related to
|
||||||
|
the EC here (XY -> GPE number from /sys/kernel/debug/ec/*/gpe):
|
||||||
|
/sys/firmware/acpi/interrupts/gpeXY
|
||||||
|
|
||||||
|
The io file is binary and a userspace tool located here:
|
||||||
|
ftp://ftp.suse.com/pub/people/trenn/sources/ec/
|
||||||
|
should get used to read out the 256 Embedded Controller registers
|
||||||
|
or writing to them.
|
||||||
|
|
||||||
|
CAUTION: Do not write to the Embedded Controller if you don't know
|
||||||
|
what you are doing! Rebooting afterwards also is a good idea.
|
||||||
|
This can influence the way your machine is cooled and fans may
|
||||||
|
not get switched on again after you did a wrong write.
|
19
Documentation/ABI/testing/debugfs-ideapad
Normal file
19
Documentation/ABI/testing/debugfs-ideapad
Normal file
|
@ -0,0 +1,19 @@
|
||||||
|
What: /sys/kernel/debug/ideapad/cfg
|
||||||
|
Date: Sep 2011
|
||||||
|
KernelVersion: 3.2
|
||||||
|
Contact: Ike Panhc <ike.pan@canonical.com>
|
||||||
|
Description:
|
||||||
|
|
||||||
|
cfg shows the return value of _CFG method in VPC2004 device. It tells machine
|
||||||
|
capability and what graphic component within the machine.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/kernel/debug/ideapad/status
|
||||||
|
Date: Sep 2011
|
||||||
|
KernelVersion: 3.2
|
||||||
|
Contact: Ike Panhc <ike.pan@canonical.com>
|
||||||
|
Description:
|
||||||
|
|
||||||
|
status shows infos we can read and tells its meaning and value.
|
||||||
|
|
||||||
|
|
16
Documentation/ABI/testing/debugfs-olpc
Normal file
16
Documentation/ABI/testing/debugfs-olpc
Normal file
|
@ -0,0 +1,16 @@
|
||||||
|
What: /sys/kernel/debug/olpc-ec/cmd
|
||||||
|
Date: Dec 2011
|
||||||
|
KernelVersion: 3.4
|
||||||
|
Contact: devel@lists.laptop.org
|
||||||
|
Description:
|
||||||
|
|
||||||
|
A generic interface for executing OLPC Embedded Controller commands and
|
||||||
|
reading their responses.
|
||||||
|
|
||||||
|
To execute a command, write data with the format: CC:N A A A A
|
||||||
|
CC is the (hex) command, N is the count of expected reply bytes, and A A A A
|
||||||
|
are optional (hex) arguments.
|
||||||
|
|
||||||
|
To read the response (if any), read from the generic node after executing
|
||||||
|
a command. Hex reply bytes will be returned, *whether or not* they came from
|
||||||
|
the immediately previous command.
|
45
Documentation/ABI/testing/debugfs-pfo-nx-crypto
Normal file
45
Documentation/ABI/testing/debugfs-pfo-nx-crypto
Normal file
|
@ -0,0 +1,45 @@
|
||||||
|
What: /sys/kernel/debug/nx-crypto/*
|
||||||
|
Date: March 2012
|
||||||
|
KernelVersion: 3.4
|
||||||
|
Contact: Kent Yoder <key@linux.vnet.ibm.com>
|
||||||
|
Description:
|
||||||
|
|
||||||
|
These debugfs interfaces are built by the nx-crypto driver, built in
|
||||||
|
arch/powerpc/crypto/nx.
|
||||||
|
|
||||||
|
Error Detection
|
||||||
|
===============
|
||||||
|
|
||||||
|
errors:
|
||||||
|
- A u32 providing a total count of errors since the driver was loaded. The
|
||||||
|
only errors counted here are those returned from the hcall, H_COP_OP.
|
||||||
|
|
||||||
|
last_error:
|
||||||
|
- The most recent non-zero return code from the H_COP_OP hcall. -EBUSY is not
|
||||||
|
recorded here (the hcall will retry until -EBUSY goes away).
|
||||||
|
|
||||||
|
last_error_pid:
|
||||||
|
- The process ID of the process who received the most recent error from the
|
||||||
|
hcall.
|
||||||
|
|
||||||
|
Device Use
|
||||||
|
==========
|
||||||
|
|
||||||
|
aes_bytes:
|
||||||
|
- The total number of bytes encrypted using AES in any of the driver's
|
||||||
|
supported modes.
|
||||||
|
|
||||||
|
aes_ops:
|
||||||
|
- The total number of AES operations submitted to the hardware.
|
||||||
|
|
||||||
|
sha256_bytes:
|
||||||
|
- The total number of bytes hashed by the hardware using SHA-256.
|
||||||
|
|
||||||
|
sha256_ops:
|
||||||
|
- The total number of SHA-256 operations submitted to the hardware.
|
||||||
|
|
||||||
|
sha512_bytes:
|
||||||
|
- The total number of bytes hashed by the hardware using SHA-512.
|
||||||
|
|
||||||
|
sha512_ops:
|
||||||
|
- The total number of SHA-512 operations submitted to the hardware.
|
19
Documentation/ABI/testing/debugfs-pktcdvd
Normal file
19
Documentation/ABI/testing/debugfs-pktcdvd
Normal file
|
@ -0,0 +1,19 @@
|
||||||
|
What: /sys/kernel/debug/pktcdvd/pktcdvd[0-7]
|
||||||
|
Date: Oct. 2006
|
||||||
|
KernelVersion: 2.6.20
|
||||||
|
Contact: Thomas Maier <balagi@justmail.de>
|
||||||
|
Description:
|
||||||
|
|
||||||
|
debugfs interface
|
||||||
|
-----------------
|
||||||
|
|
||||||
|
The pktcdvd module (packet writing driver) creates
|
||||||
|
these files in debugfs:
|
||||||
|
|
||||||
|
/sys/kernel/debug/pktcdvd/pktcdvd[0-7]/
|
||||||
|
info (0444) Lots of driver statistics and infos.
|
||||||
|
|
||||||
|
Example:
|
||||||
|
-------
|
||||||
|
|
||||||
|
cat /sys/kernel/debug/pktcdvd/pktcdvd0/info
|
110
Documentation/ABI/testing/dev-kmsg
Normal file
110
Documentation/ABI/testing/dev-kmsg
Normal file
|
@ -0,0 +1,110 @@
|
||||||
|
What: /dev/kmsg
|
||||||
|
Date: Mai 2012
|
||||||
|
KernelVersion: 3.5
|
||||||
|
Contact: Kay Sievers <kay@vrfy.org>
|
||||||
|
Description: The /dev/kmsg character device node provides userspace access
|
||||||
|
to the kernel's printk buffer.
|
||||||
|
|
||||||
|
Injecting messages:
|
||||||
|
Every write() to the opened device node places a log entry in
|
||||||
|
the kernel's printk buffer.
|
||||||
|
|
||||||
|
The logged line can be prefixed with a <N> syslog prefix, which
|
||||||
|
carries the syslog priority and facility. The single decimal
|
||||||
|
prefix number is composed of the 3 lowest bits being the syslog
|
||||||
|
priority and the higher bits the syslog facility number.
|
||||||
|
|
||||||
|
If no prefix is given, the priority number is the default kernel
|
||||||
|
log priority and the facility number is set to LOG_USER (1). It
|
||||||
|
is not possible to inject messages from userspace with the
|
||||||
|
facility number LOG_KERN (0), to make sure that the origin of
|
||||||
|
the messages can always be reliably determined.
|
||||||
|
|
||||||
|
Accessing the buffer:
|
||||||
|
Every read() from the opened device node receives one record
|
||||||
|
of the kernel's printk buffer.
|
||||||
|
|
||||||
|
The first read() directly following an open() always returns
|
||||||
|
first message in the buffer; there is no kernel-internal
|
||||||
|
persistent state; many readers can concurrently open the device
|
||||||
|
and read from it, without affecting other readers.
|
||||||
|
|
||||||
|
Every read() will receive the next available record. If no more
|
||||||
|
records are available read() will block, or if O_NONBLOCK is
|
||||||
|
used -EAGAIN returned.
|
||||||
|
|
||||||
|
Messages in the record ring buffer get overwritten as whole,
|
||||||
|
there are never partial messages received by read().
|
||||||
|
|
||||||
|
In case messages get overwritten in the circular buffer while
|
||||||
|
the device is kept open, the next read() will return -EPIPE,
|
||||||
|
and the seek position be updated to the next available record.
|
||||||
|
Subsequent reads() will return available records again.
|
||||||
|
|
||||||
|
Unlike the classic syslog() interface, the 64 bit record
|
||||||
|
sequence numbers allow to calculate the amount of lost
|
||||||
|
messages, in case the buffer gets overwritten. And they allow
|
||||||
|
to reconnect to the buffer and reconstruct the read position
|
||||||
|
if needed, without limiting the interface to a single reader.
|
||||||
|
|
||||||
|
The device supports seek with the following parameters:
|
||||||
|
SEEK_SET, 0
|
||||||
|
seek to the first entry in the buffer
|
||||||
|
SEEK_END, 0
|
||||||
|
seek after the last entry in the buffer
|
||||||
|
SEEK_DATA, 0
|
||||||
|
seek after the last record available at the time
|
||||||
|
the last SYSLOG_ACTION_CLEAR was issued.
|
||||||
|
|
||||||
|
The output format consists of a prefix carrying the syslog
|
||||||
|
prefix including priority and facility, the 64 bit message
|
||||||
|
sequence number and the monotonic timestamp in microseconds,
|
||||||
|
and a flag field. All fields are separated by a ','.
|
||||||
|
|
||||||
|
Future extensions might add more comma separated values before
|
||||||
|
the terminating ';'. Unknown fields and values should be
|
||||||
|
gracefully ignored.
|
||||||
|
|
||||||
|
The human readable text string starts directly after the ';'
|
||||||
|
and is terminated by a '\n'. Untrusted values derived from
|
||||||
|
hardware or other facilities are printed, therefore
|
||||||
|
all non-printable characters and '\' itself in the log message
|
||||||
|
are escaped by "\x00" C-style hex encoding.
|
||||||
|
|
||||||
|
A line starting with ' ', is a continuation line, adding
|
||||||
|
key/value pairs to the log message, which provide the machine
|
||||||
|
readable context of the message, for reliable processing in
|
||||||
|
userspace.
|
||||||
|
|
||||||
|
Example:
|
||||||
|
7,160,424069,-;pci_root PNP0A03:00: host bridge window [io 0x0000-0x0cf7] (ignored)
|
||||||
|
SUBSYSTEM=acpi
|
||||||
|
DEVICE=+acpi:PNP0A03:00
|
||||||
|
6,339,5140900,-;NET: Registered protocol family 10
|
||||||
|
30,340,5690716,-;udevd[80]: starting version 181
|
||||||
|
|
||||||
|
The DEVICE= key uniquely identifies devices the following way:
|
||||||
|
b12:8 - block dev_t
|
||||||
|
c127:3 - char dev_t
|
||||||
|
n8 - netdev ifindex
|
||||||
|
+sound:card0 - subsystem:devname
|
||||||
|
|
||||||
|
The flags field carries '-' by default. A 'c' indicates a
|
||||||
|
fragment of a line. All following fragments are flagged with
|
||||||
|
'+'. Note, that these hints about continuation lines are not
|
||||||
|
necessarily correct, and the stream could be interleaved with
|
||||||
|
unrelated messages, but merging the lines in the output
|
||||||
|
usually produces better human readable results. A similar
|
||||||
|
logic is used internally when messages are printed to the
|
||||||
|
console, /proc/kmsg or the syslog() syscall.
|
||||||
|
|
||||||
|
By default, kernel tries to avoid fragments by concatenating
|
||||||
|
when it can and fragments are rare; however, when extended
|
||||||
|
console support is enabled, the in-kernel concatenation is
|
||||||
|
disabled and /dev/kmsg output will contain more fragments. If
|
||||||
|
the log consumer performs concatenation, the end result
|
||||||
|
should be the same. In the future, the in-kernel concatenation
|
||||||
|
may be removed entirely and /dev/kmsg users are recommended to
|
||||||
|
implement fragment handling.
|
||||||
|
|
||||||
|
Users: dmesg(1), userspace kernel log consumers
|
23
Documentation/ABI/testing/evm
Normal file
23
Documentation/ABI/testing/evm
Normal file
|
@ -0,0 +1,23 @@
|
||||||
|
What: security/evm
|
||||||
|
Date: March 2011
|
||||||
|
Contact: Mimi Zohar <zohar@us.ibm.com>
|
||||||
|
Description:
|
||||||
|
EVM protects a file's security extended attributes(xattrs)
|
||||||
|
against integrity attacks. The initial method maintains an
|
||||||
|
HMAC-sha1 value across the extended attributes, storing the
|
||||||
|
value as the extended attribute 'security.evm'.
|
||||||
|
|
||||||
|
EVM depends on the Kernel Key Retention System to provide it
|
||||||
|
with a trusted/encrypted key for the HMAC-sha1 operation.
|
||||||
|
The key is loaded onto the root's keyring using keyctl. Until
|
||||||
|
EVM receives notification that the key has been successfully
|
||||||
|
loaded onto the keyring (echo 1 > <securityfs>/evm), EVM
|
||||||
|
can not create or validate the 'security.evm' xattr, but
|
||||||
|
returns INTEGRITY_UNKNOWN. Loading the key and signaling EVM
|
||||||
|
should be done as early as possible. Normally this is done
|
||||||
|
in the initramfs, which has already been measured as part
|
||||||
|
of the trusted boot. For more information on creating and
|
||||||
|
loading existing trusted/encrypted keys, refer to:
|
||||||
|
Documentation/keys-trusted-encrypted.txt. (A sample dracut
|
||||||
|
patch, which loads the trusted/encrypted key and enables
|
||||||
|
EVM, is available from http://linux-ima.sourceforge.net/#EVM.)
|
26
Documentation/ABI/testing/gpio-cdev
Normal file
26
Documentation/ABI/testing/gpio-cdev
Normal file
|
@ -0,0 +1,26 @@
|
||||||
|
What: /dev/gpiochip[0-9]+
|
||||||
|
Date: November 2015
|
||||||
|
KernelVersion: 4.4
|
||||||
|
Contact: linux-gpio@vger.kernel.org
|
||||||
|
Description:
|
||||||
|
The character device files /dev/gpiochip* are the interface
|
||||||
|
between GPIO chips and userspace.
|
||||||
|
|
||||||
|
The ioctl(2)-based ABI is defined and documented in
|
||||||
|
[include/uapi]<linux/gpio.h>.
|
||||||
|
|
||||||
|
The following file operations are supported:
|
||||||
|
|
||||||
|
open(2)
|
||||||
|
Currently the only useful flags are O_RDWR.
|
||||||
|
|
||||||
|
ioctl(2)
|
||||||
|
Initiate various actions.
|
||||||
|
See the inline documentation in [include/uapi]<linux/gpio.h>
|
||||||
|
for descriptions of all ioctls.
|
||||||
|
|
||||||
|
close(2)
|
||||||
|
Stops and free up the I/O contexts that was associated
|
||||||
|
with the file descriptor.
|
||||||
|
|
||||||
|
Users: TBD
|
98
Documentation/ABI/testing/ima_policy
Normal file
98
Documentation/ABI/testing/ima_policy
Normal file
|
@ -0,0 +1,98 @@
|
||||||
|
What: security/ima/policy
|
||||||
|
Date: May 2008
|
||||||
|
Contact: Mimi Zohar <zohar@us.ibm.com>
|
||||||
|
Description:
|
||||||
|
The Trusted Computing Group(TCG) runtime Integrity
|
||||||
|
Measurement Architecture(IMA) maintains a list of hash
|
||||||
|
values of executables and other sensitive system files
|
||||||
|
loaded into the run-time of this system. At runtime,
|
||||||
|
the policy can be constrained based on LSM specific data.
|
||||||
|
Policies are loaded into the securityfs file ima/policy
|
||||||
|
by opening the file, writing the rules one at a time and
|
||||||
|
then closing the file. The new policy takes effect after
|
||||||
|
the file ima/policy is closed.
|
||||||
|
|
||||||
|
IMA appraisal, if configured, uses these file measurements
|
||||||
|
for local measurement appraisal.
|
||||||
|
|
||||||
|
rule format: action [condition ...]
|
||||||
|
|
||||||
|
action: measure | dont_measure | appraise | dont_appraise | audit
|
||||||
|
condition:= base | lsm [option]
|
||||||
|
base: [[func=] [mask=] [fsmagic=] [fsuuid=] [uid=]
|
||||||
|
[euid=] [fowner=]]
|
||||||
|
lsm: [[subj_user=] [subj_role=] [subj_type=]
|
||||||
|
[obj_user=] [obj_role=] [obj_type=]]
|
||||||
|
option: [[appraise_type=]] [permit_directio]
|
||||||
|
|
||||||
|
base: func:= [BPRM_CHECK][MMAP_CHECK][FILE_CHECK][MODULE_CHECK]
|
||||||
|
[FIRMWARE_CHECK]
|
||||||
|
[KEXEC_KERNEL_CHECK] [KEXEC_INITRAMFS_CHECK]
|
||||||
|
mask:= [[^]MAY_READ] [[^]MAY_WRITE] [[^]MAY_APPEND]
|
||||||
|
[[^]MAY_EXEC]
|
||||||
|
fsmagic:= hex value
|
||||||
|
fsuuid:= file system UUID (e.g 8bcbe394-4f13-4144-be8e-5aa9ea2ce2f6)
|
||||||
|
uid:= decimal value
|
||||||
|
euid:= decimal value
|
||||||
|
fowner:=decimal value
|
||||||
|
lsm: are LSM specific
|
||||||
|
option: appraise_type:= [imasig]
|
||||||
|
|
||||||
|
default policy:
|
||||||
|
# PROC_SUPER_MAGIC
|
||||||
|
dont_measure fsmagic=0x9fa0
|
||||||
|
dont_appraise fsmagic=0x9fa0
|
||||||
|
# SYSFS_MAGIC
|
||||||
|
dont_measure fsmagic=0x62656572
|
||||||
|
dont_appraise fsmagic=0x62656572
|
||||||
|
# DEBUGFS_MAGIC
|
||||||
|
dont_measure fsmagic=0x64626720
|
||||||
|
dont_appraise fsmagic=0x64626720
|
||||||
|
# TMPFS_MAGIC
|
||||||
|
dont_measure fsmagic=0x01021994
|
||||||
|
dont_appraise fsmagic=0x01021994
|
||||||
|
# RAMFS_MAGIC
|
||||||
|
dont_appraise fsmagic=0x858458f6
|
||||||
|
# DEVPTS_SUPER_MAGIC
|
||||||
|
dont_measure fsmagic=0x1cd1
|
||||||
|
dont_appraise fsmagic=0x1cd1
|
||||||
|
# BINFMTFS_MAGIC
|
||||||
|
dont_measure fsmagic=0x42494e4d
|
||||||
|
dont_appraise fsmagic=0x42494e4d
|
||||||
|
# SECURITYFS_MAGIC
|
||||||
|
dont_measure fsmagic=0x73636673
|
||||||
|
dont_appraise fsmagic=0x73636673
|
||||||
|
# SELINUX_MAGIC
|
||||||
|
dont_measure fsmagic=0xf97cff8c
|
||||||
|
dont_appraise fsmagic=0xf97cff8c
|
||||||
|
# CGROUP_SUPER_MAGIC
|
||||||
|
dont_measure fsmagic=0x27e0eb
|
||||||
|
dont_appraise fsmagic=0x27e0eb
|
||||||
|
# NSFS_MAGIC
|
||||||
|
dont_measure fsmagic=0x6e736673
|
||||||
|
dont_appraise fsmagic=0x6e736673
|
||||||
|
|
||||||
|
measure func=BPRM_CHECK
|
||||||
|
measure func=FILE_MMAP mask=MAY_EXEC
|
||||||
|
measure func=FILE_CHECK mask=MAY_READ uid=0
|
||||||
|
measure func=MODULE_CHECK
|
||||||
|
measure func=FIRMWARE_CHECK
|
||||||
|
appraise fowner=0
|
||||||
|
|
||||||
|
The default policy measures all executables in bprm_check,
|
||||||
|
all files mmapped executable in file_mmap, and all files
|
||||||
|
open for read by root in do_filp_open. The default appraisal
|
||||||
|
policy appraises all files owned by root.
|
||||||
|
|
||||||
|
Examples of LSM specific definitions:
|
||||||
|
|
||||||
|
SELinux:
|
||||||
|
dont_measure obj_type=var_log_t
|
||||||
|
dont_appraise obj_type=var_log_t
|
||||||
|
dont_measure obj_type=auditd_log_t
|
||||||
|
dont_appraise obj_type=auditd_log_t
|
||||||
|
measure subj_user=system_u func=FILE_CHECK mask=MAY_READ
|
||||||
|
measure subj_role=system_r func=FILE_CHECK mask=MAY_READ
|
||||||
|
|
||||||
|
Smack:
|
||||||
|
measure subj_user=_ func=FILE_CHECK mask=MAY_READ
|
22
Documentation/ABI/testing/procfs-diskstats
Normal file
22
Documentation/ABI/testing/procfs-diskstats
Normal file
|
@ -0,0 +1,22 @@
|
||||||
|
What: /proc/diskstats
|
||||||
|
Date: February 2008
|
||||||
|
Contact: Jerome Marchand <jmarchan@redhat.com>
|
||||||
|
Description:
|
||||||
|
The /proc/diskstats file displays the I/O statistics
|
||||||
|
of block devices. Each line contains the following 14
|
||||||
|
fields:
|
||||||
|
1 - major number
|
||||||
|
2 - minor mumber
|
||||||
|
3 - device name
|
||||||
|
4 - reads completed successfully
|
||||||
|
5 - reads merged
|
||||||
|
6 - sectors read
|
||||||
|
7 - time spent reading (ms)
|
||||||
|
8 - writes completed
|
||||||
|
9 - writes merged
|
||||||
|
10 - sectors written
|
||||||
|
11 - time spent writing (ms)
|
||||||
|
12 - I/Os currently in progress
|
||||||
|
13 - time spent doing I/Os (ms)
|
||||||
|
14 - weighted time spent doing I/Os (ms)
|
||||||
|
For more details refer to Documentation/iostats.txt
|
47
Documentation/ABI/testing/pstore
Normal file
47
Documentation/ABI/testing/pstore
Normal file
|
@ -0,0 +1,47 @@
|
||||||
|
Where: /sys/fs/pstore/... (or /dev/pstore/...)
|
||||||
|
Date: March 2011
|
||||||
|
Kernel Version: 2.6.39
|
||||||
|
Contact: tony.luck@intel.com
|
||||||
|
Description: Generic interface to platform dependent persistent storage.
|
||||||
|
|
||||||
|
Platforms that provide a mechanism to preserve some data
|
||||||
|
across system reboots can register with this driver to
|
||||||
|
provide a generic interface to show records captured in
|
||||||
|
the dying moments. In the case of a panic the last part
|
||||||
|
of the console log is captured, but other interesting
|
||||||
|
data can also be saved.
|
||||||
|
|
||||||
|
# mount -t pstore -o kmsg_bytes=8000 - /sys/fs/pstore
|
||||||
|
|
||||||
|
$ ls -l /sys/fs/pstore/
|
||||||
|
total 0
|
||||||
|
-r--r--r-- 1 root root 7896 Nov 30 15:38 dmesg-erst-1
|
||||||
|
|
||||||
|
Different users of this interface will result in different
|
||||||
|
filename prefixes. Currently two are defined:
|
||||||
|
|
||||||
|
"dmesg" - saved console log
|
||||||
|
"mce" - architecture dependent data from fatal h/w error
|
||||||
|
|
||||||
|
Once the information in a file has been read, removing
|
||||||
|
the file will signal to the underlying persistent storage
|
||||||
|
device that it can reclaim the space for later re-use.
|
||||||
|
|
||||||
|
$ rm /sys/fs/pstore/dmesg-erst-1
|
||||||
|
|
||||||
|
The expectation is that all files in /sys/fs/pstore/
|
||||||
|
will be saved elsewhere and erased from persistent store
|
||||||
|
soon after boot to free up space ready for the next
|
||||||
|
catastrophe.
|
||||||
|
|
||||||
|
The 'kmsg_bytes' mount option changes the target amount of
|
||||||
|
data saved on each oops/panic. Pstore saves (possibly
|
||||||
|
multiple) files based on the record size of the underlying
|
||||||
|
persistent storage until at least this amount is reached.
|
||||||
|
Default is 10 Kbytes.
|
||||||
|
|
||||||
|
Pstore only supports one backend at a time. If multiple
|
||||||
|
backends are available, the preferred backend may be
|
||||||
|
set by passing the pstore.backend= argument to the kernel at
|
||||||
|
boot time.
|
||||||
|
|
110
Documentation/ABI/testing/sysfs-ata
Normal file
110
Documentation/ABI/testing/sysfs-ata
Normal file
|
@ -0,0 +1,110 @@
|
||||||
|
What: /sys/class/ata_...
|
||||||
|
Date: August 2008
|
||||||
|
Contact: Gwendal Grignou<gwendal@google.com>
|
||||||
|
Description:
|
||||||
|
|
||||||
|
Provide a place in sysfs for storing the ATA topology of the system. This allows
|
||||||
|
retrieving various information about ATA objects.
|
||||||
|
|
||||||
|
Files under /sys/class/ata_port
|
||||||
|
-------------------------------
|
||||||
|
|
||||||
|
For each port, a directory ataX is created where X is the ata_port_id of
|
||||||
|
the port. The device parent is the ata host device.
|
||||||
|
|
||||||
|
idle_irq (read)
|
||||||
|
|
||||||
|
Number of IRQ received by the port while idle [some ata HBA only].
|
||||||
|
|
||||||
|
nr_pmp_links (read)
|
||||||
|
|
||||||
|
If a SATA Port Multiplier (PM) is connected, number of link behind it.
|
||||||
|
|
||||||
|
Files under /sys/class/ata_link
|
||||||
|
-------------------------------
|
||||||
|
|
||||||
|
Behind each port, there is a ata_link. If there is a SATA PM in the
|
||||||
|
topology, 15 ata_link objects are created.
|
||||||
|
|
||||||
|
If a link is behind a port, the directory name is linkX, where X is
|
||||||
|
ata_port_id of the port.
|
||||||
|
If a link is behind a PM, its name is linkX.Y where X is ata_port_id
|
||||||
|
of the parent port and Y the PM port.
|
||||||
|
|
||||||
|
hw_sata_spd_limit
|
||||||
|
|
||||||
|
Maximum speed supported by the connected SATA device.
|
||||||
|
|
||||||
|
sata_spd_limit
|
||||||
|
|
||||||
|
Maximum speed imposed by libata.
|
||||||
|
|
||||||
|
sata_spd
|
||||||
|
|
||||||
|
Current speed of the link [1.5, 3Gps,...].
|
||||||
|
|
||||||
|
Files under /sys/class/ata_device
|
||||||
|
---------------------------------
|
||||||
|
|
||||||
|
Behind each link, up to two ata device are created.
|
||||||
|
The name of the directory is devX[.Y].Z where:
|
||||||
|
- X is ata_port_id of the port where the device is connected,
|
||||||
|
- Y the port of the PM if any, and
|
||||||
|
- Z the device id: for PATA, there is usually 2 devices [0,1],
|
||||||
|
only 1 for SATA.
|
||||||
|
|
||||||
|
class
|
||||||
|
Device class. Can be "ata" for disk, "atapi" for packet device,
|
||||||
|
"pmp" for PM, or "none" if no device was found behind the link.
|
||||||
|
|
||||||
|
dma_mode
|
||||||
|
|
||||||
|
Transfer modes supported by the device when in DMA mode.
|
||||||
|
Mostly used by PATA device.
|
||||||
|
|
||||||
|
pio_mode
|
||||||
|
|
||||||
|
Transfer modes supported by the device when in PIO mode.
|
||||||
|
Mostly used by PATA device.
|
||||||
|
|
||||||
|
xfer_mode
|
||||||
|
|
||||||
|
Current transfer mode.
|
||||||
|
|
||||||
|
id
|
||||||
|
|
||||||
|
Cached result of IDENTIFY command, as described in ATA8 7.16 and 7.17.
|
||||||
|
Only valid if the device is not a PM.
|
||||||
|
|
||||||
|
gscr
|
||||||
|
|
||||||
|
Cached result of the dump of PM GSCR register.
|
||||||
|
Valid registers are:
|
||||||
|
0: SATA_PMP_GSCR_PROD_ID,
|
||||||
|
1: SATA_PMP_GSCR_REV,
|
||||||
|
2: SATA_PMP_GSCR_PORT_INFO,
|
||||||
|
32: SATA_PMP_GSCR_ERROR,
|
||||||
|
33: SATA_PMP_GSCR_ERROR_EN,
|
||||||
|
64: SATA_PMP_GSCR_FEAT,
|
||||||
|
96: SATA_PMP_GSCR_FEAT_EN,
|
||||||
|
130: SATA_PMP_GSCR_SII_GPIO
|
||||||
|
Only valid if the device is a PM.
|
||||||
|
|
||||||
|
trim
|
||||||
|
|
||||||
|
Shows the DSM TRIM mode currently used by the device. Valid
|
||||||
|
values are:
|
||||||
|
unsupported: Drive does not support DSM TRIM
|
||||||
|
unqueued: Drive supports unqueued DSM TRIM only
|
||||||
|
queued: Drive supports queued DSM TRIM
|
||||||
|
forced_unqueued: Drive's queued DSM support is known to be
|
||||||
|
buggy and only unqueued TRIM commands
|
||||||
|
are sent
|
||||||
|
|
||||||
|
spdn_cnt
|
||||||
|
|
||||||
|
Number of time libata decided to lower the speed of link due to errors.
|
||||||
|
|
||||||
|
ering
|
||||||
|
|
||||||
|
Formatted output of the error ring of the device.
|
273
Documentation/ABI/testing/sysfs-block
Normal file
273
Documentation/ABI/testing/sysfs-block
Normal file
|
@ -0,0 +1,273 @@
|
||||||
|
What: /sys/block/<disk>/stat
|
||||||
|
Date: February 2008
|
||||||
|
Contact: Jerome Marchand <jmarchan@redhat.com>
|
||||||
|
Description:
|
||||||
|
The /sys/block/<disk>/stat files displays the I/O
|
||||||
|
statistics of disk <disk>. They contain 11 fields:
|
||||||
|
1 - reads completed successfully
|
||||||
|
2 - reads merged
|
||||||
|
3 - sectors read
|
||||||
|
4 - time spent reading (ms)
|
||||||
|
5 - writes completed
|
||||||
|
6 - writes merged
|
||||||
|
7 - sectors written
|
||||||
|
8 - time spent writing (ms)
|
||||||
|
9 - I/Os currently in progress
|
||||||
|
10 - time spent doing I/Os (ms)
|
||||||
|
11 - weighted time spent doing I/Os (ms)
|
||||||
|
For more details refer Documentation/iostats.txt
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/<part>/stat
|
||||||
|
Date: February 2008
|
||||||
|
Contact: Jerome Marchand <jmarchan@redhat.com>
|
||||||
|
Description:
|
||||||
|
The /sys/block/<disk>/<part>/stat files display the
|
||||||
|
I/O statistics of partition <part>. The format is the
|
||||||
|
same as the above-written /sys/block/<disk>/stat
|
||||||
|
format.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/integrity/format
|
||||||
|
Date: June 2008
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
Metadata format for integrity capable block device.
|
||||||
|
E.g. T10-DIF-TYPE1-CRC.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/integrity/read_verify
|
||||||
|
Date: June 2008
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
Indicates whether the block layer should verify the
|
||||||
|
integrity of read requests serviced by devices that
|
||||||
|
support sending integrity metadata.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/integrity/tag_size
|
||||||
|
Date: June 2008
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
Number of bytes of integrity tag space available per
|
||||||
|
512 bytes of data.
|
||||||
|
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/integrity/device_is_integrity_capable
|
||||||
|
Date: July 2014
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
Indicates whether a storage device is capable of storing
|
||||||
|
integrity metadata. Set if the device is T10 PI-capable.
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/integrity/protection_interval_bytes
|
||||||
|
Date: July 2015
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
Describes the number of data bytes which are protected
|
||||||
|
by one integrity tuple. Typically the device's logical
|
||||||
|
block size.
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/integrity/write_generate
|
||||||
|
Date: June 2008
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
Indicates whether the block layer should automatically
|
||||||
|
generate checksums for write requests bound for
|
||||||
|
devices that support receiving integrity metadata.
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/alignment_offset
|
||||||
|
Date: April 2009
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
Storage devices may report a physical block size that is
|
||||||
|
bigger than the logical block size (for instance a drive
|
||||||
|
with 4KB physical sectors exposing 512-byte logical
|
||||||
|
blocks to the operating system). This parameter
|
||||||
|
indicates how many bytes the beginning of the device is
|
||||||
|
offset from the disk's natural alignment.
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/<partition>/alignment_offset
|
||||||
|
Date: April 2009
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
Storage devices may report a physical block size that is
|
||||||
|
bigger than the logical block size (for instance a drive
|
||||||
|
with 4KB physical sectors exposing 512-byte logical
|
||||||
|
blocks to the operating system). This parameter
|
||||||
|
indicates how many bytes the beginning of the partition
|
||||||
|
is offset from the disk's natural alignment.
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/queue/logical_block_size
|
||||||
|
Date: May 2009
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
This is the smallest unit the storage device can
|
||||||
|
address. It is typically 512 bytes.
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/queue/physical_block_size
|
||||||
|
Date: May 2009
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
This is the smallest unit a physical storage device can
|
||||||
|
write atomically. It is usually the same as the logical
|
||||||
|
block size but may be bigger. One example is SATA
|
||||||
|
drives with 4KB sectors that expose a 512-byte logical
|
||||||
|
block size to the operating system. For stacked block
|
||||||
|
devices the physical_block_size variable contains the
|
||||||
|
maximum physical_block_size of the component devices.
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/queue/minimum_io_size
|
||||||
|
Date: April 2009
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
Storage devices may report a granularity or preferred
|
||||||
|
minimum I/O size which is the smallest request the
|
||||||
|
device can perform without incurring a performance
|
||||||
|
penalty. For disk drives this is often the physical
|
||||||
|
block size. For RAID arrays it is often the stripe
|
||||||
|
chunk size. A properly aligned multiple of
|
||||||
|
minimum_io_size is the preferred request size for
|
||||||
|
workloads where a high number of I/O operations is
|
||||||
|
desired.
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/queue/optimal_io_size
|
||||||
|
Date: April 2009
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
Storage devices may report an optimal I/O size, which is
|
||||||
|
the device's preferred unit for sustained I/O. This is
|
||||||
|
rarely reported for disk drives. For RAID arrays it is
|
||||||
|
usually the stripe width or the internal track size. A
|
||||||
|
properly aligned multiple of optimal_io_size is the
|
||||||
|
preferred request size for workloads where sustained
|
||||||
|
throughput is desired. If no optimal I/O size is
|
||||||
|
reported this file contains 0.
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/queue/nomerges
|
||||||
|
Date: January 2010
|
||||||
|
Contact:
|
||||||
|
Description:
|
||||||
|
Standard I/O elevator operations include attempts to
|
||||||
|
merge contiguous I/Os. For known random I/O loads these
|
||||||
|
attempts will always fail and result in extra cycles
|
||||||
|
being spent in the kernel. This allows one to turn off
|
||||||
|
this behavior on one of two ways: When set to 1, complex
|
||||||
|
merge checks are disabled, but the simple one-shot merges
|
||||||
|
with the previous I/O request are enabled. When set to 2,
|
||||||
|
all merge tries are disabled. The default value is 0 -
|
||||||
|
which enables all types of merge tries.
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/discard_alignment
|
||||||
|
Date: May 2011
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
Devices that support discard functionality may
|
||||||
|
internally allocate space in units that are bigger than
|
||||||
|
the exported logical block size. The discard_alignment
|
||||||
|
parameter indicates how many bytes the beginning of the
|
||||||
|
device is offset from the internal allocation unit's
|
||||||
|
natural alignment.
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/<partition>/discard_alignment
|
||||||
|
Date: May 2011
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
Devices that support discard functionality may
|
||||||
|
internally allocate space in units that are bigger than
|
||||||
|
the exported logical block size. The discard_alignment
|
||||||
|
parameter indicates how many bytes the beginning of the
|
||||||
|
partition is offset from the internal allocation unit's
|
||||||
|
natural alignment.
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/queue/discard_granularity
|
||||||
|
Date: May 2011
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
Devices that support discard functionality may
|
||||||
|
internally allocate space using units that are bigger
|
||||||
|
than the logical block size. The discard_granularity
|
||||||
|
parameter indicates the size of the internal allocation
|
||||||
|
unit in bytes if reported by the device. Otherwise the
|
||||||
|
discard_granularity will be set to match the device's
|
||||||
|
physical block size. A discard_granularity of 0 means
|
||||||
|
that the device does not support discard functionality.
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/queue/discard_max_bytes
|
||||||
|
Date: May 2011
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
Devices that support discard functionality may have
|
||||||
|
internal limits on the number of bytes that can be
|
||||||
|
trimmed or unmapped in a single operation. Some storage
|
||||||
|
protocols also have inherent limits on the number of
|
||||||
|
blocks that can be described in a single command. The
|
||||||
|
discard_max_bytes parameter is set by the device driver
|
||||||
|
to the maximum number of bytes that can be discarded in
|
||||||
|
a single operation. Discard requests issued to the
|
||||||
|
device must not exceed this limit. A discard_max_bytes
|
||||||
|
value of 0 means that the device does not support
|
||||||
|
discard functionality.
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/queue/discard_zeroes_data
|
||||||
|
Date: May 2011
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
Will always return 0. Don't rely on any specific behavior
|
||||||
|
for discards, and don't read this file.
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/queue/write_same_max_bytes
|
||||||
|
Date: January 2012
|
||||||
|
Contact: Martin K. Petersen <martin.petersen@oracle.com>
|
||||||
|
Description:
|
||||||
|
Some devices support a write same operation in which a
|
||||||
|
single data block can be written to a range of several
|
||||||
|
contiguous blocks on storage. This can be used to wipe
|
||||||
|
areas on disk or to initialize drives in a RAID
|
||||||
|
configuration. write_same_max_bytes indicates how many
|
||||||
|
bytes can be written in a single write same command. If
|
||||||
|
write_same_max_bytes is 0, write same is not supported
|
||||||
|
by the device.
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/queue/write_zeroes_max_bytes
|
||||||
|
Date: November 2016
|
||||||
|
Contact: Chaitanya Kulkarni <chaitanya.kulkarni@wdc.com>
|
||||||
|
Description:
|
||||||
|
Devices that support write zeroes operation in which a
|
||||||
|
single request can be issued to zero out the range of
|
||||||
|
contiguous blocks on storage without having any payload
|
||||||
|
in the request. This can be used to optimize writing zeroes
|
||||||
|
to the devices. write_zeroes_max_bytes indicates how many
|
||||||
|
bytes can be written in a single write zeroes command. If
|
||||||
|
write_zeroes_max_bytes is 0, write zeroes is not supported
|
||||||
|
by the device.
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/queue/zoned
|
||||||
|
Date: September 2016
|
||||||
|
Contact: Damien Le Moal <damien.lemoal@hgst.com>
|
||||||
|
Description:
|
||||||
|
zoned indicates if the device is a zoned block device
|
||||||
|
and the zone model of the device if it is indeed zoned.
|
||||||
|
The possible values indicated by zoned are "none" for
|
||||||
|
regular block devices and "host-aware" or "host-managed"
|
||||||
|
for zoned block devices. The characteristics of
|
||||||
|
host-aware and host-managed zoned block devices are
|
||||||
|
described in the ZBC (Zoned Block Commands) and ZAC
|
||||||
|
(Zoned Device ATA Command Set) standards. These standards
|
||||||
|
also define the "drive-managed" zone model. However,
|
||||||
|
since drive-managed zoned block devices do not support
|
||||||
|
zone commands, they will be treated as regular block
|
||||||
|
devices and zoned will report "none".
|
||||||
|
|
||||||
|
What: /sys/block/<disk>/queue/chunk_sectors
|
||||||
|
Date: September 2016
|
||||||
|
Contact: Hannes Reinecke <hare@suse.com>
|
||||||
|
Description:
|
||||||
|
chunk_sectors has different meaning depending on the type
|
||||||
|
of the disk. For a RAID device (dm-raid), chunk_sectors
|
||||||
|
indicates the size in 512B sectors of the RAID volume
|
||||||
|
stripe segment. For a zoned block device, either
|
||||||
|
host-aware or host-managed, chunk_sectors indicates the
|
||||||
|
size of 512B sectors of the zones of the device, with
|
||||||
|
the eventual exception of the last zone of the device
|
||||||
|
which may be smaller.
|
Some files were not shown because too many files have changed in this diff Show more
Loading…
Reference in a new issue