fs_findmtddriver.c 4.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135
  1. /****************************************************************************
  2. * fs/driver/fs_findmtddriver.c
  3. *
  4. * Copyright (C) 2018 Gregory Nutt. All rights reserved.
  5. * Author: Gregory Nutt <gnutt@nuttx.org>
  6. *
  7. * Redistribution and use in pathname and binary forms, with or without
  8. * modification, are permitted provided that the following conditions
  9. * are met:
  10. *
  11. * 1. Redistributions of pathname code must retain the above copyright
  12. * notice, this list of conditions and the following disclaimer.
  13. * 2. Redistributions in binary form must reproduce the above copyright
  14. * notice, this list of conditions and the following disclaimer in
  15. * the documentation and/or other materials provided with the
  16. * distribution.
  17. * 3. Neither the name NuttX nor the names of its contributors may be
  18. * used to endorse or promote products derived from this software
  19. * without specific prior written permission.
  20. *
  21. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  22. * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  23. * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  24. * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
  25. * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  26. * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
  27. * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
  28. * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
  29. * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  30. * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
  31. * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  32. * POSSIBILITY OF SUCH DAMAGE.
  33. *
  34. ****************************************************************************/
  35. /****************************************************************************
  36. * Included Files
  37. ****************************************************************************/
  38. #include <nuttx/config.h>
  39. #include <sys/types.h>
  40. #include <sys/mount.h>
  41. #include <stdbool.h>
  42. #include <assert.h>
  43. #include <errno.h>
  44. #include <debug.h>
  45. #include <nuttx/fs/fs.h>
  46. #include "inode/inode.h"
  47. #include "driver/driver.h"
  48. #ifdef CONFIG_MTD
  49. /****************************************************************************
  50. * Public Functions
  51. ****************************************************************************/
  52. /****************************************************************************
  53. * Name: find_mtddriver
  54. *
  55. * Description:
  56. * Return the inode of the named MTD driver specified by 'pathname'
  57. *
  58. * Input Parameters:
  59. * pathname - the full path to the named MTD driver to be located
  60. * ppinode - address of the location to return the inode reference
  61. *
  62. * Returned Value:
  63. * Returns zero on success or a negated errno on failure:
  64. *
  65. * ENOENT - No MTD driver of this name is registered
  66. * ENOTBLK - The inode associated with the pathname is not an MTD driver
  67. *
  68. ****************************************************************************/
  69. int find_mtddriver(FAR const char *pathname, FAR struct inode **ppinode)
  70. {
  71. struct inode_search_s desc;
  72. FAR struct inode *inode;
  73. int ret = 0; /* Assume success */
  74. DEBUGASSERT(pathname != NULL || ppinode != NULL);
  75. /* Find the inode registered with this pathname */
  76. SETUP_SEARCH(&desc, pathname, false);
  77. ret = inode_find(&desc);
  78. if (ret < 0)
  79. {
  80. ferr("ERROR: Failed to find %s\n", pathname);
  81. ret = -ENOENT;
  82. goto errout_with_search;
  83. }
  84. /* Get the search results */
  85. inode = desc.node;
  86. DEBUGASSERT(inode != NULL);
  87. /* Verify that the inode is a block driver. */
  88. if (!INODE_IS_MTD(inode))
  89. {
  90. ferr("ERROR: %s is not a named MTD driver\n", pathname);
  91. ret = -ENOTBLK;
  92. goto errout_with_inode;
  93. }
  94. /* Return the MTD inode reference */
  95. DEBUGASSERT(inode->u.i_mtd != NULL);
  96. *ppinode = inode;
  97. RELEASE_SEARCH(&desc);
  98. return OK;
  99. errout_with_inode:
  100. inode_release(inode);
  101. errout_with_search:
  102. RELEASE_SEARCH(&desc);
  103. return ret;
  104. }
  105. #else
  106. int find_mtddriver(FAR const char *pathname, FAR struct inode **ppinode)
  107. {
  108. return -ENODEV;
  109. }
  110. #endif /* CONFIG_MTD */