Commit 13ac1a3c authored by Martin Schwidefsky's avatar Martin Schwidefsky Committed by Linus Torvalds

[PATCH] s390: documentation.

s390 documentation changes.
parent ef27be58
...@@ -45,25 +45,6 @@ Command line parameters ...@@ -45,25 +45,6 @@ Command line parameters
/proc entries /proc entries
------------- -------------
* /proc/subchannels
This entry shows information on a per-subchannel basis.
The data is ordered in the following way:
- device number
- subchannel number
- device type/model (if applicable; if not, this is empty) and control unit
type/model
- whether the device is in use (i. e. a device driver has requested ownership
and registered an interrupt handler)
- path installed mask (PIM), as reflected by last store subchannel
- path available mask (PAM), as reflected by last store subchannel
- path operational mask (POM), as reflected by last store subchannel
- the channel path IDs (CHPIDs)
All fields are separated by spaces, the chpids are in blocks of four chpids.
* /proc/cio_ignore * /proc/cio_ignore
Lists the ranges of device numbers which are ignored by common I/O. Lists the ranges of device numbers which are ignored by common I/O.
...@@ -116,27 +97,6 @@ Command line parameters ...@@ -116,27 +97,6 @@ Command line parameters
/proc/s390dbf/cio_*/level a number between 0 and 6; see the documentation on /proc/s390dbf/cio_*/level a number between 0 and 6; see the documentation on
the S/390 debug feature (Documentation/s390/s390dbf.txt) for details. the S/390 debug feature (Documentation/s390/s390dbf.txt) for details.
* /proc/irq_count * For some of the information present in the /proc filesystem in 2.4 (namely,
/proc/subchannels and /proc/chpids), see driver-model.txt.
This entry counts how many times s390_process_IRQ has been called for each Information formerly in /proc/irq_count is now in /proc/interrupts.
CPU. This info is in /proc/interrupts on other architectures.
* /proc/chpids
This entry serves a dual purpose:
- show which chpids are currently known to Linux and their status (online,
logically offline),
- toggling known chpids logically online/offline.
To toggle a known chpid logically offline, do an
echo off <chpid> > /proc/chpids
<chpid> is interpreted as hex, even if you omit the '0x'.
The chpid will be treated by Linux as if it were not online, which can mean
some devices will become unavailable.
You can toggle a logically offline chpid online again by
echo on <chpid> > /proc/chpids
If devices became unavailable by toggling the chpid logically offline, they
will become available again after you toggle the chpid online again.
...@@ -14,19 +14,18 @@ root/ ...@@ -14,19 +14,18 @@ root/
- sys - sys
- legacy - legacy
- css0/ - css0/
- 0:0000/0:0815/ - 0.0.0000/0.0.0815/
- 0:0001/0:4711/ - 0.0.0001/0.0.4711/
- 0:0002/ - 0.0.0002/
... ...
In this example, device 0815 is accessed via subchannel 0, device 4711 via In this example, device 0815 is accessed via subchannel 0, device 4711 via
subchannel 1, and subchannel 2 is a non-I/O subchannel. subchannel 1, and subchannel 2 is a non-I/O subchannel.
You should address a ccw device via its bus id (e.g. 0:4711); the device can You should address a ccw device via its bus id (e.g. 0.0.4711); the device can
be found under bus/ccw/devices/. be found under bus/ccw/devices/.
All ccw devices export some data via sysfs additional to the standard 'name' All ccw devices export some data via sysfs.
and 'power' entries.
cutype: The control unit type / model. cutype: The control unit type / model.
...@@ -177,6 +176,10 @@ this attributes creates a ccwgroup device consisting of these ccw devices (if ...@@ -177,6 +176,10 @@ this attributes creates a ccwgroup device consisting of these ccw devices (if
possible). This ccwgroup device can be set online or offline just like a normal possible). This ccwgroup device can be set online or offline just like a normal
ccw device. ccw device.
Each ccwgroup device also provides an 'ungroup' attribute to destroy the device
again (only when offline). This is a generic ccwgroup mechanism (the driver does
not need to implement anything beyond normal removal routines).
To implement a ccwgroup driver, please refer to include/asm/ccwgroup.h. Keep in To implement a ccwgroup driver, please refer to include/asm/ccwgroup.h. Keep in
mind that most drivers will need to implement both a ccwgroup and a ccw driver mind that most drivers will need to implement both a ccwgroup and a ccw driver
(unless you have a meta ccw driver, like cu3088 for lcs and ctc). (unless you have a meta ccw driver, like cu3088 for lcs and ctc).
...@@ -186,7 +189,7 @@ mind that most drivers will need to implement both a ccwgroup and a ccw driver ...@@ -186,7 +189,7 @@ mind that most drivers will need to implement both a ccwgroup and a ccw driver
----------------- -----------------
Channel paths show up, like subchannels, under the channel subsystem root (css0) Channel paths show up, like subchannels, under the channel subsystem root (css0)
and are called 'chp<chpid>'. They have no driver and do not belong to any bus. and are called 'chp0.<chpid>'. They have no driver and do not belong to any bus.
status - Can be 'online', 'logically offline' or 'n/a'. status - Can be 'online', 'logically offline' or 'n/a'.
Piping 'on' or 'off' sets the chpid logically online/offline. Piping 'on' or 'off' sets the chpid logically online/offline.
...@@ -215,7 +218,9 @@ connection to the specified host. ...@@ -215,7 +218,9 @@ connection to the specified host.
Netiucv connections show up under devices/iucv/ as "netiucv<ifnum>". The interface Netiucv connections show up under devices/iucv/ as "netiucv<ifnum>". The interface
number is assigned sequentially to the connections defined via the 'connection' number is assigned sequentially to the connections defined via the 'connection'
attribute. 'name' shows the connection partner. attribute.
user - shows the connection partner.
buffer - maximum buffer size. buffer - maximum buffer size.
Pipe to it to change buffer size. Pipe to it to change buffer size.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment