---

---

---

001: /*
002:  * ioctl interface for the scsi media changer driver
003:  */
004: 
005: /* changer element types */
006: #define CHET_MT   0     /* media transport element (robot) */
007: #define CHET_ST   1     /* storage element (media slots) */
008: #define CHET_IE   2     /* import/export element */
009: #define CHET_DT   3     /* data transfer element (tape/cdrom/whatever) */
010: #define CHET_V1   4     /* vendor specific #1 */
011: #define CHET_V2   5     /* vendor specific #2 */
012: #define CHET_V3   6     /* vendor specific #3 */
013: #define CHET_V4   7     /* vendor specific #4 */
014: 
015: 
016: /*
017:  * CHIOGPARAMS
018:  *    query changer properties
019:  *
020:  * CHIOVGPARAMS
021:  *    query vendor-specific element types
022:  *
023:  *    accessing elements works by specifing type and unit of the element.
024:  *    for example, storage elements are addressed with type = CHET_ST and
025:  *    unit = 0 .. cp_nslots-1
026:  *
027:  */
028: struct changer_params {
029:         int cp_curpicker;  /* current transport element */
030:         int cp_npickers;   /* number of transport elements      (CHET_MT) */
031:         int cp_nslots;     /* number of storage elements        (CHET_ST) */
032:         int cp_nportals;   /* number of import/export elements  (CHET_IE) */
033:         int cp_ndrives;    /* number of data transfer elements  (CHET_DT) */
034: };
035: struct changer_vendor_params {
036:         int  cvp_n1;       /* number of vendor specific elems   (CHET_V1) */
037:         char cvp_label1[16];
038:         int  cvp_n2;       /* number of vendor specific elems   (CHET_V2) */
039:         char cvp_label2[16];
040:         int  cvp_n3;       /* number of vendor specific elems   (CHET_V3) */
041:         char cvp_label3[16];
042:         int  cvp_n4;       /* number of vendor specific elems   (CHET_V4) */
043:         char cvp_label4[16];
044:         int  reserved[8];
045: };
046: 
047: 
048: /*
049:  * CHIOMOVE
050:  *    move a medium from one element to another
051:  */
052: struct changer_move {
053:         int cm_fromtype;        /* type/unit of source element */
054:         int cm_fromunit;        
055:         int cm_totype;  /* type/unit of destination element */
056:         int cm_tounit;
057:         int cm_flags;
058: };
059: #define CM_INVERT   1   /* flag: rotate media (for double-sided like MOD) */
060: 
061: 
062: /*
063:  * CHIOEXCHANGE
064:  *    move one medium from element #1 to element #2,
065:  *    and another one from element #2 to element #3.
066:  *    element #1 and #3 are allowed to be identical.
067:  */
068: struct changer_exchange {
069:         int ce_srctype;     /* type/unit of element #1 */
070:         int ce_srcunit;
071:         int ce_fdsttype;    /* type/unit of element #2 */
072:         int ce_fdstunit;
073:         int ce_sdsttype;    /* type/unit of element #3 */
074:         int ce_sdstunit;
075:         int ce_flags;
076: };
077: #define CE_INVERT1   1
078: #define CE_INVERT2   2
079: 
080: 
081: /*
082:  * CHIOPOSITION
083:  *    move the transport element (robot arm) to a specific element.
084:  */
085: struct changer_position {
086:         int cp_type;
087:         int cp_unit;
088:         int cp_flags;
089: };
090: #define CP_INVERT   1
091: 
092: 
093: /*
094:  * CHIOGSTATUS
095:  *    get element status for all elements of a specific type
096:  */
097: struct changer_element_status {
098:         int             ces_type;
099:         unsigned char   *ces_data;
100: };
101: #define CESTATUS_FULL     0x01 /* full */
102: #define CESTATUS_IMPEXP   0x02  /* media was imported (inserted by sysop) */
103: #define CESTATUS_EXCEPT   0x04  /* error condition */
104: #define CESTATUS_ACCESS   0x08  /* access allowed */
105: #define CESTATUS_EXENAB   0x10  /* element can export media */
106: #define CESTATUS_INENAB   0x20  /* element can import media */
107: 
108: 
109: /*
110:  * CHIOGELEM
111:  *    get more detailed status information for a single element
112:  */
113: struct changer_get_element {
114:         int     cge_type;        /* type/unit */
115:         int     cge_unit;
116:         int     cge_status;      /* status */
117:         int     cge_errno;       /* errno */
118:         int     cge_srctype;     /* source element of the last move/exchange */
119:         int     cge_srcunit;
120:         int     cge_id;          /* scsi id  (for data transfer elements) */
121:         int     cge_lun;         /* scsi lun (for data transfer elements) */
122:         char    cge_pvoltag[36]; /* primary volume tag */
123:         char    cge_avoltag[36]; /* alternate volume tag */
124:         int     cge_flags;
125: };
126: /* flags */
127: #define CGE_ERRNO     0x01       /* errno available       */
128: #define CGE_INVERT    0x02       /* media inverted        */
129: #define CGE_SRC       0x04       /* media src available   */
130: #define CGE_IDLUN     0x08       /* ID+LUN available      */
131: #define CGE_PVOLTAG   0x10       /* primary volume tag available */
132: #define CGE_AVOLTAG   0x20       /* alternate volume tag available */
133: 
134: 
135: /*
136:  * CHIOSVOLTAG
137:  *    set volume tag
138:  */
139: struct changer_set_voltag {
140:         int     csv_type;        /* type/unit */
141:         int     csv_unit;
142:         char    csv_voltag[36];  /* volume tag */
143:         int     csv_flags;
144: };
145: #define CSV_PVOLTAG   0x01       /* primary volume tag */
146: #define CSV_AVOLTAG   0x02       /* alternate volume tag */
147: #define CSV_CLEARTAG  0x04       /* clear volume tag */
148: 
149: /* ioctls */
150: #define CHIOMOVE       _IOW('c', 1,struct changer_move)
151: #define CHIOEXCHANGE   _IOW('c', 2,struct changer_exchange)
152: #define CHIOPOSITION   _IOW('c', 3,struct changer_position)
153: #define CHIOGPICKER    _IOR('c', 4,int)                        /* not impl. */
154: #define CHIOSPICKER    _IOW('c', 5,int)                        /* not impl. */
155: #define CHIOGPARAMS    _IOR('c', 6,struct changer_params)
156: #define CHIOGSTATUS    _IOW('c', 8,struct changer_element_status)
157: #define CHIOGELEM      _IOW('c',16,struct changer_get_element)
158: #define CHIOINITELEM   _IO('c',17)
159: #define CHIOSVOLTAG    _IOW('c',18,struct changer_set_voltag)
160: #define CHIOGVPARAMS   _IOR('c',19,struct changer_vendor_params)
161: 
162: /* ---------------------------------------------------------------------- */
163: 
164: /*
165:  * Local variables:
166:  * c-basic-offset: 8
167:  * End:
168:  */
169: 

---

---

---