chio.h 5.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168
  1. /*
  2. * ioctl interface for the scsi media changer driver
  3. */
  4. /* changer element types */
  5. #define CHET_MT 0 /* media transport element (robot) */
  6. #define CHET_ST 1 /* storage element (media slots) */
  7. #define CHET_IE 2 /* import/export element */
  8. #define CHET_DT 3 /* data transfer element (tape/cdrom/whatever) */
  9. #define CHET_V1 4 /* vendor specific #1 */
  10. #define CHET_V2 5 /* vendor specific #2 */
  11. #define CHET_V3 6 /* vendor specific #3 */
  12. #define CHET_V4 7 /* vendor specific #4 */
  13. /*
  14. * CHIOGPARAMS
  15. * query changer properties
  16. *
  17. * CHIOVGPARAMS
  18. * query vendor-specific element types
  19. *
  20. * accessing elements works by specifing type and unit of the element.
  21. * for example, storage elements are addressed with type = CHET_ST and
  22. * unit = 0 .. cp_nslots-1
  23. *
  24. */
  25. struct changer_params {
  26. int cp_curpicker; /* current transport element */
  27. int cp_npickers; /* number of transport elements (CHET_MT) */
  28. int cp_nslots; /* number of storage elements (CHET_ST) */
  29. int cp_nportals; /* number of import/export elements (CHET_IE) */
  30. int cp_ndrives; /* number of data transfer elements (CHET_DT) */
  31. };
  32. struct changer_vendor_params {
  33. int cvp_n1; /* number of vendor specific elems (CHET_V1) */
  34. char cvp_label1[16];
  35. int cvp_n2; /* number of vendor specific elems (CHET_V2) */
  36. char cvp_label2[16];
  37. int cvp_n3; /* number of vendor specific elems (CHET_V3) */
  38. char cvp_label3[16];
  39. int cvp_n4; /* number of vendor specific elems (CHET_V4) */
  40. char cvp_label4[16];
  41. int reserved[8];
  42. };
  43. /*
  44. * CHIOMOVE
  45. * move a medium from one element to another
  46. */
  47. struct changer_move {
  48. int cm_fromtype; /* type/unit of source element */
  49. int cm_fromunit;
  50. int cm_totype; /* type/unit of destination element */
  51. int cm_tounit;
  52. int cm_flags;
  53. };
  54. #define CM_INVERT 1 /* flag: rotate media (for double-sided like MOD) */
  55. /*
  56. * CHIOEXCHANGE
  57. * move one medium from element #1 to element #2,
  58. * and another one from element #2 to element #3.
  59. * element #1 and #3 are allowed to be identical.
  60. */
  61. struct changer_exchange {
  62. int ce_srctype; /* type/unit of element #1 */
  63. int ce_srcunit;
  64. int ce_fdsttype; /* type/unit of element #2 */
  65. int ce_fdstunit;
  66. int ce_sdsttype; /* type/unit of element #3 */
  67. int ce_sdstunit;
  68. int ce_flags;
  69. };
  70. #define CE_INVERT1 1
  71. #define CE_INVERT2 2
  72. /*
  73. * CHIOPOSITION
  74. * move the transport element (robot arm) to a specific element.
  75. */
  76. struct changer_position {
  77. int cp_type;
  78. int cp_unit;
  79. int cp_flags;
  80. };
  81. #define CP_INVERT 1
  82. /*
  83. * CHIOGSTATUS
  84. * get element status for all elements of a specific type
  85. */
  86. struct changer_element_status {
  87. int ces_type;
  88. unsigned char *ces_data;
  89. };
  90. #define CESTATUS_FULL 0x01 /* full */
  91. #define CESTATUS_IMPEXP 0x02 /* media was imported (inserted by sysop) */
  92. #define CESTATUS_EXCEPT 0x04 /* error condition */
  93. #define CESTATUS_ACCESS 0x08 /* access allowed */
  94. #define CESTATUS_EXENAB 0x10 /* element can export media */
  95. #define CESTATUS_INENAB 0x20 /* element can import media */
  96. /*
  97. * CHIOGELEM
  98. * get more detailed status information for a single element
  99. */
  100. struct changer_get_element {
  101. int cge_type; /* type/unit */
  102. int cge_unit;
  103. int cge_status; /* status */
  104. int cge_errno; /* errno */
  105. int cge_srctype; /* source element of the last move/exchange */
  106. int cge_srcunit;
  107. int cge_id; /* scsi id (for data transfer elements) */
  108. int cge_lun; /* scsi lun (for data transfer elements) */
  109. char cge_pvoltag[36]; /* primary volume tag */
  110. char cge_avoltag[36]; /* alternate volume tag */
  111. int cge_flags;
  112. };
  113. /* flags */
  114. #define CGE_ERRNO 0x01 /* errno available */
  115. #define CGE_INVERT 0x02 /* media inverted */
  116. #define CGE_SRC 0x04 /* media src available */
  117. #define CGE_IDLUN 0x08 /* ID+LUN available */
  118. #define CGE_PVOLTAG 0x10 /* primary volume tag available */
  119. #define CGE_AVOLTAG 0x20 /* alternate volume tag available */
  120. /*
  121. * CHIOSVOLTAG
  122. * set volume tag
  123. */
  124. struct changer_set_voltag {
  125. int csv_type; /* type/unit */
  126. int csv_unit;
  127. char csv_voltag[36]; /* volume tag */
  128. int csv_flags;
  129. };
  130. #define CSV_PVOLTAG 0x01 /* primary volume tag */
  131. #define CSV_AVOLTAG 0x02 /* alternate volume tag */
  132. #define CSV_CLEARTAG 0x04 /* clear volume tag */
  133. /* ioctls */
  134. #define CHIOMOVE _IOW('c', 1,struct changer_move)
  135. #define CHIOEXCHANGE _IOW('c', 2,struct changer_exchange)
  136. #define CHIOPOSITION _IOW('c', 3,struct changer_position)
  137. #define CHIOGPICKER _IOR('c', 4,int) /* not impl. */
  138. #define CHIOSPICKER _IOW('c', 5,int) /* not impl. */
  139. #define CHIOGPARAMS _IOR('c', 6,struct changer_params)
  140. #define CHIOGSTATUS _IOW('c', 8,struct changer_element_status)
  141. #define CHIOGELEM _IOW('c',16,struct changer_get_element)
  142. #define CHIOINITELEM _IO('c',17)
  143. #define CHIOSVOLTAG _IOW('c',18,struct changer_set_voltag)
  144. #define CHIOGVPARAMS _IOR('c',19,struct changer_vendor_params)
  145. /* ---------------------------------------------------------------------- */
  146. /*
  147. * Local variables:
  148. * c-basic-offset: 8
  149. * End:
  150. */