mirror of
https://github.com/torvalds/linux.git
synced 2024-11-26 14:12:06 +00:00
bf18140d30
When a traditional channel-attached device transitions from not-ready to
ready state, an unsolicited DEVICE END I/O interrupt is raised. This
happens for example when a new file arrives in the z/VM virtual reader
device.
Change the Linux kernel to generate a change uevent when such an
interrupt occurs for any online unit record devices supported by the
vmur driver. This can be useful to automatically trigger processing of
files as they arrive in the reader device.
A sample udev rule for running a program when this event occurs looks as
follows:
ENV{DRIVER}=="vmur", ACTION=="change", ENV{EVENT}=="unsol_de", \
RUN{program}="/path/to/program"
The rule can be tested using the following steps:
1. Set reader device online (assuming default reader device number 000c)
$ chzdev -ea 0.0.000c
2. Force a ready-state transition using z/VM's READY CP command
$ vmcp ready 000c
Suggested-by: Alan Altmark <Alan_Altmark@us.ibm.com>
Reviewed-by: Heiko Carstens <hca@linux.ibm.com>
Reviewed-by: Sven Schnelle <svens@linux.ibm.com>
Signed-off-by: Peter Oberparleiter <oberpar@linux.ibm.com>
Signed-off-by: Vasily Gorbik <gor@linux.ibm.com>
116 lines
3.1 KiB
C
116 lines
3.1 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
/*
|
|
* Linux driver for System z and s390 unit record devices
|
|
* (z/VM virtual punch, reader, printer)
|
|
*
|
|
* Copyright IBM Corp. 2001, 2007
|
|
* Authors: Malcolm Beattie <beattiem@uk.ibm.com>
|
|
* Michael Holzheu <holzheu@de.ibm.com>
|
|
* Frank Munzert <munzert@de.ibm.com>
|
|
*/
|
|
|
|
#ifndef _VMUR_H_
|
|
#define _VMUR_H_
|
|
|
|
#include <linux/refcount.h>
|
|
#include <linux/workqueue.h>
|
|
|
|
#define DEV_CLASS_UR_I 0x20 /* diag210 unit record input device class */
|
|
#define DEV_CLASS_UR_O 0x10 /* diag210 unit record output device class */
|
|
/*
|
|
* we only support z/VM's default unit record devices:
|
|
* both in SPOOL directory control statement and in CP DEFINE statement
|
|
* RDR defaults to 2540 reader
|
|
* PUN defaults to 2540 punch
|
|
* PRT defaults to 1403 printer
|
|
*/
|
|
#define READER_PUNCH_DEVTYPE 0x2540
|
|
#define PRINTER_DEVTYPE 0x1403
|
|
|
|
/* z/VM spool file control block SFBLOK */
|
|
struct file_control_block {
|
|
char reserved_1[8];
|
|
char user_owner[8];
|
|
char user_orig[8];
|
|
__s32 data_recs;
|
|
__s16 rec_len;
|
|
__s16 file_num;
|
|
__u8 file_stat;
|
|
__u8 dev_type;
|
|
char reserved_2[6];
|
|
char file_name[12];
|
|
char file_type[12];
|
|
char create_date[8];
|
|
char create_time[8];
|
|
char reserved_3[6];
|
|
__u8 file_class;
|
|
__u8 sfb_lok;
|
|
__u64 distr_code;
|
|
__u32 reserved_4;
|
|
__u8 current_starting_copy_number;
|
|
__u8 sfblock_cntrl_flags;
|
|
__u8 reserved_5;
|
|
__u8 more_status_flags;
|
|
char rest[200];
|
|
} __attribute__ ((packed));
|
|
|
|
#define FLG_SYSTEM_HOLD 0x04
|
|
#define FLG_CP_DUMP 0x10
|
|
#define FLG_USER_HOLD 0x20
|
|
#define FLG_IN_USE 0x80
|
|
|
|
/*
|
|
* A struct urdev is created for each ur device that is made available
|
|
* via the ccw_device driver model.
|
|
*/
|
|
struct urdev {
|
|
struct ccw_device *cdev; /* Backpointer to ccw device */
|
|
struct mutex io_mutex; /* Serialises device IO */
|
|
struct completion *io_done; /* do_ur_io waits; irq completes */
|
|
struct device *device;
|
|
struct cdev *char_device;
|
|
struct ccw_dev_id dev_id; /* device id */
|
|
size_t reclen; /* Record length for *write* CCWs */
|
|
int class; /* VM device class */
|
|
int io_request_rc; /* return code from I/O request */
|
|
refcount_t ref_count; /* reference counter */
|
|
wait_queue_head_t wait; /* wait queue to serialize open */
|
|
int open_flag; /* "urdev is open" flag */
|
|
spinlock_t open_lock; /* serialize critical sections */
|
|
struct work_struct uevent_work; /* work to send uevent */
|
|
};
|
|
|
|
/*
|
|
* A struct urfile is allocated at open() time for each device and
|
|
* freed on release().
|
|
*/
|
|
struct urfile {
|
|
struct urdev *urd;
|
|
unsigned int flags;
|
|
size_t dev_reclen;
|
|
__u16 file_reclen;
|
|
};
|
|
|
|
/*
|
|
* Device major/minor definitions.
|
|
*/
|
|
|
|
#define UR_MAJOR 0 /* get dynamic major */
|
|
/*
|
|
* We map minor numbers directly to device numbers (0-FFFF) for simplicity.
|
|
* This avoids having to allocate (and manage) slot numbers.
|
|
*/
|
|
#define NUM_MINORS 65536
|
|
|
|
/* Limiting each I/O to 511 records limits chan prog to 4KB (511 r/w + 1 NOP) */
|
|
#define MAX_RECS_PER_IO 511
|
|
#define WRITE_CCW_CMD 0x01
|
|
|
|
#define TRACE(x...) debug_sprintf_event(vmur_dbf, 1, x)
|
|
#define CCWDEV_CU_DI(cutype, di) \
|
|
CCW_DEVICE(cutype, 0x00), .driver_info = (di)
|
|
|
|
#define FILE_RECLEN_OFFSET 4064 /* reclen offset in spool data block */
|
|
|
|
#endif /* _VMUR_H_ */
|