2 * Copyright (c) 2004 The DragonFly Project. All rights reserved.
4 * This code is derived from software contributed to The DragonFly Project
5 * by Matthew Dillon <dillon@backplane.com>
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
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
17 * 3. Neither the name of The DragonFly Project nor the names of its
18 * contributors may be used to endorse or promote products derived
19 * from this software without specific, prior written permission.
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 HOLDERS 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;
28 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
29 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
30 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
31 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35 #ifndef _SYS_NLOOKUP_H_
36 #define _SYS_NLOOKUP_H_
38 #ifndef _SYS_NAMECACHE_H_
39 #include <sys/namecache.h>
60 * Encapsulation of nlookup parameters.
62 * Note on nl_flags and nl_op: nl_flags supports a simplified subset of
63 * namei's original CNP flags. nl_op (e.g. NAMEI_*) does no in any way
64 * effect the state of the returned namecache and is only used to enforce
69 * These fields are setup by nlookup_init() with nl_nch set to
70 * the current directory if a process or the root directory if
71 * a pure thread. The result from nlookup() will be returned in
74 struct nchandle nl_nch; /* start-point and result */
75 struct nchandle nl_rootnch; /* root directory */
76 struct nchandle nl_jailnch; /* jail directory */
78 char *nl_path; /* path buffer */
79 struct thread *nl_td; /* thread requesting the nlookup */
80 struct ucred *nl_cred; /* credentials for nlookup */
81 struct vnode *nl_dvp; /* NLC_REFDVP */
83 int nl_flags; /* operations flags */
84 int nl_loopcnt; /* symlinks encountered */
87 * These fields are populated by vn_open(). nlookup_done() will
88 * vn_close() a non-NULL vp so if you extract it be sure to NULL out
91 struct vnode *nl_open_vp;
96 * NOTE: nlookup() flags related to open checks do not actually perform
97 * any modifying operation. e.g. the file isn't created, truncated,
98 * etc. vn_open() handles that.
100 #define NLC_FOLLOW 0x00000001 /* follow leaf symlink */
101 #define NLC_NOCROSSMOUNT 0x00000002 /* do not cross mount points */
102 #define NLC_HASBUF 0x00000004 /* nl_path is allocated */
103 #define NLC_ISWHITEOUT 0x00000008
104 #define NLC_WILLBEDIR 0x00000010
105 #define NLC_NCPISLOCKED 0x00000020
106 #define NLC_LOCKVP 0x00000040 /* nl_open_vp from vn_open */
107 #define NLC_CREATE 0x00000080 /* do create checks */
108 #define NLC_DELETE 0x00000100 /* do delete checks */
109 #define NLC_RENAME_DST 0x00000200 /* do rename checks (target) */
110 #define NLC_OPEN 0x00000400 /* do open checks */
111 #define NLC_TRUNCATE 0x00000800 /* do truncation checks */
112 #define NLC_HLINK 0x00001000 /* do hardlink checks */
113 #define NLC_RENAME_SRC 0x00002000 /* do rename checks (source) */
114 #define NLC_SHAREDLOCK 0x00004000 /* allow shared ncp & vp lock */
115 #define NLC_IGNBADDIR 0x00008000 /* used by umount */
116 #define NLC_NFS_RDONLY 0x00010000 /* set by nfs_namei() only */
117 #define NLC_NFS_NOSOFTLINKTRAV 0x00020000 /* do not traverse softlnks */
118 #define NLC_REFDVP 0x00040000 /* set ref'd/unlocked nl_dvp */
120 #define NLC_APPEND 0x00100000 /* open check: append */
121 #define NLC_NCDIR 0x00200000 /* nd->nl_nch is ncdir */
123 #define NLC_READ 0x00400000 /* require read access */
124 #define NLC_WRITE 0x00800000 /* require write access */
125 #define NLC_EXEC 0x01000000 /* require execute access */
126 #define NLC_EXCL 0x02000000 /* open check: exclusive */
127 #define NLC_OWN 0x04000000 /* open check: owner override */
128 #define NLC_BORROWCRED 0x08000000 /* cred ref borrowed */
129 #define NLC_STICKY 0x10000000 /* indicate sticky case */
130 #define NLC_APPENDONLY 0x20000000 /* indicate append-only */
131 #define NLC_IMMUTABLE 0x40000000 /* indicate immutable set */
132 #define NLC_WRITABLE 0x80000000 /* indicate writeable */
135 * All checks. If any of these bits are set general user/group/world
136 * permission checks will be done by nlookup().
138 #define NLC_ALLCHKS (NLC_CREATE | NLC_DELETE | NLC_RENAME_DST | \
139 NLC_OPEN | NLC_TRUNCATE | NLC_RENAME_SRC | \
140 NLC_READ | NLC_WRITE | NLC_EXEC | NLC_OWN)
143 #include <sys/_uio.h>
145 int naccess_va(struct vattr *va, int nflags, struct ucred *cred);
146 int nlookup(struct nlookupdata *);
147 void nlookup_done(struct nlookupdata *);
148 void nlookup_done_at(struct nlookupdata *, struct file *);
149 int nlookup_init(struct nlookupdata *, const char *, enum uio_seg, int);
150 int nlookup_init_at(struct nlookupdata *, struct file **, int,
151 const char *, enum uio_seg, int);
152 int nlookup_init_raw(struct nlookupdata *, const char *, enum uio_seg,
153 int, struct ucred *, struct nchandle *);
154 int nlookup_init_root(struct nlookupdata *, const char *, enum uio_seg,
155 int, struct ucred *, struct nchandle *, struct nchandle *);
156 int nlookup_mp(struct mount *mp, struct nchandle *nch);
157 struct nchandle nlookup_simple(const char *str, enum uio_seg seg,
158 int niflags, int *error);
159 void nlookup_zero(struct nlookupdata *);
160 int nreadsymlink(struct nlookupdata *nd, struct nchandle *nch,
161 struct nlcomponent *nlc);
164 #endif /* !_SYS_NAMEI_H_ */