![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to namei.h CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Net/2] / Net2 / sys|
Return to namei.h CVS log | Up to [Net/2] / Net2 / sys |
1.1 root 1: /*
2: * Copyright (c) 1985, 1989, 1991 Regents of the University of California.
3: * All rights reserved.
4: *
5: * Redistribution and use in source and binary forms, with or without
6: * modification, are permitted provided that the following conditions
7: * are met:
8: * 1. Redistributions of source code must retain the above copyright
9: * notice, this list of conditions and the following disclaimer.
10: * 2. Redistributions in binary form must reproduce the above copyright
11: * notice, this list of conditions and the following disclaimer in the
12: * documentation and/or other materials provided with the distribution.
13: * 3. All advertising materials mentioning features or use of this software
14: * must display the following acknowledgement:
15: * This product includes software developed by the University of
16: * California, Berkeley and its contributors.
17: * 4. Neither the name of the University nor the names of its contributors
18: * may be used to endorse or promote products derived from this software
19: * without specific prior written permission.
20: *
21: * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22: * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24: * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25: * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26: * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27: * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29: * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31: * SUCH DAMAGE.
32: *
33: * @(#)namei.h 7.15 (Berkeley) 5/15/91
34: */
35:
36: #ifndef _NAMEI_H_
37: #define _NAMEI_H_
38:
39: /*
40: * Encapsulation of namei parameters.
41: */
42: struct nameidata {
43: /*
44: * Arguments to namei.
45: */
46: caddr_t ni_dirp; /* pathname pointer */
47: enum uio_seg ni_segflg; /* location of pathname */
48: u_long ni_nameiop; /* see below */
49: /*
50: * Arguments to lookup.
51: */
52: struct ucred *ni_cred; /* credentials */
53: struct vnode *ni_startdir; /* starting directory */
54: struct vnode *ni_rootdir; /* logical root directory */
55: /*
56: * Results
57: */
58: struct vnode *ni_vp; /* vnode of result */
59: struct vnode *ni_dvp; /* vnode of intermediate directory */
60: /*
61: * Shared between namei, lookup routines, and commit routines.
62: */
63: char *ni_pnbuf; /* pathname buffer */
64: long ni_pathlen; /* remaining chars in path */
65: char *ni_ptr; /* current location in pathname */
66: long ni_namelen; /* length of current component */
67: char *ni_next; /* next location in pathname */
68: u_long ni_hash; /* hash value of current component */
69: u_char ni_loopcnt; /* count of symlinks encountered */
70: u_char ni_makeentry; /* 1 => add entry to name cache */
71: u_char ni_isdotdot; /* 1 => current component name is .. */
72: u_char ni_more; /* 1 => symlink needs interpretation */
73: /*
74: * Side effects.
75: */
76: struct ufs_specific { /* saved info for new dir entry */
77: off_t ufs_endoff; /* end of useful directory contents */
78: long ufs_offset; /* offset of free space in directory */
79: long ufs_count; /* size of free slot in directory */
80: ino_t ufs_ino; /* inode number of found directory */
81: u_long ufs_reclen; /* size of found directory entry */
82: } ni_ufs;
83: };
84:
85: #ifdef KERNEL
86: /*
87: * namei operations
88: */
89: #define LOOKUP 0 /* perform name lookup only */
90: #define CREATE 1 /* setup for file creation */
91: #define DELETE 2 /* setup for file deletion */
92: #define RENAME 3 /* setup for file renaming */
93: #define OPMASK 3 /* mask for operation */
94: /*
95: * namei operational modifiers
96: */
97: #define LOCKLEAF 0x0004 /* lock inode on return */
98: #define LOCKPARENT 0x0008 /* want parent vnode returned locked */
99: #define WANTPARENT 0x0010 /* want parent vnode returned unlocked */
100: #define NOCACHE 0x0020 /* name must not be left in cache */
101: #define FOLLOW 0x0040 /* follow symbolic links */
102: #define NOFOLLOW 0x0000 /* do not follow symbolic links (pseudo) */
103: #define MODMASK 0x00fc /* mask of operational modifiers */
104: /*
105: * Namei parameter descriptors.
106: *
107: * SAVENAME may be set by either the callers of namei or by VOP_LOOKUP.
108: * If the caller of namei sets the flag (for example execve wants to
109: * know the name of the program that is being executed), then it must
110: * free the buffer. If VOP_LOOKUP sets the flag, then the buffer must
111: * be freed by either the commit routine or the VOP_ABORT routine.
112: * SAVESTART is set only by the callers of namei. It implies SAVENAME
113: * plus the addition of saving the parent directory that contains the
114: * name in ni_startdir. It allows repeated calls to lookup for the
115: * name being sought. The caller is responsible for releasing the
116: * buffer and for vrele'ing ni_startdir.
117: */
118: #define NOCROSSMOUNT 0x0100 /* do not cross mount points */
119: #define REMOTE 0x0200 /* lookup for remote filesystem servers */
120: #define HASBUF 0x0400 /* has allocated pathname buffer */
121: #define SAVENAME 0x0800 /* save pathanme buffer */
122: #define SAVESTART 0x1000 /* save starting directory */
123: #define PARAMASK 0xff00 /* mask of parameter descriptors */
124: #endif
125:
126: /*
127: * This structure describes the elements in the cache of recent
128: * names looked up by namei. NCHNAMLEN is sized to make structure
129: * size a power of two to optimize malloc's. Minimum reasonable
130: * size is 15.
131: */
132:
133: #define NCHNAMLEN 31 /* maximum name segment length we bother with */
134:
135: struct namecache {
136: struct namecache *nc_forw; /* hash chain, MUST BE FIRST */
137: struct namecache *nc_back; /* hash chain, MUST BE FIRST */
138: struct namecache *nc_nxt; /* LRU chain */
139: struct namecache **nc_prev; /* LRU chain */
140: struct vnode *nc_dvp; /* vnode of parent of name */
141: u_long nc_dvpid; /* capability number of nc_dvp */
142: struct vnode *nc_vp; /* vnode the name refers to */
143: u_long nc_vpid; /* capability number of nc_vp */
144: char nc_nlen; /* length of name */
145: char nc_name[NCHNAMLEN]; /* segment name */
146: };
147:
148: #ifdef KERNEL
149: u_long nextvnodeid;
150: int namei __P((struct nameidata *ndp, struct proc *p));
151: int lookup __P((struct nameidata *ndp, struct proc *p));
152: #endif
153:
154: /*
155: * Stats on usefulness of namei caches.
156: */
157: struct nchstats {
158: long ncs_goodhits; /* hits that we can really use */
159: long ncs_neghits; /* negative hits that we can use */
160: long ncs_badhits; /* hits we must drop */
161: long ncs_falsehits; /* hits with id mismatch */
162: long ncs_miss; /* misses */
163: long ncs_long; /* long names that ignore cache */
164: long ncs_pass2; /* names found with passes == 2 */
165: long ncs_2passes; /* number of times we attempt it */
166: };
167: #endif /* !_NAMEI_H_ */
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.