2 * Copyright 2007 Red Hat, Inc.
3 * by Peter Jones <pjones@redhat.com>
4 * Copyright 2008 IBM, Inc.
5 * by Konrad Rzeszutek <konradr@linux.vnet.ibm.com>
7 * by Konrad Rzeszutek <ketuzsezr@darnok.org>
9 * This code exposes the iSCSI Boot Format Table to userland via sysfs.
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License v2.0 as published by
13 * the Free Software Foundation
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
22 * 14 Mar 2008 - Konrad Rzeszutek <ketuzsezr@darnok.org>
23 * Updated comments and copyrights. (v0.4.9)
25 * 11 Feb 2008 - Konrad Rzeszutek <konradr@linux.vnet.ibm.com>
26 * Converted to using ibft_addr. (v0.4.8)
28 * 8 Feb 2008 - Konrad Rzeszutek <konradr@linux.vnet.ibm.com>
29 * Combined two functions in one: reserve_ibft_region. (v0.4.7)
31 * 30 Jan 2008 - Konrad Rzeszutek <konradr@linux.vnet.ibm.com>
32 * Added logic to handle IPv6 addresses. (v0.4.6)
34 * 25 Jan 2008 - Konrad Rzeszutek <konradr@linux.vnet.ibm.com>
35 * Added logic to handle badly not-to-spec iBFT. (v0.4.5)
37 * 4 Jan 2008 - Konrad Rzeszutek <konradr@linux.vnet.ibm.com>
38 * Added __init to function declarations. (v0.4.4)
40 * 21 Dec 2007 - Konrad Rzeszutek <konradr@linux.vnet.ibm.com>
41 * Updated kobject registration, combined unregister functions in one
42 * and code and style cleanup. (v0.4.3)
44 * 5 Dec 2007 - Konrad Rzeszutek <konradr@linux.vnet.ibm.com>
45 * Added end-markers to enums and re-organized kobject registration. (v0.4.2)
47 * 4 Dec 2007 - Konrad Rzeszutek <konradr@linux.vnet.ibm.com>
48 * Created 'device' sysfs link to the NIC and style cleanup. (v0.4.1)
50 * 28 Nov 2007 - Konrad Rzeszutek <konradr@linux.vnet.ibm.com>
51 * Added sysfs-ibft documentation, moved 'find_ibft' function to
52 * in its own file and added text attributes for every struct field. (v0.4)
54 * 21 Nov 2007 - Konrad Rzeszutek <konradr@linux.vnet.ibm.com>
55 * Added text attributes emulating OpenFirmware /proc/device-tree naming.
56 * Removed binary /sysfs interface (v0.3)
58 * 29 Aug 2007 - Konrad Rzeszutek <konradr@linux.vnet.ibm.com>
59 * Added functionality in setup.c to reserve iBFT region. (v0.2)
61 * 27 Aug 2007 - Konrad Rzeszutek <konradr@linux.vnet.ibm.com>
62 * First version exposing iBFT data via a binary /sysfs. (v0.1)
67 #include <linux/blkdev.h>
68 #include <linux/capability.h>
69 #include <linux/ctype.h>
70 #include <linux/device.h>
71 #include <linux/err.h>
72 #include <linux/init.h>
73 #include <linux/iscsi_ibft.h>
74 #include <linux/limits.h>
75 #include <linux/module.h>
76 #include <linux/pci.h>
77 #include <linux/slab.h>
78 #include <linux/stat.h>
79 #include <linux/string.h>
80 #include <linux/types.h>
82 #define IBFT_ISCSI_VERSION "0.4.9"
83 #define IBFT_ISCSI_DATE "2008-Mar-14"
85 MODULE_AUTHOR("Peter Jones <pjones@redhat.com> and \
86 Konrad Rzeszutek <ketuzsezr@darnok.org>");
87 MODULE_DESCRIPTION("sysfs interface to BIOS iBFT information");
88 MODULE_LICENSE("GPL");
89 MODULE_VERSION(IBFT_ISCSI_VERSION);
97 } __attribute__((__packed__));
107 } __attribute__((__packed__));
109 struct ibft_initiator {
111 char isns_server[16];
113 char pri_radius_server[16];
114 char sec_radius_server[16];
115 u16 initiator_name_len;
116 u16 initiator_name_off;
117 } __attribute__((__packed__));
122 u8 subnet_mask_prefix;
125 char primary_dns[16];
126 char secondary_dns[16];
133 } __attribute__((__packed__));
148 u16 rev_chap_name_len;
149 u16 rev_chap_name_off;
150 u16 rev_chap_secret_len;
151 u16 rev_chap_secret_off;
152 } __attribute__((__packed__));
155 * The kobject different types and its names.
159 id_reserved = 0, /* We don't support. */
160 id_control = 1, /* Should show up only once and is not exported. */
164 id_extensions = 5, /* We don't support. */
169 * We do not support the other types, hence the usage of NULL.
170 * This maps to the enum ibft_id.
172 static const char *ibft_id_names[] =
173 {NULL, NULL, "initiator", "ethernet%d", "target%d", NULL, NULL};
176 * The text attributes names for each of the kobjects.
178 enum ibft_eth_properties_enum {
182 ibft_eth_subnet_mask,
185 ibft_eth_primary_dns,
186 ibft_eth_secondary_dns,
190 /* ibft_eth_pci_bdf - this is replaced by link to the device itself. */
195 static const char *ibft_eth_properties[] =
196 {"index", "flags", "ip-addr", "subnet-mask", "origin", "gateway",
197 "primary-dns", "secondary-dns", "dhcp", "vlan", "mac", "hostname",
200 enum ibft_tgt_properties_enum {
210 ibft_tgt_chap_secret,
211 ibft_tgt_rev_chap_name,
212 ibft_tgt_rev_chap_secret,
216 static const char *ibft_tgt_properties[] =
217 {"index", "flags", "ip-addr", "port", "lun", "chap-type", "nic-assoc",
218 "target-name", "chap-name", "chap-secret", "rev-chap-name",
219 "rev-chap-name-secret", NULL};
221 enum ibft_initiator_properties_enum {
224 ibft_init_isns_server,
225 ibft_init_slp_server,
226 ibft_init_pri_radius_server,
227 ibft_init_sec_radius_server,
228 ibft_init_initiator_name,
229 ibft_init_end_marker,
232 static const char *ibft_initiator_properties[] =
233 {"index", "flags", "isns-server", "slp-server", "pri-radius-server",
234 "sec-radius-server", "initiator-name", NULL};
237 * The kobject and attribute structures.
240 struct ibft_kobject {
241 struct ibft_table_header *header;
243 struct ibft_initiator *initiator;
244 struct ibft_nic *nic;
245 struct ibft_tgt *tgt;
246 struct ibft_hdr *hdr;
249 struct list_head node;
252 struct ibft_attribute {
253 struct attribute attr;
254 ssize_t (*show) (struct ibft_kobject *entry,
255 struct ibft_attribute *attr, char *buf);
257 struct ibft_initiator *initiator;
258 struct ibft_nic *nic;
259 struct ibft_tgt *tgt;
260 struct ibft_hdr *hdr;
262 struct kobject *kobj;
263 int type; /* The enum of the type. This can be any value of:
264 ibft_eth_properties_enum, ibft_tgt_properties_enum,
265 or ibft_initiator_properties_enum. */
266 struct list_head node;
269 static LIST_HEAD(ibft_attr_list);
270 static LIST_HEAD(ibft_kobject_list);
272 static const char nulls[16];
275 * Helper functions to parse data properly.
277 static ssize_t sprintf_ipaddr(char *buf, u8 *ip)
281 if (ip[0] == 0 && ip[1] == 0 && ip[2] == 0 && ip[3] == 0 &&
282 ip[4] == 0 && ip[5] == 0 && ip[6] == 0 && ip[7] == 0 &&
283 ip[8] == 0 && ip[9] == 0 && ip[10] == 0xff && ip[11] == 0xff) {
287 str += sprintf(buf, NIPQUAD_FMT, ip[12],
288 ip[13], ip[14], ip[15]);
293 str += sprintf(str, NIP6_FMT, ntohs(ip[0]), ntohs(ip[1]),
294 ntohs(ip[2]), ntohs(ip[3]), ntohs(ip[4]),
295 ntohs(ip[5]), ntohs(ip[6]), ntohs(ip[7]));
297 str += sprintf(str, "\n");
301 static ssize_t sprintf_string(char *str, int len, char *buf)
303 return sprintf(str, "%.*s\n", len, buf);
307 * Helper function to verify the IBFT header.
309 static int ibft_verify_hdr(char *t, struct ibft_hdr *hdr, int id, int length)
312 printk(KERN_ERR "iBFT error: We expected the " \
313 "field header.id to have %d but " \
314 "found %d instead!\n", id, hdr->id);
317 if (hdr->length != length) {
318 printk(KERN_ERR "iBFT error: We expected the " \
319 "field header.length to have %d but " \
320 "found %d instead!\n", length, hdr->length);
327 static void ibft_release(struct kobject *kobj)
329 struct ibft_kobject *ibft =
330 container_of(kobj, struct ibft_kobject, kobj);
335 * Routines for parsing the iBFT data to be human readable.
337 ssize_t ibft_attr_show_initiator(struct ibft_kobject *entry,
338 struct ibft_attribute *attr,
341 struct ibft_initiator *initiator = entry->initiator;
342 void *ibft_loc = entry->header;
348 switch (attr->type) {
349 case ibft_init_index:
350 str += sprintf(str, "%d\n", initiator->hdr.index);
352 case ibft_init_flags:
353 str += sprintf(str, "%d\n", initiator->hdr.flags);
355 case ibft_init_isns_server:
356 str += sprintf_ipaddr(str, initiator->isns_server);
358 case ibft_init_slp_server:
359 str += sprintf_ipaddr(str, initiator->slp_server);
361 case ibft_init_pri_radius_server:
362 str += sprintf_ipaddr(str, initiator->pri_radius_server);
364 case ibft_init_sec_radius_server:
365 str += sprintf_ipaddr(str, initiator->sec_radius_server);
367 case ibft_init_initiator_name:
368 str += sprintf_string(str, initiator->initiator_name_len,
370 initiator->initiator_name_off);
379 ssize_t ibft_attr_show_nic(struct ibft_kobject *entry,
380 struct ibft_attribute *attr,
383 struct ibft_nic *nic = entry->nic;
384 void *ibft_loc = entry->header;
392 switch (attr->type) {
394 str += sprintf(str, "%d\n", nic->hdr.index);
397 str += sprintf(str, "%d\n", nic->hdr.flags);
399 case ibft_eth_ip_addr:
400 str += sprintf_ipaddr(str, nic->ip_addr);
402 case ibft_eth_subnet_mask:
403 val = ~((1 << (32-nic->subnet_mask_prefix))-1);
404 str += sprintf(str, NIPQUAD_FMT,
405 (u8)(val >> 24), (u8)(val >> 16),
406 (u8)(val >> 8), (u8)(val));
408 case ibft_eth_origin:
409 str += sprintf(str, "%d\n", nic->origin);
411 case ibft_eth_gateway:
412 str += sprintf_ipaddr(str, nic->gateway);
414 case ibft_eth_primary_dns:
415 str += sprintf_ipaddr(str, nic->primary_dns);
417 case ibft_eth_secondary_dns:
418 str += sprintf_ipaddr(str, nic->secondary_dns);
421 str += sprintf_ipaddr(str, nic->dhcp);
424 str += sprintf(str, "%d\n", nic->vlan);
428 str += sprintf(str, "%02x:%02x:%02x:%02x:%02x:%02x\n",
429 (u8)mac[0], (u8)mac[1], (u8)mac[2],
430 (u8)mac[3], (u8)mac[4], (u8)mac[5]);
432 case ibft_eth_hostname:
433 str += sprintf_string(str, nic->hostname_len,
434 (char *)ibft_loc + nic->hostname_off);
443 ssize_t ibft_attr_show_target(struct ibft_kobject *entry,
444 struct ibft_attribute *attr,
447 struct ibft_tgt *tgt = entry->tgt;
448 void *ibft_loc = entry->header;
455 switch (attr->type) {
457 str += sprintf(str, "%d\n", tgt->hdr.index);
460 str += sprintf(str, "%d\n", tgt->hdr.flags);
462 case ibft_tgt_ip_addr:
463 str += sprintf_ipaddr(str, tgt->ip_addr);
466 str += sprintf(str, "%d\n", tgt->port);
469 for (i = 0; i < 8; i++)
470 str += sprintf(str, "%x", (u8)tgt->lun[i]);
471 str += sprintf(str, "\n");
473 case ibft_tgt_nic_assoc:
474 str += sprintf(str, "%d\n", tgt->nic_assoc);
476 case ibft_tgt_chap_type:
477 str += sprintf(str, "%d\n", tgt->chap_type);
480 str += sprintf_string(str, tgt->tgt_name_len,
481 (char *)ibft_loc + tgt->tgt_name_off);
483 case ibft_tgt_chap_name:
484 str += sprintf_string(str, tgt->chap_name_len,
485 (char *)ibft_loc + tgt->chap_name_off);
487 case ibft_tgt_chap_secret:
488 str += sprintf_string(str, tgt->chap_secret_len,
489 (char *)ibft_loc + tgt->chap_secret_off);
491 case ibft_tgt_rev_chap_name:
492 str += sprintf_string(str, tgt->rev_chap_name_len,
494 tgt->rev_chap_name_off);
496 case ibft_tgt_rev_chap_secret:
497 str += sprintf_string(str, tgt->rev_chap_secret_len,
499 tgt->rev_chap_secret_off);
509 * The routine called for all sysfs attributes.
511 static ssize_t ibft_show_attribute(struct kobject *kobj,
512 struct attribute *attr,
515 struct ibft_kobject *dev =
516 container_of(kobj, struct ibft_kobject, kobj);
517 struct ibft_attribute *ibft_attr =
518 container_of(attr, struct ibft_attribute, attr);
522 if (!capable(CAP_SYS_ADMIN))
526 ret = ibft_attr->show(dev, ibft_attr, str);
531 static struct sysfs_ops ibft_attr_ops = {
532 .show = ibft_show_attribute,
535 static struct kobj_type ibft_ktype = {
536 .release = ibft_release,
537 .sysfs_ops = &ibft_attr_ops,
540 static struct kset *ibft_kset;
542 static int __init ibft_check_device(void)
548 len = ibft_addr->length;
550 /* Sanity checking of iBFT. */
551 if (ibft_addr->revision != 1) {
552 printk(KERN_ERR "iBFT module supports only revision 1, " \
553 "while this is %d.\n", ibft_addr->revision);
556 for (pos = (u8 *)ibft_addr; pos < (u8 *)ibft_addr + len; pos++)
560 printk(KERN_ERR "iBFT has incorrect checksum (0x%x)!\n", csum);
568 * Helper function for ibft_register_kobjects.
570 static int __init ibft_create_kobject(struct ibft_table_header *header,
571 struct ibft_hdr *hdr,
572 struct list_head *list)
574 struct ibft_kobject *ibft_kobj = NULL;
575 struct ibft_nic *nic = (struct ibft_nic *)hdr;
576 struct pci_dev *pci_dev;
579 ibft_kobj = kzalloc(sizeof(*ibft_kobj), GFP_KERNEL);
583 ibft_kobj->header = header;
584 ibft_kobj->hdr = hdr;
588 rc = ibft_verify_hdr("initiator", hdr, id_initiator,
589 sizeof(*ibft_kobj->initiator));
592 rc = ibft_verify_hdr("ethernet", hdr, id_nic,
593 sizeof(*ibft_kobj->nic));
596 rc = ibft_verify_hdr("target", hdr, id_target,
597 sizeof(*ibft_kobj->tgt));
602 /* Fields which we don't support. Ignore them */
606 printk(KERN_ERR "iBFT has unknown structure type (%d). " \
607 "Report this bug to %.6s!\n", hdr->id,
614 /* Skip adding this kobject, but exit with non-fatal error. */
616 goto out_invalid_struct;
619 ibft_kobj->kobj.kset = ibft_kset;
621 rc = kobject_init_and_add(&ibft_kobj->kobj, &ibft_ktype,
622 NULL, ibft_id_names[hdr->id], hdr->index);
629 kobject_uevent(&ibft_kobj->kobj, KOBJ_ADD);
631 if (hdr->id == id_nic) {
633 * We don't search for the device in other domains than
634 * zero. This is because on x86 platforms the BIOS
635 * executes only devices which are in domain 0. Furthermore, the
636 * iBFT spec doesn't have a domain id field :-(
638 pci_dev = pci_get_bus_and_slot((nic->pci_bdf & 0xff00) >> 8,
639 (nic->pci_bdf & 0xff));
641 rc = sysfs_create_link(&ibft_kobj->kobj,
642 &pci_dev->dev.kobj, "device");
643 pci_dev_put(pci_dev);
647 /* Nothing broke so lets add it to the list. */
648 list_add_tail(&ibft_kobj->node, list);
652 /* Unsupported structs are skipped. */
657 * Scan the IBFT table structure for the NIC and Target fields. When
658 * found add them on the passed-in list. We do not support the other
659 * fields at this point, so they are skipped.
661 static int __init ibft_register_kobjects(struct ibft_table_header *header,
662 struct list_head *list)
664 struct ibft_control *control = NULL;
670 control = (void *)header + sizeof(*header);
671 end = (void *)control + control->hdr.length;
672 eot_offset = (void *)header + header->length - (void *)control;
673 rc = ibft_verify_hdr("control", (struct ibft_hdr *)control, id_control,
676 /* iBFT table safety checking */
677 rc |= ((control->hdr.index) ? -ENODEV : 0);
679 printk(KERN_ERR "iBFT error: Control header is invalid!\n");
682 for (ptr = &control->initiator_off; ptr < end; ptr += sizeof(u16)) {
683 offset = *(u16 *)ptr;
684 if (offset && offset < header->length && offset < eot_offset) {
685 rc = ibft_create_kobject(header,
686 (void *)header + offset,
696 static void ibft_unregister(struct list_head *attr_list,
697 struct list_head *kobj_list)
699 struct ibft_kobject *data = NULL, *n;
700 struct ibft_attribute *attr = NULL, *m;
702 list_for_each_entry_safe(attr, m, attr_list, node) {
703 sysfs_remove_file(attr->kobj, &attr->attr);
704 list_del(&attr->node);
707 list_del_init(attr_list);
709 list_for_each_entry_safe(data, n, kobj_list, node) {
710 list_del(&data->node);
711 if (data->hdr->id == id_nic)
712 sysfs_remove_link(&data->kobj, "device");
713 kobject_put(&data->kobj);
715 list_del_init(kobj_list);
718 static int __init ibft_create_attribute(struct ibft_kobject *kobj_data,
721 ssize_t (*show)(struct ibft_kobject *,
722 struct ibft_attribute*,
724 struct list_head *list)
726 struct ibft_attribute *attr = NULL;
727 struct ibft_hdr *hdr = kobj_data->hdr;
729 attr = kmalloc(sizeof(*attr), GFP_KERNEL);
733 attr->attr.name = name;
734 attr->attr.mode = S_IRUSR;
735 attr->attr.owner = THIS_MODULE;
739 attr->kobj = &kobj_data->kobj;
742 list_add_tail(&attr->node, list);
748 * Helper routiners to check to determine if the entry is valid
749 * in the proper iBFT structure.
751 static int __init ibft_check_nic_for(struct ibft_nic *nic, int entry)
760 case ibft_eth_ip_addr:
761 if (!memcmp(nic->dhcp, nulls, sizeof(nic->dhcp)))
764 case ibft_eth_subnet_mask:
765 if (!memcmp(nic->dhcp, nulls, sizeof(nic->dhcp)))
768 case ibft_eth_origin:
771 case ibft_eth_gateway:
772 if (memcmp(nic->gateway, nulls, sizeof(nic->gateway)))
775 case ibft_eth_primary_dns:
776 if (memcmp(nic->primary_dns, nulls,
777 sizeof(nic->primary_dns)))
780 case ibft_eth_secondary_dns:
781 if (memcmp(nic->secondary_dns, nulls,
782 sizeof(nic->secondary_dns)))
786 if (memcmp(nic->dhcp, nulls, sizeof(nic->dhcp)))
793 case ibft_eth_hostname:
794 if (nic->hostname_off)
804 static int __init ibft_check_tgt_for(struct ibft_tgt *tgt, int entry)
811 case ibft_tgt_ip_addr:
814 case ibft_tgt_nic_assoc:
815 case ibft_tgt_chap_type:
818 if (tgt->tgt_name_len)
821 case ibft_tgt_chap_name:
822 case ibft_tgt_chap_secret:
823 if (tgt->chap_name_len)
826 case ibft_tgt_rev_chap_name:
827 case ibft_tgt_rev_chap_secret:
828 if (tgt->rev_chap_name_len)
838 static int __init ibft_check_initiator_for(struct ibft_initiator *init,
844 case ibft_init_index:
845 case ibft_init_flags:
848 case ibft_init_isns_server:
849 if (memcmp(init->isns_server, nulls,
850 sizeof(init->isns_server)))
853 case ibft_init_slp_server:
854 if (memcmp(init->slp_server, nulls,
855 sizeof(init->slp_server)))
858 case ibft_init_pri_radius_server:
859 if (memcmp(init->pri_radius_server, nulls,
860 sizeof(init->pri_radius_server)))
863 case ibft_init_sec_radius_server:
864 if (memcmp(init->sec_radius_server, nulls,
865 sizeof(init->sec_radius_server)))
868 case ibft_init_initiator_name:
869 if (init->initiator_name_len)
880 * Register the attributes for all of the kobjects.
882 static int __init ibft_register_attributes(struct list_head *kobject_list,
883 struct list_head *attr_list)
886 struct ibft_kobject *data = NULL;
887 struct ibft_attribute *attr = NULL, *m;
889 list_for_each_entry(data, kobject_list, node) {
890 switch (data->hdr->id) {
892 for (i = 0; i < ibft_eth_end_marker && !rc; i++)
893 if (ibft_check_nic_for(data->nic, i))
894 rc = ibft_create_attribute(data, i,
895 ibft_eth_properties[i],
896 ibft_attr_show_nic, attr_list);
899 for (i = 0; i < ibft_tgt_end_marker && !rc; i++)
900 if (ibft_check_tgt_for(data->tgt, i))
901 rc = ibft_create_attribute(data, i,
902 ibft_tgt_properties[i],
903 ibft_attr_show_target,
907 for (i = 0; i < ibft_init_end_marker && !rc; i++)
908 if (ibft_check_initiator_for(
910 rc = ibft_create_attribute(data, i,
911 ibft_initiator_properties[i],
912 ibft_attr_show_initiator,
921 list_for_each_entry_safe(attr, m, attr_list, node) {
922 rc = sysfs_create_file(attr->kobj, &attr->attr);
924 list_del(&attr->node);
934 * ibft_init() - creates sysfs tree entries for the iBFT data.
936 static int __init ibft_init(void)
940 ibft_kset = kset_create_and_add("ibft", NULL, firmware_kobj);
945 printk(KERN_INFO "iBFT detected at 0x%lx.\n",
946 virt_to_phys((void *)ibft_addr));
948 rc = ibft_check_device();
950 goto out_firmware_unregister;
952 /* Scan the IBFT for data and register the kobjects. */
953 rc = ibft_register_kobjects(ibft_addr, &ibft_kobject_list);
957 /* Register the attributes */
958 rc = ibft_register_attributes(&ibft_kobject_list,
963 printk(KERN_INFO "No iBFT detected.\n");
968 ibft_unregister(&ibft_attr_list, &ibft_kobject_list);
969 out_firmware_unregister:
970 kset_unregister(ibft_kset);
974 static void __exit ibft_exit(void)
976 ibft_unregister(&ibft_attr_list, &ibft_kobject_list);
977 kset_unregister(ibft_kset);
980 module_init(ibft_init);
981 module_exit(ibft_exit);