newlib-cygwin/winsup/cygwin/mtinfo.h

/* mtinfo.h: Defininitions for the Cygwin tape driver class.

   Copyright 2004 Red Hat, Inc.

This file is part of Cygwin.

This software is a copyrighted work licensed under the terms of the
Cygwin license.  Please consult the file "CYGWIN_LICENSE" for
details. */

#define MTINFO_MAGIC		0x179b2af0
#define MTINFO_VERSION		1

/* Maximum number of supported partitions per drive. */
#define MAX_PARTITION_NUM	64
/* Maximum number of supported drives. */
#define MAX_DRIVE_NUM		8

/* Values for bookkeeping of the tape position relative to filemarks
   and eod/eom.  */
enum eom_val
{
  no_eof,
  eof_hit,
  eof,
  eod_hit,
  eod,
  eom_hit,
  eom
};

enum dirty_state
{
  clean,
  has_read,
  has_written
};

enum lock_state
{
  unlocked,
  lock_error,
  auto_locked,
  locked
};

/* Partition specific information */
class mtinfo_part
{
public:
  long block;		/* logical block no */
  long file;		/* current file no */
  long fblock;		/* relative block no */
  bool smark;		/* At setmark? */
  eom_val emark;	/* "end-of"-mark */

  void initialize (long nblock = -1);
};

class mtinfo_drive
{
  int drive;
  int lasterr;
  long partition;
  long block;
  dirty_state dirty;
  lock_state lock;
  TAPE_GET_DRIVE_PARAMETERS _dp;
  TAPE_GET_MEDIA_PARAMETERS _mp;
  bool buffer_writes;
  bool two_fm;
  bool fast_eom;
  bool auto_lock;
  bool sysv;
  bool nowait;
  mtinfo_part _part[MAX_PARTITION_NUM];

  inline int error (const char *str)
    {
      if (lasterr)
        debug_printf ("%s: Win32 error %d", lasterr);
      return lasterr;
    }
  inline bool get_feature (DWORD parm)
    {
      return ((parm & TAPE_DRIVE_HIGH_FEATURES)
	      ? ((_dp.FeaturesHigh & parm) != 0)
	      : ((_dp.FeaturesLow & parm) != 0));
    }
  int get_pos (HANDLE mt, long *ppartition = NULL, long *pblock = NULL);
  int _set_pos (HANDLE mt, int mode, long count, int partition);
  int create_partitions (HANDLE mt, long count);
  int set_partition (HANDLE mt, long count);
  int write_marks (HANDLE mt, int marktype, DWORD count);
  int erase (HANDLE mt, int mode);
  int prepare (HANDLE mt, int action, bool is_auto = false);
  int set_compression (HANDLE mt, long count);
  int set_blocksize (HANDLE mt, long count);
  int status (HANDLE mt, struct mtget *get);
  int set_options (HANDLE mt, long options);

public:
  void initialize (int num, bool first_time);
  int get_dp (HANDLE mt);
  int get_mp (HANDLE mt);
  int open (HANDLE mt);
  int close (HANDLE mt, bool rewind);
  int read (HANDLE mt, void *ptr, size_t &ulen);
  int write (HANDLE mt, const void *ptr, size_t &len);
  int ioctl (HANDLE mt, unsigned int cmd, void *buf);
  int set_pos (HANDLE mt, int mode, long count, bool sfm_func);

  inline bool buffered_writes (void) { return buffer_writes; }
  PTAPE_GET_DRIVE_PARAMETERS dp (void) { return &_dp; }
  PTAPE_GET_MEDIA_PARAMETERS mp (void) { return &_mp; }
  mtinfo_part *part (int num) { return &_part[num]; }
};

class mtinfo
{
  DWORD magic;
  DWORD version;
  mtinfo_drive _drive[MAX_DRIVE_NUM];

public:
  void initialize (void);
  mtinfo_drive *drive (int num) { return &_drive[num]; }
};

extern HANDLE mt_h;
extern mtinfo *mt;

extern void __stdcall mtinfo_init ();