1 /* SPDX-License-Identifier: GPL-2.0-or-later */
3 * ata_id - reads product/serial number from ATA drives
5 * Copyright © 2009-2010 David Zeuthen <zeuthen@gmail.com>
12 #include <linux/bsg.h>
13 #include <linux/hdreg.h>
14 #include <scsi/scsi.h>
15 #include <scsi/scsi_ioctl.h>
21 #include <sys/ioctl.h>
23 #include <sys/types.h>
26 #include "device-nodes.h"
29 #include "memory-util.h"
30 #include "udev-util.h"
32 #define COMMAND_TIMEOUT_MSEC (30 * 1000)
34 static int disk_scsi_inquiry_command(
40 /* INQUIRY, see SPC-4 section 6.4 */
41 [0] = 0x12, /* OPERATION CODE: INQUIRY */
42 [3] = (buf_len
>> 8), /* ALLOCATION LENGTH */
43 [4] = (buf_len
& 0xff),
45 uint8_t sense
[32] = {};
46 struct sg_io_v4 io_v4
= {
48 .protocol
= BSG_PROTOCOL_SCSI
,
49 .subprotocol
= BSG_SUB_PROTOCOL_SCSI_CMD
,
50 .request_len
= sizeof(cdb
),
51 .request
= (uintptr_t) cdb
,
52 .max_response_len
= sizeof(sense
),
53 .response
= (uintptr_t) sense
,
54 .din_xfer_len
= buf_len
,
55 .din_xferp
= (uintptr_t) buf
,
56 .timeout
= COMMAND_TIMEOUT_MSEC
,
60 ret
= ioctl(fd
, SG_IO
, &io_v4
);
62 /* could be that the driver doesn't do version 4, try version 3 */
63 if (errno
== EINVAL
) {
64 struct sg_io_hdr io_hdr
= {
66 .cmdp
= (unsigned char*) cdb
,
67 .cmd_len
= sizeof (cdb
),
71 .mx_sb_len
= sizeof(sense
),
72 .dxfer_direction
= SG_DXFER_FROM_DEV
,
73 .timeout
= COMMAND_TIMEOUT_MSEC
,
76 ret
= ioctl(fd
, SG_IO
, &io_hdr
);
80 /* even if the ioctl succeeds, we need to check the return value */
81 if (!(io_hdr
.status
== 0 &&
82 io_hdr
.host_status
== 0 &&
83 io_hdr
.driver_status
== 0)) {
91 /* even if the ioctl succeeds, we need to check the return value */
92 if (!(io_v4
.device_status
== 0 &&
93 io_v4
.transport_status
== 0 &&
94 io_v4
.driver_status
== 0)) {
102 static int disk_identify_command(
109 * ATA Pass-Through 12 byte command, as described in
111 * T10 04-262r8 ATA Command Pass-Through
113 * from http://www.t10.org/ftp/t10/document.04/04-262r8.pdf
115 [0] = 0xa1, /* OPERATION CODE: 12 byte pass through */
116 [1] = 4 << 1, /* PROTOCOL: PIO Data-in */
117 [2] = 0x2e, /* OFF_LINE=0, CK_COND=1, T_DIR=1, BYT_BLOK=1, T_LENGTH=2 */
118 [3] = 0, /* FEATURES */
119 [4] = 1, /* SECTORS */
120 [5] = 0, /* LBA LOW */
121 [6] = 0, /* LBA MID */
122 [7] = 0, /* LBA HIGH */
123 [8] = 0 & 0x4F, /* SELECT */
124 [9] = 0xEC, /* Command: ATA IDENTIFY DEVICE */
126 uint8_t sense
[32] = {};
127 uint8_t *desc
= sense
+ 8;
128 struct sg_io_v4 io_v4
= {
130 .protocol
= BSG_PROTOCOL_SCSI
,
131 .subprotocol
= BSG_SUB_PROTOCOL_SCSI_CMD
,
132 .request_len
= sizeof(cdb
),
133 .request
= (uintptr_t) cdb
,
134 .max_response_len
= sizeof(sense
),
135 .response
= (uintptr_t) sense
,
136 .din_xfer_len
= buf_len
,
137 .din_xferp
= (uintptr_t) buf
,
138 .timeout
= COMMAND_TIMEOUT_MSEC
,
142 ret
= ioctl(fd
, SG_IO
, &io_v4
);
144 /* could be that the driver doesn't do version 4, try version 3 */
145 if (errno
== EINVAL
) {
146 struct sg_io_hdr io_hdr
= {
148 .cmdp
= (unsigned char*) cdb
,
149 .cmd_len
= sizeof (cdb
),
151 .dxfer_len
= buf_len
,
153 .mx_sb_len
= sizeof (sense
),
154 .dxfer_direction
= SG_DXFER_FROM_DEV
,
155 .timeout
= COMMAND_TIMEOUT_MSEC
,
158 ret
= ioctl(fd
, SG_IO
, &io_hdr
);
165 if (!((sense
[0] & 0x7f) == 0x72 && desc
[0] == 0x9 && desc
[1] == 0x0c) &&
166 !((sense
[0] & 0x7f) == 0x70 && sense
[12] == 0x00 && sense
[13] == 0x1d)) {
174 static int disk_identify_packet_device_command(
181 * ATA Pass-Through 16 byte command, as described in
183 * T10 04-262r8 ATA Command Pass-Through
185 * from http://www.t10.org/ftp/t10/document.04/04-262r8.pdf
187 [0] = 0x85, /* OPERATION CODE: 16 byte pass through */
188 [1] = 4 << 1, /* PROTOCOL: PIO Data-in */
189 [2] = 0x2e, /* OFF_LINE=0, CK_COND=1, T_DIR=1, BYT_BLOK=1, T_LENGTH=2 */
190 [3] = 0, /* FEATURES */
191 [4] = 0, /* FEATURES */
192 [5] = 0, /* SECTORS */
193 [6] = 1, /* SECTORS */
194 [7] = 0, /* LBA LOW */
195 [8] = 0, /* LBA LOW */
196 [9] = 0, /* LBA MID */
197 [10] = 0, /* LBA MID */
198 [11] = 0, /* LBA HIGH */
199 [12] = 0, /* LBA HIGH */
200 [13] = 0, /* DEVICE */
201 [14] = 0xA1, /* Command: ATA IDENTIFY PACKET DEVICE */
202 [15] = 0, /* CONTROL */
204 uint8_t sense
[32] = {};
205 uint8_t *desc
= sense
+ 8;
206 struct sg_io_v4 io_v4
= {
208 .protocol
= BSG_PROTOCOL_SCSI
,
209 .subprotocol
= BSG_SUB_PROTOCOL_SCSI_CMD
,
210 .request_len
= sizeof (cdb
),
211 .request
= (uintptr_t) cdb
,
212 .max_response_len
= sizeof (sense
),
213 .response
= (uintptr_t) sense
,
214 .din_xfer_len
= buf_len
,
215 .din_xferp
= (uintptr_t) buf
,
216 .timeout
= COMMAND_TIMEOUT_MSEC
,
220 ret
= ioctl(fd
, SG_IO
, &io_v4
);
222 /* could be that the driver doesn't do version 4, try version 3 */
223 if (errno
== EINVAL
) {
224 struct sg_io_hdr io_hdr
= {
226 .cmdp
= (unsigned char*) cdb
,
227 .cmd_len
= sizeof (cdb
),
229 .dxfer_len
= buf_len
,
231 .mx_sb_len
= sizeof (sense
),
232 .dxfer_direction
= SG_DXFER_FROM_DEV
,
233 .timeout
= COMMAND_TIMEOUT_MSEC
,
236 ret
= ioctl(fd
, SG_IO
, &io_hdr
);
243 if (!((sense
[0] & 0x7f) == 0x72 && desc
[0] == 0x9 && desc
[1] == 0x0c)) {
252 * disk_identify_get_string:
253 * @identify: A block of IDENTIFY data
254 * @offset_words: Offset of the string to get, in words.
255 * @dest: Destination buffer for the string.
256 * @dest_len: Length of destination buffer, in bytes.
258 * Copies the ATA string from @identify located at @offset_words into @dest.
260 static void disk_identify_get_string(
261 uint8_t identify
[512],
262 unsigned offset_words
,
269 while (dest_len
> 0) {
270 c1
= identify
[offset_words
* 2 + 1];
271 c2
= identify
[offset_words
* 2];
281 static void disk_identify_fixup_string(
282 uint8_t identify
[512],
283 unsigned offset_words
,
285 disk_identify_get_string(identify
, offset_words
,
286 (char *) identify
+ offset_words
* 2, len
);
289 static void disk_identify_fixup_uint16 (uint8_t identify
[512], unsigned offset_words
) {
292 p
= (uint16_t *) identify
;
293 p
[offset_words
] = le16toh (p
[offset_words
]);
298 * @fd: File descriptor for the block device.
299 * @out_identify: Return location for IDENTIFY data.
300 * @out_is_packet_device: Return location for whether returned data is from an IDENTIFY PACKET DEVICE.
302 * Sends the IDENTIFY DEVICE or IDENTIFY PACKET DEVICE command to the
303 * device represented by @fd. If successful, then the result will be
304 * copied into @out_identify and @out_is_packet_device.
306 * This routine is based on code from libatasmart, LGPL v2.1.
308 * Returns: 0 if the data was successfully obtained, otherwise
309 * non-zero with errno set.
311 static int disk_identify(int fd
,
312 uint8_t out_identify
[512],
313 int *out_is_packet_device
) {
315 uint8_t inquiry_buf
[36];
316 int peripheral_device_type
;
319 int is_packet_device
= 0;
322 memzero(out_identify
, 512);
324 /* If we were to use ATA PASS_THROUGH (12) on an ATAPI device
325 * we could accidentally blank media. This is because MMC's BLANK
326 * command has the same op-code (0x61).
328 * To prevent this from happening we bail out if the device
329 * isn't a Direct Access Block Device, e.g. SCSI type 0x00
330 * (CD/DVD devices are type 0x05). So we send a SCSI INQUIRY
331 * command first... libata is handling this via its SCSI
334 * This also ensures that we're actually dealing with a device
335 * that understands SCSI commands.
337 * (Yes, it is a bit perverse that we're tunneling the ATA
338 * command through SCSI and relying on the ATA driver
339 * emulating SCSI well-enough...)
341 * (See commit 160b069c25690bfb0c785994c7c3710289179107 for
342 * the original bug-fix and see http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=556635
343 * for the original bug-report.)
345 ret
= disk_scsi_inquiry_command (fd
, inquiry_buf
, sizeof (inquiry_buf
));
349 /* SPC-4, section 6.4.2: Standard INQUIRY data */
350 peripheral_device_type
= inquiry_buf
[0] & 0x1f;
351 if (peripheral_device_type
== 0x05)
353 is_packet_device
= 1;
354 ret
= disk_identify_packet_device_command(fd
, out_identify
, 512);
355 goto check_nul_bytes
;
357 if (!IN_SET(peripheral_device_type
, 0x00, 0x14)) {
363 /* OK, now issue the IDENTIFY DEVICE command */
364 ret
= disk_identify_command(fd
, out_identify
, 512);
369 /* Check if IDENTIFY data is all NUL bytes - if so, bail */
371 for (n
= 0; n
< 512; n
++) {
372 if (out_identify
[n
] != '\0') {
385 if (out_is_packet_device
)
386 *out_is_packet_device
= is_packet_device
;
390 int main(int argc
, char *argv
[]) {
391 struct hd_driveid id
;
400 const char *node
= NULL
;
402 _cleanup_close_
int fd
= -EBADF
;
404 int is_packet_device
= 0;
405 static const struct option options
[] = {
406 { "export", no_argument
, NULL
, 'x' },
407 { "help", no_argument
, NULL
, 'h' },
411 log_set_target(LOG_TARGET_AUTO
);
413 log_parse_environment();
419 option
= getopt_long(argc
, argv
, "xh", options
, NULL
);
428 printf("Usage: %s [--export] [--help] <device>\n"
429 " -x,--export print values as environment keys\n"
430 " -h,--help print this help text\n\n",
431 program_invocation_short_name
);
438 log_error("no node specified");
442 fd
= open(node
, O_RDONLY
|O_NONBLOCK
|O_CLOEXEC
|O_NOCTTY
);
444 log_error("unable to open '%s'", node
);
448 if (disk_identify(fd
, identify
.byte
, &is_packet_device
) == 0) {
450 * fix up only the fields from the IDENTIFY data that we are going to
451 * use and copy it into the hd_driveid struct for convenience
453 disk_identify_fixup_string(identify
.byte
, 10, 20); /* serial */
454 disk_identify_fixup_string(identify
.byte
, 23, 8); /* fwrev */
455 disk_identify_fixup_string(identify
.byte
, 27, 40); /* model */
456 disk_identify_fixup_uint16(identify
.byte
, 0); /* configuration */
457 disk_identify_fixup_uint16(identify
.byte
, 75); /* queue depth */
458 disk_identify_fixup_uint16(identify
.byte
, 76); /* SATA capabilities */
459 disk_identify_fixup_uint16(identify
.byte
, 82); /* command set supported */
460 disk_identify_fixup_uint16(identify
.byte
, 83); /* command set supported */
461 disk_identify_fixup_uint16(identify
.byte
, 84); /* command set supported */
462 disk_identify_fixup_uint16(identify
.byte
, 85); /* command set supported */
463 disk_identify_fixup_uint16(identify
.byte
, 86); /* command set supported */
464 disk_identify_fixup_uint16(identify
.byte
, 87); /* command set supported */
465 disk_identify_fixup_uint16(identify
.byte
, 89); /* time required for SECURITY ERASE UNIT */
466 disk_identify_fixup_uint16(identify
.byte
, 90); /* time required for enhanced SECURITY ERASE UNIT */
467 disk_identify_fixup_uint16(identify
.byte
, 91); /* current APM values */
468 disk_identify_fixup_uint16(identify
.byte
, 94); /* current AAM value */
469 disk_identify_fixup_uint16(identify
.byte
, 108); /* WWN */
470 disk_identify_fixup_uint16(identify
.byte
, 109); /* WWN */
471 disk_identify_fixup_uint16(identify
.byte
, 110); /* WWN */
472 disk_identify_fixup_uint16(identify
.byte
, 111); /* WWN */
473 disk_identify_fixup_uint16(identify
.byte
, 128); /* device lock function */
474 disk_identify_fixup_uint16(identify
.byte
, 217); /* nominal media rotation rate */
475 memcpy(&id
, identify
.byte
, sizeof id
);
477 /* If this fails, then try HDIO_GET_IDENTITY */
478 if (ioctl(fd
, HDIO_GET_IDENTITY
, &id
) != 0) {
479 log_debug_errno(errno
, "HDIO_GET_IDENTITY failed for '%s': %m", node
);
484 memcpy(model
, id
.model
, 40);
486 encode_devnode_name(model
, model_enc
, sizeof(model_enc
));
487 udev_replace_whitespace((char *) id
.model
, model
, 40);
488 udev_replace_chars(model
, NULL
);
489 udev_replace_whitespace((char *) id
.serial_no
, serial
, 20);
490 udev_replace_chars(serial
, NULL
);
491 udev_replace_whitespace((char *) id
.fw_rev
, revision
, 8);
492 udev_replace_chars(revision
, NULL
);
495 /* Set this to convey the disk speaks the ATA protocol */
496 printf("ID_ATA=1\n");
498 if ((id
.config
>> 8) & 0x80) {
499 /* This is an ATAPI device */
500 switch ((id
.config
>> 8) & 0x1f) {
502 printf("ID_TYPE=cd\n");
505 printf("ID_TYPE=tape\n");
508 printf("ID_TYPE=cd\n");
511 printf("ID_TYPE=optical\n");
514 printf("ID_TYPE=generic\n");
518 printf("ID_TYPE=disk\n");
519 printf("ID_BUS=ata\n");
520 printf("ID_MODEL=%s\n", model
);
521 printf("ID_MODEL_ENC=%s\n", model_enc
);
522 printf("ID_REVISION=%s\n", revision
);
523 if (serial
[0] != '\0') {
524 printf("ID_SERIAL=%s_%s\n", model
, serial
);
525 printf("ID_SERIAL_SHORT=%s\n", serial
);
527 printf("ID_SERIAL=%s\n", model
);
529 if (id
.command_set_1
& (1<<5)) {
530 printf("ID_ATA_WRITE_CACHE=1\n");
531 printf("ID_ATA_WRITE_CACHE_ENABLED=%d\n", (id
.cfs_enable_1
& (1<<5)) ? 1 : 0);
533 if (id
.command_set_1
& (1<<10)) {
534 printf("ID_ATA_FEATURE_SET_HPA=1\n");
535 printf("ID_ATA_FEATURE_SET_HPA_ENABLED=%d\n", (id
.cfs_enable_1
& (1<<10)) ? 1 : 0);
538 * TODO: use the READ NATIVE MAX ADDRESS command to get the native max address
539 * so it is easy to check whether the protected area is in use.
542 if (id
.command_set_1
& (1<<3)) {
543 printf("ID_ATA_FEATURE_SET_PM=1\n");
544 printf("ID_ATA_FEATURE_SET_PM_ENABLED=%d\n", (id
.cfs_enable_1
& (1<<3)) ? 1 : 0);
546 if (id
.command_set_1
& (1<<1)) {
547 printf("ID_ATA_FEATURE_SET_SECURITY=1\n");
548 printf("ID_ATA_FEATURE_SET_SECURITY_ENABLED=%d\n", (id
.cfs_enable_1
& (1<<1)) ? 1 : 0);
549 printf("ID_ATA_FEATURE_SET_SECURITY_ERASE_UNIT_MIN=%d\n", id
.trseuc
* 2);
550 if ((id
.cfs_enable_1
& (1<<1))) /* enabled */ {
552 printf("ID_ATA_FEATURE_SET_SECURITY_LEVEL=maximum\n");
554 printf("ID_ATA_FEATURE_SET_SECURITY_LEVEL=high\n");
557 printf("ID_ATA_FEATURE_SET_SECURITY_ENHANCED_ERASE_UNIT_MIN=%d\n", id
.trsEuc
* 2);
559 printf("ID_ATA_FEATURE_SET_SECURITY_EXPIRE=1\n");
561 printf("ID_ATA_FEATURE_SET_SECURITY_FROZEN=1\n");
563 printf("ID_ATA_FEATURE_SET_SECURITY_LOCKED=1\n");
565 if (id
.command_set_1
& (1<<0)) {
566 printf("ID_ATA_FEATURE_SET_SMART=1\n");
567 printf("ID_ATA_FEATURE_SET_SMART_ENABLED=%d\n", (id
.cfs_enable_1
& (1<<0)) ? 1 : 0);
569 if (id
.command_set_2
& (1<<9)) {
570 printf("ID_ATA_FEATURE_SET_AAM=1\n");
571 printf("ID_ATA_FEATURE_SET_AAM_ENABLED=%d\n", (id
.cfs_enable_2
& (1<<9)) ? 1 : 0);
572 printf("ID_ATA_FEATURE_SET_AAM_VENDOR_RECOMMENDED_VALUE=%d\n", id
.acoustic
>> 8);
573 printf("ID_ATA_FEATURE_SET_AAM_CURRENT_VALUE=%d\n", id
.acoustic
& 0xff);
575 if (id
.command_set_2
& (1<<5)) {
576 printf("ID_ATA_FEATURE_SET_PUIS=1\n");
577 printf("ID_ATA_FEATURE_SET_PUIS_ENABLED=%d\n", (id
.cfs_enable_2
& (1<<5)) ? 1 : 0);
579 if (id
.command_set_2
& (1<<3)) {
580 printf("ID_ATA_FEATURE_SET_APM=1\n");
581 printf("ID_ATA_FEATURE_SET_APM_ENABLED=%d\n", (id
.cfs_enable_2
& (1<<3)) ? 1 : 0);
582 if ((id
.cfs_enable_2
& (1<<3)))
583 printf("ID_ATA_FEATURE_SET_APM_CURRENT_VALUE=%d\n", id
.CurAPMvalues
& 0xff);
585 if (id
.command_set_2
& (1<<0))
586 printf("ID_ATA_DOWNLOAD_MICROCODE=1\n");
589 * Word 76 indicates the capabilities of a SATA device. A PATA device shall set
590 * word 76 to 0000h or FFFFh. If word 76 is set to 0000h or FFFFh, then
591 * the device does not claim compliance with the Serial ATA specification and words
592 * 76 through 79 are not valid and shall be ignored.
595 word
= identify
.wyde
[76];
596 if (!IN_SET(word
, 0x0000, 0xffff)) {
597 printf("ID_ATA_SATA=1\n");
599 * If bit 2 of word 76 is set to one, then the device supports the Gen2
600 * signaling rate of 3.0 Gb/s (see SATA 2.6).
602 * If bit 1 of word 76 is set to one, then the device supports the Gen1
603 * signaling rate of 1.5 Gb/s (see SATA 2.6).
606 printf("ID_ATA_SATA_SIGNAL_RATE_GEN2=1\n");
608 printf("ID_ATA_SATA_SIGNAL_RATE_GEN1=1\n");
611 /* Word 217 indicates the nominal media rotation rate of the device */
612 word
= identify
.wyde
[217];
614 printf ("ID_ATA_ROTATION_RATE_RPM=0\n"); /* non-rotating e.g. SSD */
615 else if (word
>= 0x0401 && word
<= 0xfffe)
616 printf ("ID_ATA_ROTATION_RATE_RPM=%d\n", word
);
619 * Words 108-111 contain a mandatory World Wide Name (WWN) in the NAA IEEE Registered identifier
620 * format. Word 108 bits (15:12) shall contain 5h, indicating that the naming authority is IEEE.
621 * All other values are reserved.
623 word
= identify
.wyde
[108];
624 if ((word
& 0xf000) == 0x5000) {
627 wwwn
= identify
.wyde
[108];
629 wwwn
|= identify
.wyde
[109];
631 wwwn
|= identify
.wyde
[110];
633 wwwn
|= identify
.wyde
[111];
634 printf("ID_WWN=0x%1$" PRIx64
"\n"
635 "ID_WWN_WITH_EXTENSION=0x%1$" PRIx64
"\n",
639 /* from Linux's include/linux/ata.h */
640 if (IN_SET(identify
.wyde
[0], 0x848a, 0x844a) ||
641 (identify
.wyde
[83] & 0xc004) == 0x4004)
642 printf("ID_ATA_CFA=1\n");
644 if (serial
[0] != '\0')
645 printf("%s_%s\n", model
, serial
);
647 printf("%s\n", model
);