[mirror_ubuntu-bionic-kernel.git] / drivers / s390 / char / tape.h

/* SPDX-License-Identifier: GPL-2.0 */
/*
 *    tape device driver for 3480/3490E/3590 tapes.
 *
 *  S390 and zSeries version
 *    Copyright IBM Corp. 2001, 2009
 *    Author(s): Carsten Otte <cotte@de.ibm.com>
 *		 Tuan Ngo-Anh <ngoanh@de.ibm.com>
 *		 Martin Schwidefsky <schwidefsky@de.ibm.com>
 *		 Stefan Bader <shbader@de.ibm.com>
 */

#ifndef _TAPE_H
#define _TAPE_H

#include <asm/ccwdev.h>
#include <asm/debug.h>
#include <asm/idals.h>
#include <linux/kernel.h>
#include <linux/module.h>
#include <linux/mtio.h>
#include <linux/interrupt.h>
#include <linux/workqueue.h>

struct gendisk;

/*
 * Define DBF_LIKE_HELL for lots of messages in the debug feature.
 */
#define DBF_LIKE_HELL
#ifdef  DBF_LIKE_HELL
#define DBF_LH(level, str, ...) \
do { \
	debug_sprintf_event(TAPE_DBF_AREA, level, str, ## __VA_ARGS__); \
} while (0)
#else
#define DBF_LH(level, str, ...) do {} while(0)
#endif

/*
 * macros s390 debug feature (dbf)
 */
#define DBF_EVENT(d_level, d_str...) \
do { \
	debug_sprintf_event(TAPE_DBF_AREA, d_level, d_str); \
} while (0)

#define DBF_EXCEPTION(d_level, d_str...) \
do { \
	debug_sprintf_exception(TAPE_DBF_AREA, d_level, d_str); \
} while (0)

#define TAPE_VERSION_MAJOR 2
#define TAPE_VERSION_MINOR 0
#define TAPE_MAGIC "tape"

#define TAPE_MINORS_PER_DEV 2	    /* two minors per device */
#define TAPEBLOCK_HSEC_SIZE	2048
#define TAPEBLOCK_HSEC_S2B	2
#define TAPEBLOCK_RETRIES	5

enum tape_medium_state {
	MS_UNKNOWN,
	MS_LOADED,
	MS_UNLOADED,
	MS_SIZE
};

enum tape_state {
	TS_UNUSED=0,
	TS_IN_USE,
	TS_BLKUSE,
	TS_INIT,
	TS_NOT_OPER,
	TS_SIZE
};

enum tape_op {
	TO_BLOCK,	/* Block read */
	TO_BSB,		/* Backward space block */
	TO_BSF,		/* Backward space filemark */
	TO_DSE,		/* Data security erase */
	TO_FSB,		/* Forward space block */
	TO_FSF,		/* Forward space filemark */
	TO_LBL,		/* Locate block label */
	TO_NOP,		/* No operation */
	TO_RBA,		/* Read backward */
	TO_RBI,		/* Read block information */
	TO_RFO,		/* Read forward */
	TO_REW,		/* Rewind tape */
	TO_RUN,		/* Rewind and unload tape */
	TO_WRI,		/* Write block */
	TO_WTM,		/* Write tape mark */
	TO_MSEN,	/* Medium sense */
	TO_LOAD,	/* Load tape */
	TO_READ_CONFIG, /* Read configuration data */
	TO_READ_ATTMSG, /* Read attention message */
	TO_DIS,		/* Tape display */
	TO_ASSIGN,	/* Assign tape to channel path */
	TO_UNASSIGN,	/* Unassign tape from channel path */
	TO_CRYPT_ON,	/* Enable encrpytion */
	TO_CRYPT_OFF,	/* Disable encrpytion */
	TO_KEKL_SET,	/* Set KEK label */
	TO_KEKL_QUERY,	/* Query KEK label */
	TO_RDC,		/* Read device characteristics */
	TO_SIZE,	/* #entries in tape_op_t */
};

/* Forward declaration */
struct tape_device;

/* tape_request->status can be: */
enum tape_request_status {
	TAPE_REQUEST_INIT,	/* request is ready to be processed */
	TAPE_REQUEST_QUEUED,	/* request is queued to be processed */
	TAPE_REQUEST_IN_IO,	/* request is currently in IO */
	TAPE_REQUEST_DONE,	/* request is completed. */
	TAPE_REQUEST_CANCEL,	/* request should be canceled. */
	TAPE_REQUEST_LONG_BUSY, /* request has to be restarted after long busy */
};

/* Tape CCW request */
struct tape_request {
	struct list_head list;		/* list head for request queueing. */
	struct tape_device *device;	/* tape device of this request */
	struct ccw1 *cpaddr;		/* address of the channel program. */
	void *cpdata;			/* pointer to ccw data. */
	enum tape_request_status status;/* status of this request */
	int options;			/* options for execution. */
	int retries;			/* retry counter for error recovery. */
	int rescnt;			/* residual count from devstat. */
	struct timer_list timer;	/* timer for std_assign_timeout(). */

	/* Callback for delivering final status. */
	void (*callback)(struct tape_request *, void *);
	void *callback_data;

	enum tape_op op;
	int rc;
};

/* Function type for magnetic tape commands */
typedef int (*tape_mtop_fn)(struct tape_device *, int);

/* Size of the array containing the mtops for a discipline */
#define TAPE_NR_MTOPS (MTMKPART+1)

/* Tape Discipline */
struct tape_discipline {
	struct module *owner;
	int  (*setup_device)(struct tape_device *);
	void (*cleanup_device)(struct tape_device *);
	int (*irq)(struct tape_device *, struct tape_request *, struct irb *);
	struct tape_request *(*read_block)(struct tape_device *, size_t);
	struct tape_request *(*write_block)(struct tape_device *, size_t);
	void (*process_eov)(struct tape_device*);
	/* ioctl function for additional ioctls. */
	int (*ioctl_fn)(struct tape_device *, unsigned int, unsigned long);
	/* Array of tape commands with TAPE_NR_MTOPS entries */
	tape_mtop_fn *mtop_array;
};

/*
 * The discipline irq function either returns an error code (<0) which
 * means that the request has failed with an error or one of the following:
 */
#define TAPE_IO_SUCCESS		0	/* request successful */
#define TAPE_IO_PENDING		1	/* request still running */
#define TAPE_IO_RETRY		2	/* retry to current request */
#define TAPE_IO_STOP		3	/* stop the running request */
#define TAPE_IO_LONG_BUSY	4	/* delay the running request */

/* Char Frontend Data */
struct tape_char_data {
	struct idal_buffer *idal_buf;	/* idal buffer for user char data */
	int block_size;			/*   of size block_size. */
};

/* Tape Info */
struct tape_device {
	/* entry in tape_device_list */
	struct list_head		node;

	int				cdev_id;
	struct ccw_device *		cdev;
	struct tape_class_device *	nt;
	struct tape_class_device *	rt;

	/* Device mutex to serialize tape commands. */
	struct mutex			mutex;

	/* Device discipline information. */
	struct tape_discipline *	discipline;
	void *				discdata;

	/* Generic status flags */
	long				tape_generic_status;

	/* Device state information. */
	wait_queue_head_t		state_change_wq;
	enum tape_state			tape_state;
	enum tape_medium_state		medium_state;
	unsigned char *			modeset_byte;

	/* Reference count. */
	atomic_t			ref_count;

	/* Request queue. */
	struct list_head		req_queue;

	/* Request wait queue. */
	wait_queue_head_t		wait_queue;

	/* Each tape device has (currently) two minor numbers. */
	int				first_minor;

	/* Number of tapemarks required for correct termination. */
	int				required_tapemarks;

	/* Block ID of the BOF */
	unsigned int			bof;

	/* Character device frontend data */
	struct tape_char_data		char_data;

	/* Function to start or stop the next request later. */
	struct delayed_work		tape_dnr;

	/* Timer for long busy */
	struct timer_list		lb_timeout;

};

/* Externals from tape_core.c */
extern struct tape_request *tape_alloc_request(int cplength, int datasize);
extern void tape_free_request(struct tape_request *);
extern int tape_do_io(struct tape_device *, struct tape_request *);
extern int tape_do_io_async(struct tape_device *, struct tape_request *);
extern int tape_do_io_interruptible(struct tape_device *, struct tape_request *);
extern int tape_cancel_io(struct tape_device *, struct tape_request *);
void tape_hotplug_event(struct tape_device *, int major, int action);

static inline int
tape_do_io_free(struct tape_device *device, struct tape_request *request)
{
	int rc;

	rc = tape_do_io(device, request);
	tape_free_request(request);
	return rc;
}

static inline void
tape_do_io_async_free(struct tape_device *device, struct tape_request *request)
{
	request->callback = (void *) tape_free_request;
	request->callback_data = NULL;
	tape_do_io_async(device, request);
}

extern int tape_oper_handler(int irq, int status);
extern void tape_noper_handler(int irq, int status);
extern int tape_open(struct tape_device *);
extern int tape_release(struct tape_device *);
extern int tape_mtop(struct tape_device *, int, int);
extern void tape_state_set(struct tape_device *, enum tape_state);

extern int tape_generic_online(struct tape_device *, struct tape_discipline *);
extern int tape_generic_offline(struct ccw_device *);
extern int tape_generic_pm_suspend(struct ccw_device *);

/* Externals from tape_devmap.c */
extern int tape_generic_probe(struct ccw_device *);
extern void tape_generic_remove(struct ccw_device *);

extern struct tape_device *tape_find_device(int devindex);
extern struct tape_device *tape_get_device(struct tape_device *);
extern void tape_put_device(struct tape_device *);

/* Externals from tape_char.c */
extern int tapechar_init(void);
extern void tapechar_exit(void);
extern int  tapechar_setup_device(struct tape_device *);
extern void tapechar_cleanup_device(struct tape_device *);

/* tape initialisation functions */
#ifdef CONFIG_PROC_FS
extern void tape_proc_init (void);
extern void tape_proc_cleanup (void);
#else
static inline void tape_proc_init (void) {;}
static inline void tape_proc_cleanup (void) {;}
#endif

/* a function for dumping device sense info */
extern void tape_dump_sense_dbf(struct tape_device *, struct tape_request *,
				struct irb *);

/* functions for handling the status of a device */
extern void tape_med_state_set(struct tape_device *, enum tape_medium_state);

/* The debug area */
extern debug_info_t *TAPE_DBF_AREA;

/* functions for building ccws */
static inline struct ccw1 *
tape_ccw_cc(struct ccw1 *ccw, __u8 cmd_code, __u16 memsize, void *cda)
{
	ccw->cmd_code = cmd_code;
	ccw->flags = CCW_FLAG_CC;
	ccw->count = memsize;
	ccw->cda = (__u32)(addr_t) cda;
	return ccw + 1;
}

static inline struct ccw1 *
tape_ccw_end(struct ccw1 *ccw, __u8 cmd_code, __u16 memsize, void *cda)
{
	ccw->cmd_code = cmd_code;
	ccw->flags = 0;
	ccw->count = memsize;
	ccw->cda = (__u32)(addr_t) cda;
	return ccw + 1;
}

static inline struct ccw1 *
tape_ccw_cmd(struct ccw1 *ccw, __u8 cmd_code)
{
	ccw->cmd_code = cmd_code;
	ccw->flags = 0;
	ccw->count = 0;
	ccw->cda = (__u32)(addr_t) &ccw->cmd_code;
	return ccw + 1;
}

static inline struct ccw1 *
tape_ccw_repeat(struct ccw1 *ccw, __u8 cmd_code, int count)
{
	while (count-- > 0) {
		ccw->cmd_code = cmd_code;
		ccw->flags = CCW_FLAG_CC;
		ccw->count = 0;
		ccw->cda = (__u32)(addr_t) &ccw->cmd_code;
		ccw++;
	}
	return ccw;
}

static inline struct ccw1 *
tape_ccw_cc_idal(struct ccw1 *ccw, __u8 cmd_code, struct idal_buffer *idal)
{
	ccw->cmd_code = cmd_code;
	ccw->flags    = CCW_FLAG_CC;
	idal_buffer_set_cda(idal, ccw);
	return ccw++;
}

static inline struct ccw1 *
tape_ccw_end_idal(struct ccw1 *ccw, __u8 cmd_code, struct idal_buffer *idal)
{
	ccw->cmd_code = cmd_code;
	ccw->flags    = 0;
	idal_buffer_set_cda(idal, ccw);
	return ccw++;
}

/* Global vars */
extern const char *tape_state_verbose[];
extern const char *tape_op_verbose[];

#endif /* for ifdef tape.h */
Commit	Line	Data
b2441318	1	/* SPDX-License-Identifier: GPL-2.0 */
1da177e4	2	/*
1da177e4 LT	3	* tape device driver for 3480/3490E/3590 tapes.
	4	*
	5	* S390 and zSeries version
3ef32e62	6	* Copyright IBM Corp. 2001, 2009
1da177e4 LT	7	* Author(s): Carsten Otte <cotte@de.ibm.com>
	8	* Tuan Ngo-Anh <ngoanh@de.ibm.com>
	9	* Martin Schwidefsky <schwidefsky@de.ibm.com>
4111796d	10	* Stefan Bader <shbader@de.ibm.com>
1da177e4 LT	11	*/
	12
	13	#ifndef _TAPE_H
	14	#define _TAPE_H
	15
	16	#include <asm/ccwdev.h>
	17	#include <asm/debug.h>
	18	#include <asm/idals.h>
1da177e4 LT	19	#include <linux/kernel.h>
	20	#include <linux/module.h>
	21	#include <linux/mtio.h>
	22	#include <linux/interrupt.h>
	23	#include <linux/workqueue.h>
	24
	25	struct gendisk;
	26
	27	/*
	28	* Define DBF_LIKE_HELL for lots of messages in the debug feature.
	29	*/
	30	#define DBF_LIKE_HELL
	31	#ifdef DBF_LIKE_HELL
	32	#define DBF_LH(level, str, ...) \
	33	do { \
	34	debug_sprintf_event(TAPE_DBF_AREA, level, str, ## __VA_ARGS__); \
	35	} while (0)
	36	#else
	37	#define DBF_LH(level, str, ...) do {} while(0)
	38	#endif
	39
	40	/*
	41	* macros s390 debug feature (dbf)
	42	*/
	43	#define DBF_EVENT(d_level, d_str...) \
	44	do { \
	45	debug_sprintf_event(TAPE_DBF_AREA, d_level, d_str); \
	46	} while (0)
	47
	48	#define DBF_EXCEPTION(d_level, d_str...) \
	49	do { \
	50	debug_sprintf_exception(TAPE_DBF_AREA, d_level, d_str); \
	51	} while (0)
	52
	53	#define TAPE_VERSION_MAJOR 2
	54	#define TAPE_VERSION_MINOR 0
	55	#define TAPE_MAGIC "tape"
	56
	57	#define TAPE_MINORS_PER_DEV 2 /* two minors per device */
	58	#define TAPEBLOCK_HSEC_SIZE 2048
	59	#define TAPEBLOCK_HSEC_S2B 2
	60	#define TAPEBLOCK_RETRIES 5
	61
	62	enum tape_medium_state {
	63	MS_UNKNOWN,
	64	MS_LOADED,
	65	MS_UNLOADED,
	66	MS_SIZE
	67	};
	68
	69	enum tape_state {
	70	TS_UNUSED=0,
	71	TS_IN_USE,
	72	TS_BLKUSE,
	73	TS_INIT,
	74	TS_NOT_OPER,
	75	TS_SIZE
	76	};
	77
	78	enum tape_op {
	79	TO_BLOCK, /* Block read */
	80	TO_BSB, /* Backward space block */
	81	TO_BSF, /* Backward space filemark */
	82	TO_DSE, /* Data security erase */
83	TO_FSB, /* Forward space block */
84	TO_FSF, /* Forward space filemark */
85	TO_LBL, /* Locate block label */
86	TO_NOP, /* No operation */
87	TO_RBA, /* Read backward */
88	TO_RBI, /* Read block information */
89	TO_RFO, /* Read forward */
90	TO_REW, /* Rewind tape */
91	TO_RUN, /* Rewind and unload tape */
92	TO_WRI, /* Write block */
93	TO_WTM, /* Write tape mark */
94	TO_MSEN, /* Medium sense */
95	TO_LOAD, /* Load tape */
96	TO_READ_CONFIG, /* Read configuration data */
97	TO_READ_ATTMSG, /* Read attention message */
98	TO_DIS, /* Tape display */
99	TO_ASSIGN, /* Assign tape to channel path */
100	TO_UNASSIGN, /* Unassign tape from channel path */
cced1dd4 MH	101	TO_CRYPT_ON, /* Enable encrpytion */
	102	TO_CRYPT_OFF, /* Disable encrpytion */
	103	TO_KEKL_SET, /* Set KEK label */
	104	TO_KEKL_QUERY, /* Query KEK label */
e2963062	105	TO_RDC, /* Read device characteristics */
cced1dd4	106	TO_SIZE, /* #entries in tape_op_t */
1da177e4 LT	107	};
	108
	109	/* Forward declaration */
	110	struct tape_device;
	111
	112	/* tape_request->status can be: */
	113	enum tape_request_status {
	114	TAPE_REQUEST_INIT, /* request is ready to be processed */
	115	TAPE_REQUEST_QUEUED, /* request is queued to be processed */
	116	TAPE_REQUEST_IN_IO, /* request is currently in IO */
	117	TAPE_REQUEST_DONE, /* request is completed. */
4111796d	118	TAPE_REQUEST_CANCEL, /* request should be canceled. */
cced1dd4	119	TAPE_REQUEST_LONG_BUSY, /* request has to be restarted after long busy */
1da177e4 LT	120	};
	121
	122	/* Tape CCW request */
	123	struct tape_request {
	124	struct list_head list; /* list head for request queueing. */
	125	struct tape_device device; / tape device of this request */
	126	struct ccw1 cpaddr; / address of the channel program. */
	127	void cpdata; / pointer to ccw data. */
	128	enum tape_request_status status;/* status of this request */
	129	int options; /* options for execution. */
	130	int retries; /* retry counter for error recovery. */
	131	int rescnt; /* residual count from devstat. */
9c6c273a	132	struct timer_list timer; /* timer for std_assign_timeout(). */
1da177e4 LT	133
	134	/* Callback for delivering final status. */
	135	void (callback)(struct tape_request , void *);
	136	void *callback_data;
	137
	138	enum tape_op op;
	139	int rc;
	140	};
	141
	142	/* Function type for magnetic tape commands */
	143	typedef int (tape_mtop_fn)(struct tape_device , int);
	144
	145	/* Size of the array containing the mtops for a discipline */
	146	#define TAPE_NR_MTOPS (MTMKPART+1)
	147
	148	/* Tape Discipline */
	149	struct tape_discipline {
	150	struct module *owner;
	151	int (setup_device)(struct tape_device );
	152	void (cleanup_device)(struct tape_device );
	153	int (irq)(struct tape_device , struct tape_request , struct irb );
	154	struct tape_request (read_block)(struct tape_device *, size_t);
	155	struct tape_request (write_block)(struct tape_device *, size_t);
	156	void (process_eov)(struct tape_device);
1da177e4 LT	157	/* ioctl function for additional ioctls. */
	158	int (ioctl_fn)(struct tape_device , unsigned int, unsigned long);
	159	/* Array of tape commands with TAPE_NR_MTOPS entries */
	160	tape_mtop_fn *mtop_array;
	161	};
	162
	163	/*
	164	* The discipline irq function either returns an error code (<0) which
	165	* means that the request has failed with an error or one of the following:
	166	*/
cced1dd4 MH	167	#define TAPE_IO_SUCCESS 0 /* request successful */
	168	#define TAPE_IO_PENDING 1 /* request still running */
	169	#define TAPE_IO_RETRY 2 /* retry to current request */
	170	#define TAPE_IO_STOP 3 /* stop the running request */
	171	#define TAPE_IO_LONG_BUSY 4 /* delay the running request */
1da177e4 LT	172
	173	/* Char Frontend Data */
	174	struct tape_char_data {
	175	struct idal_buffer idal_buf; / idal buffer for user char data */
	176	int block_size; /* of size block_size. */
	177	};
	178
1da177e4 LT	179	/* Tape Info */
	180	struct tape_device {
	181	/* entry in tape_device_list */
	182	struct list_head node;
	183
	184	int cdev_id;
	185	struct ccw_device * cdev;
	186	struct tape_class_device * nt;
	187	struct tape_class_device * rt;
	188
369a4632 MS	189	/* Device mutex to serialize tape commands. */
	190	struct mutex mutex;
	191
1da177e4 LT	192	/* Device discipline information. */
	193	struct tape_discipline * discipline;
	194	void * discdata;
	195
	196	/* Generic status flags */
	197	long tape_generic_status;
	198
	199	/* Device state information. */
	200	wait_queue_head_t state_change_wq;
	201	enum tape_state tape_state;
	202	enum tape_medium_state medium_state;
	203	unsigned char * modeset_byte;
	204
	205	/* Reference count. */
	206	atomic_t ref_count;
	207
	208	/* Request queue. */
	209	struct list_head req_queue;
	210
4657fb8a MS	211	/* Request wait queue. */
	212	wait_queue_head_t wait_queue;
	213
1da177e4 LT	214	/* Each tape device has (currently) two minor numbers. */
	215	int first_minor;
	216
	217	/* Number of tapemarks required for correct termination. */
	218	int required_tapemarks;
	219
	220	/* Block ID of the BOF */
	221	unsigned int bof;
	222
	223	/* Character device frontend data */
	224	struct tape_char_data char_data;
4111796d SB	225
4111796d SB	226	/* Function to start or stop the next request later. */
c1637532	227	struct delayed_work tape_dnr;
cced1dd4 MH	228
	229	/* Timer for long busy */
	230	struct timer_list lb_timeout;
	231
1da177e4 LT	232	};
	233
	234	/* Externals from tape_core.c */
	235	extern struct tape_request *tape_alloc_request(int cplength, int datasize);
	236	extern void tape_free_request(struct tape_request *);
	237	extern int tape_do_io(struct tape_device , struct tape_request );
	238	extern int tape_do_io_async(struct tape_device , struct tape_request );
	239	extern int tape_do_io_interruptible(struct tape_device , struct tape_request );
5f384338	240	extern int tape_cancel_io(struct tape_device , struct tape_request );
1da177e4 LT	241	void tape_hotplug_event(struct tape_device *, int major, int action);
	242
	243	static inline int
	244	tape_do_io_free(struct tape_device device, struct tape_request request)
	245	{
	246	int rc;
	247
	248	rc = tape_do_io(device, request);
	249	tape_free_request(request);
	250	return rc;
	251	}
	252
0c2bd9b2 MS	253	static inline void
	254	tape_do_io_async_free(struct tape_device device, struct tape_request request)
	255	{
	256	request->callback = (void *) tape_free_request;
	257	request->callback_data = NULL;
	258	tape_do_io_async(device, request);
	259	}
	260
1da177e4 LT	261	extern int tape_oper_handler(int irq, int status);
	262	extern void tape_noper_handler(int irq, int status);
	263	extern int tape_open(struct tape_device *);
	264	extern int tape_release(struct tape_device *);
	265	extern int tape_mtop(struct tape_device *, int, int);
	266	extern void tape_state_set(struct tape_device *, enum tape_state);
	267
	268	extern int tape_generic_online(struct tape_device , struct tape_discipline );
4d7a3cdf	269	extern int tape_generic_offline(struct ccw_device *);
3ef32e62	270	extern int tape_generic_pm_suspend(struct ccw_device *);
1da177e4 LT	271
	272	/* Externals from tape_devmap.c */
	273	extern int tape_generic_probe(struct ccw_device *);
	274	extern void tape_generic_remove(struct ccw_device *);
	275
8fd138c3 MS	276	extern struct tape_device *tape_find_device(int devindex);
	277	extern struct tape_device tape_get_device(struct tape_device );
	278	extern void tape_put_device(struct tape_device *);
1da177e4 LT	279
	280	/* Externals from tape_char.c */
	281	extern int tapechar_init(void);
	282	extern void tapechar_exit(void);
	283	extern int tapechar_setup_device(struct tape_device *);
	284	extern void tapechar_cleanup_device(struct tape_device *);
	285
1da177e4 LT	286	/* tape initialisation functions */
	287	#ifdef CONFIG_PROC_FS
	288	extern void tape_proc_init (void);
	289	extern void tape_proc_cleanup (void);
	290	#else
	291	static inline void tape_proc_init (void) {;}
	292	static inline void tape_proc_cleanup (void) {;}
	293	#endif
	294
	295	/* a function for dumping device sense info */
1da177e4 LT	296	extern void tape_dump_sense_dbf(struct tape_device , struct tape_request ,
	297	struct irb *);
	298
	299	/* functions for handling the status of a device */
	300	extern void tape_med_state_set(struct tape_device *, enum tape_medium_state);
	301
	302	/* The debug area */
	303	extern debug_info_t *TAPE_DBF_AREA;
	304
	305	/* functions for building ccws */
	306	static inline struct ccw1 *
	307	tape_ccw_cc(struct ccw1 ccw, __u8 cmd_code, __u16 memsize, void cda)
	308	{
	309	ccw->cmd_code = cmd_code;
	310	ccw->flags = CCW_FLAG_CC;
	311	ccw->count = memsize;
	312	ccw->cda = (__u32)(addr_t) cda;
	313	return ccw + 1;
	314	}
	315
	316	static inline struct ccw1 *
	317	tape_ccw_end(struct ccw1 ccw, __u8 cmd_code, __u16 memsize, void cda)
	318	{
	319	ccw->cmd_code = cmd_code;
	320	ccw->flags = 0;
	321	ccw->count = memsize;
	322	ccw->cda = (__u32)(addr_t) cda;
	323	return ccw + 1;
	324	}
	325
	326	static inline struct ccw1 *
	327	tape_ccw_cmd(struct ccw1 *ccw, __u8 cmd_code)
	328	{
	329	ccw->cmd_code = cmd_code;
	330	ccw->flags = 0;
	331	ccw->count = 0;
	332	ccw->cda = (__u32)(addr_t) &ccw->cmd_code;
	333	return ccw + 1;
	334	}
	335
	336	static inline struct ccw1 *
	337	tape_ccw_repeat(struct ccw1 *ccw, __u8 cmd_code, int count)
	338	{
	339	while (count-- > 0) {
	340	ccw->cmd_code = cmd_code;
	341	ccw->flags = CCW_FLAG_CC;
	342	ccw->count = 0;
	343	ccw->cda = (__u32)(addr_t) &ccw->cmd_code;
	344	ccw++;
	345	}
	346	return ccw;
	347	}
	348
	349	static inline struct ccw1 *
	350	tape_ccw_cc_idal(struct ccw1 ccw, __u8 cmd_code, struct idal_buffer idal)
	351	{
	352	ccw->cmd_code = cmd_code;
	353	ccw->flags = CCW_FLAG_CC;
	354	idal_buffer_set_cda(idal, ccw);
	355	return ccw++;
	356	}
	357
	358	static inline struct ccw1 *
	359	tape_ccw_end_idal(struct ccw1 ccw, __u8 cmd_code, struct idal_buffer idal)
360	{
361	ccw->cmd_code = cmd_code;
362	ccw->flags = 0;
363	idal_buffer_set_cda(idal, ccw);
364	return ccw++;
365	}
366
367	/* Global vars */
368	extern const char *tape_state_verbose[];
369	extern const char *tape_op_verbose[];
370
371	#endif /* for ifdef tape.h */