1 // SPDX-License-Identifier: GPL-2.0-only
5  * Libata transport class.
7  * The ATA transport class contains common code to deal with ATA HBAs,
10  * interfaces to user-space.
12  * There are 3 objects defined in this class:
13  * - ata_port
14  * - ata_link
15  * - ata_device
38 #include "libata-transport.h"
68 #define tdev_to_device(d)					\  argument
69 	container_of((d), struct ata_device, tdev)
71 	tdev_to_device((dev)->parent)
73 #define tdev_to_link(d)						\  argument
74 	container_of((d), struct ata_link, tdev)
76 	tdev_to_link((dev)->parent)
78 #define tdev_to_port(d)						\  argument
79 	container_of((d), struct ata_port, tdev)
81 	tdev_to_port((dev)->parent)
149 ata_bitfield_name_search(class, ata_class_names)
211 	return scnprintf(buf, 20, format_string, cast ap->field);	\
218 ata_port_simple_attr(nr_pmp_links, nr_pmp_links, "%d\n", int);
228 	ata_host_put(ap->host);  in ata_tport_release()
232  * ata_is_port --  check if a struct device represents a ATA port
240 	return dev->release == ata_tport_release;  in ata_is_port()
248 	return &ata_scsi_transport_template->host_attrs.ac == cont;  in ata_tport_match()
252  * ata_tport_delete  --  remove ATA PORT
259 	struct device *dev = &ap->tdev;  in ata_tport_delete()
261 	ata_tlink_delete(&ap->link);  in ata_tport_delete()
273 /** ata_tport_add - initialize a transport ATA port structure
287 	struct device *dev = &ap->tdev;  in ata_tport_add()
290 	if (ap->flags & ATA_FLAG_SAS_HOST)  in ata_tport_add()
291 		dev->type = &ata_port_sas_type;  in ata_tport_add()
293 		dev->type = &ata_port_type;  in ata_tport_add()
295 	dev->parent = parent;  in ata_tport_add()
296 	ata_host_get(ap->host);  in ata_tport_add()
297 	dev->release = ata_tport_release;  in ata_tport_add()
298 	dev_set_name(dev, "ata%d", ap->print_id);  in ata_tport_add()
316 	error = ata_tlink_add(&ap->link);  in ata_tport_add()
334  *     ata_port_classify - determine device type based on ATA-spec signature
348 	unsigned int class = ata_dev_classify(tf);  in ata_port_classify()  local
352 		if (ata_class_names[i].value == class) {  in ata_port_classify()
355 			return class;  in ata_port_classify()
359 	ata_port_info(ap, "found unknown device (class %u)\n", class);  in ata_port_classify()
360 	return class;  in ata_port_classify()
376 	return sprintf(buf, "%s\n", sata_spd_string(format(link->field))); \
396  * ata_is_link --  check if a struct device represents a ATA link
404 	return dev->release == ata_tlink_release;  in ata_is_link()
413 	return &i->link_attr_cont.ac == cont;  in ata_tlink_match()
417  * ata_tlink_delete  --  remove ATA LINK
424 	struct device *dev = &link->tdev;  in ata_tlink_delete()
438  * ata_tlink_add  --  initialize a transport ATA link structure
448 	struct device *dev = &link->tdev;  in ata_tlink_add()
449 	struct ata_port *ap = link->ap;  in ata_tlink_add()
454 	dev->parent = &ap->tdev;  in ata_tlink_add()
455 	dev->release = ata_tlink_release;  in ata_tlink_add()
457 		dev_set_name(dev, "link%d", ap->print_id);  in ata_tlink_add()
459 		dev_set_name(dev, "link%d.%d", ap->print_id, link->pmp);  in ata_tlink_add()
481 	while (--ata_dev >= link->device) {  in ata_tlink_add()
504 	return get_ata_##title##_names(ata_dev->field, buf);		\
511 ata_dev_attr(class, class);
524 	return scnprintf(buf, 20, format_string, cast ata_dev->field);	\
532 ata_dev_simple_attr(spdn_cnt, "%d\n", int);
545 	seconds = div_u64_rem(ent->timestamp, HZ, &rem);  in ata_show_ering()
546 	arg->written += sprintf(arg->buf + arg->written,  in ata_show_ering()
549 	arg->written += get_ata_err_names(ent->err_mask,  in ata_show_ering()
550 					  arg->buf + arg->written);  in ata_show_ering()
561 	ata_ering_map(&ata_dev->ering, ata_show_ering, &arg);  in show_ata_dev_ering()
575 	if (ata_dev->class == ATA_DEV_PMP)  in show_ata_dev_id()
579 				    ata_dev->id[i],  in show_ata_dev_id()
594 	if (ata_dev->class != ATA_DEV_PMP)  in show_ata_dev_gscr()
598 				    ata_dev->gscr[i],  in show_ata_dev_gscr()
602 		buf[written-1] = '\n';  in show_ata_dev_gscr()
615 	if (!ata_id_has_trim(ata_dev->id))  in show_ata_dev_trim()
617 	else if (ata_dev->horkage & ATA_HORKAGE_NOTRIM)  in show_ata_dev_trim()
619 	else if (ata_dev->horkage & ATA_HORKAGE_NO_NCQ_TRIM)  in show_ata_dev_trim()
639  * ata_is_ata_dev  --  check if a struct device represents a ATA device
647 	return dev->release == ata_tdev_release;  in ata_is_ata_dev()
656 	return &i->dev_attr_cont.ac == cont;  in ata_tdev_match()
660  * ata_tdev_free  --  free a ATA LINK
671 	transport_destroy_device(&dev->tdev);  in ata_tdev_free()
672 	put_device(&dev->tdev);  in ata_tdev_free()
676  * ata_tdev_delete  --  remove ATA device
683 	struct device *dev = &ata_dev->tdev;  in ata_tdev_delete()
692  * ata_tdev_add  --  initialize a transport ATA device structure.
702 	struct device *dev = &ata_dev->tdev;  in ata_tdev_add()
703 	struct ata_link *link = ata_dev->link;  in ata_tdev_add()
704 	struct ata_port *ap = link->ap;  in ata_tdev_add()
708 	dev->parent = &link->tdev;  in ata_tdev_add()
709 	dev->release = ata_tdev_release;  in ata_tdev_add()
711 		dev_set_name(dev, "dev%d.%d", ap->print_id,ata_dev->devno);  in ata_tdev_add()
713 		dev_set_name(dev, "dev%d.%d.0", ap->print_id, link->pmp);  in ata_tdev_add()
740 	i->private_##attrb[count] = dev_attr_##field;			\
741 	i->private_##attrb[count].attr.mode = perm;			\
742 	i->attrb[count] = &i->private_##attrb[count];			\
756  * ata_attach_transport  --  instantiate ATA transport template
767 	i->t.eh_strategy_handler	= ata_scsi_error;  in ata_attach_transport()
768 	i->t.user_scan			= ata_scsi_user_scan;  in ata_attach_transport()
770 	i->t.host_attrs.ac.attrs = &i->port_attrs[0];  in ata_attach_transport()
771 	i->t.host_attrs.ac.class = &ata_port_class.class;  in ata_attach_transport()
772 	i->t.host_attrs.ac.match = ata_tport_match;  in ata_attach_transport()
773 	transport_container_register(&i->t.host_attrs);  in ata_attach_transport()
775 	i->link_attr_cont.ac.class = &ata_link_class.class;  in ata_attach_transport()
776 	i->link_attr_cont.ac.attrs = &i->link_attrs[0];  in ata_attach_transport()
777 	i->link_attr_cont.ac.match = ata_tlink_match;  in ata_attach_transport()
778 	transport_container_register(&i->link_attr_cont);  in ata_attach_transport()
780 	i->dev_attr_cont.ac.class = &ata_dev_class.class;  in ata_attach_transport()
781 	i->dev_attr_cont.ac.attrs = &i->dev_attrs[0];  in ata_attach_transport()
782 	i->dev_attr_cont.ac.match = ata_tdev_match;  in ata_attach_transport()
783 	transport_container_register(&i->dev_attr_cont);  in ata_attach_transport()
790 	i->port_attrs[count] = NULL;  in ata_attach_transport()
797 	i->link_attrs[count] = NULL;  in ata_attach_transport()
800 	SETUP_DEV_ATTRIBUTE(class);  in ata_attach_transport()
810 	i->dev_attrs[count] = NULL;  in ata_attach_transport()
812 	return &i->t;  in ata_attach_transport()
816  * ata_release_transport  --  release ATA transport template instance
823 	transport_container_unregister(&i->t.host_attrs);  in ata_release_transport()
824 	transport_container_unregister(&i->link_attr_cont);  in ata_release_transport()
825 	transport_container_unregister(&i->dev_attr_cont);  in ata_release_transport()