Quelle  tape_std.h   Sprache: C

/* SPDX-License-Identifier: GPL-2.0 */
/*
 *    standard tape device functions for ibm tapes.
 *
 *    Copyright IBM Corp. 2001, 2006
 *    Author(s): Carsten Otte <cotte@de.ibm.com>
 *  Tuan Ngo-Anh <ngoanh@de.ibm.com>
 *  Martin Schwidefsky <schwidefsky@de.ibm.com>
 */

#ifndef _TAPE_STD_H
#define _TAPE_STD_H

#include <asm/tape390.h>

/*
 * Biggest block size to handle. Currently 64K because we only build
 * channel programs without data chaining.
 */
#define MAX_BLOCKSIZE   65535

/*
 * The CCW commands for the Tape type of command.
 */
#define INVALID_00  0x00 /* Invalid cmd */
#define BACKSPACEBLOCK  0x27 /* Back Space block */
#define BACKSPACEFILE  0x2f /* Back Space file */
#define DATA_SEC_ERASE  0x97 /* Data security erase */
#define ERASE_GAP  0x17 /* Erase Gap */
#define FORSPACEBLOCK  0x37 /* Forward space block */
#define FORSPACEFILE  0x3F /* Forward Space file */
#define FORCE_STREAM_CNT 0xEB /* Forced streaming count # */
#define NOP   0x03 /* No operation */
#define READ_FORWARD  0x02 /* Read forward */
#define REWIND   0x07 /* Rewind */
#define REWIND_UNLOAD  0x0F /* Rewind and Unload */
#define SENSE   0x04 /* Sense */
#define NEW_MODE_SET  0xEB /* Guess it is Mode set */
#define WRITE_CMD  0x01 /* Write */
#define WRITETAPEMARK  0x1F /* Write Tape Mark */

#define ASSIGN   0xB7 /* 3420 REJECT,3480 OK */
#define CONTROL_ACCESS  0xE3 /* Set high speed */
#define DIAG_MODE_SET  0x0B /* 3420 NOP, 3480 REJECT */
#define LOAD_DISPLAY  0x9F /* 3420 REJECT,3480 OK */
#define LOCATE   0x4F /* 3420 REJ, 3480 NOP */
#define LOOP_WRITE_TO_READ 0x8B /* 3480 REJECT */
#define MODE_SET_DB  0xDB /* 3420 REJECT,3480 OK */
#define MODE_SET_C3  0xC3 /* for 3420 */
#define MODE_SET_CB  0xCB /* for 3420 */
#define MODE_SET_D3  0xD3 /* for 3420 */
#define READ_BACKWARD  0x0C /* */
#define READ_BLOCK_ID  0x22 /* 3420 REJECT,3480 OK */
#define READ_BUFFER  0x12 /* 3420 REJECT,3480 OK */
#define READ_BUFF_LOG  0x24 /* 3420 REJECT,3480 OK */
#define RELEASE   0xD4 /* 3420 NOP, 3480 REJECT */
#define REQ_TRK_IN_ERROR 0x1B /* 3420 NOP, 3480 REJECT */
#define RESERVE   0xF4 /* 3420 NOP, 3480 REJECT */
#define SENSE_GROUP_ID  0x34 /* 3420 REJECT,3480 OK */
#define SENSE_ID  0xE4 /* 3420 REJECT,3480 OK */
#define READ_DEV_CHAR  0x64 /* Read device characteristics */
#define SET_DIAGNOSE  0x4B /* 3420 NOP, 3480 REJECT */
#define SET_GROUP_ID  0xAF /* 3420 REJECT,3480 OK */
#define SET_TAPE_WRITE_IMMED 0xC3 /* for 3480 */
#define SUSPEND   0x5B /* 3420 REJ, 3480 NOP */
#define SYNC   0x43 /* Synchronize (flush buffer) */
#define UNASSIGN  0xC7 /* 3420 REJECT,3480 OK */
#define PERF_SUBSYS_FUNC 0x77 /* 3490 CMD */
#define READ_CONFIG_DATA 0xFA /* 3490 CMD */
#define READ_MESSAGE_ID  0x4E /* 3490 CMD */
#define READ_SUBSYS_DATA 0x3E /* 3490 CMD */
#define SET_INTERFACE_ID 0x73 /* 3490 CMD */

#define SENSE_COMMAND_REJECT  0x80
#define SENSE_INTERVENTION_REQUIRED 0x40
#define SENSE_BUS_OUT_CHECK  0x20
#define SENSE_EQUIPMENT_CHECK  0x10
#define SENSE_DATA_CHECK  0x08
#define SENSE_OVERRUN   0x04
#define SENSE_DEFERRED_UNIT_CHECK 0x02
#define SENSE_ASSIGNED_ELSEWHERE 0x01

#define SENSE_LOCATE_FAILURE  0x80
#define SENSE_DRIVE_ONLINE  0x40
#define SENSE_RESERVED   0x20
#define SENSE_RECORD_SEQUENCE_ERR 0x10
#define SENSE_BEGINNING_OF_TAPE  0x08
#define SENSE_WRITE_MODE  0x04
#define SENSE_WRITE_PROTECT  0x02
#define SENSE_NOT_CAPABLE  0x01

#define SENSE_CHANNEL_ADAPTER_CODE 0xE0
#define SENSE_CHANNEL_ADAPTER_LOC 0x10
#define SENSE_REPORTING_CU  0x08
#define SENSE_AUTOMATIC_LOADER  0x04
#define SENSE_TAPE_SYNC_MODE  0x02
#define SENSE_TAPE_POSITIONING  0x01

/* discipline functions */
struct tape_request *tape_std_read_block(struct tape_device *, size_t);
void tape_std_read_backward(struct tape_device *device,
       struct tape_request *request);
struct tape_request *tape_std_write_block(struct tape_device *, size_t);

/* Some non-mtop commands. */
int tape_std_assign(struct tape_device *);
int tape_std_unassign(struct tape_device *);
int tape_std_read_block_id(struct tape_device *device, __u64 *id);
int tape_std_display(struct tape_device *, struct display_struct *disp);
int tape_std_terminate_write(struct tape_device *);

/* Standard magnetic tape commands. */
int tape_std_mtbsf(struct tape_device *, int);
int tape_std_mtbsfm(struct tape_device *, int);
int tape_std_mtbsr(struct tape_device *, int);
int tape_std_mtcompression(struct tape_device *, int);
int tape_std_mteom(struct tape_device *, int);
int tape_std_mterase(struct tape_device *, int);
int tape_std_mtfsf(struct tape_device *, int);
int tape_std_mtfsfm(struct tape_device *, int);
int tape_std_mtfsr(struct tape_device *, int);
int tape_std_mtload(struct tape_device *, int);
int tape_std_mtnop(struct tape_device *, int);
int tape_std_mtoffl(struct tape_device *, int);
int tape_std_mtreset(struct tape_device *, int);
int tape_std_mtreten(struct tape_device *, int);
int tape_std_mtrew(struct tape_device *, int);
int tape_std_mtsetblk(struct tape_device *, int);
int tape_std_mtunload(struct tape_device *, int);
int tape_std_mtweof(struct tape_device *, int);

/* Event handlers */
void tape_std_process_eov(struct tape_device *);

/* S390 tape types */
enum s390_tape_type {
        tape_3480,
        tape_3490,
        tape_3590,
        tape_3592,
};

#endif // _TAPE_STD_H