1#ifndef _CSS_H
2#define _CSS_H
3
4#include <linux/mutex.h>
5#include <linux/wait.h>
6#include <linux/workqueue.h>
7#include <linux/device.h>
8#include <linux/types.h>
9
10#include <asm/cio.h>
11#include <asm/chpid.h>
12#include <asm/schid.h>
13
14#include "cio.h"
15
16/*
17 * path grouping stuff
18 */
19#define SPID_FUNC_SINGLE_PATH	   0x00
20#define SPID_FUNC_MULTI_PATH	   0x80
21#define SPID_FUNC_ESTABLISH	   0x00
22#define SPID_FUNC_RESIGN	   0x40
23#define SPID_FUNC_DISBAND	   0x20
24
25#define SNID_STATE1_RESET	   0
26#define SNID_STATE1_UNGROUPED	   2
27#define SNID_STATE1_GROUPED	   3
28
29#define SNID_STATE2_NOT_RESVD	   0
30#define SNID_STATE2_RESVD_ELSE	   2
31#define SNID_STATE2_RESVD_SELF	   3
32
33#define SNID_STATE3_MULTI_PATH	   1
34#define SNID_STATE3_SINGLE_PATH	   0
35
36struct path_state {
37	__u8  state1 : 2;	/* path state value 1 */
38	__u8  state2 : 2;	/* path state value 2 */
39	__u8  state3 : 1;	/* path state value 3 */
40	__u8  resvd  : 3;	/* reserved */
41} __attribute__ ((packed));
42
43struct extended_cssid {
44	u8 version;
45	u8 cssid;
46} __attribute__ ((packed));
47
48struct pgid {
49	union {
50		__u8 fc;   	/* SPID function code */
51		struct path_state ps;	/* SNID path state */
52	} __attribute__ ((packed)) inf;
53	union {
54		__u32 cpu_addr	: 16;	/* CPU address */
55		struct extended_cssid ext_cssid;
56	} __attribute__ ((packed)) pgid_high;
57	__u32 cpu_id	: 24;	/* CPU identification */
58	__u32 cpu_model : 16;	/* CPU model */
59	__u32 tod_high;		/* high word TOD clock */
60} __attribute__ ((packed));
61
62struct subchannel;
63struct chp_link;
64/**
65 * struct css_driver - device driver for subchannels
66 * @subchannel_type: subchannel type supported by this driver
67 * @drv: embedded device driver structure
68 * @irq: called on interrupts
69 * @chp_event: called for events affecting a channel path
70 * @sch_event: called for events affecting the subchannel
71 * @probe: function called on probe
72 * @remove: function called on remove
73 * @shutdown: called at device shutdown
74 * @prepare: prepare for pm state transition
75 * @complete: undo work done in @prepare
76 * @freeze: callback for freezing during hibernation snapshotting
77 * @thaw: undo work done in @freeze
78 * @restore: callback for restoring after hibernation
79 * @settle: wait for asynchronous work to finish
80 */
81struct css_driver {
82	struct css_device_id *subchannel_type;
83	struct device_driver drv;
84	void (*irq)(struct subchannel *);
85	int (*chp_event)(struct subchannel *, struct chp_link *, int);
86	int (*sch_event)(struct subchannel *, int);
87	int (*probe)(struct subchannel *);
88	int (*remove)(struct subchannel *);
89	void (*shutdown)(struct subchannel *);
90	int (*prepare) (struct subchannel *);
91	void (*complete) (struct subchannel *);
92	int (*freeze)(struct subchannel *);
93	int (*thaw) (struct subchannel *);
94	int (*restore)(struct subchannel *);
95	int (*settle)(void);
96};
97
98#define to_cssdriver(n) container_of(n, struct css_driver, drv)
99
100extern int css_driver_register(struct css_driver *);
101extern void css_driver_unregister(struct css_driver *);
102
103extern void css_sch_device_unregister(struct subchannel *);
104extern int css_probe_device(struct subchannel_id);
105extern struct subchannel *get_subchannel_by_schid(struct subchannel_id);
106extern int css_init_done;
107extern int max_ssid;
108int for_each_subchannel_staged(int (*fn_known)(struct subchannel *, void *),
109			       int (*fn_unknown)(struct subchannel_id,
110			       void *), void *data);
111extern int for_each_subchannel(int(*fn)(struct subchannel_id, void *), void *);
112extern void css_reiterate_subchannels(void);
113void css_update_ssd_info(struct subchannel *sch);
114
115#define __MAX_SUBCHANNEL 65535
116#define __MAX_SSID 3
117
118struct channel_subsystem {
119	u8 cssid;
120	int valid;
121	struct channel_path *chps[__MAX_CHPID + 1];
122	struct device device;
123	struct pgid global_pgid;
124	struct mutex mutex;
125	/* channel measurement related */
126	int cm_enabled;
127	void *cub_addr1;
128	void *cub_addr2;
129	/* for orphaned ccw devices */
130	struct subchannel *pseudo_subchannel;
131};
132#define to_css(dev) container_of(dev, struct channel_subsystem, device)
133
134extern struct channel_subsystem *channel_subsystems[];
135
136void channel_subsystem_reinit(void);
137
138/* Helper functions to build lists for the slow path. */
139void css_schedule_eval(struct subchannel_id schid);
140void css_schedule_eval_all(void);
141int css_complete_work(void);
142
143int sch_is_pseudo_sch(struct subchannel *);
144struct schib;
145int css_sch_is_valid(struct schib *);
146
147extern struct workqueue_struct *cio_work_q;
148void css_wait_for_slow_path(void);
149void css_sched_sch_todo(struct subchannel *sch, enum sch_todo todo);
150#endif
151