Loading...
1/*
2 * Export the iSCSI boot info to userland via sysfs.
3 *
4 * Copyright (C) 2010 Red Hat, Inc. All rights reserved.
5 * Copyright (C) 2010 Mike Christie
6 *
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License v2.0 as published by
9 * the Free Software Foundation
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 */
16
17#include <linux/module.h>
18#include <linux/string.h>
19#include <linux/slab.h>
20#include <linux/sysfs.h>
21#include <linux/capability.h>
22#include <linux/iscsi_boot_sysfs.h>
23
24
25MODULE_AUTHOR("Mike Christie <michaelc@cs.wisc.edu>");
26MODULE_DESCRIPTION("sysfs interface and helpers to export iSCSI boot information");
27MODULE_LICENSE("GPL");
28/*
29 * The kobject and attribute structures.
30 */
31struct iscsi_boot_attr {
32 struct attribute attr;
33 int type;
34 ssize_t (*show) (void *data, int type, char *buf);
35};
36
37/*
38 * The routine called for all sysfs attributes.
39 */
40static ssize_t iscsi_boot_show_attribute(struct kobject *kobj,
41 struct attribute *attr, char *buf)
42{
43 struct iscsi_boot_kobj *boot_kobj =
44 container_of(kobj, struct iscsi_boot_kobj, kobj);
45 struct iscsi_boot_attr *boot_attr =
46 container_of(attr, struct iscsi_boot_attr, attr);
47 ssize_t ret = -EIO;
48 char *str = buf;
49
50 if (!capable(CAP_SYS_ADMIN))
51 return -EACCES;
52
53 if (boot_kobj->show)
54 ret = boot_kobj->show(boot_kobj->data, boot_attr->type, str);
55 return ret;
56}
57
58static const struct sysfs_ops iscsi_boot_attr_ops = {
59 .show = iscsi_boot_show_attribute,
60};
61
62static void iscsi_boot_kobj_release(struct kobject *kobj)
63{
64 struct iscsi_boot_kobj *boot_kobj =
65 container_of(kobj, struct iscsi_boot_kobj, kobj);
66
67 if (boot_kobj->release)
68 boot_kobj->release(boot_kobj->data);
69 kfree(boot_kobj);
70}
71
72static struct kobj_type iscsi_boot_ktype = {
73 .release = iscsi_boot_kobj_release,
74 .sysfs_ops = &iscsi_boot_attr_ops,
75};
76
77#define iscsi_boot_rd_attr(fnname, sysfs_name, attr_type) \
78static struct iscsi_boot_attr iscsi_boot_attr_##fnname = { \
79 .attr = { .name = __stringify(sysfs_name), .mode = 0444 }, \
80 .type = attr_type, \
81}
82
83/* Target attrs */
84iscsi_boot_rd_attr(tgt_index, index, ISCSI_BOOT_TGT_INDEX);
85iscsi_boot_rd_attr(tgt_flags, flags, ISCSI_BOOT_TGT_FLAGS);
86iscsi_boot_rd_attr(tgt_ip, ip-addr, ISCSI_BOOT_TGT_IP_ADDR);
87iscsi_boot_rd_attr(tgt_port, port, ISCSI_BOOT_TGT_PORT);
88iscsi_boot_rd_attr(tgt_lun, lun, ISCSI_BOOT_TGT_LUN);
89iscsi_boot_rd_attr(tgt_chap, chap-type, ISCSI_BOOT_TGT_CHAP_TYPE);
90iscsi_boot_rd_attr(tgt_nic, nic-assoc, ISCSI_BOOT_TGT_NIC_ASSOC);
91iscsi_boot_rd_attr(tgt_name, target-name, ISCSI_BOOT_TGT_NAME);
92iscsi_boot_rd_attr(tgt_chap_name, chap-name, ISCSI_BOOT_TGT_CHAP_NAME);
93iscsi_boot_rd_attr(tgt_chap_secret, chap-secret, ISCSI_BOOT_TGT_CHAP_SECRET);
94iscsi_boot_rd_attr(tgt_chap_rev_name, rev-chap-name,
95 ISCSI_BOOT_TGT_REV_CHAP_NAME);
96iscsi_boot_rd_attr(tgt_chap_rev_secret, rev-chap-name-secret,
97 ISCSI_BOOT_TGT_REV_CHAP_SECRET);
98
99static struct attribute *target_attrs[] = {
100 &iscsi_boot_attr_tgt_index.attr,
101 &iscsi_boot_attr_tgt_flags.attr,
102 &iscsi_boot_attr_tgt_ip.attr,
103 &iscsi_boot_attr_tgt_port.attr,
104 &iscsi_boot_attr_tgt_lun.attr,
105 &iscsi_boot_attr_tgt_chap.attr,
106 &iscsi_boot_attr_tgt_nic.attr,
107 &iscsi_boot_attr_tgt_name.attr,
108 &iscsi_boot_attr_tgt_chap_name.attr,
109 &iscsi_boot_attr_tgt_chap_secret.attr,
110 &iscsi_boot_attr_tgt_chap_rev_name.attr,
111 &iscsi_boot_attr_tgt_chap_rev_secret.attr,
112 NULL
113};
114
115static umode_t iscsi_boot_tgt_attr_is_visible(struct kobject *kobj,
116 struct attribute *attr, int i)
117{
118 struct iscsi_boot_kobj *boot_kobj =
119 container_of(kobj, struct iscsi_boot_kobj, kobj);
120
121 if (attr == &iscsi_boot_attr_tgt_index.attr)
122 return boot_kobj->is_visible(boot_kobj->data,
123 ISCSI_BOOT_TGT_INDEX);
124 else if (attr == &iscsi_boot_attr_tgt_flags.attr)
125 return boot_kobj->is_visible(boot_kobj->data,
126 ISCSI_BOOT_TGT_FLAGS);
127 else if (attr == &iscsi_boot_attr_tgt_ip.attr)
128 return boot_kobj->is_visible(boot_kobj->data,
129 ISCSI_BOOT_TGT_IP_ADDR);
130 else if (attr == &iscsi_boot_attr_tgt_port.attr)
131 return boot_kobj->is_visible(boot_kobj->data,
132 ISCSI_BOOT_TGT_PORT);
133 else if (attr == &iscsi_boot_attr_tgt_lun.attr)
134 return boot_kobj->is_visible(boot_kobj->data,
135 ISCSI_BOOT_TGT_LUN);
136 else if (attr == &iscsi_boot_attr_tgt_chap.attr)
137 return boot_kobj->is_visible(boot_kobj->data,
138 ISCSI_BOOT_TGT_CHAP_TYPE);
139 else if (attr == &iscsi_boot_attr_tgt_nic.attr)
140 return boot_kobj->is_visible(boot_kobj->data,
141 ISCSI_BOOT_TGT_NIC_ASSOC);
142 else if (attr == &iscsi_boot_attr_tgt_name.attr)
143 return boot_kobj->is_visible(boot_kobj->data,
144 ISCSI_BOOT_TGT_NAME);
145 else if (attr == &iscsi_boot_attr_tgt_chap_name.attr)
146 return boot_kobj->is_visible(boot_kobj->data,
147 ISCSI_BOOT_TGT_CHAP_NAME);
148 else if (attr == &iscsi_boot_attr_tgt_chap_secret.attr)
149 return boot_kobj->is_visible(boot_kobj->data,
150 ISCSI_BOOT_TGT_CHAP_SECRET);
151 else if (attr == &iscsi_boot_attr_tgt_chap_rev_name.attr)
152 return boot_kobj->is_visible(boot_kobj->data,
153 ISCSI_BOOT_TGT_REV_CHAP_NAME);
154 else if (attr == &iscsi_boot_attr_tgt_chap_rev_secret.attr)
155 return boot_kobj->is_visible(boot_kobj->data,
156 ISCSI_BOOT_TGT_REV_CHAP_SECRET);
157 return 0;
158}
159
160static struct attribute_group iscsi_boot_target_attr_group = {
161 .attrs = target_attrs,
162 .is_visible = iscsi_boot_tgt_attr_is_visible,
163};
164
165/* Ethernet attrs */
166iscsi_boot_rd_attr(eth_index, index, ISCSI_BOOT_ETH_INDEX);
167iscsi_boot_rd_attr(eth_flags, flags, ISCSI_BOOT_ETH_FLAGS);
168iscsi_boot_rd_attr(eth_ip, ip-addr, ISCSI_BOOT_ETH_IP_ADDR);
169iscsi_boot_rd_attr(eth_prefix, prefix-len, ISCSI_BOOT_ETH_PREFIX_LEN);
170iscsi_boot_rd_attr(eth_subnet, subnet-mask, ISCSI_BOOT_ETH_SUBNET_MASK);
171iscsi_boot_rd_attr(eth_origin, origin, ISCSI_BOOT_ETH_ORIGIN);
172iscsi_boot_rd_attr(eth_gateway, gateway, ISCSI_BOOT_ETH_GATEWAY);
173iscsi_boot_rd_attr(eth_primary_dns, primary-dns, ISCSI_BOOT_ETH_PRIMARY_DNS);
174iscsi_boot_rd_attr(eth_secondary_dns, secondary-dns,
175 ISCSI_BOOT_ETH_SECONDARY_DNS);
176iscsi_boot_rd_attr(eth_dhcp, dhcp, ISCSI_BOOT_ETH_DHCP);
177iscsi_boot_rd_attr(eth_vlan, vlan, ISCSI_BOOT_ETH_VLAN);
178iscsi_boot_rd_attr(eth_mac, mac, ISCSI_BOOT_ETH_MAC);
179iscsi_boot_rd_attr(eth_hostname, hostname, ISCSI_BOOT_ETH_HOSTNAME);
180
181static struct attribute *ethernet_attrs[] = {
182 &iscsi_boot_attr_eth_index.attr,
183 &iscsi_boot_attr_eth_flags.attr,
184 &iscsi_boot_attr_eth_ip.attr,
185 &iscsi_boot_attr_eth_prefix.attr,
186 &iscsi_boot_attr_eth_subnet.attr,
187 &iscsi_boot_attr_eth_origin.attr,
188 &iscsi_boot_attr_eth_gateway.attr,
189 &iscsi_boot_attr_eth_primary_dns.attr,
190 &iscsi_boot_attr_eth_secondary_dns.attr,
191 &iscsi_boot_attr_eth_dhcp.attr,
192 &iscsi_boot_attr_eth_vlan.attr,
193 &iscsi_boot_attr_eth_mac.attr,
194 &iscsi_boot_attr_eth_hostname.attr,
195 NULL
196};
197
198static umode_t iscsi_boot_eth_attr_is_visible(struct kobject *kobj,
199 struct attribute *attr, int i)
200{
201 struct iscsi_boot_kobj *boot_kobj =
202 container_of(kobj, struct iscsi_boot_kobj, kobj);
203
204 if (attr == &iscsi_boot_attr_eth_index.attr)
205 return boot_kobj->is_visible(boot_kobj->data,
206 ISCSI_BOOT_ETH_INDEX);
207 else if (attr == &iscsi_boot_attr_eth_flags.attr)
208 return boot_kobj->is_visible(boot_kobj->data,
209 ISCSI_BOOT_ETH_FLAGS);
210 else if (attr == &iscsi_boot_attr_eth_ip.attr)
211 return boot_kobj->is_visible(boot_kobj->data,
212 ISCSI_BOOT_ETH_IP_ADDR);
213 else if (attr == &iscsi_boot_attr_eth_prefix.attr)
214 return boot_kobj->is_visible(boot_kobj->data,
215 ISCSI_BOOT_ETH_PREFIX_LEN);
216 else if (attr == &iscsi_boot_attr_eth_subnet.attr)
217 return boot_kobj->is_visible(boot_kobj->data,
218 ISCSI_BOOT_ETH_SUBNET_MASK);
219 else if (attr == &iscsi_boot_attr_eth_origin.attr)
220 return boot_kobj->is_visible(boot_kobj->data,
221 ISCSI_BOOT_ETH_ORIGIN);
222 else if (attr == &iscsi_boot_attr_eth_gateway.attr)
223 return boot_kobj->is_visible(boot_kobj->data,
224 ISCSI_BOOT_ETH_GATEWAY);
225 else if (attr == &iscsi_boot_attr_eth_primary_dns.attr)
226 return boot_kobj->is_visible(boot_kobj->data,
227 ISCSI_BOOT_ETH_PRIMARY_DNS);
228 else if (attr == &iscsi_boot_attr_eth_secondary_dns.attr)
229 return boot_kobj->is_visible(boot_kobj->data,
230 ISCSI_BOOT_ETH_SECONDARY_DNS);
231 else if (attr == &iscsi_boot_attr_eth_dhcp.attr)
232 return boot_kobj->is_visible(boot_kobj->data,
233 ISCSI_BOOT_ETH_DHCP);
234 else if (attr == &iscsi_boot_attr_eth_vlan.attr)
235 return boot_kobj->is_visible(boot_kobj->data,
236 ISCSI_BOOT_ETH_VLAN);
237 else if (attr == &iscsi_boot_attr_eth_mac.attr)
238 return boot_kobj->is_visible(boot_kobj->data,
239 ISCSI_BOOT_ETH_MAC);
240 else if (attr == &iscsi_boot_attr_eth_hostname.attr)
241 return boot_kobj->is_visible(boot_kobj->data,
242 ISCSI_BOOT_ETH_HOSTNAME);
243 return 0;
244}
245
246static struct attribute_group iscsi_boot_ethernet_attr_group = {
247 .attrs = ethernet_attrs,
248 .is_visible = iscsi_boot_eth_attr_is_visible,
249};
250
251/* Initiator attrs */
252iscsi_boot_rd_attr(ini_index, index, ISCSI_BOOT_INI_INDEX);
253iscsi_boot_rd_attr(ini_flags, flags, ISCSI_BOOT_INI_FLAGS);
254iscsi_boot_rd_attr(ini_isns, isns-server, ISCSI_BOOT_INI_ISNS_SERVER);
255iscsi_boot_rd_attr(ini_slp, slp-server, ISCSI_BOOT_INI_SLP_SERVER);
256iscsi_boot_rd_attr(ini_primary_radius, pri-radius-server,
257 ISCSI_BOOT_INI_PRI_RADIUS_SERVER);
258iscsi_boot_rd_attr(ini_secondary_radius, sec-radius-server,
259 ISCSI_BOOT_INI_SEC_RADIUS_SERVER);
260iscsi_boot_rd_attr(ini_name, initiator-name, ISCSI_BOOT_INI_INITIATOR_NAME);
261
262static struct attribute *initiator_attrs[] = {
263 &iscsi_boot_attr_ini_index.attr,
264 &iscsi_boot_attr_ini_flags.attr,
265 &iscsi_boot_attr_ini_isns.attr,
266 &iscsi_boot_attr_ini_slp.attr,
267 &iscsi_boot_attr_ini_primary_radius.attr,
268 &iscsi_boot_attr_ini_secondary_radius.attr,
269 &iscsi_boot_attr_ini_name.attr,
270 NULL
271};
272
273static umode_t iscsi_boot_ini_attr_is_visible(struct kobject *kobj,
274 struct attribute *attr, int i)
275{
276 struct iscsi_boot_kobj *boot_kobj =
277 container_of(kobj, struct iscsi_boot_kobj, kobj);
278
279 if (attr == &iscsi_boot_attr_ini_index.attr)
280 return boot_kobj->is_visible(boot_kobj->data,
281 ISCSI_BOOT_INI_INDEX);
282 if (attr == &iscsi_boot_attr_ini_flags.attr)
283 return boot_kobj->is_visible(boot_kobj->data,
284 ISCSI_BOOT_INI_FLAGS);
285 if (attr == &iscsi_boot_attr_ini_isns.attr)
286 return boot_kobj->is_visible(boot_kobj->data,
287 ISCSI_BOOT_INI_ISNS_SERVER);
288 if (attr == &iscsi_boot_attr_ini_slp.attr)
289 return boot_kobj->is_visible(boot_kobj->data,
290 ISCSI_BOOT_INI_SLP_SERVER);
291 if (attr == &iscsi_boot_attr_ini_primary_radius.attr)
292 return boot_kobj->is_visible(boot_kobj->data,
293 ISCSI_BOOT_INI_PRI_RADIUS_SERVER);
294 if (attr == &iscsi_boot_attr_ini_secondary_radius.attr)
295 return boot_kobj->is_visible(boot_kobj->data,
296 ISCSI_BOOT_INI_SEC_RADIUS_SERVER);
297 if (attr == &iscsi_boot_attr_ini_name.attr)
298 return boot_kobj->is_visible(boot_kobj->data,
299 ISCSI_BOOT_INI_INITIATOR_NAME);
300
301 return 0;
302}
303
304static struct attribute_group iscsi_boot_initiator_attr_group = {
305 .attrs = initiator_attrs,
306 .is_visible = iscsi_boot_ini_attr_is_visible,
307};
308
309/* iBFT ACPI Table attributes */
310iscsi_boot_rd_attr(acpitbl_signature, signature, ISCSI_BOOT_ACPITBL_SIGNATURE);
311iscsi_boot_rd_attr(acpitbl_oem_id, oem_id, ISCSI_BOOT_ACPITBL_OEM_ID);
312iscsi_boot_rd_attr(acpitbl_oem_table_id, oem_table_id,
313 ISCSI_BOOT_ACPITBL_OEM_TABLE_ID);
314
315static struct attribute *acpitbl_attrs[] = {
316 &iscsi_boot_attr_acpitbl_signature.attr,
317 &iscsi_boot_attr_acpitbl_oem_id.attr,
318 &iscsi_boot_attr_acpitbl_oem_table_id.attr,
319 NULL
320};
321
322static umode_t iscsi_boot_acpitbl_attr_is_visible(struct kobject *kobj,
323 struct attribute *attr, int i)
324{
325 struct iscsi_boot_kobj *boot_kobj =
326 container_of(kobj, struct iscsi_boot_kobj, kobj);
327
328 if (attr == &iscsi_boot_attr_acpitbl_signature.attr)
329 return boot_kobj->is_visible(boot_kobj->data,
330 ISCSI_BOOT_ACPITBL_SIGNATURE);
331 if (attr == &iscsi_boot_attr_acpitbl_oem_id.attr)
332 return boot_kobj->is_visible(boot_kobj->data,
333 ISCSI_BOOT_ACPITBL_OEM_ID);
334 if (attr == &iscsi_boot_attr_acpitbl_oem_table_id.attr)
335 return boot_kobj->is_visible(boot_kobj->data,
336 ISCSI_BOOT_ACPITBL_OEM_TABLE_ID);
337 return 0;
338}
339
340static struct attribute_group iscsi_boot_acpitbl_attr_group = {
341 .attrs = acpitbl_attrs,
342 .is_visible = iscsi_boot_acpitbl_attr_is_visible,
343};
344
345static struct iscsi_boot_kobj *
346iscsi_boot_create_kobj(struct iscsi_boot_kset *boot_kset,
347 struct attribute_group *attr_group,
348 const char *name, int index, void *data,
349 ssize_t (*show) (void *data, int type, char *buf),
350 umode_t (*is_visible) (void *data, int type),
351 void (*release) (void *data))
352{
353 struct iscsi_boot_kobj *boot_kobj;
354
355 boot_kobj = kzalloc(sizeof(*boot_kobj), GFP_KERNEL);
356 if (!boot_kobj)
357 return NULL;
358 INIT_LIST_HEAD(&boot_kobj->list);
359
360 boot_kobj->kobj.kset = boot_kset->kset;
361 if (kobject_init_and_add(&boot_kobj->kobj, &iscsi_boot_ktype,
362 NULL, name, index)) {
363 kfree(boot_kobj);
364 return NULL;
365 }
366 boot_kobj->data = data;
367 boot_kobj->show = show;
368 boot_kobj->is_visible = is_visible;
369 boot_kobj->release = release;
370
371 if (sysfs_create_group(&boot_kobj->kobj, attr_group)) {
372 /*
373 * We do not want to free this because the caller
374 * will assume that since the creation call failed
375 * the boot kobj was not setup and the normal release
376 * path is not being run.
377 */
378 boot_kobj->release = NULL;
379 kobject_put(&boot_kobj->kobj);
380 return NULL;
381 }
382 boot_kobj->attr_group = attr_group;
383
384 kobject_uevent(&boot_kobj->kobj, KOBJ_ADD);
385 /* Nothing broke so lets add it to the list. */
386 list_add_tail(&boot_kobj->list, &boot_kset->kobj_list);
387 return boot_kobj;
388}
389
390static void iscsi_boot_remove_kobj(struct iscsi_boot_kobj *boot_kobj)
391{
392 list_del(&boot_kobj->list);
393 sysfs_remove_group(&boot_kobj->kobj, boot_kobj->attr_group);
394 kobject_put(&boot_kobj->kobj);
395}
396
397/**
398 * iscsi_boot_create_target() - create boot target sysfs dir
399 * @boot_kset: boot kset
400 * @index: the target id
401 * @data: driver specific data for target
402 * @show: attr show function
403 * @is_visible: attr visibility function
404 * @release: release function
405 *
406 * Note: The boot sysfs lib will free the data passed in for the caller
407 * when all refs to the target kobject have been released.
408 */
409struct iscsi_boot_kobj *
410iscsi_boot_create_target(struct iscsi_boot_kset *boot_kset, int index,
411 void *data,
412 ssize_t (*show) (void *data, int type, char *buf),
413 umode_t (*is_visible) (void *data, int type),
414 void (*release) (void *data))
415{
416 return iscsi_boot_create_kobj(boot_kset, &iscsi_boot_target_attr_group,
417 "target%d", index, data, show, is_visible,
418 release);
419}
420EXPORT_SYMBOL_GPL(iscsi_boot_create_target);
421
422/**
423 * iscsi_boot_create_initiator() - create boot initiator sysfs dir
424 * @boot_kset: boot kset
425 * @index: the initiator id
426 * @data: driver specific data
427 * @show: attr show function
428 * @is_visible: attr visibility function
429 * @release: release function
430 *
431 * Note: The boot sysfs lib will free the data passed in for the caller
432 * when all refs to the initiator kobject have been released.
433 */
434struct iscsi_boot_kobj *
435iscsi_boot_create_initiator(struct iscsi_boot_kset *boot_kset, int index,
436 void *data,
437 ssize_t (*show) (void *data, int type, char *buf),
438 umode_t (*is_visible) (void *data, int type),
439 void (*release) (void *data))
440{
441 return iscsi_boot_create_kobj(boot_kset,
442 &iscsi_boot_initiator_attr_group,
443 "initiator", index, data, show,
444 is_visible, release);
445}
446EXPORT_SYMBOL_GPL(iscsi_boot_create_initiator);
447
448/**
449 * iscsi_boot_create_ethernet() - create boot ethernet sysfs dir
450 * @boot_kset: boot kset
451 * @index: the ethernet device id
452 * @data: driver specific data
453 * @show: attr show function
454 * @is_visible: attr visibility function
455 * @release: release function
456 *
457 * Note: The boot sysfs lib will free the data passed in for the caller
458 * when all refs to the ethernet kobject have been released.
459 */
460struct iscsi_boot_kobj *
461iscsi_boot_create_ethernet(struct iscsi_boot_kset *boot_kset, int index,
462 void *data,
463 ssize_t (*show) (void *data, int type, char *buf),
464 umode_t (*is_visible) (void *data, int type),
465 void (*release) (void *data))
466{
467 return iscsi_boot_create_kobj(boot_kset,
468 &iscsi_boot_ethernet_attr_group,
469 "ethernet%d", index, data, show,
470 is_visible, release);
471}
472EXPORT_SYMBOL_GPL(iscsi_boot_create_ethernet);
473
474/**
475 * iscsi_boot_create_acpitbl() - create boot acpi table sysfs dir
476 * @boot_kset: boot kset
477 * @index: not used
478 * @data: driver specific data
479 * @show: attr show function
480 * @is_visible: attr visibility function
481 * @release: release function
482 *
483 * Note: The boot sysfs lib will free the data passed in for the caller
484 * when all refs to the acpitbl kobject have been released.
485 */
486struct iscsi_boot_kobj *
487iscsi_boot_create_acpitbl(struct iscsi_boot_kset *boot_kset, int index,
488 void *data,
489 ssize_t (*show)(void *data, int type, char *buf),
490 umode_t (*is_visible)(void *data, int type),
491 void (*release)(void *data))
492{
493 return iscsi_boot_create_kobj(boot_kset,
494 &iscsi_boot_acpitbl_attr_group,
495 "acpi_header", index, data, show,
496 is_visible, release);
497}
498EXPORT_SYMBOL_GPL(iscsi_boot_create_acpitbl);
499
500/**
501 * iscsi_boot_create_kset() - creates root sysfs tree
502 * @set_name: name of root dir
503 */
504struct iscsi_boot_kset *iscsi_boot_create_kset(const char *set_name)
505{
506 struct iscsi_boot_kset *boot_kset;
507
508 boot_kset = kzalloc(sizeof(*boot_kset), GFP_KERNEL);
509 if (!boot_kset)
510 return NULL;
511
512 boot_kset->kset = kset_create_and_add(set_name, NULL, firmware_kobj);
513 if (!boot_kset->kset) {
514 kfree(boot_kset);
515 return NULL;
516 }
517
518 INIT_LIST_HEAD(&boot_kset->kobj_list);
519 return boot_kset;
520}
521EXPORT_SYMBOL_GPL(iscsi_boot_create_kset);
522
523/**
524 * iscsi_boot_create_host_kset() - creates root sysfs tree for a scsi host
525 * @hostno: host number of scsi host
526 */
527struct iscsi_boot_kset *iscsi_boot_create_host_kset(unsigned int hostno)
528{
529 struct iscsi_boot_kset *boot_kset;
530 char *set_name;
531
532 set_name = kasprintf(GFP_KERNEL, "iscsi_boot%u", hostno);
533 if (!set_name)
534 return NULL;
535
536 boot_kset = iscsi_boot_create_kset(set_name);
537 kfree(set_name);
538 return boot_kset;
539}
540EXPORT_SYMBOL_GPL(iscsi_boot_create_host_kset);
541
542/**
543 * iscsi_boot_destroy_kset() - destroy kset and kobjects under it
544 * @boot_kset: boot kset
545 *
546 * This will remove the kset and kobjects and attrs under it.
547 */
548void iscsi_boot_destroy_kset(struct iscsi_boot_kset *boot_kset)
549{
550 struct iscsi_boot_kobj *boot_kobj, *tmp_kobj;
551
552 if (!boot_kset)
553 return;
554
555 list_for_each_entry_safe(boot_kobj, tmp_kobj,
556 &boot_kset->kobj_list, list)
557 iscsi_boot_remove_kobj(boot_kobj);
558
559 kset_unregister(boot_kset->kset);
560 kfree(boot_kset);
561}
562EXPORT_SYMBOL_GPL(iscsi_boot_destroy_kset);
1// SPDX-License-Identifier: GPL-2.0-only
2/*
3 * Export the iSCSI boot info to userland via sysfs.
4 *
5 * Copyright (C) 2010 Red Hat, Inc. All rights reserved.
6 * Copyright (C) 2010 Mike Christie
7 */
8
9#include <linux/module.h>
10#include <linux/string.h>
11#include <linux/slab.h>
12#include <linux/sysfs.h>
13#include <linux/capability.h>
14#include <linux/iscsi_boot_sysfs.h>
15
16
17MODULE_AUTHOR("Mike Christie <michaelc@cs.wisc.edu>");
18MODULE_DESCRIPTION("sysfs interface and helpers to export iSCSI boot information");
19MODULE_LICENSE("GPL");
20/*
21 * The kobject and attribute structures.
22 */
23struct iscsi_boot_attr {
24 struct attribute attr;
25 int type;
26 ssize_t (*show) (void *data, int type, char *buf);
27};
28
29/*
30 * The routine called for all sysfs attributes.
31 */
32static ssize_t iscsi_boot_show_attribute(struct kobject *kobj,
33 struct attribute *attr, char *buf)
34{
35 struct iscsi_boot_kobj *boot_kobj =
36 container_of(kobj, struct iscsi_boot_kobj, kobj);
37 struct iscsi_boot_attr *boot_attr =
38 container_of(attr, struct iscsi_boot_attr, attr);
39 ssize_t ret = -EIO;
40 char *str = buf;
41
42 if (!capable(CAP_SYS_ADMIN))
43 return -EACCES;
44
45 if (boot_kobj->show)
46 ret = boot_kobj->show(boot_kobj->data, boot_attr->type, str);
47 return ret;
48}
49
50static const struct sysfs_ops iscsi_boot_attr_ops = {
51 .show = iscsi_boot_show_attribute,
52};
53
54static void iscsi_boot_kobj_release(struct kobject *kobj)
55{
56 struct iscsi_boot_kobj *boot_kobj =
57 container_of(kobj, struct iscsi_boot_kobj, kobj);
58
59 if (boot_kobj->release)
60 boot_kobj->release(boot_kobj->data);
61 kfree(boot_kobj);
62}
63
64static struct kobj_type iscsi_boot_ktype = {
65 .release = iscsi_boot_kobj_release,
66 .sysfs_ops = &iscsi_boot_attr_ops,
67};
68
69#define iscsi_boot_rd_attr(fnname, sysfs_name, attr_type) \
70static struct iscsi_boot_attr iscsi_boot_attr_##fnname = { \
71 .attr = { .name = __stringify(sysfs_name), .mode = 0444 }, \
72 .type = attr_type, \
73}
74
75/* Target attrs */
76iscsi_boot_rd_attr(tgt_index, index, ISCSI_BOOT_TGT_INDEX);
77iscsi_boot_rd_attr(tgt_flags, flags, ISCSI_BOOT_TGT_FLAGS);
78iscsi_boot_rd_attr(tgt_ip, ip-addr, ISCSI_BOOT_TGT_IP_ADDR);
79iscsi_boot_rd_attr(tgt_port, port, ISCSI_BOOT_TGT_PORT);
80iscsi_boot_rd_attr(tgt_lun, lun, ISCSI_BOOT_TGT_LUN);
81iscsi_boot_rd_attr(tgt_chap, chap-type, ISCSI_BOOT_TGT_CHAP_TYPE);
82iscsi_boot_rd_attr(tgt_nic, nic-assoc, ISCSI_BOOT_TGT_NIC_ASSOC);
83iscsi_boot_rd_attr(tgt_name, target-name, ISCSI_BOOT_TGT_NAME);
84iscsi_boot_rd_attr(tgt_chap_name, chap-name, ISCSI_BOOT_TGT_CHAP_NAME);
85iscsi_boot_rd_attr(tgt_chap_secret, chap-secret, ISCSI_BOOT_TGT_CHAP_SECRET);
86iscsi_boot_rd_attr(tgt_chap_rev_name, rev-chap-name,
87 ISCSI_BOOT_TGT_REV_CHAP_NAME);
88iscsi_boot_rd_attr(tgt_chap_rev_secret, rev-chap-name-secret,
89 ISCSI_BOOT_TGT_REV_CHAP_SECRET);
90
91static struct attribute *target_attrs[] = {
92 &iscsi_boot_attr_tgt_index.attr,
93 &iscsi_boot_attr_tgt_flags.attr,
94 &iscsi_boot_attr_tgt_ip.attr,
95 &iscsi_boot_attr_tgt_port.attr,
96 &iscsi_boot_attr_tgt_lun.attr,
97 &iscsi_boot_attr_tgt_chap.attr,
98 &iscsi_boot_attr_tgt_nic.attr,
99 &iscsi_boot_attr_tgt_name.attr,
100 &iscsi_boot_attr_tgt_chap_name.attr,
101 &iscsi_boot_attr_tgt_chap_secret.attr,
102 &iscsi_boot_attr_tgt_chap_rev_name.attr,
103 &iscsi_boot_attr_tgt_chap_rev_secret.attr,
104 NULL
105};
106
107static umode_t iscsi_boot_tgt_attr_is_visible(struct kobject *kobj,
108 struct attribute *attr, int i)
109{
110 struct iscsi_boot_kobj *boot_kobj =
111 container_of(kobj, struct iscsi_boot_kobj, kobj);
112
113 if (attr == &iscsi_boot_attr_tgt_index.attr)
114 return boot_kobj->is_visible(boot_kobj->data,
115 ISCSI_BOOT_TGT_INDEX);
116 else if (attr == &iscsi_boot_attr_tgt_flags.attr)
117 return boot_kobj->is_visible(boot_kobj->data,
118 ISCSI_BOOT_TGT_FLAGS);
119 else if (attr == &iscsi_boot_attr_tgt_ip.attr)
120 return boot_kobj->is_visible(boot_kobj->data,
121 ISCSI_BOOT_TGT_IP_ADDR);
122 else if (attr == &iscsi_boot_attr_tgt_port.attr)
123 return boot_kobj->is_visible(boot_kobj->data,
124 ISCSI_BOOT_TGT_PORT);
125 else if (attr == &iscsi_boot_attr_tgt_lun.attr)
126 return boot_kobj->is_visible(boot_kobj->data,
127 ISCSI_BOOT_TGT_LUN);
128 else if (attr == &iscsi_boot_attr_tgt_chap.attr)
129 return boot_kobj->is_visible(boot_kobj->data,
130 ISCSI_BOOT_TGT_CHAP_TYPE);
131 else if (attr == &iscsi_boot_attr_tgt_nic.attr)
132 return boot_kobj->is_visible(boot_kobj->data,
133 ISCSI_BOOT_TGT_NIC_ASSOC);
134 else if (attr == &iscsi_boot_attr_tgt_name.attr)
135 return boot_kobj->is_visible(boot_kobj->data,
136 ISCSI_BOOT_TGT_NAME);
137 else if (attr == &iscsi_boot_attr_tgt_chap_name.attr)
138 return boot_kobj->is_visible(boot_kobj->data,
139 ISCSI_BOOT_TGT_CHAP_NAME);
140 else if (attr == &iscsi_boot_attr_tgt_chap_secret.attr)
141 return boot_kobj->is_visible(boot_kobj->data,
142 ISCSI_BOOT_TGT_CHAP_SECRET);
143 else if (attr == &iscsi_boot_attr_tgt_chap_rev_name.attr)
144 return boot_kobj->is_visible(boot_kobj->data,
145 ISCSI_BOOT_TGT_REV_CHAP_NAME);
146 else if (attr == &iscsi_boot_attr_tgt_chap_rev_secret.attr)
147 return boot_kobj->is_visible(boot_kobj->data,
148 ISCSI_BOOT_TGT_REV_CHAP_SECRET);
149 return 0;
150}
151
152static struct attribute_group iscsi_boot_target_attr_group = {
153 .attrs = target_attrs,
154 .is_visible = iscsi_boot_tgt_attr_is_visible,
155};
156
157/* Ethernet attrs */
158iscsi_boot_rd_attr(eth_index, index, ISCSI_BOOT_ETH_INDEX);
159iscsi_boot_rd_attr(eth_flags, flags, ISCSI_BOOT_ETH_FLAGS);
160iscsi_boot_rd_attr(eth_ip, ip-addr, ISCSI_BOOT_ETH_IP_ADDR);
161iscsi_boot_rd_attr(eth_prefix, prefix-len, ISCSI_BOOT_ETH_PREFIX_LEN);
162iscsi_boot_rd_attr(eth_subnet, subnet-mask, ISCSI_BOOT_ETH_SUBNET_MASK);
163iscsi_boot_rd_attr(eth_origin, origin, ISCSI_BOOT_ETH_ORIGIN);
164iscsi_boot_rd_attr(eth_gateway, gateway, ISCSI_BOOT_ETH_GATEWAY);
165iscsi_boot_rd_attr(eth_primary_dns, primary-dns, ISCSI_BOOT_ETH_PRIMARY_DNS);
166iscsi_boot_rd_attr(eth_secondary_dns, secondary-dns,
167 ISCSI_BOOT_ETH_SECONDARY_DNS);
168iscsi_boot_rd_attr(eth_dhcp, dhcp, ISCSI_BOOT_ETH_DHCP);
169iscsi_boot_rd_attr(eth_vlan, vlan, ISCSI_BOOT_ETH_VLAN);
170iscsi_boot_rd_attr(eth_mac, mac, ISCSI_BOOT_ETH_MAC);
171iscsi_boot_rd_attr(eth_hostname, hostname, ISCSI_BOOT_ETH_HOSTNAME);
172
173static struct attribute *ethernet_attrs[] = {
174 &iscsi_boot_attr_eth_index.attr,
175 &iscsi_boot_attr_eth_flags.attr,
176 &iscsi_boot_attr_eth_ip.attr,
177 &iscsi_boot_attr_eth_prefix.attr,
178 &iscsi_boot_attr_eth_subnet.attr,
179 &iscsi_boot_attr_eth_origin.attr,
180 &iscsi_boot_attr_eth_gateway.attr,
181 &iscsi_boot_attr_eth_primary_dns.attr,
182 &iscsi_boot_attr_eth_secondary_dns.attr,
183 &iscsi_boot_attr_eth_dhcp.attr,
184 &iscsi_boot_attr_eth_vlan.attr,
185 &iscsi_boot_attr_eth_mac.attr,
186 &iscsi_boot_attr_eth_hostname.attr,
187 NULL
188};
189
190static umode_t iscsi_boot_eth_attr_is_visible(struct kobject *kobj,
191 struct attribute *attr, int i)
192{
193 struct iscsi_boot_kobj *boot_kobj =
194 container_of(kobj, struct iscsi_boot_kobj, kobj);
195
196 if (attr == &iscsi_boot_attr_eth_index.attr)
197 return boot_kobj->is_visible(boot_kobj->data,
198 ISCSI_BOOT_ETH_INDEX);
199 else if (attr == &iscsi_boot_attr_eth_flags.attr)
200 return boot_kobj->is_visible(boot_kobj->data,
201 ISCSI_BOOT_ETH_FLAGS);
202 else if (attr == &iscsi_boot_attr_eth_ip.attr)
203 return boot_kobj->is_visible(boot_kobj->data,
204 ISCSI_BOOT_ETH_IP_ADDR);
205 else if (attr == &iscsi_boot_attr_eth_prefix.attr)
206 return boot_kobj->is_visible(boot_kobj->data,
207 ISCSI_BOOT_ETH_PREFIX_LEN);
208 else if (attr == &iscsi_boot_attr_eth_subnet.attr)
209 return boot_kobj->is_visible(boot_kobj->data,
210 ISCSI_BOOT_ETH_SUBNET_MASK);
211 else if (attr == &iscsi_boot_attr_eth_origin.attr)
212 return boot_kobj->is_visible(boot_kobj->data,
213 ISCSI_BOOT_ETH_ORIGIN);
214 else if (attr == &iscsi_boot_attr_eth_gateway.attr)
215 return boot_kobj->is_visible(boot_kobj->data,
216 ISCSI_BOOT_ETH_GATEWAY);
217 else if (attr == &iscsi_boot_attr_eth_primary_dns.attr)
218 return boot_kobj->is_visible(boot_kobj->data,
219 ISCSI_BOOT_ETH_PRIMARY_DNS);
220 else if (attr == &iscsi_boot_attr_eth_secondary_dns.attr)
221 return boot_kobj->is_visible(boot_kobj->data,
222 ISCSI_BOOT_ETH_SECONDARY_DNS);
223 else if (attr == &iscsi_boot_attr_eth_dhcp.attr)
224 return boot_kobj->is_visible(boot_kobj->data,
225 ISCSI_BOOT_ETH_DHCP);
226 else if (attr == &iscsi_boot_attr_eth_vlan.attr)
227 return boot_kobj->is_visible(boot_kobj->data,
228 ISCSI_BOOT_ETH_VLAN);
229 else if (attr == &iscsi_boot_attr_eth_mac.attr)
230 return boot_kobj->is_visible(boot_kobj->data,
231 ISCSI_BOOT_ETH_MAC);
232 else if (attr == &iscsi_boot_attr_eth_hostname.attr)
233 return boot_kobj->is_visible(boot_kobj->data,
234 ISCSI_BOOT_ETH_HOSTNAME);
235 return 0;
236}
237
238static struct attribute_group iscsi_boot_ethernet_attr_group = {
239 .attrs = ethernet_attrs,
240 .is_visible = iscsi_boot_eth_attr_is_visible,
241};
242
243/* Initiator attrs */
244iscsi_boot_rd_attr(ini_index, index, ISCSI_BOOT_INI_INDEX);
245iscsi_boot_rd_attr(ini_flags, flags, ISCSI_BOOT_INI_FLAGS);
246iscsi_boot_rd_attr(ini_isns, isns-server, ISCSI_BOOT_INI_ISNS_SERVER);
247iscsi_boot_rd_attr(ini_slp, slp-server, ISCSI_BOOT_INI_SLP_SERVER);
248iscsi_boot_rd_attr(ini_primary_radius, pri-radius-server,
249 ISCSI_BOOT_INI_PRI_RADIUS_SERVER);
250iscsi_boot_rd_attr(ini_secondary_radius, sec-radius-server,
251 ISCSI_BOOT_INI_SEC_RADIUS_SERVER);
252iscsi_boot_rd_attr(ini_name, initiator-name, ISCSI_BOOT_INI_INITIATOR_NAME);
253
254static struct attribute *initiator_attrs[] = {
255 &iscsi_boot_attr_ini_index.attr,
256 &iscsi_boot_attr_ini_flags.attr,
257 &iscsi_boot_attr_ini_isns.attr,
258 &iscsi_boot_attr_ini_slp.attr,
259 &iscsi_boot_attr_ini_primary_radius.attr,
260 &iscsi_boot_attr_ini_secondary_radius.attr,
261 &iscsi_boot_attr_ini_name.attr,
262 NULL
263};
264
265static umode_t iscsi_boot_ini_attr_is_visible(struct kobject *kobj,
266 struct attribute *attr, int i)
267{
268 struct iscsi_boot_kobj *boot_kobj =
269 container_of(kobj, struct iscsi_boot_kobj, kobj);
270
271 if (attr == &iscsi_boot_attr_ini_index.attr)
272 return boot_kobj->is_visible(boot_kobj->data,
273 ISCSI_BOOT_INI_INDEX);
274 if (attr == &iscsi_boot_attr_ini_flags.attr)
275 return boot_kobj->is_visible(boot_kobj->data,
276 ISCSI_BOOT_INI_FLAGS);
277 if (attr == &iscsi_boot_attr_ini_isns.attr)
278 return boot_kobj->is_visible(boot_kobj->data,
279 ISCSI_BOOT_INI_ISNS_SERVER);
280 if (attr == &iscsi_boot_attr_ini_slp.attr)
281 return boot_kobj->is_visible(boot_kobj->data,
282 ISCSI_BOOT_INI_SLP_SERVER);
283 if (attr == &iscsi_boot_attr_ini_primary_radius.attr)
284 return boot_kobj->is_visible(boot_kobj->data,
285 ISCSI_BOOT_INI_PRI_RADIUS_SERVER);
286 if (attr == &iscsi_boot_attr_ini_secondary_radius.attr)
287 return boot_kobj->is_visible(boot_kobj->data,
288 ISCSI_BOOT_INI_SEC_RADIUS_SERVER);
289 if (attr == &iscsi_boot_attr_ini_name.attr)
290 return boot_kobj->is_visible(boot_kobj->data,
291 ISCSI_BOOT_INI_INITIATOR_NAME);
292
293 return 0;
294}
295
296static struct attribute_group iscsi_boot_initiator_attr_group = {
297 .attrs = initiator_attrs,
298 .is_visible = iscsi_boot_ini_attr_is_visible,
299};
300
301/* iBFT ACPI Table attributes */
302iscsi_boot_rd_attr(acpitbl_signature, signature, ISCSI_BOOT_ACPITBL_SIGNATURE);
303iscsi_boot_rd_attr(acpitbl_oem_id, oem_id, ISCSI_BOOT_ACPITBL_OEM_ID);
304iscsi_boot_rd_attr(acpitbl_oem_table_id, oem_table_id,
305 ISCSI_BOOT_ACPITBL_OEM_TABLE_ID);
306
307static struct attribute *acpitbl_attrs[] = {
308 &iscsi_boot_attr_acpitbl_signature.attr,
309 &iscsi_boot_attr_acpitbl_oem_id.attr,
310 &iscsi_boot_attr_acpitbl_oem_table_id.attr,
311 NULL
312};
313
314static umode_t iscsi_boot_acpitbl_attr_is_visible(struct kobject *kobj,
315 struct attribute *attr, int i)
316{
317 struct iscsi_boot_kobj *boot_kobj =
318 container_of(kobj, struct iscsi_boot_kobj, kobj);
319
320 if (attr == &iscsi_boot_attr_acpitbl_signature.attr)
321 return boot_kobj->is_visible(boot_kobj->data,
322 ISCSI_BOOT_ACPITBL_SIGNATURE);
323 if (attr == &iscsi_boot_attr_acpitbl_oem_id.attr)
324 return boot_kobj->is_visible(boot_kobj->data,
325 ISCSI_BOOT_ACPITBL_OEM_ID);
326 if (attr == &iscsi_boot_attr_acpitbl_oem_table_id.attr)
327 return boot_kobj->is_visible(boot_kobj->data,
328 ISCSI_BOOT_ACPITBL_OEM_TABLE_ID);
329 return 0;
330}
331
332static struct attribute_group iscsi_boot_acpitbl_attr_group = {
333 .attrs = acpitbl_attrs,
334 .is_visible = iscsi_boot_acpitbl_attr_is_visible,
335};
336
337static struct iscsi_boot_kobj *
338iscsi_boot_create_kobj(struct iscsi_boot_kset *boot_kset,
339 struct attribute_group *attr_group,
340 const char *name, int index, void *data,
341 ssize_t (*show) (void *data, int type, char *buf),
342 umode_t (*is_visible) (void *data, int type),
343 void (*release) (void *data))
344{
345 struct iscsi_boot_kobj *boot_kobj;
346
347 boot_kobj = kzalloc(sizeof(*boot_kobj), GFP_KERNEL);
348 if (!boot_kobj)
349 return NULL;
350 INIT_LIST_HEAD(&boot_kobj->list);
351
352 boot_kobj->kobj.kset = boot_kset->kset;
353 if (kobject_init_and_add(&boot_kobj->kobj, &iscsi_boot_ktype,
354 NULL, name, index)) {
355 kobject_put(&boot_kobj->kobj);
356 return NULL;
357 }
358 boot_kobj->data = data;
359 boot_kobj->show = show;
360 boot_kobj->is_visible = is_visible;
361 boot_kobj->release = release;
362
363 if (sysfs_create_group(&boot_kobj->kobj, attr_group)) {
364 /*
365 * We do not want to free this because the caller
366 * will assume that since the creation call failed
367 * the boot kobj was not setup and the normal release
368 * path is not being run.
369 */
370 boot_kobj->release = NULL;
371 kobject_put(&boot_kobj->kobj);
372 return NULL;
373 }
374 boot_kobj->attr_group = attr_group;
375
376 kobject_uevent(&boot_kobj->kobj, KOBJ_ADD);
377 /* Nothing broke so lets add it to the list. */
378 list_add_tail(&boot_kobj->list, &boot_kset->kobj_list);
379 return boot_kobj;
380}
381
382static void iscsi_boot_remove_kobj(struct iscsi_boot_kobj *boot_kobj)
383{
384 list_del(&boot_kobj->list);
385 sysfs_remove_group(&boot_kobj->kobj, boot_kobj->attr_group);
386 kobject_put(&boot_kobj->kobj);
387}
388
389/**
390 * iscsi_boot_create_target() - create boot target sysfs dir
391 * @boot_kset: boot kset
392 * @index: the target id
393 * @data: driver specific data for target
394 * @show: attr show function
395 * @is_visible: attr visibility function
396 * @release: release function
397 *
398 * Note: The boot sysfs lib will free the data passed in for the caller
399 * when all refs to the target kobject have been released.
400 */
401struct iscsi_boot_kobj *
402iscsi_boot_create_target(struct iscsi_boot_kset *boot_kset, int index,
403 void *data,
404 ssize_t (*show) (void *data, int type, char *buf),
405 umode_t (*is_visible) (void *data, int type),
406 void (*release) (void *data))
407{
408 return iscsi_boot_create_kobj(boot_kset, &iscsi_boot_target_attr_group,
409 "target%d", index, data, show, is_visible,
410 release);
411}
412EXPORT_SYMBOL_GPL(iscsi_boot_create_target);
413
414/**
415 * iscsi_boot_create_initiator() - create boot initiator sysfs dir
416 * @boot_kset: boot kset
417 * @index: the initiator id
418 * @data: driver specific data
419 * @show: attr show function
420 * @is_visible: attr visibility function
421 * @release: release function
422 *
423 * Note: The boot sysfs lib will free the data passed in for the caller
424 * when all refs to the initiator kobject have been released.
425 */
426struct iscsi_boot_kobj *
427iscsi_boot_create_initiator(struct iscsi_boot_kset *boot_kset, int index,
428 void *data,
429 ssize_t (*show) (void *data, int type, char *buf),
430 umode_t (*is_visible) (void *data, int type),
431 void (*release) (void *data))
432{
433 return iscsi_boot_create_kobj(boot_kset,
434 &iscsi_boot_initiator_attr_group,
435 "initiator", index, data, show,
436 is_visible, release);
437}
438EXPORT_SYMBOL_GPL(iscsi_boot_create_initiator);
439
440/**
441 * iscsi_boot_create_ethernet() - create boot ethernet sysfs dir
442 * @boot_kset: boot kset
443 * @index: the ethernet device id
444 * @data: driver specific data
445 * @show: attr show function
446 * @is_visible: attr visibility function
447 * @release: release function
448 *
449 * Note: The boot sysfs lib will free the data passed in for the caller
450 * when all refs to the ethernet kobject have been released.
451 */
452struct iscsi_boot_kobj *
453iscsi_boot_create_ethernet(struct iscsi_boot_kset *boot_kset, int index,
454 void *data,
455 ssize_t (*show) (void *data, int type, char *buf),
456 umode_t (*is_visible) (void *data, int type),
457 void (*release) (void *data))
458{
459 return iscsi_boot_create_kobj(boot_kset,
460 &iscsi_boot_ethernet_attr_group,
461 "ethernet%d", index, data, show,
462 is_visible, release);
463}
464EXPORT_SYMBOL_GPL(iscsi_boot_create_ethernet);
465
466/**
467 * iscsi_boot_create_acpitbl() - create boot acpi table sysfs dir
468 * @boot_kset: boot kset
469 * @index: not used
470 * @data: driver specific data
471 * @show: attr show function
472 * @is_visible: attr visibility function
473 * @release: release function
474 *
475 * Note: The boot sysfs lib will free the data passed in for the caller
476 * when all refs to the acpitbl kobject have been released.
477 */
478struct iscsi_boot_kobj *
479iscsi_boot_create_acpitbl(struct iscsi_boot_kset *boot_kset, int index,
480 void *data,
481 ssize_t (*show)(void *data, int type, char *buf),
482 umode_t (*is_visible)(void *data, int type),
483 void (*release)(void *data))
484{
485 return iscsi_boot_create_kobj(boot_kset,
486 &iscsi_boot_acpitbl_attr_group,
487 "acpi_header", index, data, show,
488 is_visible, release);
489}
490EXPORT_SYMBOL_GPL(iscsi_boot_create_acpitbl);
491
492/**
493 * iscsi_boot_create_kset() - creates root sysfs tree
494 * @set_name: name of root dir
495 */
496struct iscsi_boot_kset *iscsi_boot_create_kset(const char *set_name)
497{
498 struct iscsi_boot_kset *boot_kset;
499
500 boot_kset = kzalloc(sizeof(*boot_kset), GFP_KERNEL);
501 if (!boot_kset)
502 return NULL;
503
504 boot_kset->kset = kset_create_and_add(set_name, NULL, firmware_kobj);
505 if (!boot_kset->kset) {
506 kfree(boot_kset);
507 return NULL;
508 }
509
510 INIT_LIST_HEAD(&boot_kset->kobj_list);
511 return boot_kset;
512}
513EXPORT_SYMBOL_GPL(iscsi_boot_create_kset);
514
515/**
516 * iscsi_boot_create_host_kset() - creates root sysfs tree for a scsi host
517 * @hostno: host number of scsi host
518 */
519struct iscsi_boot_kset *iscsi_boot_create_host_kset(unsigned int hostno)
520{
521 struct iscsi_boot_kset *boot_kset;
522 char *set_name;
523
524 set_name = kasprintf(GFP_KERNEL, "iscsi_boot%u", hostno);
525 if (!set_name)
526 return NULL;
527
528 boot_kset = iscsi_boot_create_kset(set_name);
529 kfree(set_name);
530 return boot_kset;
531}
532EXPORT_SYMBOL_GPL(iscsi_boot_create_host_kset);
533
534/**
535 * iscsi_boot_destroy_kset() - destroy kset and kobjects under it
536 * @boot_kset: boot kset
537 *
538 * This will remove the kset and kobjects and attrs under it.
539 */
540void iscsi_boot_destroy_kset(struct iscsi_boot_kset *boot_kset)
541{
542 struct iscsi_boot_kobj *boot_kobj, *tmp_kobj;
543
544 if (!boot_kset)
545 return;
546
547 list_for_each_entry_safe(boot_kobj, tmp_kobj,
548 &boot_kset->kobj_list, list)
549 iscsi_boot_remove_kobj(boot_kobj);
550
551 kset_unregister(boot_kset->kset);
552 kfree(boot_kset);
553}
554EXPORT_SYMBOL_GPL(iscsi_boot_destroy_kset);