1CCW_DEVICE_START_TIM(9)           The ccw bus          CCW_DEVICE_START_TIM(9)
2
3
4

NAME

6       ccw_device_start_timeout_key - start a s390 channel program with
7       timeout and key
8

SYNOPSIS

10       int ccw_device_start_timeout_key(struct ccw_device * cdev,
11                                        struct ccw1 * cpa,
12                                        unsigned long intparm, __u8 lpm,
13                                        __u8 key, unsigned long flags,
14                                        int expires);
15

ARGUMENTS

17       cdev
18           target ccw device
19
20       cpa
21           logical start address of channel program
22
23       intparm
24           user specific interruption parameter; will be presented back to
25           cdev´s interrupt handler. Allows a device driver to associate the
26           interrupt with a particular I/O request.
27
28       lpm
29           defines the channel path to be used for a specific I/O request. A
30           value of 0 will make cio use the opm.
31
32       key
33           storage key to be used for the I/O
34
35       flags
36           additional flags; defines the action to be performed for I/O
37           processing.
38
39       expires
40           timeout value in jiffies
41

DESCRIPTION

43       Start a S/390 channel program. When the interrupt arrives, the IRQ
44       handler is called, either immediately, delayed (dev-end missing, or
45       sense required) or never (no IRQ handler registered). This function
46       notifies the device driver if the channel program has not completed
47       during the time specified by expires. If a timeout occurs, the channel
48       program is terminated via xsch, hsch or csch, and the device´s
49       interrupt handler will be called with an irb containing
50       ERR_PTR(-ETIMEDOUT).
51

RETURNS

53       0, if the operation was successful; -EBUSY, if the device is busy, or
54       status pending; -EACCES, if no path specified in lpm is operational;
55       -ENODEV, if the device is not operational.
56

CONTEXT

58       Interrupts disabled, ccw device lock held
59

AUTHOR

61       Cornelia Huck <cornelia.huck@de.ibm.com>
62           Author.
63

65Kernel Hackers Manual 2.6.         June 2019           CCW_DEVICE_START_TIM(9)
Impressum