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

NAME

6       ccw_device_start_timeout - start a s390 channel program with timeout
7

SYNOPSIS

9       int ccw_device_start_timeout(struct ccw_device * cdev,
10                                    struct ccw1 * cpa, unsigned long intparm,
11                                    __u8 lpm, unsigned long flags,
12                                    int expires);
13

ARGUMENTS

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

DESCRIPTION

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

RETURNS

48       0, if the operation was successful; -EBUSY, if the device is busy, or
49       status pending; -EACCES, if no path specified in lpm is operational;
50       -ENODEV, if the device is not operational.
51

CONTEXT

53       Interrupts disabled, ccw device lock held
54

AUTHOR

56       Cornelia Huck <cornelia.huck@de.ibm.com>
57           Author.
58

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