Merge tag 's390-5.4-1' of git://git.kernel.org/pub/scm/linux/kernel/git/s390/linux

==================

DASD device driver

==================

S/390's disk devices (DASDs) are managed by Linux via the DASD device

driver. It is valid for all types of DASDs and represents them to

Linux as block devices, namely "dd". Currently the DASD driver uses a

single major number (254) and 4 minor numbers per volume (1 for the

physical volume and 3 for partitions). With respect to partitions see

below. Thus you may have up to 64 DASD devices in your system.

The kernel parameter 'dasd=from-to,...' may be issued arbitrary times

in the kernel's parameter line or not at all. The 'from' and 'to'

parameters are to be given in hexadecimal notation without a leading

0x.

If you supply kernel parameters the different instances are processed

in order of appearance and a minor number is reserved for any device

covered by the supplied range up to 64 volumes. Additional DASDs are

ignored. If you do not supply the 'dasd=' kernel parameter at all, the

DASD driver registers all supported DASDs of your system to a minor

number in ascending order of the subchannel number.

The driver currently supports ECKD-devices and there are stubs for

support of the FBA and CKD architectures. For the FBA architecture

only some smart data structures are missing to make the support

complete.

We performed our testing on 3380 and 3390 type disks of different

sizes, under VM and on the bare hardware (LPAR), using internal disks

of the multiprise as well as a RAMAC virtual array. Disks exported by

an Enterprise Storage Server (Seascape) should work fine as well.

We currently implement one partition per volume, which is the whole

volume, skipping the first blocks up to the volume label. These are

reserved for IPL records and IBM's volume label to assure

accessibility of the DASD from other OSs. In a later stage we will

provide support of partitions, maybe VTOC oriented or using a kind of

partition table in the label record.

Usage

=====

-Low-level format (?CKD only)

For using an ECKD-DASD as a Linux harddisk you have to low-level

format the tracks by issuing the BLKDASDFORMAT-ioctl on that

device. This will erase any data on that volume including IBM volume

labels, VTOCs etc. The ioctl may take a `struct format_data *` or

'NULL' as an argument::

  typedef struct {

	int start_unit;

	int stop_unit;

	int blksize;

  } format_data_t;

When a NULL argument is passed to the BLKDASDFORMAT ioctl the whole

disk is formatted to a blocksize of 1024 bytes. Otherwise start_unit

and stop_unit are the first and last track to be formatted. If

stop_unit is -1 it implies that the DASD is formatted from start_unit

up to the last track. blksize can be any power of two between 512 and

4096. We recommend no blksize lower than 1024 because the ext2fs uses

1kB blocks anyway and you gain approx. 50% of capacity increasing your

blksize from 512 byte to 1kB.

Make a filesystem

=================

Then you can mk??fs the filesystem of your choice on that volume or

partition. For reasons of sanity you should build your filesystem on

the partition /dev/dd?1 instead of the whole volume. You only lose 3kB

but may be sure that you can reuse your data after introduction of a

real partition table.

Bugs

====

- Performance sometimes is rather low because we don't fully exploit clustering

TODO-List

=========

- Add IBM'S Disk layout to genhd

- Enhance driver to use more than one major number

- Enable usage as a module

- Support Cache fast write and DASD fast write (ECKD)

    cds

    3270

    debugging390

    driver-model

    monreader

    qeth

    vfio-ap

    vfio-ccw

    zfcpdump

    dasd

    common_io

    text_files

	select ARCH_INLINE_WRITE_UNLOCK_IRQRESTORE

	select ARCH_KEEP_MEMBLOCK

	select ARCH_SAVE_PAGE_KEYS if HIBERNATION

	select ARCH_STACKWALK

	select ARCH_SUPPORTS_ATOMIC_RMW

	select ARCH_SUPPORTS_NUMA_BALANCING

	select ARCH_USE_BUILTIN_BSWAP

	def_bool n

	select HAVE_MARCH_Z13_FEATURES

config HAVE_MARCH_Z15_FEATURES

	def_bool n

	select HAVE_MARCH_Z14_FEATURES

choice

	prompt "Processor type"

	default MARCH_Z196

	  and 3906 series). The kernel will be slightly faster but will not

	  work on older machines.

config MARCH_Z15

	bool "IBM z15"

	select HAVE_MARCH_Z15_FEATURES

	help

	  Select this to enable optimizations for IBM z15 (8562

	  and 8561 series). The kernel will be slightly faster but will not

	  work on older machines.

endchoice

config MARCH_Z900_TUNE

config MARCH_Z14_TUNE

	def_bool TUNE_Z14 || MARCH_Z14 && TUNE_DEFAULT

config MARCH_Z15_TUNE

	def_bool TUNE_Z15 || MARCH_Z15 && TUNE_DEFAULT

choice

	prompt "Tune code generation"

	default TUNE_DEFAULT

config TUNE_Z14

	bool "IBM z14"

config TUNE_Z15

	bool "IBM z15"

endchoice

config 64BIT

mflags-$(CONFIG_MARCH_ZEC12)  := -march=zEC12

mflags-$(CONFIG_MARCH_Z13)    := -march=z13

mflags-$(CONFIG_MARCH_Z14)    := -march=z14

mflags-$(CONFIG_MARCH_Z15)    := -march=z15

export CC_FLAGS_MARCH := $(mflags-y)

cflags-$(CONFIG_MARCH_ZEC12_TUNE)	+= -mtune=zEC12

cflags-$(CONFIG_MARCH_Z13_TUNE)		+= -mtune=z13

cflags-$(CONFIG_MARCH_Z14_TUNE)		+= -mtune=z14

cflags-$(CONFIG_MARCH_Z15_TUNE)		+= -mtune=z15

cflags-y += -Wa,-I$(srctree)/arch/$(ARCH)/include