////////////////////////////////////////////////////////////////////////////////////
// W32MTIO.H      --      Win32 'mtio.h' (Magnetic Tape structures)
//
// (c) Copyright "Fish" (David B. Trout), 2005-2009. Released under
// the Q Public License (http://www.hercules-390.org/herclic.html)
// as modifications to Hercules.
////////////////////////////////////////////////////////////////////////////////////
//
//  From the Koders.com (http://www.koders.com/) entry for
//  the Unununium(uuu) project (http://unununium.org/) which,
//  believe it or not, states their source code is COMPLETELY
//  FREE (i.e. no licensing restrictions AT ALL!).
//  Modified as needed by Fish for Hercules Win32 port.
//  Original filename: mtio.h; new filename: w32mtio.h
//
////////////////////////////////////////////////////////////////////////////////////

// $Id: w32mtio.h 5127 2009-01-23 13:25:01Z bernard $
//
// $Log$
// Revision 1.7  2008/03/25 11:41:31  fish
// SCSI TAPE MODS part 1: groundwork: non-functional changes:
// rename some functions, comments, general restructuring, etc.
// New source modules awstape.c, omatape.c, hettape.c and
// tapeccws.c added, but not yet used (all will be used in a future
// commit though when tapedev.c code is eventually split)
//
// Revision 1.6  2007/11/30 14:54:33  jmaynard
// Changed conmicro.cx to hercules-390.org or conmicro.com, as needed.
//
// Revision 1.5  2007/06/23 00:04:19  ivan
// Update copyright notices to include current year (2007)
//
// Revision 1.4  2006/12/08 09:43:33  jj
// Add CVS message log
//

#ifndef _W32MTIO_H_
#define _W32MTIO_H_

#ifdef _MSVC_               // (Fish: only needed for MSVC)

//#include <sys/ioctl.h>    // (Fish: not needed)
#define  _IOWR  _IOW        // (Fish: see 'winsock2.h')
//__BEGIN_DECLS             // (Fish: not needed)

/* structure for MTIOCTOP - mag tape op command */
struct mtop {
  short int mt_op;  /* operations defined below */
  int mt_count;     /* how many of them */
};

/* Magnetic Tape operations [Not all operations supported by all drivers]: */
#define MTRESET         0   /* +reset drive in case of problems */
#define MTFSF           1   /* forward space over FileMark,
                             * position at first record of next file
                             */
#define MTBSF           2   /* backward space FileMark (position before FM) */
#define MTFSR           3   /* forward space record */
#define MTBSR           4   /* backward space record */
#define MTWEOF          5   /* write an end-of-file record (mark) */
#define MTREW           6   /* rewind */
#define MTOFFL          7   /* rewind and put the drive offline (eject?) */
#define MTNOP           8   /* no op, set status only (read with MTIOCGET) */
#define MTRETEN         9   /* retension tape */
#define MTBSFM          10  /* +backward space FileMark, position at FM */
#define MTFSFM          11  /* +forward space FileMark, position at FM */
#define MTEOM           12  /* goto end of recorded media (for appending files).
                             * MTEOM positions after the last FM, ready for
                             * appending another file.
                             */
#define MTERASE         13  /* erase tape -- be careful! */

#define MTRAS1          14  /* run self test 1 (nondestructive) */
#define MTRAS2          15  /* run self test 2 (destructive) */
#define MTRAS3          16  /* reserved for self test 3 */

#define MTEOTWARN       17  /* Fish: Warning Zone size (0 bytes == disable) */
                            /* Some BSD's only support an "MTEWARN" boolean */
#define MTEWARN  MTEOTWARN  /* (for transparency/portability)               */

#define MTSETBLK        20  /* set block length (SCSI) */
#define MTSETDENSITY    21  /* set tape density (SCSI) */
#define MTSEEK          22  /* seek to block (Tandberg, etc.) */
#define MTTELL          23  /* tell block (Tandberg, etc.) */
#define MTSETDRVBUFFER  24  /* set the drive buffering according to SCSI-2 */
                            /* ordinary buffered operation with code 1 */
#define MTFSS           25  /* space forward over setmarks */
#define MTBSS           26  /* space backward over setmarks */
#define MTWSM           27  /* write setmarks */

#define MTLOCK          28  /* lock the drive door */
#define MTUNLOCK        29  /* unlock the drive door */
#define MTLOAD          30  /* execute the SCSI load command */
#define MTUNLOAD        31  /* execute the SCSI unload command */
#define MTCOMPRESSION   32  /* control compression with SCSI mode page 15 */
#define MTSETPART       33  /* Change the active tape partition */
#define MTMKPART        34  /* Format the tape with one or two partitions */

/* structure for MTIOCGET - mag tape get status command */

struct mtget {
  long int mt_type;     /* type of magtape device */
  long int mt_resid;    /* residual count: (not sure)
                         *   number of bytes ignored, or
                         *   number of files not skipped, or
                         *   number of records not skipped.
                         */
  /* the following registers are device dependent */
  long int mt_dsreg;    /* status register */
  long int mt_gstat;    /* generic (device independent) status */
  long int mt_erreg;    /* error register */
  /* The next two fields are not always used */
  /* these really are daddr_t, but that is only declared with _BSD_SOURCE */
  long mt_fileno;       /* number of current file on tape */
  long mt_blkno;        /* current block number */
};

/*
 * Constants for mt_type. Not all of these are supported,
 * and these are not all of the ones that are supported.
 */
#define MT_ISUNKNOWN        0x01
#define MT_ISQIC02          0x02    /* Generic QIC-02 tape streamer */
#define MT_ISWT5150         0x03    /* Wangtek 5150EQ, QIC-150, QIC-02 */
#define MT_ISARCHIVE_5945L2 0x04    /* Archive 5945L-2, QIC-24, QIC-02? */
#define MT_ISCMSJ500        0x05    /* CMS Jumbo 500 (QIC-02?) */
#define MT_ISTDC3610        0x06    /* Tandberg 6310, QIC-24 */
#define MT_ISARCHIVE_VP60I  0x07    /* Archive VP60i, QIC-02 */
#define MT_ISARCHIVE_2150L  0x08    /* Archive Viper 2150L */
#define MT_ISARCHIVE_2060L  0x09    /* Archive Viper 2060L */
#define MT_ISARCHIVESC499   0x0A    /* Archive SC-499 QIC-36 controller */
#define MT_ISQIC02_ALL_FEATURES 0x0F/* Generic QIC-02 with all features */
#define MT_ISWT5099EEN24    0x11    /* Wangtek 5099-een24, 60MB, QIC-24 */
#define MT_ISTEAC_MT2ST     0x12    /* Teac MT-2ST 155mb drive, Teac DC-1 card (Wangtek type) */
#define MT_ISEVEREX_FT40A   0x32    /* Everex FT40A (QIC-40) */
#define MT_ISDDS1           0x51    /* DDS device without partitions */
#define MT_ISDDS2           0x52    /* DDS device with partitions */
#define MT_ISONSTREAM_SC    0x61    /* OnStream SCSI tape drives (SC-x0)
                                       and SCSI emulated (DI, DP, USB) */
#define MT_ISSCSI1          0x71    /* Generic ANSI SCSI-1 tape unit */
#define MT_ISSCSI2          0x72    /* Generic ANSI SCSI-2 tape unit */

/* QIC-40/80/3010/3020 ftape supported drives.
 * 20bit vendor ID + 0x800000 (see ftape-vendors.h)
 */
#define MT_ISFTAPE_UNKNOWN  0x800000 /* obsolete */
#define MT_ISFTAPE_FLAG     0x800000

struct mt_tape_info {
  long int t_type;  /* device type id (mt_type) */
  char* t_name;     /* descriptive name */
};

#define MT_TAPE_INFO    { \
    {MT_ISUNKNOWN,              "Unknown type of tape device"}, \
    {MT_ISQIC02,                "Generic QIC-02 tape streamer"}, \
    {MT_ISWT5150,               "Wangtek 5150, QIC-150"}, \
    {MT_ISARCHIVE_5945L2,       "Archive 5945L-2"}, \
    {MT_ISCMSJ500,              "CMS Jumbo 500"}, \
    {MT_ISTDC3610,              "Tandberg TDC 3610, QIC-24"}, \
    {MT_ISARCHIVE_VP60I,        "Archive VP60i, QIC-02"}, \
    {MT_ISARCHIVE_2150L,        "Archive Viper 2150L"}, \
    {MT_ISARCHIVE_2060L,        "Archive Viper 2060L"}, \
    {MT_ISARCHIVESC499,         "Archive SC-499 QIC-36 controller"}, \
    {MT_ISQIC02_ALL_FEATURES,   "Generic QIC-02 tape, all features"}, \
    {MT_ISWT5099EEN24,          "Wangtek 5099-een24, 60MB"}, \
    {MT_ISTEAC_MT2ST,           "Teac MT-2ST 155mb data cassette drive"}, \
    {MT_ISEVEREX_FT40A,         "Everex FT40A, QIC-40"}, \
    {MT_ISONSTREAM_SC,          "OnStream SC-, DI-, DP-, or USB tape drive"}, \
    {MT_ISSCSI1,                "Generic SCSI-1 tape"}, \
    {MT_ISSCSI2,                "Generic SCSI-2 tape"}, \
    {0, NULL} \
}

/* structure for MTIOCPOS - mag tape get position command */

struct mtpos {
  long int mt_blkno;    /* current block number */
};

/* structure for MTIOCGETCONFIG/MTIOCSETCONFIG primarily intended
 * as an interim solution for QIC-02 until DDI is fully implemented.
 */
struct mtconfiginfo {
  long int mt_type;         /* drive type */
  long int ifc_type;        /* interface card type */
  unsigned short int irqnr; /* IRQ number to use */
  unsigned short int dmanr; /* DMA channel to use */
  unsigned short int port;  /* IO port base address */

  unsigned long int debug;  /* debugging flags */

  unsigned int have_dens:1;
  unsigned int have_bsf:1;
  unsigned int have_fsr:1;
  unsigned int have_bsr:1;
  unsigned int have_eod:1;
  unsigned int have_seek:1;
  unsigned int have_tell:1;
  unsigned int have_ras1:1;
  unsigned int have_ras2:1;
  unsigned int have_ras3:1;
  unsigned int have_qfa:1;

  unsigned int pad1:5;
  char reserved[10];
};

/*  structure for MTIOCVOLINFO, query information about the volume
 *  currently positioned at (zftape)
 */
struct mtvolinfo {
  unsigned int mt_volno;    /* vol-number */
  unsigned int mt_blksz;    /* blocksize used when recording */
  unsigned int mt_rawsize;  /* raw tape space consumed, in kb */
  unsigned int mt_size;     /* volume size after decompression, in kb */
  unsigned int mt_cmpr:1;   /* this volume has been compressed */
};

/* raw access to a floppy drive, read and write an arbitrary segment.
 * For ftape/zftape to support formatting etc.
 */
#define MT_FT_RD_SINGLE  0
#define MT_FT_RD_AHEAD   1
#define MT_FT_WR_ASYNC   0  /* start tape only when all buffers are full     */
#define MT_FT_WR_MULTI   1  /* start tape, continue until buffers are empty  */
#define MT_FT_WR_SINGLE  2  /* write a single segment and stop afterwards    */
#define MT_FT_WR_DELETE  3  /* write deleted data marks, one segment at time */

struct mtftseg {
  unsigned int mt_segno;    /* the segment to read or write */
  unsigned int mt_mode;     /* modes for read/write (sync/async etc.) */
  int mt_result;            /* result of r/w request, not of the ioctl */
  void *mt_data;            /* User space buffer: must be 29kb */
};

/* get tape capacity (ftape/zftape)
 */
struct mttapesize {
  unsigned long mt_capacity; /* entire, uncompressed capacity of a cartridge */
  unsigned long mt_used;     /* what has been used so far, raw uncompressed amount */
};

/*  possible values of the ftfmt_op field
 */
#define FTFMT_SET_PARMS     1 /* set software parms */
#define FTFMT_GET_PARMS     2 /* get software parms */
#define FTFMT_FORMAT_TRACK  3 /* start formatting a tape track   */
#define FTFMT_STATUS        4 /* monitor formatting a tape track */
#define FTFMT_VERIFY        5 /* verify the given segment        */

struct ftfmtparms {
  unsigned char  ft_qicstd;   /* QIC-40/QIC-80/QIC-3010/QIC-3020 */
  unsigned char  ft_fmtcode;  /* Refer to the QIC specs */
  unsigned char  ft_fhm;      /* floppy head max */
  unsigned char  ft_ftm;      /* floppy track max */
  unsigned short ft_spt;      /* segments per track */
  unsigned short ft_tpc;      /* tracks per cartridge */
};

struct ftfmttrack {
  unsigned int  ft_track;     /* track to format */
  unsigned char ft_gap3;      /* size of gap3, for FORMAT_TRK */
};

struct ftfmtstatus {
  unsigned int  ft_segment;   /* segment currently being formatted */
};

struct ftfmtverify {
  unsigned int  ft_segment;   /* segment to verify */
  unsigned long ft_bsm;       /* bsm as result of VERIFY cmd */
};

struct mtftformat {
  unsigned int fmt_op;        /* operation to perform */
  union fmt_arg {
    struct ftfmtparms  fmt_parms;  /* format parameters */
    struct ftfmttrack  fmt_track;  /* ctrl while formatting */
    struct ftfmtstatus fmt_status;
    struct ftfmtverify fmt_verify; /* for verifying */
  } fmt_arg;
};

/* mag tape io control commands */
#define MTIOCTOP        _IOW('m', 1, struct mtop)           /* do a mag tape op */
#define MTIOCGET        _IOR('m', 2, struct mtget)          /* get tape status */
#define MTIOCPOS        _IOR('m', 3, struct mtpos)          /* get tape position */

/* The next two are used by the QIC-02 driver for runtime reconfiguration.
 * See tpqic02.h for struct mtconfiginfo.
 */
#define MTIOCGETCONFIG  _IOR('m', 4, struct mtconfiginfo)   /* get tape config */
#define MTIOCSETCONFIG  _IOW('m', 5, struct mtconfiginfo)   /* set tape config */

/* the next six are used by the floppy ftape drivers and its frontends
 * sorry, but MTIOCTOP commands are write only.
 */
#define MTIOCRDFTSEG    _IOWR('m', 6, struct mtftseg)       /* read a segment */
#define MTIOCWRFTSEG    _IOWR('m', 7, struct mtftseg)       /* write a segment */
#define MTIOCVOLINFO    _IOR('m',  8, struct mtvolinfo)     /* info about volume */
#define MTIOCGETSIZE    _IOR('m',  9, struct mttapesize)    /* get cartridge size*/
#define MTIOCFTFORMAT   _IOWR('m', 10, struct mtftformat)   /* format ftape */
#define MTIOCFTCMD      _IOWR('m', 11, struct mtftcmd)      /* send QIC-117 cmd */

/* Generic Mag Tape (device independent) status macros for examining
 * mt_gstat -- HP-UX compatible.
 * There is room for more generic status bits here, but I don't
 * know which of them are reserved. At least three or so should
 * be added to make this really useful.
 */
#define GMT_EOF(x)              ((x) & 0x80000000)
#define GMT_BOT(x)              ((x) & 0x40000000)
#define GMT_EOT(x)              ((x) & 0x20000000)
#define GMT_SM(x)               ((x) & 0x10000000)  /* DDS setmark */
#define GMT_EOD(x)              ((x) & 0x08000000)  /* DDS EOD */
#define GMT_WR_PROT(x)          ((x) & 0x04000000)
/* #define GMT_ ?               ((x) & 0x02000000) */
#define GMT_ONLINE(x)           ((x) & 0x01000000)
#define GMT_D_6250(x)           ((x) & 0x00800000)
#define GMT_D_1600(x)           ((x) & 0x00400000)
#define GMT_D_800(x)            ((x) & 0x00200000)
/* #define GMT_ ?               ((x) & 0x00100000) */
/* #define GMT_ ?               ((x) & 0x00080000) */
#define GMT_DR_OPEN(x)          ((x) & 0x00040000)  /* door open (no tape) */
/* #define GMT_ ?               ((x) & 0x00020000) */
#define GMT_IM_REP_EN(x)        ((x) & 0x00010000)  /* immediate report mode */
/* 16 generic status bits unused */

/* SCSI-tape specific definitions */
/* Bitfield shifts in the status  */
#define MT_ST_BLKSIZE_SHIFT     0
#define MT_ST_BLKSIZE_MASK      0xffffff
#define MT_ST_DENSITY_SHIFT     24
#define MT_ST_DENSITY_MASK      0xff000000

#define MT_ST_SOFTERR_SHIFT     0
#define MT_ST_SOFTERR_MASK      0xffff

/* Bitfields for the MTSETDRVBUFFER ioctl */
#define MT_ST_OPTIONS           0xf0000000
#define MT_ST_BOOLEANS          0x10000000
#define MT_ST_SETBOOLEANS       0x30000000
#define MT_ST_CLEARBOOLEANS     0x40000000
#define MT_ST_WRITE_THRESHOLD   0x20000000
#define MT_ST_DEF_BLKSIZE       0x50000000
#define MT_ST_DEF_OPTIONS       0x60000000
#define MT_ST_TIMEOUTS          0x70000000
#define MT_ST_SET_TIMEOUT       (MT_ST_TIMEOUTS | 0x000000)
#define MT_ST_SET_LONG_TIMEOUT  (MT_ST_TIMEOUTS | 0x100000)

#define MT_ST_BUFFER_WRITES     0x0001
#define MT_ST_ASYNC_WRITES      0x0002
#define MT_ST_READ_AHEAD        0x0004
#define MT_ST_DEBUGGING         0x0008
#define MT_ST_TWO_FM            0x0010
#define MT_ST_FAST_MTEOM        0x0020
#define MT_ST_AUTO_LOCK         0x0040
#define MT_ST_DEF_WRITES        0x0080
#define MT_ST_CAN_BSR           0x0100
#define MT_ST_NO_BLKLIMS        0x0200
#define MT_ST_CAN_PARTITIONS    0x0400
#define MT_ST_SCSI2LOGICAL      0x0800
#define MT_ST_SYSV              0x1000

/* The mode parameters to be controlled. Parameter chosen with bits 20-28 */
#define MT_ST_CLEAR_DEFAULT     0xfffff
#define MT_ST_DEF_DENSITY       (MT_ST_DEF_OPTIONS | 0x100000)
#define MT_ST_DEF_COMPRESSION   (MT_ST_DEF_OPTIONS | 0x200000)
#define MT_ST_DEF_DRVBUFFER     (MT_ST_DEF_OPTIONS | 0x300000)

/* The offset for the arguments for the special HP changer load command. */
#define MT_ST_HPLOADER_OFFSET   10000

/* Specify default tape device.  */
#ifndef DEFTAPE
#define DEFTAPE "/dev/tape/0"
#endif

//__END_DECLS               // (Fish: not needed)

#endif // _MSVC_

#endif // _W32MTIO_H_
