sysfs.c 9.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419
  1. // SPDX-License-Identifier: GPL-2.0
  2. #include <linux/highmem.h>
  3. #include <linux/module.h>
  4. #include <linux/security.h>
  5. #include <linux/slab.h>
  6. #include <linux/types.h>
  7. #include "sysfs.h"
  8. /*
  9. * sysfs support for firmware loader
  10. */
  11. void __fw_load_abort(struct fw_priv *fw_priv)
  12. {
  13. /*
  14. * There is a small window in which user can write to 'loading'
  15. * between loading done/aborted and disappearance of 'loading'
  16. */
  17. if (fw_state_is_aborted(fw_priv) || fw_state_is_done(fw_priv))
  18. return;
  19. fw_state_aborted(fw_priv);
  20. }
  21. #ifdef CONFIG_FW_LOADER_USER_HELPER
  22. static ssize_t timeout_show(struct class *class, struct class_attribute *attr,
  23. char *buf)
  24. {
  25. return sysfs_emit(buf, "%d\n", __firmware_loading_timeout());
  26. }
  27. /**
  28. * timeout_store() - set number of seconds to wait for firmware
  29. * @class: device class pointer
  30. * @attr: device attribute pointer
  31. * @buf: buffer to scan for timeout value
  32. * @count: number of bytes in @buf
  33. *
  34. * Sets the number of seconds to wait for the firmware. Once
  35. * this expires an error will be returned to the driver and no
  36. * firmware will be provided.
  37. *
  38. * Note: zero means 'wait forever'.
  39. **/
  40. static ssize_t timeout_store(struct class *class, struct class_attribute *attr,
  41. const char *buf, size_t count)
  42. {
  43. int tmp_loading_timeout = simple_strtol(buf, NULL, 10);
  44. if (tmp_loading_timeout < 0)
  45. tmp_loading_timeout = 0;
  46. __fw_fallback_set_timeout(tmp_loading_timeout);
  47. return count;
  48. }
  49. static CLASS_ATTR_RW(timeout);
  50. static struct attribute *firmware_class_attrs[] = {
  51. &class_attr_timeout.attr,
  52. NULL,
  53. };
  54. ATTRIBUTE_GROUPS(firmware_class);
  55. static int do_firmware_uevent(struct fw_sysfs *fw_sysfs, struct kobj_uevent_env *env)
  56. {
  57. if (add_uevent_var(env, "FIRMWARE=%s", fw_sysfs->fw_priv->fw_name))
  58. return -ENOMEM;
  59. if (add_uevent_var(env, "TIMEOUT=%i", __firmware_loading_timeout()))
  60. return -ENOMEM;
  61. if (add_uevent_var(env, "ASYNC=%d", fw_sysfs->nowait))
  62. return -ENOMEM;
  63. return 0;
  64. }
  65. static int firmware_uevent(struct device *dev, struct kobj_uevent_env *env)
  66. {
  67. struct fw_sysfs *fw_sysfs = to_fw_sysfs(dev);
  68. int err = 0;
  69. mutex_lock(&fw_lock);
  70. if (fw_sysfs->fw_priv)
  71. err = do_firmware_uevent(fw_sysfs, env);
  72. mutex_unlock(&fw_lock);
  73. return err;
  74. }
  75. #endif /* CONFIG_FW_LOADER_USER_HELPER */
  76. static void fw_dev_release(struct device *dev)
  77. {
  78. struct fw_sysfs *fw_sysfs = to_fw_sysfs(dev);
  79. if (fw_sysfs->fw_upload_priv)
  80. fw_upload_free(fw_sysfs);
  81. kfree(fw_sysfs);
  82. }
  83. static struct class firmware_class = {
  84. .name = "firmware",
  85. #ifdef CONFIG_FW_LOADER_USER_HELPER
  86. .class_groups = firmware_class_groups,
  87. .dev_uevent = firmware_uevent,
  88. #endif
  89. .dev_release = fw_dev_release,
  90. };
  91. int register_sysfs_loader(void)
  92. {
  93. int ret = class_register(&firmware_class);
  94. if (ret != 0)
  95. return ret;
  96. return register_firmware_config_sysctl();
  97. }
  98. void unregister_sysfs_loader(void)
  99. {
  100. unregister_firmware_config_sysctl();
  101. class_unregister(&firmware_class);
  102. }
  103. static ssize_t firmware_loading_show(struct device *dev,
  104. struct device_attribute *attr, char *buf)
  105. {
  106. struct fw_sysfs *fw_sysfs = to_fw_sysfs(dev);
  107. int loading = 0;
  108. mutex_lock(&fw_lock);
  109. if (fw_sysfs->fw_priv)
  110. loading = fw_state_is_loading(fw_sysfs->fw_priv);
  111. mutex_unlock(&fw_lock);
  112. return sysfs_emit(buf, "%d\n", loading);
  113. }
  114. /**
  115. * firmware_loading_store() - set value in the 'loading' control file
  116. * @dev: device pointer
  117. * @attr: device attribute pointer
  118. * @buf: buffer to scan for loading control value
  119. * @count: number of bytes in @buf
  120. *
  121. * The relevant values are:
  122. *
  123. * 1: Start a load, discarding any previous partial load.
  124. * 0: Conclude the load and hand the data to the driver code.
  125. * -1: Conclude the load with an error and discard any written data.
  126. **/
  127. static ssize_t firmware_loading_store(struct device *dev,
  128. struct device_attribute *attr,
  129. const char *buf, size_t count)
  130. {
  131. struct fw_sysfs *fw_sysfs = to_fw_sysfs(dev);
  132. struct fw_priv *fw_priv;
  133. ssize_t written = count;
  134. int loading = simple_strtol(buf, NULL, 10);
  135. mutex_lock(&fw_lock);
  136. fw_priv = fw_sysfs->fw_priv;
  137. if (fw_state_is_aborted(fw_priv) || fw_state_is_done(fw_priv))
  138. goto out;
  139. switch (loading) {
  140. case 1:
  141. /* discarding any previous partial load */
  142. fw_free_paged_buf(fw_priv);
  143. fw_state_start(fw_priv);
  144. break;
  145. case 0:
  146. if (fw_state_is_loading(fw_priv)) {
  147. int rc;
  148. /*
  149. * Several loading requests may be pending on
  150. * one same firmware buf, so let all requests
  151. * see the mapped 'buf->data' once the loading
  152. * is completed.
  153. */
  154. rc = fw_map_paged_buf(fw_priv);
  155. if (rc)
  156. dev_err(dev, "%s: map pages failed\n",
  157. __func__);
  158. else
  159. rc = security_kernel_post_load_data(fw_priv->data,
  160. fw_priv->size,
  161. LOADING_FIRMWARE,
  162. "blob");
  163. /*
  164. * Same logic as fw_load_abort, only the DONE bit
  165. * is ignored and we set ABORT only on failure.
  166. */
  167. if (rc) {
  168. fw_state_aborted(fw_priv);
  169. written = rc;
  170. } else {
  171. fw_state_done(fw_priv);
  172. /*
  173. * If this is a user-initiated firmware upload
  174. * then start the upload in a worker thread now.
  175. */
  176. rc = fw_upload_start(fw_sysfs);
  177. if (rc)
  178. written = rc;
  179. }
  180. break;
  181. }
  182. fallthrough;
  183. default:
  184. dev_err(dev, "%s: unexpected value (%d)\n", __func__, loading);
  185. fallthrough;
  186. case -1:
  187. fw_load_abort(fw_sysfs);
  188. if (fw_sysfs->fw_upload_priv)
  189. fw_state_init(fw_sysfs->fw_priv);
  190. break;
  191. }
  192. out:
  193. mutex_unlock(&fw_lock);
  194. return written;
  195. }
  196. DEVICE_ATTR(loading, 0644, firmware_loading_show, firmware_loading_store);
  197. static void firmware_rw_data(struct fw_priv *fw_priv, char *buffer,
  198. loff_t offset, size_t count, bool read)
  199. {
  200. if (read)
  201. memcpy(buffer, fw_priv->data + offset, count);
  202. else
  203. memcpy(fw_priv->data + offset, buffer, count);
  204. }
  205. static void firmware_rw(struct fw_priv *fw_priv, char *buffer,
  206. loff_t offset, size_t count, bool read)
  207. {
  208. while (count) {
  209. int page_nr = offset >> PAGE_SHIFT;
  210. int page_ofs = offset & (PAGE_SIZE - 1);
  211. int page_cnt = min_t(size_t, PAGE_SIZE - page_ofs, count);
  212. if (read)
  213. memcpy_from_page(buffer, fw_priv->pages[page_nr],
  214. page_ofs, page_cnt);
  215. else
  216. memcpy_to_page(fw_priv->pages[page_nr], page_ofs,
  217. buffer, page_cnt);
  218. buffer += page_cnt;
  219. offset += page_cnt;
  220. count -= page_cnt;
  221. }
  222. }
  223. static ssize_t firmware_data_read(struct file *filp, struct kobject *kobj,
  224. struct bin_attribute *bin_attr,
  225. char *buffer, loff_t offset, size_t count)
  226. {
  227. struct device *dev = kobj_to_dev(kobj);
  228. struct fw_sysfs *fw_sysfs = to_fw_sysfs(dev);
  229. struct fw_priv *fw_priv;
  230. ssize_t ret_count;
  231. mutex_lock(&fw_lock);
  232. fw_priv = fw_sysfs->fw_priv;
  233. if (!fw_priv || fw_state_is_done(fw_priv)) {
  234. ret_count = -ENODEV;
  235. goto out;
  236. }
  237. if (offset > fw_priv->size) {
  238. ret_count = 0;
  239. goto out;
  240. }
  241. if (count > fw_priv->size - offset)
  242. count = fw_priv->size - offset;
  243. ret_count = count;
  244. if (fw_priv->data)
  245. firmware_rw_data(fw_priv, buffer, offset, count, true);
  246. else
  247. firmware_rw(fw_priv, buffer, offset, count, true);
  248. out:
  249. mutex_unlock(&fw_lock);
  250. return ret_count;
  251. }
  252. static int fw_realloc_pages(struct fw_sysfs *fw_sysfs, int min_size)
  253. {
  254. int err;
  255. err = fw_grow_paged_buf(fw_sysfs->fw_priv,
  256. PAGE_ALIGN(min_size) >> PAGE_SHIFT);
  257. if (err)
  258. fw_load_abort(fw_sysfs);
  259. return err;
  260. }
  261. /**
  262. * firmware_data_write() - write method for firmware
  263. * @filp: open sysfs file
  264. * @kobj: kobject for the device
  265. * @bin_attr: bin_attr structure
  266. * @buffer: buffer being written
  267. * @offset: buffer offset for write in total data store area
  268. * @count: buffer size
  269. *
  270. * Data written to the 'data' attribute will be later handed to
  271. * the driver as a firmware image.
  272. **/
  273. static ssize_t firmware_data_write(struct file *filp, struct kobject *kobj,
  274. struct bin_attribute *bin_attr,
  275. char *buffer, loff_t offset, size_t count)
  276. {
  277. struct device *dev = kobj_to_dev(kobj);
  278. struct fw_sysfs *fw_sysfs = to_fw_sysfs(dev);
  279. struct fw_priv *fw_priv;
  280. ssize_t retval;
  281. if (!capable(CAP_SYS_RAWIO))
  282. return -EPERM;
  283. mutex_lock(&fw_lock);
  284. fw_priv = fw_sysfs->fw_priv;
  285. if (!fw_priv || fw_state_is_done(fw_priv)) {
  286. retval = -ENODEV;
  287. goto out;
  288. }
  289. if (fw_priv->data) {
  290. if (offset + count > fw_priv->allocated_size) {
  291. retval = -ENOMEM;
  292. goto out;
  293. }
  294. firmware_rw_data(fw_priv, buffer, offset, count, false);
  295. retval = count;
  296. } else {
  297. retval = fw_realloc_pages(fw_sysfs, offset + count);
  298. if (retval)
  299. goto out;
  300. retval = count;
  301. firmware_rw(fw_priv, buffer, offset, count, false);
  302. }
  303. fw_priv->size = max_t(size_t, offset + count, fw_priv->size);
  304. out:
  305. mutex_unlock(&fw_lock);
  306. return retval;
  307. }
  308. static struct bin_attribute firmware_attr_data = {
  309. .attr = { .name = "data", .mode = 0644 },
  310. .size = 0,
  311. .read = firmware_data_read,
  312. .write = firmware_data_write,
  313. };
  314. static struct attribute *fw_dev_attrs[] = {
  315. &dev_attr_loading.attr,
  316. #ifdef CONFIG_FW_UPLOAD
  317. &dev_attr_cancel.attr,
  318. &dev_attr_status.attr,
  319. &dev_attr_error.attr,
  320. &dev_attr_remaining_size.attr,
  321. #endif
  322. NULL
  323. };
  324. static struct bin_attribute *fw_dev_bin_attrs[] = {
  325. &firmware_attr_data,
  326. NULL
  327. };
  328. static const struct attribute_group fw_dev_attr_group = {
  329. .attrs = fw_dev_attrs,
  330. .bin_attrs = fw_dev_bin_attrs,
  331. #ifdef CONFIG_FW_UPLOAD
  332. .is_visible = fw_upload_is_visible,
  333. #endif
  334. };
  335. static const struct attribute_group *fw_dev_attr_groups[] = {
  336. &fw_dev_attr_group,
  337. NULL
  338. };
  339. struct fw_sysfs *
  340. fw_create_instance(struct firmware *firmware, const char *fw_name,
  341. struct device *device, u32 opt_flags)
  342. {
  343. struct fw_sysfs *fw_sysfs;
  344. struct device *f_dev;
  345. fw_sysfs = kzalloc(sizeof(*fw_sysfs), GFP_KERNEL);
  346. if (!fw_sysfs) {
  347. fw_sysfs = ERR_PTR(-ENOMEM);
  348. goto exit;
  349. }
  350. fw_sysfs->nowait = !!(opt_flags & FW_OPT_NOWAIT);
  351. fw_sysfs->fw = firmware;
  352. f_dev = &fw_sysfs->dev;
  353. device_initialize(f_dev);
  354. dev_set_name(f_dev, "%s", fw_name);
  355. f_dev->parent = device;
  356. f_dev->class = &firmware_class;
  357. f_dev->groups = fw_dev_attr_groups;
  358. exit:
  359. return fw_sysfs;
  360. }