1 /****************************************************************************
2 * fs/inode/fs_inodefind.c
3 *
4 * Copyright (C) 2007-2009, 2017 Gregory Nutt. All rights reserved.
5 * Author: Gregory Nutt <gnutt@nuttx.org>
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 *
11 * 1. Redistributions of source 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 /****************************************************************************
37 * Included Files
38 ****************************************************************************/
39
40 #include <vfs_config.h>
41
42 #include <errno.h>
43 #include <fs/fs.h>
44
45 #include "inode/inode.h"
46
47 /****************************************************************************
48 * Public Functions
49 ****************************************************************************/
50
51 /****************************************************************************
52 * Name: inode_find
53 *
54 * Description:
55 * This is called from the open() logic to get a reference to the inode
56 * associated with a path. This is accomplished by calling inode_search().
57 * inode_find() is a simple wrapper around inode_search(). The primary
58 * difference between inode_find() and inode_search is that inode_find()
59 * will lock the inode tree and increment the reference count on the inode.
60 *
61 ****************************************************************************/
62
inode_find(FAR struct inode_search_s * desc)63 int inode_find(FAR struct inode_search_s *desc)
64 {
65 int ret;
66 FAR const char *path = desc->path;
67 FAR const char **relpath = &(desc->relpath);
68 FAR struct inode **peer = &(desc->peer);
69 FAR struct inode **parent = &(desc->parent);
70 /* Find the node matching the path. If found, increment the count of
71 * references on the node.
72 */
73
74 inode_semtake();
75 desc->node = inode_search(&path, peer, parent, relpath);
76 if (desc->node != NULL)
77 {
78 /* Found it */
79
80 FAR struct inode *node = desc->node;
81
82 /* Increment the reference count on the inode */
83
84 node->i_crefs++;
85 ret = 0;
86 }
87 else
88 {
89 ret = -1;
90 }
91 inode_semgive();
92 return ret;
93 }