-
Notifications
You must be signed in to change notification settings - Fork 0
/
STUCMethod.c
executable file
·936 lines (838 loc) · 51.9 KB
/
STUCMethod.c
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
/*
File: STUCMethod.c
Description: Part of the sample SCSIOldAndNew. This sample demonstrates how to use the SCSITask User
Client (STUC) and the (as of Mac OS X 10.2) deprecated IOSCSIUserClient APIs to find
SCSI devices and issue a simple INQUIRY command to each device.
Copyright: © Copyright 2003-2006 Apple Computer, Inc. All rights reserved.
Disclaimer: IMPORTANT: This Apple software is supplied to you by Apple Computer, Inc.
("Apple") in consideration of your agreement to the following terms, and your
use, installation, modification or redistribution of this Apple software
constitutes acceptance of these terms. If you do not agree with these terms,
please do not use, install, modify or redistribute this Apple software.
In consideration of your agreement to abide by the following terms, and subject
to these terms, Apple grants you a personal, non-exclusive license, under Apple’s
copyrights in this original Apple software (the "Apple Software"), to use,
reproduce, modify and redistribute the Apple Software, with or without
modifications, in source and/or binary forms; provided that if you redistribute
the Apple Software in its entirety and without modifications, you must retain
this notice and the following text and disclaimers in all such redistributions of
the Apple Software. Neither the name, trademarks, service marks or logos of
Apple Computer, Inc. may be used to endorse or promote products derived from the
Apple Software without specific prior written permission from Apple. Except as
expressly stated in this notice, no other rights or licenses, express or implied,
are granted by Apple herein, including but not limited to any patent rights that
may be infringed by your derivative works or by other works in which the Apple
Software may be incorporated.
The Apple Software is provided by Apple on an "AS IS" basis. APPLE MAKES NO
WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND OPERATION ALONE OR IN
COMBINATION WITH YOUR PRODUCTS.
IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, MODIFICATION AND/OR DISTRIBUTION
OF THE APPLE SOFTWARE, HOWEVER CAUSED AND WHETHER UNDER THEORY OF CONTRACT, TORT
(INCLUDING NEGLIGENCE), STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Change History (most recent first):
1.1 10/10/2006 Updated to produce a universal binary. Now requires Xcode 2.2.1 or
later to build.
1.0 05/08/2003 New sample.
*/
#include <IOKit/scsi-commands/SCSICommandOperationCodes.h>
#include "STUCMethod.h"
void PrintSCSIInquiryDataUsingSTUC(SCSICmd_INQUIRY_StandardData *inquiryData, UInt32 inquiryDataSize)
{
fprintf(stderr, "\n*********** INQUIRY DATA ***********\n");
fprintf(stderr, "Got inquiry results size = %ld\n", inquiryDataSize);
fprintf(stderr, " Peripheral device type = 0x%02x\n", inquiryData->PERIPHERAL_DEVICE_TYPE & kINQUIRY_PERIPHERAL_TYPE_Mask);
fprintf(stderr, " Removable media bit = %d\n", inquiryData->RMB & kINQUIRY_PERIPHERAL_RMB_BitMask);
fprintf(stderr, " Version = 0x%x\n", inquiryData->VERSION);
fprintf(stderr, " Response data format = 0x%x\n", inquiryData->RESPONSE_DATA_FORMAT);
fprintf(stderr, " Additional length = 0x%x\n", inquiryData->ADDITIONAL_LENGTH);
fprintf(stderr, " SCCS and Reserved = 0x%x\n", inquiryData->SCCSReserved);
fprintf(stderr, " Byte 6 flags = 0x%x\n", inquiryData->flags1);
fprintf(stderr, " Byte 7 flags = 0x%x\n", inquiryData->flags2);
// The SCSI Primary Commands spec doesn't require VENDOR IDENTIFICATION, PRODUCT IDENTIFICATION,
// or PRODUCT REVISION LEVEL to be NUL-terminated, hence the precision values in the following
// fprintf format strings.
fprintf(stderr, " Vendor identification = \"%.8s\"\n", inquiryData->VENDOR_IDENTIFICATION);
// Work around misspelling of PRODUCT_IDENTIFICATION in Mac OS X 10.2.8 SDK
#if MAC_OS_X_VERSION_MIN_REQUIRED <= MAC_OS_X_VERSION_10_2
fprintf(stderr, " Product identification = \"%.16s\"\n", inquiryData->PRODUCT_INDENTIFICATION);
#else
fprintf(stderr, " Product identification = \"%.16s\"\n", inquiryData->PRODUCT_IDENTIFICATION);
#endif
fprintf(stderr, " Product revision level = \"%.4s\"\n", inquiryData->PRODUCT_REVISION_LEVEL);
fprintf(stderr, "\n");
}
void PrintSenseString(SCSI_Sense_Data *sense, Boolean addRawValues)
{
char str[256];
UInt8 key;
UInt8 ASC;
UInt8 ASCQ;
key = sense->SENSE_KEY & kSENSE_KEY_Mask;
ASC = sense->ADDITIONAL_SENSE_CODE;
ASCQ = sense->ADDITIONAL_SENSE_CODE_QUALIFIER;
if (addRawValues) {
sprintf(str, "Key: $%02x, ASC: $%02x, ASCQ: $%02x ", key, ASC, ASCQ);
}
else {
str[0] = '\0';
}
switch (key) {
case kSENSE_KEY_NO_SENSE: strcat(str, "No Sense"); break;
case kSENSE_KEY_RECOVERED_ERROR: strcat(str, "Recovered Error"); break;
case kSENSE_KEY_NOT_READY: strcat(str, "Not Ready"); break;
case kSENSE_KEY_MEDIUM_ERROR: strcat(str, "Medium Error"); break;
case kSENSE_KEY_HARDWARE_ERROR: strcat(str, "Hardware Error"); break;
case kSENSE_KEY_ILLEGAL_REQUEST: strcat(str, "Illegal Request"); break;
case kSENSE_KEY_UNIT_ATTENTION: strcat(str, "Unit Attention"); break;
case kSENSE_KEY_DATA_PROTECT: strcat(str, "Data Protect"); break;
case kSENSE_KEY_BLANK_CHECK: strcat(str, "Blank Check"); break;
case kSENSE_KEY_VENDOR_SPECIFIC: strcat(str, "Vendor Specific"); break;
case kSENSE_KEY_COPY_ABORTED: strcat(str, "Copy Aborted"); break;
case kSENSE_KEY_ABORTED_COMMAND: strcat(str, "Aborted Command"); break;
case 0xC: strcat(str, "Equal (now obsolete)"); break;
case kSENSE_KEY_VOLUME_OVERFLOW: strcat(str, "Volume Overflow"); break;
case kSENSE_KEY_MISCOMPARE: strcat(str, "Miscompare"); break;
default: strcat(str, "Unknown Sense Code"); break;
}
strcat(str, ", " );
switch (((UInt16) ASC << 8) | ASCQ) {
case 0x0000: strcat(str, "No additional sense information"); break;
case 0x0001: strcat(str, "Filemark detected"); break;
case 0x0002: strcat(str, "End of partition/medium detected"); break;
case 0x0003: strcat(str, "Setmark detected"); break;
case 0x0004: strcat(str, "Beginning of partition/medium detected"); break;
case 0x0005: strcat(str, "End of data detected"); break;
case 0x0006: strcat(str, "I/O process termination"); break;
case 0x0011: strcat(str, "Play operation in progress"); break;
case 0x0012: strcat(str, "Play operation paused"); break;
case 0x0013: strcat(str, "Play operation successfully completed"); break;
case 0x0014: strcat(str, "Play operation stopped due to error"); break;
case 0x0015: strcat(str, "No current audio status to return"); break;
case 0x0016: strcat(str, "Operation in progress"); break;
case 0x0017: strcat(str, "Cleaning requested"); break;
case 0x0100: strcat(str, "Mechanical positioning or changer error"); break;
case 0x0200: strcat(str, "No seek complete"); break;
case 0x0300: strcat(str, "Peripheral device write fault"); break;
case 0x0301: strcat(str, "No write current"); break;
case 0x0302: strcat(str, "Excessive write errors"); break;
case 0x0400: strcat(str, "Logical unit not ready, cause not reportable"); break;
case 0x0401: strcat(str, "Logical unit not ready, in process of becoming ready"); break;
case 0x0402: strcat(str, "Logical unit not ready, initializing command required"); break;
case 0x0403: strcat(str, "Logical unit not ready, manual intervention required"); break;
case 0x0404: strcat(str, "Logical unit not ready, format in progress"); break;
case 0x0407: strcat(str, "Logical unit not ready, operation in progress"); break;
case 0x0408: strcat(str, "Logical unit not ready, long write in progress"); break;
case 0x0409: strcat(str, "Logical unit not ready, self-test in progress"); break;
case 0x0500: strcat(str, "Logical unit does not respond to selection"); break;
case 0x0501: strcat(str, "Media load - Eject failed"); break;
case 0x0600: strcat(str, "No reference position found"); break;
case 0x0700: strcat(str, "Multiple peripheral devices selected"); break;
case 0x0800: strcat(str, "Logical unit communication failure"); break;
case 0x0801: strcat(str, "Logical unit communication time-out"); break;
case 0x0802: strcat(str, "Logical unit communication parity error"); break;
case 0x0803: strcat(str, "Logical unit communication CRC error (Ultra-DMA/32)"); break;
case 0x0804: strcat(str, "Unreachable copy target"); break;
case 0x0900: strcat(str, "Track following error"); break;
case 0x0901: strcat(str, "Tracking servo failure"); break;
case 0x0902: strcat(str, "Focus servo failure"); break;
case 0x0903: strcat(str, "Spindle servo failure"); break;
case 0x0904: strcat(str, "Head select fault"); break;
case 0x0A00: strcat(str, "Error log overflow"); break;
case 0x0B00: strcat(str, "Warning"); break;
case 0x0B01: strcat(str, "Warning, specified temperature exceeded"); break;
case 0x0B02: strcat(str, "Warning, enclosure degraded"); break;
case 0x0C00: strcat(str, "Write error"); break;
case 0x0C01: strcat(str, "Write error, recovered with auto reallocation"); break;
case 0x0C02: strcat(str, "Write error, auto reallocation failed"); break;
case 0x0C03: strcat(str, "Write error, recommend reassignment"); break;
case 0x0C04: strcat(str, "Compression check miscompare error"); break;
case 0x0C05: strcat(str, "Data expansion occurred during compression"); break;
case 0x0C06: strcat(str, "Block not compressible"); break;
case 0x0C07: strcat(str, "Write error, recovery needed"); break;
case 0x0C08: strcat(str, "Write error, recovery failed"); break;
case 0x0C09: strcat(str, "Write error, loss of streaming"); break;
case 0x0C0A: strcat(str, "Write error, padding blocks added"); break;
case 0x1000: strcat(str, "ID, CRC or ECC error"); break;
case 0x1100: strcat(str, "Unrecovered read error"); break;
case 0x1101: strcat(str, "Read retries exhausted"); break;
case 0x1102: strcat(str, "Error too long to correct"); break;
case 0x1103: strcat(str, "Multiple read errors"); break;
case 0x1104: strcat(str, "Unrecovered read error - auto reallocate failed"); break;
case 0x1105: strcat(str, "L-EC uncorrectable error"); break;
case 0x1106: strcat(str, "CIRC unrecovered error"); break;
case 0x1107: strcat(str, "Re-synchronization error"); break;
case 0x1108: strcat(str, "Incomplete block read"); break;
case 0x1109: strcat(str, "No gap found"); break;
case 0x110A: strcat(str, "Miscorrected error"); break;
case 0x110B: strcat(str, "Unrecovered read error - recommend reassignment"); break;
case 0x110C: strcat(str, "Unrecovered read error - recommend rewrite the data"); break;
case 0x110D: strcat(str, "De-compression CRC error"); break;
case 0x110E: strcat(str, "Cannot decompress using declared algorithm"); break;
case 0x110F: strcat(str, "Error reading UPC/EAN number"); break;
case 0x1110: strcat(str, "Error reading ISRC number"); break;
case 0x1111: strcat(str, "Read error, loss of streaming"); break;
case 0x1200: strcat(str, "Address mark not found for ID field"); break;
case 0x1300: strcat(str, "Address mark not found for data field"); break;
case 0x1400: strcat(str, "Recorded entity not found"); break;
case 0x1401: strcat(str, "Record not found"); break;
case 0x1402: strcat(str, "Filemark or setmark not found"); break;
case 0x1403: strcat(str, "End of data not found"); break;
case 0x1404: strcat(str, "Block sequence error"); break;
case 0x1405: strcat(str, "Record not found - recommend reassignment"); break;
case 0x1406: strcat(str, "Record not found - data auto-reallocated"); break;
case 0x1500: strcat(str, "Random positioning error"); break;
case 0x1501: strcat(str, "Mechanical positioning or changer error"); break;
case 0x1502: strcat(str, "Positioning error detected by read of medium"); break;
case 0x1600: strcat(str, "Data synchronization mark error"); break;
case 0x1601: strcat(str, "Data sync error - data rewritten"); break;
case 0x1602: strcat(str, "Data sync error - recommend rewrite"); break;
case 0x1603: strcat(str, "Data sync error - data auto-reallocated"); break;
case 0x1604: strcat(str, "Data sync error - recommend reassignment"); break;
case 0x1700: strcat(str, "Recovered data with no error correction applied"); break;
case 0x1701: strcat(str, "Recovered data with retries"); break;
case 0x1702: strcat(str, "Recovered data with positive head offset"); break;
case 0x1703: strcat(str, "Recovered data with negative head offset"); break;
case 0x1704: strcat(str, "Recovered data with retries and/or CIRC applied"); break;
case 0x1705: strcat(str, "Recovered data using previous sector ID"); break;
case 0x1706: strcat(str, "Recovered data without ECC, data auto-reallocated"); break;
case 0x1707: strcat(str, "Recovered data without ECC, recommend reassignment"); break;
case 0x1708: strcat(str, "Recovered data without ECC, recommend rewrite"); break;
case 0x1709: strcat(str, "Recivered data without ECC, data rewritten"); break;
case 0x1800: strcat(str, "Recovered data with error correction applied"); break;
case 0x1801: strcat(str, "Recovered data with error correction & retries applied"); break;
case 0x1802: strcat(str, "Recovered data, the data was auto-reallocated"); break;
case 0x1803: strcat(str, "Recovered data with CIRC"); break;
case 0x1804: strcat(str, "Recovered data with L-EC"); break;
case 0x1805: strcat(str, "Recovered data, recommend reassignment"); break;
case 0x1806: strcat(str, "Recovered data, recommend rewrite"); break;
case 0x1807: strcat(str, "Recovered data with ECC, data rewritten"); break;
case 0x1808: strcat(str, "Recovered data with linking"); break;
case 0x1900: strcat(str, "Defect list error"); break;
case 0x1901: strcat(str, "Defect list not available"); break;
case 0x1902: strcat(str, "Defect list error in primary list"); break;
case 0x1903: strcat(str, "Defect list error in grown list"); break;
case 0x1A00: strcat(str, "Parameter list length error"); break;
case 0x1B00: strcat(str, "Synchronous data transfer error"); break;
case 0x1C00: strcat(str, "Defect list not found"); break;
case 0x1C01: strcat(str, "Primary defect list not found"); break;
case 0x1C02: strcat(str, "Grown defect list not found"); break;
case 0x1D00: strcat(str, "Miscompare during verify operation"); break;
case 0x1E00: strcat(str, "Recovered ID with ECC correction"); break;
case 0x1F00: strcat(str, "Partial defect list transfer"); break;
case 0x2000: strcat(str, "Invalid command operation code"); break;
case 0x2100: strcat(str, "Logical block address out of range"); break;
case 0x2101: strcat(str, "Invalid element address"); break;
case 0x2102: strcat(str, "Invalid address for write"); break;
case 0x2200: strcat(str, "Illegal function"); break;
case 0x2400: strcat(str, "Invalid field in CDB"); break;
case 0x2401: strcat(str, "CDB decryption error"); break;
case 0x2500: strcat(str, "Logical unit not supported"); break;
case 0x2600: strcat(str, "Invalid field in parameter list"); break;
case 0x2601: strcat(str, "Parameter not supported"); break;
case 0x2602: strcat(str, "Parameter value invalid"); break;
case 0x2603: strcat(str, "Threshold parameters not supported"); break;
case 0x2604: strcat(str, "Invalid release of active persistent reservation"); break;
case 0x2605: strcat(str, "Data decryption error"); break;
case 0x2606: strcat(str, "Too many target descriptors"); break;
case 0x2607: strcat(str, "Unsupported target descriptor type code"); break;
case 0x2608: strcat(str, "Too many segment descriptors"); break;
case 0x2609: strcat(str, "Unsupported segment descriptor type code"); break;
case 0x260A: strcat(str, "Unexpected inexact segment"); break;
case 0x260B: strcat(str, "Inline data length exceeded"); break;
case 0x260C: strcat(str, "Invalid operation for copy source or destination"); break;
case 0x260D: strcat(str, "Copy segment granularity violation"); break;
case 0x2700: strcat(str, "Write protected"); break;
case 0x2701: strcat(str, "Hardware write protected"); break;
case 0x2702: strcat(str, "Logical unit software write protected"); break;
case 0x2703: strcat(str, "Associated write protect"); break;
case 0x2704: strcat(str, "Persistent write protect"); break;
case 0x2705: strcat(str, "Permanent write protect"); break;
case 0x2800: strcat(str, "Not ready to ready transition, medium may have changed"); break;
case 0x2801: strcat(str, "Import or export element accessed"); break;
case 0x2900: strcat(str, "Power on, reset or bus device reset occurred"); break;
case 0x2901: strcat(str, "Power on occured"); break;
case 0x2902: strcat(str, "SCSI bus reset occurred"); break;
case 0x2903: strcat(str, "Bus device reset function occurred"); break;
case 0x2904: strcat(str, "Device internal reset"); break;
case 0x2905: strcat(str, "Transceiver mode changed to single-ended"); break;
case 0x2906: strcat(str, "Transceiver mode changed to LVD"); break;
case 0x2A00: strcat(str, "Parameters changed"); break;
case 0x2A01: strcat(str, "Mode parameters changed"); break;
case 0x2A02: strcat(str, "Log parameters changed"); break;
case 0x2A03: strcat(str, "Reservations preempted"); break;
case 0x2A04: strcat(str, "Reservations released"); break;
case 0x2A05: strcat(str, "Registrations preempted"); break;
case 0x2B00: strcat(str, "Copy cannot execute since host cannot disconnect"); break;
case 0x2C00: strcat(str, "Command sequence error"); break;
case 0x2C01: strcat(str, "Too many windows specified"); break;
case 0x2C02: strcat(str, "Invalid combination of windows specified"); break;
case 0x2C03: strcat(str, "Current program area is not empty"); break;
case 0x2C04: strcat(str, "Current program area is empty"); break;
case 0x2C05: strcat(str, "Persistent prevent conflict"); break;
case 0x2D00: strcat(str, "Overwrite error on update in place"); break;
case 0x2E00: strcat(str, "Insufficient time for operation"); break;
case 0x2F00: strcat(str, "Commands cleared by anther initiator"); break;
case 0x3000: strcat(str, "Incompatible medium installed"); break;
case 0x3001: strcat(str, "Cannot read medium, unknown format"); break;
case 0x3002: strcat(str, "Cannot read medium, incompatible format"); break;
case 0x3003: strcat(str, "Cleaning cartridge installed"); break;
case 0x3004: strcat(str, "Cannot write medium, unknown format"); break;
case 0x3005: strcat(str, "Cannot write medium, incompatible format"); break;
case 0x3006: strcat(str, "Cannot format medium, incompatible medium"); break;
case 0x3007: strcat(str, "Cleaning failure"); break;
case 0x3008: strcat(str, "Cannot write, application code mismatch"); break;
case 0x3009: strcat(str, "Current session not fixated for append"); break;
case 0x3100: strcat(str, "Medium format corrupted"); break;
case 0x3101: strcat(str, "Format command failed"); break;
case 0x3102: strcat(str, "Zoned formatting failed due to spare linking"); break;
case 0x3200: strcat(str, "No defect spare location available"); break;
case 0x3201: strcat(str, "Defect list update failure"); break;
case 0x3300: strcat(str, "Tape length error"); break;
case 0x3400: strcat(str, "Enclosure failure"); break;
case 0x3500: strcat(str, "Enclosure services failure"); break;
case 0x3501: strcat(str, "Unsupported enclosure function"); break;
case 0x3502: strcat(str, "Enclosure services unavailable"); break;
case 0x3503: strcat(str, "Enclosure services transfer failure"); break;
case 0x3504: strcat(str, "Enclosure services transfer refused"); break;
case 0x3600: strcat(str, "Ribbon, ink, or toner failure"); break;
case 0x3700: strcat(str, "Rounded parameter"); break;
case 0x3800: strcat(str, "Event status notification"); break;
case 0x3802: strcat(str, "ESN - Power management class event"); break;
case 0x3804: strcat(str, "ESN - Media class event"); break;
case 0x3806: strcat(str, "ESN - Device busy class event"); break;
case 0x3900: strcat(str, "Saving parameters not supported"); break;
case 0x3A00: strcat(str, "Medium not present"); break;
case 0x3A01: strcat(str, "Medium not present, tray closed"); break;
case 0x3A02: strcat(str, "Medium not present, tray open"); break;
case 0x3A03: strcat(str, "Medium not present, loadable"); break;
case 0x3A04: strcat(str, "Medium not present, medium auxiliary memory accessible"); break;
case 0x3B00: strcat(str, "Sequential positioning error"); break;
case 0x3B01: strcat(str, "Tape position error at beginning of medium"); break;
case 0x3B02: strcat(str, "Tape position error at end of medium"); break;
case 0x3B03: strcat(str, "Tape or electronic vertical forms unit not ready"); break;
case 0x3B04: strcat(str, "Slew failure"); break;
case 0x3B05: strcat(str, "Paper jam"); break;
case 0x3B06: strcat(str, "Failed to sense top-of-form"); break;
case 0x3B07: strcat(str, "Failed to sense bottom-of-form"); break;
case 0x3B08: strcat(str, "Reposition error"); break;
case 0x3B09: strcat(str, "Read past end of medium"); break;
case 0x3B0A: strcat(str, "Read past beginning of medium"); break;
case 0x3B0B: strcat(str, "Position past end of medium"); break;
case 0x3B0C: strcat(str, "Position past beginning of medium"); break;
case 0x3B0D: strcat(str, "Medium destination element full"); break;
case 0x3B0E: strcat(str, "Medium source element empty"); break;
case 0x3B0F: strcat(str, "End of medium reached"); break;
case 0x3B11: strcat(str, "Medium magazine not accessible"); break;
case 0x3B12: strcat(str, "Medium magazine removed"); break;
case 0x3B13: strcat(str, "Medium magazine inserted"); break;
case 0x3B14: strcat(str, "Medium magazine locked"); break;
case 0x3B15: strcat(str, "Medium magazine unlocked"); break;
case 0x3B16: strcat(str, "Mechanical positioning or changer error"); break;
case 0x3D00: strcat(str, "Invalid bits in identify message"); break;
case 0x3E00: strcat(str, "Logical unit has not self-configured yet"); break;
case 0x3E01: strcat(str, "Logical unit failure"); break;
case 0x3E02: strcat(str, "Timeout on logical unit"); break;
case 0x3E03: strcat(str, "Logical unit failed self-test"); break;
case 0x3E04: strcat(str, "Logical unit unable to update self-test log"); break;
case 0x3F00: strcat(str, "Target operating conditions have changed"); break;
case 0x3F01: strcat(str, "Microcode has been changed"); break;
case 0x3F02: strcat(str, "Changed operating definition"); break;
case 0x3F03: strcat(str, "Inquiry data has changed"); break;
case 0x3F04: strcat(str, "Component device attached"); break;
case 0x3F05: strcat(str, "Device identifier changed"); break;
case 0x3F06: strcat(str, "Redundancy group created or modified"); break;
case 0x3F07: strcat(str, "Redundancy group deleted"); break;
case 0x3F08: strcat(str, "Spare created or modified"); break;
case 0x3F09: strcat(str, "Spare deleted"); break;
case 0x3F0A: strcat(str, "Volume set created or modified"); break;
case 0x3F0B: strcat(str, "Volume set deleted"); break;
case 0x3F0C: strcat(str, "Volume set deassigned"); break;
case 0x3F0D: strcat(str, "Volume set reassigned"); break;
case 0x3F0E: strcat(str, "Reported LUNs data has changed"); break;
case 0x3F10: strcat(str, "Medium loadable"); break;
case 0x3F11: strcat(str, "Medium auxiliary memory accessible"); break;
case 0x4000: strcat(str, "RAM failure"); break;
case 0x4100: strcat(str, "Data path failure"); break;
case 0x4200: strcat(str, "Power-on or self-test failure"); break;
case 0x4300: strcat(str, "Message error"); break;
case 0x4400: strcat(str, "Internal target failure"); break;
case 0x4500: strcat(str, "Select or reselect failure"); break;
case 0x4600: strcat(str, "Unseccessful soft reset"); break;
case 0x4700: strcat(str, "SCSI Parity error"); break;
case 0x4701: strcat(str, "Data phase CRC error detected"); break;
case 0x4702: strcat(str, "SCSI parity error detected during ST data phase"); break;
case 0x4703: strcat(str, "Information unit CRC error detected"); break;
case 0x4704: strcat(str, "Async information protection error detected"); break;
case 0x4800: strcat(str, "Initiator detected error message received"); break;
case 0x4900: strcat(str, "Invalid message error"); break;
case 0x4A00: strcat(str, "Command phase error"); break;
case 0x4B00: strcat(str, "Data phase error"); break;
case 0x4C00: strcat(str, "Logical unit failed self-configuration"); break;
case 0x4E00: strcat(str, "Overlapped commands attempted"); break;
case 0x5000: strcat(str, "Write append error"); break;
case 0x5001: strcat(str, "Write append position error"); break;
case 0x5002: strcat(str, "Position error related to timing"); break;
case 0x5100: strcat(str, "Erase failure"); break;
case 0x5300: strcat(str, "Media load or eject failed"); break;
case 0x5301: strcat(str, "Unload tape failure"); break;
case 0x5302: strcat(str, "Medium removal prevented"); break;
case 0x5400: strcat(str, "SCSI to host system interface failure"); break;
case 0x5500: strcat(str, "System Resource failure"); break;
case 0x5501: strcat(str, "System Buffer full"); break;
case 0x5502: strcat(str, "Insufficient reservation resources"); break;
case 0x5503: strcat(str, "Insufficient resources"); break;
case 0x5504: strcat(str, "Insufficient registration resources"); break;
case 0x5700: strcat(str, "Unable to recover table of contents"); break;
case 0x5800: strcat(str, "Generation does not exist"); break;
case 0x5900: strcat(str, "Updated block read"); break;
case 0x5A00: strcat(str, "Operator request or state change input (UNSPECIFIED)"); break;
case 0x5A01: strcat(str, "Operator medium removal request"); break;
case 0x5A02: strcat(str, "Operator selected write protect"); break;
case 0x5A03: strcat(str, "Operator selected write permit"); break;
case 0x5B00: strcat(str, "Log exception"); break;
case 0x5B01: strcat(str, "Threshold condition met"); break;
case 0x5B02: strcat(str, "Log counter at maximum"); break;
case 0x5B03: strcat(str, "Log list codes exhausted"); break;
case 0x5C00: strcat(str, "RPL status change"); break;
case 0x5C01: strcat(str, "Spindles synchronized"); break;
case 0x5C02: strcat(str, "Spindle not synchronized"); break;
case 0x5D00: strcat(str, "Failure prediction threshold exceeded, predicted logical unit failure"); break;
case 0x5D01: strcat(str, "Failure prediction threshold exceeded, predicted media failure"); break;
case 0x5D10: strcat(str, "Hardware impending failure - general hard drive failure"); break;
case 0x5D11: strcat(str, "Hardware impending failure - drive error rate too high"); break;
case 0x5D12: strcat(str, "Hardware impending failure - data error rate too high"); break;
case 0x5D13: strcat(str, "Hardware impending failure - seek error rate too high"); break;
case 0x5D14: strcat(str, "Hardware impending failure - too many block reassigns"); break;
case 0x5D15: strcat(str, "Hardware impending failure - access times too high"); break;
case 0x5D16: strcat(str, "Hardware impending failure - start unit times too high"); break;
case 0x5D17: strcat(str, "Hardware impending failure - channel parametrics"); break;
case 0x5D18: strcat(str, "Hardware impending failure - controller detected"); break;
case 0x5D19: strcat(str, "Hardware impending failure - throughput performance"); break;
case 0x5D1A: strcat(str, "Hardware impending failure - seek time performance"); break;
case 0x5D1B: strcat(str, "Hardware impending failure - spin-up retry count"); break;
case 0x5D1C: strcat(str, "Hardware impending failure - drive calibration retry count"); break;
case 0x5D20: strcat(str, "Controller impending failure - general hard drive failure"); break;
case 0x5D21: strcat(str, "Controller impending failure - drive error rate too high"); break;
case 0x5D22: strcat(str, "Controller impending failure - data error rate too high"); break;
case 0x5D23: strcat(str, "Controller impending failure - seek error rate too high"); break;
case 0x5D24: strcat(str, "Controller impending failure - too many block reassigns"); break;
case 0x5D25: strcat(str, "Controller impending failure - access times too high"); break;
case 0x5D26: strcat(str, "Controller impending failure - start unit times too high"); break;
case 0x5D27: strcat(str, "Controller impending failure - channel parametrics"); break;
case 0x5D28: strcat(str, "Controller impending failure - controller detected"); break;
case 0x5D29: strcat(str, "Controller impending failure - throughput performance"); break;
case 0x5D2A: strcat(str, "Controller impending failure - seek time performance"); break;
case 0x5D2B: strcat(str, "Controller impending failure - spin-up retry count"); break;
case 0x5D2C: strcat(str, "Controller impending failure - drive calibration retry count"); break;
case 0x5DFF: strcat(str, "Failure prediction threshold exceeded (FALSE)"); break;
case 0x5E00: strcat(str, "Low power condition on"); break;
case 0x5E01: strcat(str, "Idle condition activated by timer"); break;
case 0x5E02: strcat(str, "Standby condition activated by timer"); break;
case 0x5E03: strcat(str, "Idle condition activated by command"); break;
case 0x5E04: strcat(str, "Standby condition activated by command"); break;
case 0x5E41: strcat(str, "Power state change to active"); break;
case 0x5E42: strcat(str, "Power state change to idle"); break;
case 0x5E43: strcat(str, "Power state change to standby"); break;
case 0x5E45: strcat(str, "Power state change to sleep"); break;
case 0x5E47: strcat(str, "Power state change to device control"); break;
case 0x6000: strcat(str, "Lamp failure"); break;
case 0x6100: strcat(str, "Video acquisition error"); break;
case 0x6101: strcat(str, "Unable to acquire video"); break;
case 0x6102: strcat(str, "Out of focus"); break;
case 0x6200: strcat(str, "Scan head positioning error"); break;
case 0x6300: strcat(str, "End of user area encountered on this track"); break;
case 0x6301: strcat(str, "Packet does not fit in available space"); break;
case 0x6400: strcat(str, "Illegal mode for this track or incompatible medium"); break;
case 0x6401: strcat(str, "Invalid packet size"); break;
case 0x6500: strcat(str, "Voltage fault"); break;
case 0x6600: strcat(str, "Automatic document feeder cover up"); break;
case 0x6601: strcat(str, "Automatic document feeder lift up"); break;
case 0x6602: strcat(str, "Document jam in automatic document feeder"); break;
case 0x6603: strcat(str, "Document misfeed in automatic document feeder"); break;
case 0x6700: strcat(str, "Configuration failure"); break;
case 0x6701: strcat(str, "Configuration of incapable logical unit"); break;
case 0x6702: strcat(str, "Add logical unit failed"); break;
case 0x6703: strcat(str, "Modification of logical unit failed"); break;
case 0x6704: strcat(str, "Exchange of logical unit failed"); break;
case 0x6705: strcat(str, "Remove of logical unit failed"); break;
case 0x6706: strcat(str, "Attachment of logical unit failed"); break;
case 0x6707: strcat(str, "Creation of logical unit failed"); break;
case 0x6800: strcat(str, "Logical unit not configured"); break;
case 0x6900: strcat(str, "Data loss on logical unit"); break;
case 0x6901: strcat(str, "Multiple logical unit failures"); break;
case 0x6902: strcat(str, "A parity/data mismatch"); break;
case 0x6A00: strcat(str, "Informational, refer to log"); break;
case 0x6B00: strcat(str, "State change has occurred"); break;
case 0x6B01: strcat(str, "Redundancy level got better"); break;
case 0x6B02: strcat(str, "Redundancy level got worse"); break;
case 0x6C00: strcat(str, "Rebuild failure occurred"); break;
case 0x6D00: strcat(str, "Recalculate failure occurred"); break;
case 0x6E00: strcat(str, "Command to logical unit failed"); break;
case 0x6F00: strcat(str, "Copy protection key exchange failure, authentication failure"); break;
case 0x6F01: strcat(str, "Copy protection key exchange failure, key not present"); break;
case 0x6F02: strcat(str, "Copy protection key exchange failure, key not established"); break;
case 0x6F03: strcat(str, "Read of scrambled sector without authentication"); break;
case 0x6F04: strcat(str, "Media region code is mismatched to logical unit region"); break;
case 0x6F05: strcat(str, "Drive region must be permanent/Region reset count error"); break;
case 0x7100: strcat(str, "Decompression exception long algorithm id"); break;
case 0x7200: strcat(str, "Session fixation error"); break;
case 0x7201: strcat(str, "Session fixation error writing lead-in"); break;
case 0x7202: strcat(str, "Session fixation error writing lead-out"); break;
case 0x7203: strcat(str, "Session fixation error, incomplete track in session"); break;
case 0x7204: strcat(str, "Empty or partially written reserved track"); break;
case 0x7205: strcat(str, "No more RZone reservations are allowed"); break;
case 0x7300: strcat(str, "CD control error"); break;
case 0x7301: strcat(str, "Power calibration area almost full"); break;
case 0x7302: strcat(str, "Power calibration area is full"); break;
case 0x7303: strcat(str, "Power calibration area error"); break;
case 0x7304: strcat(str, "Program memory area update failure"); break;
case 0x7305: strcat(str, "Program memory area is full"); break;
case 0x7306: strcat(str, "Program memory area is (almost) full"); break;
case 0xB900: strcat(str, "Play operation aborted"); break;
case 0xBF00: strcat(str, "Loss of streaming"); break;
default:
if (ASC == 0x40) { sprintf(str, "Diagnostic failure on component $%02x", ASCQ); break; }
if (ASC == 0x4D) { sprintf(str, "Tagged overlapped commands, queue tag = $%02x", ASCQ); break; }
break;
}
fprintf(stderr, "%s\n", str);
}
void ExecuteInquiryUsingSTUC(SCSITaskDeviceInterface **interface)
{
SCSICmd_INQUIRY_StandardData inqBuffer;
SCSITaskStatus taskStatus;
SCSI_Sense_Data senseData;
SCSICommandDescriptorBlock cdb;
SCSITaskInterface **task = NULL;
IOReturn kr = kIOReturnSuccess;
IOVirtualRange *range = NULL;
UInt64 transferCount = 0;
UInt32 transferCountHi = 0;
UInt32 transferCountLo = 0;
assert(interface != NULL);
// Create a task now that we have exclusive access.
task = (*interface)->CreateSCSITask(interface);
if (task == NULL) {
fprintf(stderr, "CreateSCSITask returned NULL.\n");
}
else {
// Zero the buffer.
bzero(&inqBuffer, sizeof(SCSICmd_INQUIRY_StandardData));
// Allocate a virtual range for the buffer. If we had more than 1 scatter-gather entry,
// we would allocate more than 1 IOVirtualRange.
range = (IOVirtualRange *) malloc(sizeof(IOVirtualRange));
if (range == NULL) {
fprintf(stderr, "Could not malloc an IOVirtualRange\n" );
}
// Zero the senseData and CDB.
bzero(&senseData, sizeof(senseData));
bzero(cdb, sizeof(cdb));
// Set up the range. The address is just the buffer's address. The length is our request size.
range->address = (IOVirtualAddress) &inqBuffer;
range->length = sizeof(SCSICmd_INQUIRY_StandardData);
// We're going to execute an INQUIRY to the device as a test of exclusive commands.
cdb[0] = kSCSICmd_INQUIRY;
cdb[4] = sizeof(SCSICmd_INQUIRY_StandardData);
// Set the actual cdb in the task.
kr = (*task)->SetCommandDescriptorBlock(task, cdb, kSCSICDBSize_6Byte);
if (kr != kIOReturnSuccess) {
fprintf(stderr, "Error setting CDB. (0x%08x)\n", kr);
}
// Set the scatter-gather entry in the task.
kr = (*task)->SetScatterGatherEntries(task, range, 1, sizeof(SCSICmd_INQUIRY_StandardData),
kSCSIDataTransfer_FromTargetToInitiator);
if (kr != kIOReturnSuccess) {
fprintf(stderr, "Error setting scatter-gather entries. (0x%08x)\n", kr);
}
// Set the timeout in the task
kr = (*task)->SetTimeoutDuration(task, 10000);
if (kr != kIOReturnSuccess) {
fprintf(stderr, "Error setting timeout. (0x%08x)\n", kr);
}
fprintf(stderr, "Requesting Inquiry data\n");
// Send it!
kr = (*task)->ExecuteTaskSync(task, &senseData, &taskStatus, &transferCount);
if (kr != kIOReturnSuccess) {
fprintf(stderr, "Error executing task. (0x%08x)\n", kr);
}
// Get the transfer counts
transferCountHi = ((transferCount >> 32) & 0xFFFFFFFF);
transferCountLo = (transferCount & 0xFFFFFFFF);
if (taskStatus == kSCSITaskStatus_GOOD) {
PrintSCSIInquiryDataUsingSTUC(&inqBuffer, transferCountLo);
}
else if (taskStatus == kSCSITaskStatus_CHECK_CONDITION) {
// Something happened. Print the sense string
PrintSenseString(&senseData, false);
}
else {
fprintf(stderr, "taskStatus = 0x%08x\n", taskStatus);
}
// Be a good citizen and clean up.
free(range);
// Release the task interface.
(*task)->Release(task);
}
}
void TestADeviceUsingSTUC(SCSITaskDeviceInterface **interface)
{
kern_return_t kr = kIOReturnSuccess;
assert(interface != NULL);
// Get exclusive access for the device if we can. This must be done
// before any SCSITasks can be created and sent to the device.
kr = (*interface)->ObtainExclusiveAccess(interface);
if (kr != kIOReturnSuccess) {
fprintf(stderr, "ObtainExclusiveAccess failed. (0x%08x)\n", kr);
}
else {
// Execute an INQUIRY command on the device.
ExecuteInquiryUsingSTUC(interface);
kr = (*interface)->ReleaseExclusiveAccess(interface);
if (kr != kIOReturnSuccess) {
fprintf(stderr, "ReleaseExclusiveAccess failed. (0x%08x)\n", kr);
}
}
}
void CreateDeviceInterfaceUsingSTUC(io_object_t scsiDevice,
IOCFPlugInInterface ***thePlugInInterface,
SCSITaskDeviceInterface ***theInterface)
{
kern_return_t kr = kIOReturnSuccess;
IOCFPlugInInterface **plugInInterface = NULL;
SCSITaskDeviceInterface **interface = NULL;
HRESULT plugInResult = S_OK;
SInt32 score = 0;
assert(scsiDevice != IO_OBJECT_NULL);
// Create the base interface of type IOCFPlugInInterface.
// This object will be used to create the SCSI device interface object.
kr = IOCreatePlugInInterfaceForService(scsiDevice,
kIOSCSITaskDeviceUserClientTypeID,
kIOCFPlugInInterfaceID,
&plugInInterface,
&score);
if (kr != kIOReturnSuccess) {
fprintf(stderr, "Couldn't create a plugin interface for the io_service_t. (0x%08x)\n", kr);
}
else {
// Query the base plugin interface for an instance of the specific SCSI device interface
// object.
plugInResult = (*plugInInterface)->QueryInterface(plugInInterface,
CFUUIDGetUUIDBytes(kIOSCSITaskDeviceInterfaceID),
(LPVOID *) &interface);
if (plugInResult != S_OK) {
fprintf(stderr, "Couldn't create SCSI device interface. (%ld)\n", plugInResult);
}
}
// Set the return values.
*thePlugInInterface = plugInInterface;
*theInterface = interface;
}
void CreateDeviceInterfaceForAuthoringDevice(io_object_t scsiDevice,
IOCFPlugInInterface ***thePlugInInterface,
SCSITaskDeviceInterface ***theInterface,
MMCDeviceInterface ***theMMCInterface)
{
kern_return_t kr = kIOReturnSuccess;
IOCFPlugInInterface **plugInInterface = NULL;
SCSITaskDeviceInterface **interface = NULL;
MMCDeviceInterface **mmcInterface = NULL;
HRESULT plugInResult = S_OK;
SInt32 score = 0;
assert(scsiDevice != IO_OBJECT_NULL);
// Create the base interface of type IOCFPlugInInterface.
// This object will be used to create the SCSI device interface object.
kr = IOCreatePlugInInterfaceForService(scsiDevice,
kIOMMCDeviceUserClientTypeID,
kIOCFPlugInInterfaceID,
&plugInInterface,
&score);
if (kr != kIOReturnSuccess) {
fprintf(stderr, "Couldn't create a plugin interface for the io_service_t. (0x%08x)\n", kr);
}
else {
// Query the base plugin interface for an instance of the specific SCSI device interface
// object.
plugInResult = (*plugInInterface)->QueryInterface(plugInInterface,
CFUUIDGetUUIDBytes(kIOMMCDeviceInterfaceID),
(LPVOID *) &mmcInterface);
if (plugInResult != S_OK) {
fprintf(stderr, "Couldn't create MMC device interface. (%ld)\n", plugInResult);
}
else {
// Now get the SCSITaskDeviceInterface for this MMCDeviceInterface.
interface = (*mmcInterface)->GetSCSITaskDeviceInterface(mmcInterface);
if (interface == NULL) {
fprintf(stderr, "GetSCSITaskDeviceInterface returned NULL\n");
}
}
}
// Set the return values.
*thePlugInInterface = plugInInterface;
*theInterface = interface;
*theMMCInterface = mmcInterface;
}
void TestOtherDevicesUsingSTUC(SInt32 peripheralDeviceType, io_iterator_t iterator)
{
io_name_t className;
io_service_t scsiDevice = IO_OBJECT_NULL;
IOCFPlugInInterface **plugInInterface = NULL;
SCSITaskDeviceInterface **interface = NULL;
kern_return_t kr = kIOReturnSuccess;
while ((scsiDevice = IOIteratorNext(iterator))) {
// Get the object's class name just to display it
kr = IOObjectGetClass(scsiDevice, className);
if (kr != kIOReturnSuccess) {
fprintf(stderr, "Failed to get class name. (0x%08x)\n", kr);
}
else {
fprintf(stderr, "Found device class \"%s\" using STUC.\n", className);
}
// Get each device, then print cached info, then run live query.
CreateDeviceInterfaceUsingSTUC(scsiDevice,
&plugInInterface,
&interface);
kr = IOObjectRelease(scsiDevice); // Done with SCSI object from I/O Registry.
if (kr != kIOReturnSuccess) {
fprintf(stderr, "Error releasing SCSI device. (0x%08x)\n", kr);
}
if (interface != NULL) {
TestADeviceUsingSTUC(interface);
(*interface)->Release(interface);
}
if (plugInInterface != NULL) {
IODestroyPlugInInterface(plugInInterface);
}
}
}
void TestAuthoringDevicesUsingSTUC(io_iterator_t iterator)
{
io_name_t className;
io_service_t scsiDevice = IO_OBJECT_NULL;
IOCFPlugInInterface **plugInInterface = NULL;
SCSITaskDeviceInterface **interface = NULL;
MMCDeviceInterface **mmcInterface = NULL;
kern_return_t kr = kIOReturnSuccess;
while ((scsiDevice = IOIteratorNext(iterator))) {
// Get the object's class name just to display it
kr = IOObjectGetClass(scsiDevice, className);
if (kr != kIOReturnSuccess) {
fprintf(stderr, "Failed to get class name. (0x%08x)\n", kr);
}
else {
fprintf(stderr, "Found device class \"%s\" using STUC.\n", className);
}
// Get each device, then print cached info, then run live query.
CreateDeviceInterfaceForAuthoringDevice(scsiDevice,
&plugInInterface,
&interface,
&mmcInterface);
kr = IOObjectRelease(scsiDevice); // Done with SCSI object from I/O Registry.
if (kr != kIOReturnSuccess) {
fprintf(stderr, "Error releasing SCSI device. (0x%08x)\n", kr);
}
if (interface != NULL) {
TestADeviceUsingSTUC(interface);
(*interface)->Release(interface);
}
if (mmcInterface != NULL) {
(*mmcInterface)->Release(mmcInterface);
}
if (plugInInterface != NULL) {
IODestroyPlugInInterface(plugInInterface);
}
}
}
void TestDevicesUsingSTUC(SInt32 peripheralDeviceType, io_iterator_t iterator)
{
if (peripheralDeviceType == kINQUIRY_PERIPHERAL_TYPE_CDROM_MMCDevice) {
TestAuthoringDevicesUsingSTUC(iterator);
}
else {
TestOtherDevicesUsingSTUC(peripheralDeviceType, iterator);
}
}
void CreateMatchingDictionaryForSTUC(SInt32 peripheralDeviceType,
CFMutableDictionaryRef *matchingDict)
{
CFMutableDictionaryRef subDict;
assert(matchingDict != NULL);
// Create the dictionaries
*matchingDict = CFDictionaryCreateMutable(kCFAllocatorDefault, 0, &kCFTypeDictionaryKeyCallBacks,
&kCFTypeDictionaryValueCallBacks);
if (*matchingDict != NULL) {
subDict = CFDictionaryCreateMutable(kCFAllocatorDefault, 0, &kCFTypeDictionaryKeyCallBacks,
&kCFTypeDictionaryValueCallBacks);
if (subDict != NULL) {
// Create a dictionary with the "SCSITaskDeviceCategory" key with the appropriate value
// for the device type we're interested in.
SInt32 deviceTypeNumber = peripheralDeviceType;
CFNumberRef deviceTypeRef = NULL;
CFDictionarySetValue(subDict, CFSTR(kIOPropertySCSITaskDeviceCategory),
CFSTR(kIOPropertySCSITaskUserClientDevice));
deviceTypeRef = CFNumberCreate(kCFAllocatorDefault, kCFNumberIntType, &deviceTypeNumber);
CFDictionarySetValue(subDict, CFSTR(kIOPropertySCSIPeripheralDeviceType), deviceTypeRef);
CFRelease (deviceTypeRef);
}
// Add the dictionary to the main dictionary with the key "IOPropertyMatch" to
// narrow the search to the above dictionary.
CFDictionarySetValue(*matchingDict, CFSTR(kIOPropertyMatchKey), subDict);
CFRelease(subDict);
}
}
void CreateMatchingDictionaryForAuthoringDevices(CFMutableDictionaryRef *matchingDict)
{
CFMutableDictionaryRef subDict;
assert(matchingDict != NULL);
// Create the dictionaries
*matchingDict = CFDictionaryCreateMutable(kCFAllocatorDefault, 0, &kCFTypeDictionaryKeyCallBacks,
&kCFTypeDictionaryValueCallBacks);
if (*matchingDict != NULL) {
subDict = CFDictionaryCreateMutable(kCFAllocatorDefault, 0, &kCFTypeDictionaryKeyCallBacks,
&kCFTypeDictionaryValueCallBacks);
if (subDict != NULL) {
// Create a dictionary with the "SCSITaskDeviceCategory" key with the appropriate value
// for the device type we're interested in. CD-R and DVD-R (PDT 05h) authoring devices
// are distinguished by the value kIOPropertySCSITaskAuthoringDevice.
CFDictionarySetValue(subDict, CFSTR(kIOPropertySCSITaskDeviceCategory),
CFSTR(kIOPropertySCSITaskAuthoringDevice));
// Add the dictionary to the main dictionary with the key "IOPropertyMatch" to
// narrow the search to the above dictionary.
CFDictionarySetValue(*matchingDict, CFSTR(kIOPropertyMatchKey), subDict);
CFRelease(subDict);
}
}
}
boolean_t FindDevicesUsingSTUC(SInt32 peripheralDeviceType, mach_port_t masterPort,
io_iterator_t *iterator)
{
CFMutableDictionaryRef matchingDict = NULL;
boolean_t result = false;
// Set up a matching dictionary to search the I/O Registry for SCSI devices
// we are interested in.
if (peripheralDeviceType == kINQUIRY_PERIPHERAL_TYPE_CDROM_MMCDevice) {
CreateMatchingDictionaryForAuthoringDevices(&matchingDict);
}
else {
CreateMatchingDictionaryForSTUC(peripheralDeviceType, &matchingDict);
}
if (matchingDict == NULL) {
fprintf(stderr, "Couldn't create a matching dictionary.\n");
}
else {
kern_return_t kr;
// Now search I/O Registry for matching devices.
kr = IOServiceGetMatchingServices(masterPort, matchingDict, iterator);
if (*iterator && kr == kIOReturnSuccess) {
result = true;
}
}
// IOServiceGetMatchingServices consumes a reference to the
// matching dictionary, so we don't need to release the dictionary ref.
return result;
}