2 * Copyright (c) 2000 Matthew Jacob
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions, and the following disclaimer,
10 * without modification, immediately at the beginning of the file.
11 * 2. The name of the author may not be used to endorse or promote products
12 * derived from this software without specific prior written permission.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
18 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27 #include <sys/cdefs.h>
28 __FBSDID("$FreeBSD$");
30 #include <sys/param.h>
31 #include <sys/queue.h>
32 #include <sys/systm.h>
33 #include <sys/kernel.h>
34 #include <sys/types.h>
35 #include <sys/malloc.h>
36 #include <sys/fcntl.h>
38 #include <sys/errno.h>
39 #include <machine/stdarg.h>
42 #include <cam/cam_ccb.h>
43 #include <cam/cam_periph.h>
44 #include <cam/cam_xpt_periph.h>
45 #include <cam/cam_debug.h>
46 #include <cam/cam_sim.h>
48 #include <cam/scsi/scsi_all.h>
49 #include <cam/scsi/scsi_message.h>
50 #include <sys/ioccom.h>
51 #include <cam/scsi/scsi_ses.h>
55 MALLOC_DEFINE(M_SCSISES, "SCSI SES", "SCSI SES buffers");
58 * Platform Independent Driver Internal Definitions for SES devices.
70 typedef struct ses_softc ses_softc_t;
72 int (*softc_init)(ses_softc_t *, int);
73 int (*init_enc)(ses_softc_t *);
74 int (*get_encstat)(ses_softc_t *, int);
75 int (*set_encstat)(ses_softc_t *, ses_encstat, int);
76 int (*get_objstat)(ses_softc_t *, ses_objstat *, int);
77 int (*set_objstat)(ses_softc_t *, ses_objstat *, int);
80 #define ENCI_SVALID 0x80
84 enctype : 8, /* enclosure type */
85 subenclosure : 8, /* subenclosure id */
86 svalid : 1, /* enclosure information valid */
87 priv : 15; /* private data, per object */
88 uint8_t encstat[4]; /* state && stats */
91 #define SEN_ID "UNISYS SUN_SEN"
95 static enctyp ses_type(void *, int);
98 /* Forward reference to Enclosure Functions */
99 static int ses_softc_init(ses_softc_t *, int);
100 static int ses_init_enc(ses_softc_t *);
101 static int ses_get_encstat(ses_softc_t *, int);
102 static int ses_set_encstat(ses_softc_t *, uint8_t, int);
103 static int ses_get_objstat(ses_softc_t *, ses_objstat *, int);
104 static int ses_set_objstat(ses_softc_t *, ses_objstat *, int);
106 static int safte_softc_init(ses_softc_t *, int);
107 static int safte_init_enc(ses_softc_t *);
108 static int safte_get_encstat(ses_softc_t *, int);
109 static int safte_set_encstat(ses_softc_t *, uint8_t, int);
110 static int safte_get_objstat(ses_softc_t *, ses_objstat *, int);
111 static int safte_set_objstat(ses_softc_t *, ses_objstat *, int);
114 * Platform implementation defines/functions for SES internal kernel stuff
117 #define STRNCMP strncmp
118 #define PRINTF printf
119 #define SES_LOG ses_log
121 #define SES_DLOG ses_log
123 #define SES_DLOG if (0) ses_log
125 #define SES_VLOG if (bootverbose) ses_log
126 #define SES_MALLOC(amt) malloc(amt, M_SCSISES, M_NOWAIT)
127 #define SES_FREE(ptr, amt) free(ptr, M_SCSISES)
128 #define MEMZERO bzero
129 #define MEMCPY(dest, src, amt) bcopy(src, dest, amt)
131 static int ses_runcmd(struct ses_softc *, char *, int, char *, int *);
132 static void ses_log(struct ses_softc *, const char *, ...);
135 * Gerenal FreeBSD kernel stuff.
139 #define ccb_state ppriv_field0
140 #define ccb_bp ppriv_ptr1
143 enctyp ses_type; /* type of enclosure */
144 encvec ses_vec; /* vector to handlers */
145 void * ses_private; /* per-type private data */
146 encobj * ses_objmap; /* objects */
147 uint32_t ses_nobjects; /* number of objects */
148 ses_encstat ses_encstat; /* overall status */
150 union ccb ses_saved_ccb;
151 struct cdev *ses_dev;
152 struct cam_periph *periph;
154 #define SES_FLAG_INVALID 0x01
155 #define SES_FLAG_OPEN 0x02
156 #define SES_FLAG_INITIALIZED 0x04
158 static d_open_t sesopen;
159 static d_close_t sesclose;
160 static d_ioctl_t sesioctl;
161 static periph_init_t sesinit;
162 static periph_ctor_t sesregister;
163 static periph_oninv_t sesoninvalidate;
164 static periph_dtor_t sescleanup;
165 static periph_start_t sesstart;
167 static void sesasync(void *, uint32_t, struct cam_path *, void *);
168 static void sesdone(struct cam_periph *, union ccb *);
169 static int seserror(union ccb *, uint32_t, uint32_t);
171 static struct periph_driver sesdriver = {
173 TAILQ_HEAD_INITIALIZER(sesdriver.units), /* generation */ 0
176 PERIPHDRIVER_DECLARE(ses, sesdriver);
178 static struct cdevsw ses_cdevsw = {
179 .d_version = D_VERSION,
193 * Install a global async callback. This callback will
194 * receive async callbacks like "new device found".
196 status = xpt_register_async(AC_FOUND_DEVICE, sesasync, NULL, NULL);
198 if (status != CAM_REQ_CMP) {
199 printf("ses: Failed to attach master async callback "
200 "due to status 0x%x!\n", status);
205 sesoninvalidate(struct cam_periph *periph)
207 struct ses_softc *softc;
209 softc = (struct ses_softc *)periph->softc;
212 * Unregister any async callbacks.
214 xpt_register_async(0, sesasync, periph, periph->path);
216 softc->ses_flags |= SES_FLAG_INVALID;
218 xpt_print(periph->path, "lost device\n");
222 sescleanup(struct cam_periph *periph)
224 struct ses_softc *softc;
226 softc = (struct ses_softc *)periph->softc;
228 xpt_print(periph->path, "removing device entry\n");
229 cam_periph_unlock(periph);
230 destroy_dev(softc->ses_dev);
231 cam_periph_lock(periph);
232 free(softc, M_SCSISES);
236 sesasync(void *callback_arg, uint32_t code, struct cam_path *path, void *arg)
238 struct cam_periph *periph;
240 periph = (struct cam_periph *)callback_arg;
243 case AC_FOUND_DEVICE:
246 struct ccb_getdev *cgd;
249 cgd = (struct ccb_getdev *)arg;
254 if (cgd->protocol != PROTO_SCSI)
257 inq_len = cgd->inq_data.additional_length + 4;
260 * PROBLEM: WE NEED TO LOOK AT BYTES 48-53 TO SEE IF THIS IS
261 * PROBLEM: IS A SAF-TE DEVICE.
263 switch (ses_type(&cgd->inq_data, inq_len)) {
266 case SES_SES_PASSTHROUGH:
274 status = cam_periph_alloc(sesregister, sesoninvalidate,
275 sescleanup, sesstart, "ses", CAM_PERIPH_BIO,
276 cgd->ccb_h.path, sesasync, AC_FOUND_DEVICE, cgd);
278 if (status != CAM_REQ_CMP && status != CAM_REQ_INPROG) {
279 printf("sesasync: Unable to probe new device due to "
280 "status 0x%x\n", status);
285 cam_periph_async(periph, code, path, arg);
291 sesregister(struct cam_periph *periph, void *arg)
293 struct ses_softc *softc;
294 struct ccb_getdev *cgd;
297 cgd = (struct ccb_getdev *)arg;
298 if (periph == NULL) {
299 printf("sesregister: periph was NULL!!\n");
300 return (CAM_REQ_CMP_ERR);
304 printf("sesregister: no getdev CCB, can't register device\n");
305 return (CAM_REQ_CMP_ERR);
308 softc = SES_MALLOC(sizeof (struct ses_softc));
310 printf("sesregister: Unable to probe new device. "
311 "Unable to allocate softc\n");
312 return (CAM_REQ_CMP_ERR);
314 bzero(softc, sizeof (struct ses_softc));
315 periph->softc = softc;
316 softc->periph = periph;
318 softc->ses_type = ses_type(&cgd->inq_data, sizeof (cgd->inq_data));
320 switch (softc->ses_type) {
323 case SES_SES_PASSTHROUGH:
324 softc->ses_vec.softc_init = ses_softc_init;
325 softc->ses_vec.init_enc = ses_init_enc;
326 softc->ses_vec.get_encstat = ses_get_encstat;
327 softc->ses_vec.set_encstat = ses_set_encstat;
328 softc->ses_vec.get_objstat = ses_get_objstat;
329 softc->ses_vec.set_objstat = ses_set_objstat;
332 softc->ses_vec.softc_init = safte_softc_init;
333 softc->ses_vec.init_enc = safte_init_enc;
334 softc->ses_vec.get_encstat = safte_get_encstat;
335 softc->ses_vec.set_encstat = safte_set_encstat;
336 softc->ses_vec.get_objstat = safte_get_objstat;
337 softc->ses_vec.set_objstat = safte_set_objstat;
343 free(softc, M_SCSISES);
344 return (CAM_REQ_CMP_ERR);
347 cam_periph_unlock(periph);
348 softc->ses_dev = make_dev(&ses_cdevsw, periph->unit_number,
349 UID_ROOT, GID_OPERATOR, 0600, "%s%d",
350 periph->periph_name, periph->unit_number);
351 cam_periph_lock(periph);
352 softc->ses_dev->si_drv1 = periph;
355 * Add an async callback so that we get
356 * notified if this device goes away.
358 xpt_register_async(AC_LOST_DEVICE, sesasync, periph, periph->path);
360 switch (softc->ses_type) {
363 tname = "No SES device";
366 tname = "SCSI-2 SES Device";
369 tname = "SCSI-3 SES Device";
371 case SES_SES_PASSTHROUGH:
372 tname = "SES Passthrough Device";
375 tname = "UNISYS SEN Device (NOT HANDLED YET)";
378 tname = "SAF-TE Compliant Device";
381 xpt_announce_periph(periph, tname);
382 return (CAM_REQ_CMP);
386 sesopen(struct cdev *dev, int flags, int fmt, struct thread *td)
388 struct cam_periph *periph;
389 struct ses_softc *softc;
392 periph = (struct cam_periph *)dev->si_drv1;
393 if (periph == NULL) {
397 if (cam_periph_acquire(periph) != CAM_REQ_CMP) {
398 cam_periph_unlock(periph);
402 cam_periph_lock(periph);
404 softc = (struct ses_softc *)periph->softc;
406 if (softc->ses_flags & SES_FLAG_INVALID) {
410 if (softc->ses_flags & SES_FLAG_OPEN) {
414 if (softc->ses_vec.softc_init == NULL) {
419 softc->ses_flags |= SES_FLAG_OPEN;
420 if ((softc->ses_flags & SES_FLAG_INITIALIZED) == 0) {
421 error = (*softc->ses_vec.softc_init)(softc, 1);
423 softc->ses_flags &= ~SES_FLAG_OPEN;
425 softc->ses_flags |= SES_FLAG_INITIALIZED;
429 cam_periph_unlock(periph);
431 cam_periph_release(periph);
437 sesclose(struct cdev *dev, int flag, int fmt, struct thread *td)
439 struct cam_periph *periph;
440 struct ses_softc *softc;
445 periph = (struct cam_periph *)dev->si_drv1;
449 cam_periph_lock(periph);
451 softc = (struct ses_softc *)periph->softc;
452 softc->ses_flags &= ~SES_FLAG_OPEN;
454 cam_periph_unlock(periph);
455 cam_periph_release(periph);
461 sesstart(struct cam_periph *p, union ccb *sccb)
463 if (p->immediate_priority <= p->pinfo.priority) {
464 SLIST_INSERT_HEAD(&p->ccb_list, &sccb->ccb_h, periph_links.sle);
465 p->immediate_priority = CAM_PRIORITY_NONE;
466 wakeup(&p->ccb_list);
471 sesdone(struct cam_periph *periph, union ccb *dccb)
473 wakeup(&dccb->ccb_h.cbfcnp);
477 seserror(union ccb *ccb, uint32_t cflags, uint32_t sflags)
479 struct ses_softc *softc;
480 struct cam_periph *periph;
482 periph = xpt_path_periph(ccb->ccb_h.path);
483 softc = (struct ses_softc *)periph->softc;
485 return (cam_periph_error(ccb, cflags, sflags, &softc->ses_saved_ccb));
489 sesioctl(struct cdev *dev, u_long cmd, caddr_t arg_addr, int flag, struct thread *td)
491 struct cam_periph *periph;
495 struct ses_softc *ssc;
501 addr = *((caddr_t *) arg_addr);
505 periph = (struct cam_periph *)dev->si_drv1;
509 CAM_DEBUG(periph->path, CAM_DEBUG_TRACE, ("entering sesioctl\n"));
511 cam_periph_lock(periph);
512 ssc = (struct ses_softc *)periph->softc;
515 * Now check to see whether we're initialized or not.
516 * This actually should never fail as we're not supposed
517 * to get past ses_open w/o successfully initializing
520 if ((ssc->ses_flags & SES_FLAG_INITIALIZED) == 0) {
521 cam_periph_unlock(periph);
524 cam_periph_unlock(periph);
528 CAM_DEBUG(periph->path, CAM_DEBUG_TRACE,
529 ("trying to do ioctl %#lx\n", cmd));
532 * If this command can change the device's state,
533 * we must have the device open for writing.
535 * For commands that get information about the
536 * device- we don't need to lock the peripheral
537 * if we aren't running a command. The number
538 * of objects and the contents will stay stable
539 * after the first open that does initialization.
540 * The periph also can't go away while a user
541 * process has it open.
545 case SESIOC_GETOBJMAP:
546 case SESIOC_GETENCSTAT:
547 case SESIOC_GETOBJSTAT:
550 if ((flag & FWRITE) == 0) {
557 error = copyout(&ssc->ses_nobjects, addr,
558 sizeof (ssc->ses_nobjects));
561 case SESIOC_GETOBJMAP:
562 for (uobj = addr, i = 0; i != ssc->ses_nobjects; i++) {
565 kobj.subencid = ssc->ses_objmap[i].subenclosure;
566 kobj.object_type = ssc->ses_objmap[i].enctype;
567 error = copyout(&kobj, &uobj[i], sizeof (ses_object));
574 case SESIOC_GETENCSTAT:
575 cam_periph_lock(periph);
576 error = (*ssc->ses_vec.get_encstat)(ssc, 1);
578 cam_periph_unlock(periph);
581 tmp = ssc->ses_encstat & ~ENCI_SVALID;
582 cam_periph_unlock(periph);
583 error = copyout(&tmp, addr, sizeof (ses_encstat));
584 ssc->ses_encstat = tmp;
587 case SESIOC_SETENCSTAT:
588 error = copyin(addr, &tmp, sizeof (ses_encstat));
591 cam_periph_lock(periph);
592 error = (*ssc->ses_vec.set_encstat)(ssc, tmp, 1);
593 cam_periph_unlock(periph);
596 case SESIOC_GETOBJSTAT:
597 error = copyin(addr, &objs, sizeof (ses_objstat));
600 if (objs.obj_id >= ssc->ses_nobjects) {
604 cam_periph_lock(periph);
605 error = (*ssc->ses_vec.get_objstat)(ssc, &objs, 1);
606 cam_periph_unlock(periph);
609 error = copyout(&objs, addr, sizeof (ses_objstat));
611 * Always (for now) invalidate entry.
613 ssc->ses_objmap[objs.obj_id].svalid = 0;
616 case SESIOC_SETOBJSTAT:
617 error = copyin(addr, &objs, sizeof (ses_objstat));
621 if (objs.obj_id >= ssc->ses_nobjects) {
625 cam_periph_lock(periph);
626 error = (*ssc->ses_vec.set_objstat)(ssc, &objs, 1);
627 cam_periph_unlock(periph);
630 * Always (for now) invalidate entry.
632 ssc->ses_objmap[objs.obj_id].svalid = 0;
637 cam_periph_lock(periph);
638 error = (*ssc->ses_vec.init_enc)(ssc);
639 cam_periph_unlock(periph);
643 cam_periph_lock(periph);
644 error = cam_periph_ioctl(periph, cmd, arg_addr, seserror);
645 cam_periph_unlock(periph);
651 #define SES_CFLAGS CAM_RETRY_SELTO
652 #define SES_FLAGS SF_NO_PRINT | SF_RETRY_UA
654 ses_runcmd(struct ses_softc *ssc, char *cdb, int cdbl, char *dptr, int *dlenp)
661 if ((dlen = *dlenp) < 0) {
672 if (cdbl > IOCDBLEN) {
676 ccb = cam_periph_getccb(ssc->periph, 1);
677 cam_fill_csio(&ccb->csio, 0, sesdone, ddf, MSG_SIMPLE_Q_TAG, dptr,
678 dlen, sizeof (struct scsi_sense_data), cdbl, 60 * 1000);
679 bcopy(cdb, ccb->csio.cdb_io.cdb_bytes, cdbl);
681 error = cam_periph_runccb(ccb, seserror, SES_CFLAGS, SES_FLAGS, NULL);
688 *dlenp = ccb->csio.resid;
691 xpt_release_ccb(ccb);
696 ses_log(struct ses_softc *ssc, const char *fmt, ...)
700 printf("%s%d: ", ssc->periph->periph_name, ssc->periph->unit_number);
707 * The code after this point runs on many platforms,
708 * so forgive the slightly awkward and nonconforming
713 * Is this a device that supports enclosure services?
715 * It's a pretty simple ruleset- if it is device type 0x0D (13), it's
716 * an SES device. If it happens to be an old UNISYS SEN device, we can
720 #define SAFTE_START 44
722 #define SAFTE_LEN SAFTE_END-SAFTE_START
725 ses_type(void *buf, int buflen)
727 unsigned char *iqd = buf;
729 if (buflen < 8+SEN_ID_LEN)
732 if ((iqd[0] & 0x1f) == T_ENCLOSURE) {
733 if (STRNCMP(&iqd[8], SEN_ID, SEN_ID_LEN) == 0) {
735 } else if ((iqd[2] & 0x7) > 2) {
738 return (SES_SES_SCSI2);
743 #ifdef SES_ENABLE_PASSTHROUGH
744 if ((iqd[6] & 0x40) && (iqd[2] & 0x7) >= 2) {
746 * PassThrough Device.
748 return (SES_SES_PASSTHROUGH);
753 * The comparison is short for a reason-
754 * some vendors were chopping it short.
757 if (buflen < SAFTE_END - 2) {
761 if (STRNCMP((char *)&iqd[SAFTE_START], "SAF-TE", SAFTE_LEN - 2) == 0) {
768 * SES Native Type Device Support
772 * SES Diagnostic Page Codes
778 #define SesStatusPage SesControlPage
781 #define SesStringIn SesStringOut
783 #define SesThresholdIn SesThresholdOut
785 #define SesArrayStatus SesArrayControl
786 SesElementDescriptor,
795 * Minimum amount of data, starting from byte 0, to have
798 #define SES_CFGHDR_MINLEN 12
801 * Minimum amount of data, starting from byte 0, to have
802 * the config header and one enclosure header.
804 #define SES_ENCHDR_MINLEN 48
807 * Take this value, subtract it from VEnclen and you know
808 * the length of the vendor unique bytes.
810 #define SES_ENCHDR_VMIN 36
813 * SES Data Structures
817 uint32_t GenCode; /* Generation Code */
818 uint8_t Nsubenc; /* Number of Subenclosures */
822 uint8_t Subencid; /* SubEnclosure Identifier */
823 uint8_t Ntypes; /* # of supported types */
824 uint8_t VEnclen; /* Enclosure Descriptor Length */
828 uint8_t encWWN[8]; /* XXX- Not Right Yet */
836 uint8_t enc_type; /* type of element */
837 uint8_t enc_maxelt; /* maximum supported */
838 uint8_t enc_subenc; /* in SubEnc # N */
839 uint8_t enc_tlen; /* Type Descriptor Text Length */
853 uint8_t ses_ntypes; /* total number of types supported */
856 * We need to keep a type index as well as an
857 * object index for each object in an enclosure.
859 struct typidx *ses_typidx;
862 * We also need to keep track of the number of elements
863 * per type of element. This is needed later so that we
864 * can find precisely in the returned status data the
865 * status for the Nth element of the Kth type.
867 uint8_t * ses_eltmap;
872 * (de)canonicalization defines
874 #define sbyte(x, byte) ((((uint32_t)(x)) >> (byte * 8)) & 0xff)
875 #define sbit(x, bit) (((uint32_t)(x)) << bit)
876 #define sset8(outp, idx, sval) (((uint8_t *)(outp))[idx++]) = sbyte(sval, 0)
878 #define sset16(outp, idx, sval) \
879 (((uint8_t *)(outp))[idx++]) = sbyte(sval, 1), \
880 (((uint8_t *)(outp))[idx++]) = sbyte(sval, 0)
883 #define sset24(outp, idx, sval) \
884 (((uint8_t *)(outp))[idx++]) = sbyte(sval, 2), \
885 (((uint8_t *)(outp))[idx++]) = sbyte(sval, 1), \
886 (((uint8_t *)(outp))[idx++]) = sbyte(sval, 0)
889 #define sset32(outp, idx, sval) \
890 (((uint8_t *)(outp))[idx++]) = sbyte(sval, 3), \
891 (((uint8_t *)(outp))[idx++]) = sbyte(sval, 2), \
892 (((uint8_t *)(outp))[idx++]) = sbyte(sval, 1), \
893 (((uint8_t *)(outp))[idx++]) = sbyte(sval, 0)
895 #define gbyte(x, byte) ((((uint32_t)(x)) & 0xff) << (byte * 8))
896 #define gbit(lv, in, idx, shft, mask) lv = ((in[idx] >> shft) & mask)
897 #define sget8(inp, idx, lval) lval = (((uint8_t *)(inp))[idx++])
898 #define gget8(inp, idx, lval) lval = (((uint8_t *)(inp))[idx])
900 #define sget16(inp, idx, lval) \
901 lval = gbyte((((uint8_t *)(inp))[idx]), 1) | \
902 (((uint8_t *)(inp))[idx+1]), idx += 2
904 #define gget16(inp, idx, lval) \
905 lval = gbyte((((uint8_t *)(inp))[idx]), 1) | \
906 (((uint8_t *)(inp))[idx+1])
908 #define sget24(inp, idx, lval) \
909 lval = gbyte((((uint8_t *)(inp))[idx]), 2) | \
910 gbyte((((uint8_t *)(inp))[idx+1]), 1) | \
911 (((uint8_t *)(inp))[idx+2]), idx += 3
913 #define gget24(inp, idx, lval) \
914 lval = gbyte((((uint8_t *)(inp))[idx]), 2) | \
915 gbyte((((uint8_t *)(inp))[idx+1]), 1) | \
916 (((uint8_t *)(inp))[idx+2])
918 #define sget32(inp, idx, lval) \
919 lval = gbyte((((uint8_t *)(inp))[idx]), 3) | \
920 gbyte((((uint8_t *)(inp))[idx+1]), 2) | \
921 gbyte((((uint8_t *)(inp))[idx+2]), 1) | \
922 (((uint8_t *)(inp))[idx+3]), idx += 4
924 #define gget32(inp, idx, lval) \
925 lval = gbyte((((uint8_t *)(inp))[idx]), 3) | \
926 gbyte((((uint8_t *)(inp))[idx+1]), 2) | \
927 gbyte((((uint8_t *)(inp))[idx+2]), 1) | \
928 (((uint8_t *)(inp))[idx+3])
931 #define CFLEN (256 + SES_ENCHDR_MINLEN)
934 * Routines specific && private to SES only
937 static int ses_getconfig(ses_softc_t *);
938 static int ses_getputstat(ses_softc_t *, int, SesComStat *, int, int);
939 static int ses_cfghdr(uint8_t *, int, SesCfgHdr *);
940 static int ses_enchdr(uint8_t *, int, uint8_t, SesEncHdr *);
941 static int ses_encdesc(uint8_t *, int, uint8_t, SesEncDesc *);
942 static int ses_getthdr(uint8_t *, int, int, SesThdr *);
943 static int ses_decode(char *, int, uint8_t *, int, int, SesComStat *);
944 static int ses_encode(char *, int, uint8_t *, int, int, SesComStat *);
947 ses_softc_init(ses_softc_t *ssc, int doinit)
951 if (ssc->ses_nobjects) {
952 SES_FREE(ssc->ses_objmap,
953 ssc->ses_nobjects * sizeof (encobj));
954 ssc->ses_objmap = NULL;
956 if ((cc = ssc->ses_private) != NULL) {
957 if (cc->ses_eltmap && cc->ses_ntypes) {
958 SES_FREE(cc->ses_eltmap, cc->ses_ntypes);
959 cc->ses_eltmap = NULL;
962 if (cc->ses_typidx && ssc->ses_nobjects) {
963 SES_FREE(cc->ses_typidx,
964 ssc->ses_nobjects * sizeof (struct typidx));
965 cc->ses_typidx = NULL;
967 SES_FREE(cc, sizeof (struct sscfg));
968 ssc->ses_private = NULL;
970 ssc->ses_nobjects = 0;
973 if (ssc->ses_private == NULL) {
974 ssc->ses_private = SES_MALLOC(sizeof (struct sscfg));
976 if (ssc->ses_private == NULL) {
979 ssc->ses_nobjects = 0;
980 ssc->ses_encstat = 0;
981 return (ses_getconfig(ssc));
985 ses_init_enc(ses_softc_t *ssc)
991 ses_get_encstat(ses_softc_t *ssc, int slpflag)
996 if ((status = ses_getputstat(ssc, -1, &ComStat, slpflag, 1)) != 0) {
999 ssc->ses_encstat = ComStat.comstatus | ENCI_SVALID;
1004 ses_set_encstat(ses_softc_t *ssc, uint8_t encstat, int slpflag)
1009 ComStat.comstatus = encstat & 0xf;
1010 if ((status = ses_getputstat(ssc, -1, &ComStat, slpflag, 0)) != 0) {
1013 ssc->ses_encstat = encstat & 0xf; /* note no SVALID set */
1018 ses_get_objstat(ses_softc_t *ssc, ses_objstat *obp, int slpflag)
1020 int i = (int)obp->obj_id;
1022 if (ssc->ses_objmap[i].svalid == 0) {
1024 int err = ses_getputstat(ssc, i, &ComStat, slpflag, 1);
1027 ssc->ses_objmap[i].encstat[0] = ComStat.comstatus;
1028 ssc->ses_objmap[i].encstat[1] = ComStat.comstat[0];
1029 ssc->ses_objmap[i].encstat[2] = ComStat.comstat[1];
1030 ssc->ses_objmap[i].encstat[3] = ComStat.comstat[2];
1031 ssc->ses_objmap[i].svalid = 1;
1033 obp->cstat[0] = ssc->ses_objmap[i].encstat[0];
1034 obp->cstat[1] = ssc->ses_objmap[i].encstat[1];
1035 obp->cstat[2] = ssc->ses_objmap[i].encstat[2];
1036 obp->cstat[3] = ssc->ses_objmap[i].encstat[3];
1041 ses_set_objstat(ses_softc_t *ssc, ses_objstat *obp, int slpflag)
1046 * If this is clear, we don't do diddly.
1048 if ((obp->cstat[0] & SESCTL_CSEL) == 0) {
1051 ComStat.comstatus = obp->cstat[0];
1052 ComStat.comstat[0] = obp->cstat[1];
1053 ComStat.comstat[1] = obp->cstat[2];
1054 ComStat.comstat[2] = obp->cstat[3];
1055 err = ses_getputstat(ssc, (int)obp->obj_id, &ComStat, slpflag, 0);
1056 ssc->ses_objmap[(int)obp->obj_id].svalid = 0;
1061 ses_getconfig(ses_softc_t *ssc)
1068 int err, amt, i, nobj, ntype, maxima;
1069 char storage[CFLEN], *sdata;
1070 static char cdb[6] = {
1071 RECEIVE_DIAGNOSTIC, 0x1, SesConfigPage, SCSZ >> 8, SCSZ & 0xff, 0
1074 cc = ssc->ses_private;
1079 sdata = SES_MALLOC(SCSZ);
1084 err = ses_runcmd(ssc, cdb, 6, sdata, &amt);
1086 SES_FREE(sdata, SCSZ);
1091 if (ses_cfghdr((uint8_t *) sdata, amt, &cf)) {
1092 SES_LOG(ssc, "Unable to parse SES Config Header\n");
1093 SES_FREE(sdata, SCSZ);
1096 if (amt < SES_ENCHDR_MINLEN) {
1097 SES_LOG(ssc, "runt enclosure length (%d)\n", amt);
1098 SES_FREE(sdata, SCSZ);
1102 SES_VLOG(ssc, "GenCode %x %d Subenclosures\n", cf.GenCode, cf.Nsubenc);
1105 * Now waltz through all the subenclosures toting up the
1106 * number of types available in each. For this, we only
1107 * really need the enclosure header. However, we get the
1108 * enclosure descriptor for debug purposes, as well
1109 * as self-consistency checking purposes.
1112 maxima = cf.Nsubenc + 1;
1113 cdp = (SesEncDesc *) storage;
1114 for (ntype = i = 0; i < maxima; i++) {
1115 MEMZERO((caddr_t)cdp, sizeof (*cdp));
1116 if (ses_enchdr((uint8_t *) sdata, amt, i, &hd)) {
1117 SES_LOG(ssc, "Cannot Extract Enclosure Header %d\n", i);
1118 SES_FREE(sdata, SCSZ);
1121 SES_VLOG(ssc, " SubEnclosure ID %d, %d Types With this ID, En"
1122 "closure Length %d\n", hd.Subencid, hd.Ntypes, hd.VEnclen);
1124 if (ses_encdesc((uint8_t *)sdata, amt, i, cdp)) {
1125 SES_LOG(ssc, "Can't get Enclosure Descriptor %d\n", i);
1126 SES_FREE(sdata, SCSZ);
1129 SES_VLOG(ssc, " WWN: %02x%02x%02x%02x%02x%02x%02x%02x\n",
1130 cdp->encWWN[0], cdp->encWWN[1], cdp->encWWN[2],
1131 cdp->encWWN[3], cdp->encWWN[4], cdp->encWWN[5],
1132 cdp->encWWN[6], cdp->encWWN[7]);
1137 * Now waltz through all the types that are available, getting
1138 * the type header so we can start adding up the number of
1139 * objects available.
1141 for (nobj = i = 0; i < ntype; i++) {
1142 if (ses_getthdr((uint8_t *)sdata, amt, i, &thdr)) {
1143 SES_LOG(ssc, "Can't get Enclosure Type Header %d\n", i);
1144 SES_FREE(sdata, SCSZ);
1147 SES_LOG(ssc, " Type Desc[%d]: Type 0x%x, MaxElt %d, In Subenc "
1148 "%d, Text Length %d\n", i, thdr.enc_type, thdr.enc_maxelt,
1149 thdr.enc_subenc, thdr.enc_tlen);
1150 nobj += thdr.enc_maxelt;
1155 * Now allocate the object array and type map.
1158 ssc->ses_objmap = SES_MALLOC(nobj * sizeof (encobj));
1159 cc->ses_typidx = SES_MALLOC(nobj * sizeof (struct typidx));
1160 cc->ses_eltmap = SES_MALLOC(ntype);
1162 if (ssc->ses_objmap == NULL || cc->ses_typidx == NULL ||
1163 cc->ses_eltmap == NULL) {
1164 if (ssc->ses_objmap) {
1165 SES_FREE(ssc->ses_objmap, (nobj * sizeof (encobj)));
1166 ssc->ses_objmap = NULL;
1168 if (cc->ses_typidx) {
1169 SES_FREE(cc->ses_typidx,
1170 (nobj * sizeof (struct typidx)));
1171 cc->ses_typidx = NULL;
1173 if (cc->ses_eltmap) {
1174 SES_FREE(cc->ses_eltmap, ntype);
1175 cc->ses_eltmap = NULL;
1177 SES_FREE(sdata, SCSZ);
1180 MEMZERO(ssc->ses_objmap, nobj * sizeof (encobj));
1181 MEMZERO(cc->ses_typidx, nobj * sizeof (struct typidx));
1182 MEMZERO(cc->ses_eltmap, ntype);
1183 cc->ses_ntypes = (uint8_t) ntype;
1184 ssc->ses_nobjects = nobj;
1187 * Now waltz through the # of types again to fill in the types
1188 * (and subenclosure ids) of the allocated objects.
1191 for (i = 0; i < ntype; i++) {
1193 if (ses_getthdr((uint8_t *)sdata, amt, i, &thdr)) {
1196 cc->ses_eltmap[i] = thdr.enc_maxelt;
1197 for (j = 0; j < thdr.enc_maxelt; j++) {
1198 cc->ses_typidx[nobj].ses_tidx = i;
1199 cc->ses_typidx[nobj].ses_oidx = j;
1200 ssc->ses_objmap[nobj].subenclosure = thdr.enc_subenc;
1201 ssc->ses_objmap[nobj++].enctype = thdr.enc_type;
1204 SES_FREE(sdata, SCSZ);
1209 ses_getputstat(ses_softc_t *ssc, int objid, SesComStat *sp, int slp, int in)
1212 int err, amt, bufsiz, tidx, oidx;
1213 char cdb[6], *sdata;
1215 cc = ssc->ses_private;
1221 * If we're just getting overall enclosure status,
1222 * we only need 2 bytes of data storage.
1224 * If we're getting anything else, we know how much
1225 * storage we need by noting that starting at offset
1226 * 8 in returned data, all object status bytes are 4
1227 * bytes long, and are stored in chunks of types(M)
1228 * and nth+1 instances of type M.
1233 bufsiz = (ssc->ses_nobjects * 4) + (cc->ses_ntypes * 4) + 8;
1235 sdata = SES_MALLOC(bufsiz);
1239 cdb[0] = RECEIVE_DIAGNOSTIC;
1241 cdb[2] = SesStatusPage;
1242 cdb[3] = bufsiz >> 8;
1243 cdb[4] = bufsiz & 0xff;
1246 err = ses_runcmd(ssc, cdb, 6, sdata, &amt);
1248 SES_FREE(sdata, bufsiz);
1257 tidx = cc->ses_typidx[objid].ses_tidx;
1258 oidx = cc->ses_typidx[objid].ses_oidx;
1261 if (ses_decode(sdata, amt, cc->ses_eltmap, tidx, oidx, sp)) {
1265 if (ses_encode(sdata, amt, cc->ses_eltmap, tidx, oidx, sp)) {
1268 cdb[0] = SEND_DIAGNOSTIC;
1271 cdb[3] = bufsiz >> 8;
1272 cdb[4] = bufsiz & 0xff;
1275 err = ses_runcmd(ssc, cdb, 6, sdata, &amt);
1278 SES_FREE(sdata, bufsiz);
1284 * Routines to parse returned SES data structures.
1285 * Architecture and compiler independent.
1289 ses_cfghdr(uint8_t *buffer, int buflen, SesCfgHdr *cfp)
1291 if (buflen < SES_CFGHDR_MINLEN) {
1294 gget8(buffer, 1, cfp->Nsubenc);
1295 gget32(buffer, 4, cfp->GenCode);
1300 ses_enchdr(uint8_t *buffer, int amt, uint8_t SubEncId, SesEncHdr *chp)
1303 for (s = 0; s < SubEncId; s++) {
1306 off += buffer[off+3] + 4;
1308 if (off + 3 > amt) {
1311 gget8(buffer, off+1, chp->Subencid);
1312 gget8(buffer, off+2, chp->Ntypes);
1313 gget8(buffer, off+3, chp->VEnclen);
1318 ses_encdesc(uint8_t *buffer, int amt, uint8_t SubEncId, SesEncDesc *cdp)
1320 int s, e, enclen, off = 8;
1321 for (s = 0; s < SubEncId; s++) {
1324 off += buffer[off+3] + 4;
1326 if (off + 3 > amt) {
1329 gget8(buffer, off+3, enclen);
1338 MEMCPY(cdp, &buffer[off], e - off);
1343 ses_getthdr(uint8_t *buffer, int amt, int nth, SesThdr *thp)
1347 if (amt < SES_CFGHDR_MINLEN) {
1350 for (s = 0; s < buffer[1]; s++) {
1353 off += buffer[off+3] + 4;
1355 if (off + 3 > amt) {
1358 off += buffer[off+3] + 4 + (nth * 4);
1359 if (amt < (off + 4))
1362 gget8(buffer, off++, thp->enc_type);
1363 gget8(buffer, off++, thp->enc_maxelt);
1364 gget8(buffer, off++, thp->enc_subenc);
1365 gget8(buffer, off, thp->enc_tlen);
1370 * This function needs a little explanation.
1372 * The arguments are:
1377 * These describes the raw input SES status data and length.
1381 * This is a map of the number of types for each element type
1386 * This is the element type being sought. If elt is -1,
1387 * then overall enclosure status is being sought.
1391 * This is the ordinal Mth element of type elt being sought.
1395 * This is the output area to store the status for
1396 * the Mth element of type Elt.
1400 ses_decode(char *b, int amt, uint8_t *ep, int elt, int elm, SesComStat *sp)
1405 * If it's overall enclosure status being sought, get that.
1406 * We need at least 2 bytes of status data to get that.
1411 gget8(b, 1, sp->comstatus);
1419 * Check to make sure that the Mth element is legal for type Elt.
1426 * Starting at offset 8, start skipping over the storage
1427 * for the element types we're not interested in.
1429 for (idx = 8, i = 0; i < elt; i++) {
1430 idx += ((ep[i] + 1) * 4);
1434 * Skip over Overall status for this element type.
1439 * And skip to the index for the Mth element that we're going for.
1444 * Make sure we haven't overflowed the buffer.
1450 * Retrieve the status.
1452 gget8(b, idx++, sp->comstatus);
1453 gget8(b, idx++, sp->comstat[0]);
1454 gget8(b, idx++, sp->comstat[1]);
1455 gget8(b, idx++, sp->comstat[2]);
1457 PRINTF("Get Elt 0x%x Elm 0x%x (idx %d)\n", elt, elm, idx-4);
1463 * This is the mirror function to ses_decode, but we set the 'select'
1464 * bit for the object which we're interested in. All other objects,
1465 * after a status fetch, should have that bit off. Hmm. It'd be easy
1466 * enough to ensure this, so we will.
1470 ses_encode(char *b, int amt, uint8_t *ep, int elt, int elm, SesComStat *sp)
1475 * If it's overall enclosure status being sought, get that.
1476 * We need at least 2 bytes of status data to get that.
1483 sset8(b, i, sp->comstatus & 0xf);
1485 PRINTF("set EncStat %x\n", sp->comstatus);
1491 * Check to make sure that the Mth element is legal for type Elt.
1498 * Starting at offset 8, start skipping over the storage
1499 * for the element types we're not interested in.
1501 for (idx = 8, i = 0; i < elt; i++) {
1502 idx += ((ep[i] + 1) * 4);
1506 * Skip over Overall status for this element type.
1511 * And skip to the index for the Mth element that we're going for.
1516 * Make sure we haven't overflowed the buffer.
1524 sset8(b, idx, sp->comstatus);
1525 sset8(b, idx, sp->comstat[0]);
1526 sset8(b, idx, sp->comstat[1]);
1527 sset8(b, idx, sp->comstat[2]);
1531 PRINTF("Set Elt 0x%x Elm 0x%x (idx %d) with %x %x %x %x\n",
1532 elt, elm, idx, sp->comstatus, sp->comstat[0],
1533 sp->comstat[1], sp->comstat[2]);
1537 * Now make sure all other 'Select' bits are off.
1539 for (i = 8; i < amt; i += 4) {
1544 * And make sure the INVOP bit is clear.
1552 * SAF-TE Type Device Emulation
1555 static int safte_getconfig(ses_softc_t *);
1556 static int safte_rdstat(ses_softc_t *, int);
1557 static int set_objstat_sel(ses_softc_t *, ses_objstat *, int);
1558 static int wrbuf16(ses_softc_t *, uint8_t, uint8_t, uint8_t, uint8_t, int);
1559 static void wrslot_stat(ses_softc_t *, int);
1560 static int perf_slotop(ses_softc_t *, uint8_t, uint8_t, int);
1562 #define ALL_ENC_STAT (SES_ENCSTAT_CRITICAL | SES_ENCSTAT_UNRECOV | \
1563 SES_ENCSTAT_NONCRITICAL | SES_ENCSTAT_INFO)
1565 * SAF-TE specific defines- Mandatory ones only...
1569 * READ BUFFER ('get' commands) IDs- placed in offset 2 of cdb
1571 #define SAFTE_RD_RDCFG 0x00 /* read enclosure configuration */
1572 #define SAFTE_RD_RDESTS 0x01 /* read enclosure status */
1573 #define SAFTE_RD_RDDSTS 0x04 /* read drive slot status */
1576 * WRITE BUFFER ('set' commands) IDs- placed in offset 0 of databuf
1578 #define SAFTE_WT_DSTAT 0x10 /* write device slot status */
1579 #define SAFTE_WT_SLTOP 0x12 /* perform slot operation */
1580 #define SAFTE_WT_FANSPD 0x13 /* set fan speed */
1581 #define SAFTE_WT_ACTPWS 0x14 /* turn on/off power supply */
1582 #define SAFTE_WT_GLOBAL 0x15 /* send global command */
1585 #define SAFT_SCRATCH 64
1586 #define NPSEUDO_THERM 16
1587 #define NPSEUDO_ALARM 1
1590 * Cached Configuration
1592 uint8_t Nfans; /* Number of Fans */
1593 uint8_t Npwr; /* Number of Power Supplies */
1594 uint8_t Nslots; /* Number of Device Slots */
1595 uint8_t DoorLock; /* Door Lock Installed */
1596 uint8_t Ntherm; /* Number of Temperature Sensors */
1597 uint8_t Nspkrs; /* Number of Speakers */
1598 uint8_t Nalarm; /* Number of Alarms (at least one) */
1600 * Cached Flag Bytes for Global Status
1605 * What object index ID is where various slots start.
1609 #define SAFT_ALARM_OFFSET(cc) (cc)->slotoff - 1
1612 #define SAFT_FLG1_ALARM 0x1
1613 #define SAFT_FLG1_GLOBFAIL 0x2
1614 #define SAFT_FLG1_GLOBWARN 0x4
1615 #define SAFT_FLG1_ENCPWROFF 0x8
1616 #define SAFT_FLG1_ENCFANFAIL 0x10
1617 #define SAFT_FLG1_ENCPWRFAIL 0x20
1618 #define SAFT_FLG1_ENCDRVFAIL 0x40
1619 #define SAFT_FLG1_ENCDRVWARN 0x80
1621 #define SAFT_FLG2_LOCKDOOR 0x4
1622 #define SAFT_PRIVATE sizeof (struct scfg)
1624 static char *safte_2little = "Too Little Data Returned (%d) at line %d\n";
1625 #define SAFT_BAIL(r, x, k, l) \
1627 SES_LOG(ssc, safte_2little, x, __LINE__);\
1628 SES_FREE((k), (l)); \
1634 safte_softc_init(ses_softc_t *ssc, int doinit)
1640 if (ssc->ses_nobjects) {
1641 if (ssc->ses_objmap) {
1642 SES_FREE(ssc->ses_objmap,
1643 ssc->ses_nobjects * sizeof (encobj));
1644 ssc->ses_objmap = NULL;
1646 ssc->ses_nobjects = 0;
1648 if (ssc->ses_private) {
1649 SES_FREE(ssc->ses_private, SAFT_PRIVATE);
1650 ssc->ses_private = NULL;
1655 if (ssc->ses_private == NULL) {
1656 ssc->ses_private = SES_MALLOC(SAFT_PRIVATE);
1657 if (ssc->ses_private == NULL) {
1660 MEMZERO(ssc->ses_private, SAFT_PRIVATE);
1663 ssc->ses_nobjects = 0;
1664 ssc->ses_encstat = 0;
1666 if ((err = safte_getconfig(ssc)) != 0) {
1671 * The number of objects here, as well as that reported by the
1672 * READ_BUFFER/GET_CONFIG call, are the over-temperature flags (15)
1673 * that get reported during READ_BUFFER/READ_ENC_STATUS.
1675 cc = ssc->ses_private;
1676 ssc->ses_nobjects = cc->Nfans + cc->Npwr + cc->Nslots + cc->DoorLock +
1677 cc->Ntherm + cc->Nspkrs + NPSEUDO_THERM + NPSEUDO_ALARM;
1678 ssc->ses_objmap = (encobj *)
1679 SES_MALLOC(ssc->ses_nobjects * sizeof (encobj));
1680 if (ssc->ses_objmap == NULL) {
1683 MEMZERO(ssc->ses_objmap, ssc->ses_nobjects * sizeof (encobj));
1687 * Note that this is all arranged for the convenience
1688 * in later fetches of status.
1690 for (i = 0; i < cc->Nfans; i++)
1691 ssc->ses_objmap[r++].enctype = SESTYP_FAN;
1692 cc->pwroff = (uint8_t) r;
1693 for (i = 0; i < cc->Npwr; i++)
1694 ssc->ses_objmap[r++].enctype = SESTYP_POWER;
1695 for (i = 0; i < cc->DoorLock; i++)
1696 ssc->ses_objmap[r++].enctype = SESTYP_DOORLOCK;
1697 for (i = 0; i < cc->Nspkrs; i++)
1698 ssc->ses_objmap[r++].enctype = SESTYP_ALARM;
1699 for (i = 0; i < cc->Ntherm; i++)
1700 ssc->ses_objmap[r++].enctype = SESTYP_THERM;
1701 for (i = 0; i < NPSEUDO_THERM; i++)
1702 ssc->ses_objmap[r++].enctype = SESTYP_THERM;
1703 ssc->ses_objmap[r++].enctype = SESTYP_ALARM;
1704 cc->slotoff = (uint8_t) r;
1705 for (i = 0; i < cc->Nslots; i++)
1706 ssc->ses_objmap[r++].enctype = SESTYP_DEVICE;
1711 safte_init_enc(ses_softc_t *ssc)
1714 static char cdb0[6] = { SEND_DIAGNOSTIC };
1716 err = ses_runcmd(ssc, cdb0, 6, NULL, 0);
1721 err = wrbuf16(ssc, SAFTE_WT_GLOBAL, 0, 0, 0, 1);
1726 safte_get_encstat(ses_softc_t *ssc, int slpflg)
1728 return (safte_rdstat(ssc, slpflg));
1732 safte_set_encstat(ses_softc_t *ssc, uint8_t encstat, int slpflg)
1734 struct scfg *cc = ssc->ses_private;
1738 * Since SAF-TE devices aren't necessarily sticky in terms
1739 * of state, make our soft copy of enclosure status 'sticky'-
1740 * that is, things set in enclosure status stay set (as implied
1741 * by conditions set in reading object status) until cleared.
1743 ssc->ses_encstat &= ~ALL_ENC_STAT;
1744 ssc->ses_encstat |= (encstat & ALL_ENC_STAT);
1745 ssc->ses_encstat |= ENCI_SVALID;
1746 cc->flag1 &= ~(SAFT_FLG1_ALARM|SAFT_FLG1_GLOBFAIL|SAFT_FLG1_GLOBWARN);
1747 if ((encstat & (SES_ENCSTAT_CRITICAL|SES_ENCSTAT_UNRECOV)) != 0) {
1748 cc->flag1 |= SAFT_FLG1_ALARM|SAFT_FLG1_GLOBFAIL;
1749 } else if ((encstat & SES_ENCSTAT_NONCRITICAL) != 0) {
1750 cc->flag1 |= SAFT_FLG1_GLOBWARN;
1752 return (wrbuf16(ssc, SAFTE_WT_GLOBAL, cc->flag1, cc->flag2, 0, slpflg));
1756 safte_get_objstat(ses_softc_t *ssc, ses_objstat *obp, int slpflg)
1758 int i = (int)obp->obj_id;
1760 if ((ssc->ses_encstat & ENCI_SVALID) == 0 ||
1761 (ssc->ses_objmap[i].svalid) == 0) {
1762 int err = safte_rdstat(ssc, slpflg);
1766 obp->cstat[0] = ssc->ses_objmap[i].encstat[0];
1767 obp->cstat[1] = ssc->ses_objmap[i].encstat[1];
1768 obp->cstat[2] = ssc->ses_objmap[i].encstat[2];
1769 obp->cstat[3] = ssc->ses_objmap[i].encstat[3];
1775 safte_set_objstat(ses_softc_t *ssc, ses_objstat *obp, int slp)
1782 SES_DLOG(ssc, "safte_set_objstat(%d): %x %x %x %x\n",
1783 (int)obp->obj_id, obp->cstat[0], obp->cstat[1], obp->cstat[2],
1787 * If this is clear, we don't do diddly.
1789 if ((obp->cstat[0] & SESCTL_CSEL) == 0) {
1795 * Check to see if the common bits are set and do them first.
1797 if (obp->cstat[0] & ~SESCTL_CSEL) {
1798 err = set_objstat_sel(ssc, obp, slp);
1803 cc = ssc->ses_private;
1807 idx = (int)obp->obj_id;
1808 ep = &ssc->ses_objmap[idx];
1810 switch (ep->enctype) {
1815 * XXX: I should probably cache the previous state
1816 * XXX: of SESCTL_DEVOFF so that when it goes from
1817 * XXX: true to false I can then set PREPARE FOR OPERATION
1818 * XXX: flag in PERFORM SLOT OPERATION write buffer command.
1820 if (obp->cstat[2] & (SESCTL_RQSINS|SESCTL_RQSRMV)) {
1823 if (obp->cstat[2] & SESCTL_RQSID) {
1826 err = perf_slotop(ssc, (uint8_t) idx - (uint8_t) cc->slotoff,
1830 if (obp->cstat[3] & SESCTL_RQSFLT) {
1835 if (ep->priv & 0xc6) {
1838 ep->priv |= 0x1; /* no errors */
1840 wrslot_stat(ssc, slp);
1844 if (obp->cstat[3] & SESCTL_RQSTFAIL) {
1845 cc->flag1 |= SAFT_FLG1_ENCPWRFAIL;
1847 cc->flag1 &= ~SAFT_FLG1_ENCPWRFAIL;
1849 err = wrbuf16(ssc, SAFTE_WT_GLOBAL, cc->flag1,
1853 if (obp->cstat[3] & SESCTL_RQSTON) {
1854 (void) wrbuf16(ssc, SAFTE_WT_ACTPWS,
1855 idx - cc->pwroff, 0, 0, slp);
1857 (void) wrbuf16(ssc, SAFTE_WT_ACTPWS,
1858 idx - cc->pwroff, 0, 1, slp);
1862 if (obp->cstat[3] & SESCTL_RQSTFAIL) {
1863 cc->flag1 |= SAFT_FLG1_ENCFANFAIL;
1865 cc->flag1 &= ~SAFT_FLG1_ENCFANFAIL;
1867 err = wrbuf16(ssc, SAFTE_WT_GLOBAL, cc->flag1,
1871 if (obp->cstat[3] & SESCTL_RQSTON) {
1873 if ((obp->cstat[3] & 0x7) == 7) {
1875 } else if ((obp->cstat[3] & 0x7) == 6) {
1877 } else if ((obp->cstat[3] & 0x7) == 4) {
1882 (void) wrbuf16(ssc, SAFTE_WT_FANSPD, idx, fsp, 0, slp);
1884 (void) wrbuf16(ssc, SAFTE_WT_FANSPD, idx, 0, 0, slp);
1887 case SESTYP_DOORLOCK:
1888 if (obp->cstat[3] & 0x1) {
1889 cc->flag2 &= ~SAFT_FLG2_LOCKDOOR;
1891 cc->flag2 |= SAFT_FLG2_LOCKDOOR;
1893 (void) wrbuf16(ssc, SAFTE_WT_GLOBAL, cc->flag1,
1898 * On all nonzero but the 'muted' bit, we turn on the alarm,
1900 obp->cstat[3] &= ~0xa;
1901 if (obp->cstat[3] & 0x40) {
1902 cc->flag2 &= ~SAFT_FLG1_ALARM;
1903 } else if (obp->cstat[3] != 0) {
1904 cc->flag2 |= SAFT_FLG1_ALARM;
1906 cc->flag2 &= ~SAFT_FLG1_ALARM;
1908 ep->priv = obp->cstat[3];
1909 (void) wrbuf16(ssc, SAFTE_WT_GLOBAL, cc->flag1,
1920 safte_getconfig(ses_softc_t *ssc)
1925 static char cdb[10] =
1926 { READ_BUFFER, 1, SAFTE_RD_RDCFG, 0, 0, 0, 0, 0, SAFT_SCRATCH, 0 };
1928 cfg = ssc->ses_private;
1932 sdata = SES_MALLOC(SAFT_SCRATCH);
1937 err = ses_runcmd(ssc, cdb, 10, sdata, &amt);
1939 SES_FREE(sdata, SAFT_SCRATCH);
1942 amt = SAFT_SCRATCH - amt;
1944 SES_LOG(ssc, "too little data (%d) for configuration\n", amt);
1945 SES_FREE(sdata, SAFT_SCRATCH);
1948 SES_VLOG(ssc, "Nfans %d Npwr %d Nslots %d Lck %d Ntherm %d Nspkrs %d\n",
1949 sdata[0], sdata[1], sdata[2], sdata[3], sdata[4], sdata[5]);
1950 cfg->Nfans = sdata[0];
1951 cfg->Npwr = sdata[1];
1952 cfg->Nslots = sdata[2];
1953 cfg->DoorLock = sdata[3];
1954 cfg->Ntherm = sdata[4];
1955 cfg->Nspkrs = sdata[5];
1956 cfg->Nalarm = NPSEUDO_ALARM;
1957 SES_FREE(sdata, SAFT_SCRATCH);
1962 safte_rdstat(ses_softc_t *ssc, int slpflg)
1964 int err, oid, r, i, hiwater, nitems, amt;
1967 uint8_t status, oencstat;
1968 char *sdata, cdb[10];
1969 struct scfg *cc = ssc->ses_private;
1973 * The number of objects overstates things a bit,
1974 * both for the bogus 'thermometer' entries and
1975 * the drive status (which isn't read at the same
1976 * time as the enclosure status), but that's okay.
1978 buflen = 4 * cc->Nslots;
1979 if (ssc->ses_nobjects > buflen)
1980 buflen = ssc->ses_nobjects;
1981 sdata = SES_MALLOC(buflen);
1985 cdb[0] = READ_BUFFER;
1987 cdb[2] = SAFTE_RD_RDESTS;
1992 cdb[7] = (buflen >> 8) & 0xff;
1993 cdb[8] = buflen & 0xff;
1996 err = ses_runcmd(ssc, cdb, 10, sdata, &amt);
1998 SES_FREE(sdata, buflen);
2001 hiwater = buflen - amt;
2005 * invalidate all status bits.
2007 for (i = 0; i < ssc->ses_nobjects; i++)
2008 ssc->ses_objmap[i].svalid = 0;
2009 oencstat = ssc->ses_encstat & ALL_ENC_STAT;
2010 ssc->ses_encstat = 0;
2014 * Now parse returned buffer.
2015 * If we didn't get enough data back,
2016 * that's considered a fatal error.
2020 for (nitems = i = 0; i < cc->Nfans; i++) {
2021 SAFT_BAIL(r, hiwater, sdata, buflen);
2023 * 0 = Fan Operational
2024 * 1 = Fan is malfunctioning
2025 * 2 = Fan is not present
2026 * 0x80 = Unknown or Not Reportable Status
2028 ssc->ses_objmap[oid].encstat[1] = 0; /* resvd */
2029 ssc->ses_objmap[oid].encstat[2] = 0; /* resvd */
2030 switch ((int)(uint8_t)sdata[r]) {
2033 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_OK;
2035 * We could get fancier and cache
2036 * fan speeds that we have set, but
2037 * that isn't done now.
2039 ssc->ses_objmap[oid].encstat[3] = 7;
2043 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_CRIT;
2045 * FAIL and FAN STOPPED synthesized
2047 ssc->ses_objmap[oid].encstat[3] = 0x40;
2049 * Enclosure marked with CRITICAL error
2050 * if only one fan or no thermometers,
2051 * else the NONCRITICAL error is set.
2053 if (cc->Nfans == 1 || cc->Ntherm == 0)
2054 ssc->ses_encstat |= SES_ENCSTAT_CRITICAL;
2056 ssc->ses_encstat |= SES_ENCSTAT_NONCRITICAL;
2059 ssc->ses_objmap[oid].encstat[0] =
2060 SES_OBJSTAT_NOTINSTALLED;
2061 ssc->ses_objmap[oid].encstat[3] = 0;
2063 * Enclosure marked with CRITICAL error
2064 * if only one fan or no thermometers,
2065 * else the NONCRITICAL error is set.
2068 ssc->ses_encstat |= SES_ENCSTAT_CRITICAL;
2070 ssc->ses_encstat |= SES_ENCSTAT_NONCRITICAL;
2073 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_UNKNOWN;
2074 ssc->ses_objmap[oid].encstat[3] = 0;
2075 ssc->ses_encstat |= SES_ENCSTAT_INFO;
2078 ssc->ses_objmap[oid].encstat[0] =
2079 SES_OBJSTAT_UNSUPPORTED;
2080 SES_LOG(ssc, "Unknown fan%d status 0x%x\n", i,
2084 ssc->ses_objmap[oid++].svalid = 1;
2089 * No matter how you cut it, no cooling elements when there
2090 * should be some there is critical.
2092 if (cc->Nfans && nitems == 0) {
2093 ssc->ses_encstat |= SES_ENCSTAT_CRITICAL;
2097 for (i = 0; i < cc->Npwr; i++) {
2098 SAFT_BAIL(r, hiwater, sdata, buflen);
2099 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_UNKNOWN;
2100 ssc->ses_objmap[oid].encstat[1] = 0; /* resvd */
2101 ssc->ses_objmap[oid].encstat[2] = 0; /* resvd */
2102 ssc->ses_objmap[oid].encstat[3] = 0x20; /* requested on */
2103 switch ((uint8_t)sdata[r]) {
2104 case 0x00: /* pws operational and on */
2105 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_OK;
2107 case 0x01: /* pws operational and off */
2108 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_OK;
2109 ssc->ses_objmap[oid].encstat[3] = 0x10;
2110 ssc->ses_encstat |= SES_ENCSTAT_INFO;
2112 case 0x10: /* pws is malfunctioning and commanded on */
2113 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_CRIT;
2114 ssc->ses_objmap[oid].encstat[3] = 0x61;
2115 ssc->ses_encstat |= SES_ENCSTAT_NONCRITICAL;
2118 case 0x11: /* pws is malfunctioning and commanded off */
2119 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_NONCRIT;
2120 ssc->ses_objmap[oid].encstat[3] = 0x51;
2121 ssc->ses_encstat |= SES_ENCSTAT_NONCRITICAL;
2123 case 0x20: /* pws is not present */
2124 ssc->ses_objmap[oid].encstat[0] =
2125 SES_OBJSTAT_NOTINSTALLED;
2126 ssc->ses_objmap[oid].encstat[3] = 0;
2127 ssc->ses_encstat |= SES_ENCSTAT_INFO;
2129 case 0x21: /* pws is present */
2131 * This is for enclosures that cannot tell whether the
2132 * device is on or malfunctioning, but know that it is
2133 * present. Just fall through.
2136 case 0x80: /* Unknown or Not Reportable Status */
2137 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_UNKNOWN;
2138 ssc->ses_objmap[oid].encstat[3] = 0;
2139 ssc->ses_encstat |= SES_ENCSTAT_INFO;
2142 SES_LOG(ssc, "unknown power supply %d status (0x%x)\n",
2143 i, sdata[r] & 0xff);
2146 ssc->ses_objmap[oid++].svalid = 1;
2151 * Skip over Slot SCSI IDs
2156 * We always have doorlock status, no matter what,
2157 * but we only save the status if we have one.
2159 SAFT_BAIL(r, hiwater, sdata, buflen);
2163 * 1 = Door Unlocked, or no Lock Installed
2164 * 0x80 = Unknown or Not Reportable Status
2166 ssc->ses_objmap[oid].encstat[1] = 0;
2167 ssc->ses_objmap[oid].encstat[2] = 0;
2168 switch ((uint8_t)sdata[r]) {
2170 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_OK;
2171 ssc->ses_objmap[oid].encstat[3] = 0;
2174 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_OK;
2175 ssc->ses_objmap[oid].encstat[3] = 1;
2178 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_UNKNOWN;
2179 ssc->ses_objmap[oid].encstat[3] = 0;
2180 ssc->ses_encstat |= SES_ENCSTAT_INFO;
2183 ssc->ses_objmap[oid].encstat[0] =
2184 SES_OBJSTAT_UNSUPPORTED;
2185 SES_LOG(ssc, "unknown lock status 0x%x\n",
2189 ssc->ses_objmap[oid++].svalid = 1;
2194 * We always have speaker status, no matter what,
2195 * but we only save the status if we have one.
2197 SAFT_BAIL(r, hiwater, sdata, buflen);
2199 ssc->ses_objmap[oid].encstat[1] = 0;
2200 ssc->ses_objmap[oid].encstat[2] = 0;
2201 if (sdata[r] == 1) {
2203 * We need to cache tone urgency indicators.
2206 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_NONCRIT;
2207 ssc->ses_objmap[oid].encstat[3] = 0x8;
2208 ssc->ses_encstat |= SES_ENCSTAT_NONCRITICAL;
2209 } else if (sdata[r] == 0) {
2210 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_OK;
2211 ssc->ses_objmap[oid].encstat[3] = 0;
2213 ssc->ses_objmap[oid].encstat[0] =
2214 SES_OBJSTAT_UNSUPPORTED;
2215 ssc->ses_objmap[oid].encstat[3] = 0;
2216 SES_LOG(ssc, "unknown spkr status 0x%x\n",
2219 ssc->ses_objmap[oid++].svalid = 1;
2223 for (i = 0; i < cc->Ntherm; i++) {
2224 SAFT_BAIL(r, hiwater, sdata, buflen);
2226 * Status is a range from -10 to 245 deg Celsius,
2227 * which we need to normalize to -20 to -245 according
2228 * to the latest SCSI spec, which makes little
2229 * sense since this would overflow an 8bit value.
2230 * Well, still, the base normalization is -20,
2231 * not -10, so we have to adjust.
2233 * So what's over and under temperature?
2234 * Hmm- we'll state that 'normal' operating
2235 * is 10 to 40 deg Celsius.
2239 * Actually.... All of the units that people out in the world
2240 * seem to have do not come even close to setting a value that
2241 * complies with this spec.
2243 * The closest explanation I could find was in an
2244 * LSI-Logic manual, which seemed to indicate that
2245 * this value would be set by whatever the I2C code
2246 * would interpolate from the output of an LM75
2247 * temperature sensor.
2249 * This means that it is impossible to use the actual
2250 * numeric value to predict anything. But we don't want
2251 * to lose the value. So, we'll propagate the *uncorrected*
2252 * value and set SES_OBJSTAT_NOTAVAIL. We'll depend on the
2253 * temperature flags for warnings.
2255 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_NOTAVAIL;
2256 ssc->ses_objmap[oid].encstat[1] = 0;
2257 ssc->ses_objmap[oid].encstat[2] = sdata[r];
2258 ssc->ses_objmap[oid].encstat[3] = 0;
2259 ssc->ses_objmap[oid++].svalid = 1;
2264 * Now, for "pseudo" thermometers, we have two bytes
2265 * of information in enclosure status- 16 bits. Actually,
2266 * the MSB is a single TEMP ALERT flag indicating whether
2267 * any other bits are set, but, thanks to fuzzy thinking,
2268 * in the SAF-TE spec, this can also be set even if no
2269 * other bits are set, thus making this really another
2270 * binary temperature sensor.
2273 SAFT_BAIL(r, hiwater, sdata, buflen);
2274 tempflags = sdata[r++];
2275 SAFT_BAIL(r, hiwater, sdata, buflen);
2276 tempflags |= (tempflags << 8) | sdata[r++];
2278 for (i = 0; i < NPSEUDO_THERM; i++) {
2279 ssc->ses_objmap[oid].encstat[1] = 0;
2280 if (tempflags & (1 << (NPSEUDO_THERM - i - 1))) {
2281 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_CRIT;
2282 ssc->ses_objmap[4].encstat[2] = 0xff;
2284 * Set 'over temperature' failure.
2286 ssc->ses_objmap[oid].encstat[3] = 8;
2287 ssc->ses_encstat |= SES_ENCSTAT_CRITICAL;
2290 * We used to say 'not available' and synthesize a
2291 * nominal 30 deg (C)- that was wrong. Actually,
2292 * Just say 'OK', and use the reserved value of
2295 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_OK;
2296 ssc->ses_objmap[oid].encstat[2] = 0;
2297 ssc->ses_objmap[oid].encstat[3] = 0;
2299 ssc->ses_objmap[oid++].svalid = 1;
2305 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_OK;
2306 ssc->ses_objmap[oid].encstat[3] = ssc->ses_objmap[oid].priv;
2307 ssc->ses_objmap[oid++].svalid = 1;
2310 * Now get drive slot status
2312 cdb[2] = SAFTE_RD_RDDSTS;
2314 err = ses_runcmd(ssc, cdb, 10, sdata, &amt);
2316 SES_FREE(sdata, buflen);
2319 hiwater = buflen - amt;
2320 for (r = i = 0; i < cc->Nslots; i++, r += 4) {
2321 SAFT_BAIL(r+3, hiwater, sdata, buflen);
2322 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_UNSUPPORTED;
2323 ssc->ses_objmap[oid].encstat[1] = (uint8_t) i;
2324 ssc->ses_objmap[oid].encstat[2] = 0;
2325 ssc->ses_objmap[oid].encstat[3] = 0;
2326 status = sdata[r+3];
2327 if ((status & 0x1) == 0) { /* no device */
2328 ssc->ses_objmap[oid].encstat[0] =
2329 SES_OBJSTAT_NOTINSTALLED;
2331 ssc->ses_objmap[oid].encstat[0] = SES_OBJSTAT_OK;
2334 ssc->ses_objmap[oid].encstat[2] = 0x8;
2336 if ((status & 0x4) == 0) {
2337 ssc->ses_objmap[oid].encstat[3] = 0x10;
2339 ssc->ses_objmap[oid++].svalid = 1;
2341 /* see comment below about sticky enclosure status */
2342 ssc->ses_encstat |= ENCI_SVALID | oencstat;
2343 SES_FREE(sdata, buflen);
2348 set_objstat_sel(ses_softc_t *ssc, ses_objstat *obp, int slp)
2352 struct scfg *cc = ssc->ses_private;
2357 idx = (int)obp->obj_id;
2358 ep = &ssc->ses_objmap[idx];
2360 switch (ep->enctype) {
2362 if (obp->cstat[0] & SESCTL_PRDFAIL) {
2365 /* SESCTL_RSTSWAP has no correspondence in SAF-TE */
2366 if (obp->cstat[0] & SESCTL_DISABLE) {
2369 * Hmm. Try to set the 'No Drive' flag.
2370 * Maybe that will count as a 'disable'.
2373 if (ep->priv & 0xc6) {
2376 ep->priv |= 0x1; /* no errors */
2378 wrslot_stat(ssc, slp);
2382 * Okay- the only one that makes sense here is to
2383 * do the 'disable' for a power supply.
2385 if (obp->cstat[0] & SESCTL_DISABLE) {
2386 (void) wrbuf16(ssc, SAFTE_WT_ACTPWS,
2387 idx - cc->pwroff, 0, 0, slp);
2392 * Okay- the only one that makes sense here is to
2393 * set fan speed to zero on disable.
2395 if (obp->cstat[0] & SESCTL_DISABLE) {
2396 /* remember- fans are the first items, so idx works */
2397 (void) wrbuf16(ssc, SAFTE_WT_FANSPD, idx, 0, 0, slp);
2400 case SESTYP_DOORLOCK:
2402 * Well, we can 'disable' the lock.
2404 if (obp->cstat[0] & SESCTL_DISABLE) {
2405 cc->flag2 &= ~SAFT_FLG2_LOCKDOOR;
2406 (void) wrbuf16(ssc, SAFTE_WT_GLOBAL, cc->flag1,
2412 * Well, we can 'disable' the alarm.
2414 if (obp->cstat[0] & SESCTL_DISABLE) {
2415 cc->flag2 &= ~SAFT_FLG1_ALARM;
2416 ep->priv |= 0x40; /* Muted */
2417 (void) wrbuf16(ssc, SAFTE_WT_GLOBAL, cc->flag1,
2429 * This function handles all of the 16 byte WRITE BUFFER commands.
2432 wrbuf16(ses_softc_t *ssc, uint8_t op, uint8_t b1, uint8_t b2,
2433 uint8_t b3, int slp)
2437 struct scfg *cc = ssc->ses_private;
2438 static char cdb[10] = { WRITE_BUFFER, 1, 0, 0, 0, 0, 0, 0, 16, 0 };
2443 sdata = SES_MALLOC(16);
2447 SES_DLOG(ssc, "saf_wrbuf16 %x %x %x %x\n", op, b1, b2, b3);
2453 MEMZERO(&sdata[4], 12);
2455 err = ses_runcmd(ssc, cdb, 10, sdata, &amt);
2456 SES_FREE(sdata, 16);
2461 * This function updates the status byte for the device slot described.
2463 * Since this is an optional SAF-TE command, there's no point in
2464 * returning an error.
2467 wrslot_stat(ses_softc_t *ssc, int slp)
2471 char cdb[10], *sdata;
2472 struct scfg *cc = ssc->ses_private;
2477 SES_DLOG(ssc, "saf_wrslot\n");
2478 cdb[0] = WRITE_BUFFER;
2486 cdb[8] = cc->Nslots * 3 + 1;
2489 sdata = SES_MALLOC(cc->Nslots * 3 + 1);
2492 MEMZERO(sdata, cc->Nslots * 3 + 1);
2494 sdata[0] = SAFTE_WT_DSTAT;
2495 for (i = 0; i < cc->Nslots; i++) {
2496 ep = &ssc->ses_objmap[cc->slotoff + i];
2497 SES_DLOG(ssc, "saf_wrslot %d <- %x\n", i, ep->priv & 0xff);
2498 sdata[1 + (3 * i)] = ep->priv & 0xff;
2500 amt = -(cc->Nslots * 3 + 1);
2501 (void) ses_runcmd(ssc, cdb, 10, sdata, &amt);
2502 SES_FREE(sdata, cc->Nslots * 3 + 1);
2506 * This function issues the "PERFORM SLOT OPERATION" command.
2509 perf_slotop(ses_softc_t *ssc, uint8_t slot, uint8_t opflag, int slp)
2513 struct scfg *cc = ssc->ses_private;
2514 static char cdb[10] =
2515 { WRITE_BUFFER, 1, 0, 0, 0, 0, 0, 0, SAFT_SCRATCH, 0 };
2520 sdata = SES_MALLOC(SAFT_SCRATCH);
2523 MEMZERO(sdata, SAFT_SCRATCH);
2525 sdata[0] = SAFTE_WT_SLTOP;
2528 SES_DLOG(ssc, "saf_slotop slot %d op %x\n", slot, opflag);
2529 amt = -SAFT_SCRATCH;
2530 err = ses_runcmd(ssc, cdb, 10, sdata, &amt);
2531 SES_FREE(sdata, SAFT_SCRATCH);