Converts page_map for bdev usage
[akaros.git] / kern / src / vfs.c
1 /* Copyright (c) 2009, 2010 The Regents of the University of California
2  * Barret Rhoden <brho@cs.berkeley.edu>
3  * See LICENSE for details.
4  *
5  * Default implementations and global values for the VFS. */
6
7 #include <vfs.h> // keep this first
8 #include <sys/queue.h>
9 #include <assert.h>
10 #include <stdio.h>
11 #include <atomic.h>
12 #include <slab.h>
13 #include <kmalloc.h>
14 #include <kfs.h>
15 #include <ext2fs.h>
16 #include <pmap.h>
17 #include <umem.h>
18 #include <smp.h>
19
20 struct sb_tailq super_blocks = TAILQ_HEAD_INITIALIZER(super_blocks);
21 spinlock_t super_blocks_lock = SPINLOCK_INITIALIZER;
22 struct fs_type_tailq file_systems = TAILQ_HEAD_INITIALIZER(file_systems);
23 struct namespace default_ns;
24
25 struct kmem_cache *dentry_kcache; // not to be confused with the dcache
26 struct kmem_cache *inode_kcache;
27 struct kmem_cache *file_kcache;
28
29 /* Mounts fs from dev_name at mnt_pt in namespace ns.  There could be no mnt_pt,
30  * such as with the root of (the default) namespace.  Not sure how it would work
31  * with multiple namespaces on the same FS yet.  Note if you mount the same FS
32  * multiple times, you only have one FS still (and one SB).  If we ever support
33  * that... */
34 struct vfsmount *__mount_fs(struct fs_type *fs, char *dev_name,
35                             struct dentry *mnt_pt, int flags,
36                             struct namespace *ns)
37 {
38         struct super_block *sb;
39         struct vfsmount *vmnt = kmalloc(sizeof(struct vfsmount), 0);
40
41         /* this first ref is stored in the NS tailq below */
42         kref_init(&vmnt->mnt_kref, fake_release, 1);
43         /* Build the vfsmount, if there is no mnt_pt, mnt is the root vfsmount (for now).
44          * fields related to the actual FS, like the sb and the mnt_root are set in
45          * the fs-specific get_sb() call. */
46         if (!mnt_pt) {
47                 vmnt->mnt_parent = NULL;
48                 vmnt->mnt_mountpoint = NULL;
49         } else { /* common case, but won't be tested til we try to mount another FS */
50                 mnt_pt->d_mount_point = TRUE;
51                 mnt_pt->d_mounted_fs = vmnt;
52                 kref_get(&vmnt->mnt_kref, 1); /* held by mnt_pt */
53                 vmnt->mnt_parent = mnt_pt->d_sb->s_mount;
54                 vmnt->mnt_mountpoint = mnt_pt;
55         }
56         TAILQ_INIT(&vmnt->mnt_child_mounts);
57         vmnt->mnt_flags = flags;
58         vmnt->mnt_devname = dev_name;
59         vmnt->mnt_namespace = ns;
60         kref_get(&ns->kref, 1); /* held by vmnt */
61
62         /* Read in / create the SB */
63         sb = fs->get_sb(fs, flags, dev_name, vmnt);
64         if (!sb)
65                 panic("You're FS sucks");
66
67         /* TODO: consider moving this into get_sb or something, in case the SB
68          * already exists (mounting again) (if we support that) */
69         spin_lock(&super_blocks_lock);
70         TAILQ_INSERT_TAIL(&super_blocks, sb, s_list); /* storing a ref here... */
71         spin_unlock(&super_blocks_lock);
72
73         /* Update holding NS */
74         spin_lock(&ns->lock);
75         TAILQ_INSERT_TAIL(&ns->vfsmounts, vmnt, mnt_list);
76         spin_unlock(&ns->lock);
77         /* note to self: so, right after this point, the NS points to the root FS
78          * mount (we return the mnt, which gets assigned), the root mnt has a dentry
79          * for /, backed by an inode, with a SB prepped and in memory. */
80         return vmnt;
81 }
82
83 void vfs_init(void)
84 {
85         struct fs_type *fs;
86
87         dentry_kcache = kmem_cache_create("dentry", sizeof(struct dentry),
88                                           __alignof__(struct dentry), 0, 0, 0);
89         inode_kcache = kmem_cache_create("inode", sizeof(struct inode),
90                                          __alignof__(struct inode), 0, 0, 0);
91         file_kcache = kmem_cache_create("file", sizeof(struct file),
92                                         __alignof__(struct file), 0, 0, 0);
93         /* default NS never dies, +1 to exist */
94         kref_init(&default_ns.kref, fake_release, 1);
95         spinlock_init(&default_ns.lock);
96         default_ns.root = NULL;
97         TAILQ_INIT(&default_ns.vfsmounts);
98
99         /* build list of all FS's in the system.  put yours here.  if this is ever
100          * done on the fly, we'll need to lock. */
101         TAILQ_INSERT_TAIL(&file_systems, &kfs_fs_type, list);
102         TAILQ_INSERT_TAIL(&file_systems, &ext2_fs_type, list);
103         TAILQ_FOREACH(fs, &file_systems, list)
104                 printk("Supports the %s Filesystem\n", fs->name);
105
106         /* mounting KFS at the root (/), pending root= parameters */
107         // TODO: linux creates a temp root_fs, then mounts the real root onto that
108         default_ns.root = __mount_fs(&kfs_fs_type, "RAM", NULL, 0, &default_ns);
109
110         printk("vfs_init() completed\n");
111 }
112
113 /* Builds / populates the qstr of a dentry based on its d_iname.  If there is an
114  * l_name, (long), it will use that instead of the inline name.  This will
115  * probably change a bit. */
116 void qstr_builder(struct dentry *dentry, char *l_name)
117 {
118         dentry->d_name.name = l_name ? l_name : dentry->d_iname;
119         // TODO: pending what we actually do in d_hash
120         //dentry->d_name.hash = dentry->d_op->d_hash(dentry, &dentry->d_name); 
121         dentry->d_name.hash = 0xcafebabe;
122         dentry->d_name.len = strnlen(dentry->d_name.name, MAX_FILENAME_SZ);
123 }
124
125 /* Useful little helper - return the string ptr for a given file */
126 char *file_name(struct file *file)
127 {
128         return file->f_dentry->d_name.name;
129 }
130
131 /* Some issues with this, coupled closely to fs_lookup.
132  *
133  * Note the use of __dentry_free, instead of kref_put.  In those cases, we don't
134  * want to treat it like a kref and we have the only reference to it, so it is
135  * okay to do this.  It makes dentry_release() easier too. */
136 static struct dentry *do_lookup(struct dentry *parent, char *name)
137 {
138         struct dentry *result, *query;
139         query = get_dentry(parent->d_sb, parent, name);
140         result = dcache_get(parent->d_sb, query); 
141         if (result) {
142                 __dentry_free(query);
143                 return result;
144         }
145         /* No result, check for negative */
146         if (query->d_flags & DENTRY_NEGATIVE) {
147                 __dentry_free(query);
148                 return 0;
149         }
150         /* not in the dcache at all, need to consult the FS */
151         result = parent->d_inode->i_op->lookup(parent->d_inode, query, 0);
152         if (!result) {
153                 query->d_flags |= DENTRY_NEGATIVE;
154                 dcache_put(parent->d_sb, query);
155                 kref_put(&query->d_kref);
156                 return 0;
157         }
158         dcache_put(parent->d_sb, result);
159         /* This is because KFS doesn't return the same dentry, but ext2 does.  this
160          * is ugly and needs to be fixed. (TODO) */
161         if (result != query)
162                 __dentry_free(query);
163
164         /* TODO: if the following are done by us, how do we know the i_ino?
165          * also need to handle inodes that are already read in!  For now, we're
166          * going to have the FS handle it in it's lookup() method: 
167          * - get a new inode
168          * - read in the inode
169          * - put in the inode cache */
170         return result;
171 }
172
173 /* Update ND such that it represents having followed dentry.  IAW the nd
174  * refcnting rules, we need to decref any references that were in there before
175  * they get clobbered. */
176 static int next_link(struct dentry *dentry, struct nameidata *nd)
177 {
178         assert(nd->dentry && nd->mnt);
179         /* update the dentry */
180         kref_get(&dentry->d_kref, 1);
181         kref_put(&nd->dentry->d_kref);
182         nd->dentry = dentry;
183         /* update the mount, if we need to */
184         if (dentry->d_sb->s_mount != nd->mnt) {
185                 kref_get(&dentry->d_sb->s_mount->mnt_kref, 1);
186                 kref_put(&nd->mnt->mnt_kref);
187                 nd->mnt = dentry->d_sb->s_mount;
188         }
189         return 0;
190 }
191
192 /* Walk up one directory, being careful of mountpoints, namespaces, and the top
193  * of the FS */
194 static int climb_up(struct nameidata *nd)
195 {
196         printd("CLIMB_UP, from %s\n", nd->dentry->d_name.name);
197         /* Top of the world, just return.  Should also check for being at the top of
198          * the current process's namespace (TODO) */
199         if (!nd->dentry->d_parent || (nd->dentry->d_parent == nd->dentry))
200                 return -1;
201         /* Check if we are at the top of a mount, if so, we need to follow
202          * backwards, and then climb_up from that one.  We might need to climb
203          * multiple times if we mount multiple FSs at the same spot (highly
204          * unlikely).  This is completely untested.  Might recurse instead. */
205         while (nd->mnt->mnt_root == nd->dentry) {
206                 if (!nd->mnt->mnt_parent) {
207                         warn("Might have expected a parent vfsmount (dentry had a parent)");
208                         return -1;
209                 }
210                 next_link(nd->mnt->mnt_mountpoint, nd);
211         }
212         /* Backwards walk (no mounts or any other issues now). */
213         next_link(nd->dentry->d_parent, nd);
214         printd("CLIMB_UP, to   %s\n", nd->dentry->d_name.name);
215         return 0;
216 }
217
218 /* nd->dentry might be on a mount point, so we need to move on to the child
219  * mount's root. */
220 static int follow_mount(struct nameidata *nd)
221 {
222         if (!nd->dentry->d_mount_point)
223                 return 0;
224         next_link(nd->dentry->d_mounted_fs->mnt_root, nd);
225         return 0;
226 }
227
228 static int link_path_walk(char *path, struct nameidata *nd);
229
230 /* When nd->dentry is for a symlink, this will recurse and follow that symlink,
231  * so that nd contains the results of following the symlink (dentry and mnt).
232  * Returns when it isn't a symlink, 1 on following a link, and < 0 on error. */
233 static int follow_symlink(struct nameidata *nd)
234 {
235         int retval;
236         char *symname;
237         if (!S_ISLNK(nd->dentry->d_inode->i_mode))
238                 return 0;
239         if (nd->depth > MAX_SYMLINK_DEPTH)
240                 return -ELOOP;
241         printd("Following symlink for dentry %08p %s\n", nd->dentry,
242                nd->dentry->d_name.name);
243         nd->depth++;
244         symname = nd->dentry->d_inode->i_op->readlink(nd->dentry);
245         /* We need to pin in nd->dentry (the dentry of the symlink), since we need
246          * it's symname's storage to stay in memory throughout the upcoming
247          * link_path_walk().  The last_sym gets decreffed when we path_release() or
248          * follow another symlink. */
249         if (nd->last_sym)
250                 kref_put(&nd->last_sym->d_kref);
251         kref_get(&nd->dentry->d_kref, 1);
252         nd->last_sym = nd->dentry;
253         /* If this an absolute path in the symlink, we need to free the old path and
254          * start over, otherwise, we continue from the PARENT of nd (the symlink) */
255         if (symname[0] == '/') {
256                 path_release(nd);
257                 if (!current)
258                         nd->dentry = default_ns.root->mnt_root;
259                 else
260                         nd->dentry = current->fs_env.root;      
261                 nd->mnt = nd->dentry->d_sb->s_mount;
262                 kref_get(&nd->mnt->mnt_kref, 1);
263                 kref_get(&nd->dentry->d_kref, 1);
264         } else {
265                 climb_up(nd);
266         }
267         /* either way, keep on walking in the free world! */
268         retval = link_path_walk(symname, nd);
269         return (retval == 0 ? 1 : retval);
270 }
271
272 /* Little helper, to make it easier to break out of the nested loops.  Will also
273  * '\0' out the first slash if it's slashes all the way down.  Or turtles. */
274 static bool packed_trailing_slashes(char *first_slash)
275 {
276         for (char *i = first_slash; *i == '/'; i++) {
277                 if (*(i + 1) == '\0') {
278                         *first_slash = '\0';
279                         return TRUE;
280                 }
281         }
282         return FALSE;
283 }
284
285 /* Simple helper to set nd to track it's last name to be Name.  Also be careful
286  * with the storage of name.  Don't use and nd's name past the lifetime of the
287  * string used in the path_lookup()/link_path_walk/whatever.  Consider replacing
288  * parts of this with a qstr builder.  Note this uses the dentry's d_op, which
289  * might not be the dentry we care about. */
290 static void stash_nd_name(struct nameidata *nd, char *name)
291 {
292         nd->last.name = name;
293         nd->last.len = strlen(name);
294         nd->last.hash = nd->dentry->d_op->d_hash(nd->dentry, &nd->last);
295 }
296
297 /* Resolves the links in a basic path walk.  0 for success, -EWHATEVER
298  * otherwise.  The final lookup is returned via nd. */
299 static int link_path_walk(char *path, struct nameidata *nd)
300 {
301         struct dentry *link_dentry;
302         struct inode *link_inode, *nd_inode;
303         char *next_slash;
304         char *link = path;
305         int error;
306
307         /* Prevent crazy recursion */
308         if (nd->depth > MAX_SYMLINK_DEPTH)
309                 return -ELOOP;
310         /* skip all leading /'s */
311         while (*link == '/')
312                 link++;
313         /* if there's nothing left (null terminated), we're done.  This should only
314          * happen for "/", which if we wanted a PARENT, should fail (there is no
315          * parent). */
316         if (*link == '\0') {
317                 if (nd->flags & LOOKUP_PARENT) {
318                         set_errno(ENOENT);
319                         return -1;
320                 }
321                 /* o/w, we're good */
322                 return 0;
323         }
324         /* iterate through each intermediate link of the path.  in general, nd
325          * tracks where we are in the path, as far as dentries go.  once we have the
326          * next dentry, we try to update nd based on that dentry.  link is the part
327          * of the path string that we are looking up */
328         while (1) {
329                 nd_inode = nd->dentry->d_inode;
330                 if ((error = check_perms(nd_inode, nd->intent)))
331                         return error;
332                 /* find the next link, break out if it is the end */
333                 next_slash = strchr(link, '/');
334                 if (!next_slash) {
335                         break;
336                 } else {
337                         if (packed_trailing_slashes(next_slash)) {
338                                 nd->flags |= LOOKUP_DIRECTORY;
339                                 break;
340                         }
341                 }
342                 /* skip over any interim ./ */
343                 if (!strncmp("./", link, 2))
344                         goto next_loop;
345                 /* Check for "../", walk up */
346                 if (!strncmp("../", link, 3)) {
347                         climb_up(nd);
348                         goto next_loop;
349                 }
350                 *next_slash = '\0';
351                 link_dentry = do_lookup(nd->dentry, link);
352                 *next_slash = '/';
353                 if (!link_dentry)
354                         return -ENOENT;
355                 /* make link_dentry the current step/answer */
356                 next_link(link_dentry, nd);
357                 kref_put(&link_dentry->d_kref); /* do_lookup gave us a refcnt dentry */
358                 /* we could be on a mountpoint or a symlink - need to follow them */
359                 follow_mount(nd);
360                 if ((error = follow_symlink(nd)) < 0)
361                         return error;
362                 /* Turn off a possible DIRECTORY lookup, which could have been set
363                  * during the follow_symlink (a symlink could have had a directory at
364                  * the end), though it was in the middle of the real path. */
365                 nd->flags &= ~LOOKUP_DIRECTORY;
366                 if (!S_ISDIR(nd->dentry->d_inode->i_mode))
367                         return -ENOTDIR;
368 next_loop:
369                 /* move through the path string to the next entry */
370                 link = next_slash + 1;
371                 /* advance past any other interim slashes.  we know we won't hit the end
372                  * due to the for loop check above */
373                 while (*link == '/')
374                         link++;
375         }
376         /* Now, we're on the last link of the path.  We need to deal with with . and
377          * .. .  This might be weird with PARENT lookups - not sure what semantics
378          * we want exactly.  This will give the parent of whatever the PATH was
379          * supposed to look like.  Note that ND currently points to the parent of
380          * the last item (link). */
381         if (!strcmp(".", link)) {
382                 if (nd->flags & LOOKUP_PARENT) {
383                         assert(nd->dentry->d_name.name);
384                         stash_nd_name(nd, nd->dentry->d_name.name);
385                         climb_up(nd);
386                 }
387                 return 0;
388         }
389         if (!strcmp("..", link)) {
390                 climb_up(nd);
391                 if (nd->flags & LOOKUP_PARENT) {
392                         assert(nd->dentry->d_name.name);
393                         stash_nd_name(nd, nd->dentry->d_name.name);
394                         climb_up(nd);
395                 }
396                 return 0;
397         }
398         /* need to attempt to look it up, in case it's a symlink */
399         link_dentry = do_lookup(nd->dentry, link);
400         if (!link_dentry) {
401                 /* if there's no dentry, we are okay if we are looking for the parent */
402                 if (nd->flags & LOOKUP_PARENT) {
403                         assert(strcmp(link, ""));
404                         stash_nd_name(nd, link);
405                         return 0;
406                 } else {
407                         return -ENOENT;
408                 }
409         }
410         next_link(link_dentry, nd);
411         kref_put(&link_dentry->d_kref); /* do_lookup gave us a refcnt'd dentry */
412         /* at this point, nd is on the final link, but it might be a symlink */
413         if (nd->flags & LOOKUP_FOLLOW) {
414                 error = follow_symlink(nd);
415                 if (error < 0)
416                         return error;
417                 /* if we actually followed a symlink, then nd is set and we're done */
418                 if (error > 0)
419                         return 0;
420         }
421         /* One way or another, nd is on the last element of the path, symlinks and
422          * all.  Now we need to climb up to set nd back on the parent, if that's
423          * what we wanted */
424         if (nd->flags & LOOKUP_PARENT) {
425                 assert(nd->dentry->d_name.name);
426                 stash_nd_name(nd, link_dentry->d_name.name);
427                 climb_up(nd);
428                 return 0;
429         }
430         /* now, we have the dentry set, and don't want the parent, but might be on a
431          * mountpoint still.  FYI: this hasn't been thought through completely. */
432         follow_mount(nd);
433         /* If we wanted a directory, but didn't get one, error out */
434         if ((nd->flags & LOOKUP_DIRECTORY) && !S_ISDIR(nd->dentry->d_inode->i_mode))
435                 return -ENOTDIR;
436         return 0;
437 }
438
439 /* Given path, return the inode for the final dentry.  The ND should be
440  * initialized for the first call - specifically, we need the intent. 
441  * LOOKUP_PARENT and friends go in the flags var, which is not the intent.
442  *
443  * If path_lookup wants a PARENT, but hits the top of the FS (root or
444  * otherwise), we want it to error out.  It's still unclear how we want to
445  * handle processes with roots that aren't root, but at the very least, we don't
446  * want to think we have the parent of /, but have / itself.  Due to the way
447  * link_path_walk works, if that happened, we probably don't have a
448  * nd->last.name.  This needs more thought (TODO).
449  *
450  * Need to be careful too.  While the path has been copied-in to the kernel,
451  * it's still user input.  */
452 int path_lookup(char *path, int flags, struct nameidata *nd)
453 {
454         int retval;
455         printd("Path lookup for %s\n", path);
456         /* we allow absolute lookups with no process context */
457         if (path[0] == '/') {                   /* absolute lookup */
458                 if (!current)
459                         nd->dentry = default_ns.root->mnt_root;
460                 else
461                         nd->dentry = current->fs_env.root;      
462         } else {                                                /* relative lookup */
463                 assert(current);
464                 /* Don't need to lock on the fs_env since we're reading one item */
465                 nd->dentry = current->fs_env.pwd;       
466         }
467         nd->mnt = nd->dentry->d_sb->s_mount;
468         /* Whenever references get put in the nd, incref them.  Whenever they are
469          * removed, decref them. */
470         kref_get(&nd->mnt->mnt_kref, 1);
471         kref_get(&nd->dentry->d_kref, 1);
472         nd->flags = flags;
473         nd->depth = 0;                                  /* used in symlink following */
474         retval =  link_path_walk(path, nd);     
475         /* make sure our PARENT lookup worked */
476         if (!retval && (flags & LOOKUP_PARENT))
477                 assert(nd->last.name);
478         return retval;
479 }
480
481 /* Call this after any use of path_lookup when you are done with its results,
482  * regardless of whether it succeeded or not.  It will free any references */
483 void path_release(struct nameidata *nd)
484 {
485         kref_put(&nd->dentry->d_kref);
486         kref_put(&nd->mnt->mnt_kref);
487         /* Free the last symlink dentry used, if there was one */
488         if (nd->last_sym) {
489                 kref_put(&nd->last_sym->d_kref);
490                 nd->last_sym = 0;                       /* catch reuse bugs */
491         }
492 }
493
494 /* External version of mount, only call this after having a / mount */
495 int mount_fs(struct fs_type *fs, char *dev_name, char *path, int flags)
496 {
497         struct nameidata nd_r = {0}, *nd = &nd_r;
498         int retval = 0;
499         retval = path_lookup(path, LOOKUP_DIRECTORY, nd);
500         if (retval)
501                 goto out;
502         /* taking the namespace of the vfsmount of path */ 
503         if (!__mount_fs(fs, dev_name, nd->dentry, flags, nd->mnt->mnt_namespace))
504                 retval = -EINVAL;
505 out:
506         path_release(nd);
507         return retval;
508 }
509
510 /* Superblock functions */
511
512 /* Dentry "hash" function for the hash table to use.  Since we already have the
513  * hash in the qstr, we don't need to rehash.  Also, note we'll be using the
514  * dentry in question as both the key and the value. */
515 static size_t __dcache_hash(void *k)
516 {
517         return (size_t)((struct dentry*)k)->d_name.hash;
518 }
519
520 /* Dentry cache hashtable equality function.  This means we need to pass in some
521  * minimal dentry when doing a lookup. */
522 static ssize_t __dcache_eq(void *k1, void *k2)
523 {
524         if (((struct dentry*)k1)->d_parent != ((struct dentry*)k2)->d_parent)
525                 return 0;
526         /* TODO: use the FS-specific string comparison */
527         return !strcmp(((struct dentry*)k1)->d_name.name,
528                        ((struct dentry*)k2)->d_name.name);
529 }
530
531 /* Helper to alloc and initialize a generic superblock.  This handles all the
532  * VFS related things, like lists.  Each FS will need to handle its own things
533  * in it's *_get_sb(), usually involving reading off the disc. */
534 struct super_block *get_sb(void)
535 {
536         struct super_block *sb = kmalloc(sizeof(struct super_block), 0);
537         sb->s_dirty = FALSE;
538         spinlock_init(&sb->s_lock);
539         kref_init(&sb->s_kref, fake_release, 1); /* for the ref passed out */
540         TAILQ_INIT(&sb->s_inodes);
541         TAILQ_INIT(&sb->s_dirty_i);
542         TAILQ_INIT(&sb->s_io_wb);
543         TAILQ_INIT(&sb->s_lru_d);
544         TAILQ_INIT(&sb->s_files);
545         sb->s_dcache = create_hashtable(100, __dcache_hash, __dcache_eq);
546         sb->s_icache = create_hashtable(100, __generic_hash, __generic_eq);
547         spinlock_init(&sb->s_lru_lock);
548         spinlock_init(&sb->s_dcache_lock);
549         spinlock_init(&sb->s_icache_lock);
550         sb->s_fs_info = 0; // can override somewhere else
551         return sb;
552 }
553
554 /* Final stages of initializing a super block, including creating and linking
555  * the root dentry, root inode, vmnt, and sb.  The d_op and root_ino are
556  * FS-specific, but otherwise it's FS-independent, tricky, and not worth having
557  * around multiple times.
558  *
559  * Not the world's best interface, so it's subject to change, esp since we're
560  * passing (now 3) FS-specific things. */
561 void init_sb(struct super_block *sb, struct vfsmount *vmnt,
562              struct dentry_operations *d_op, unsigned long root_ino,
563              void *d_fs_info)
564 {
565         /* Build and init the first dentry / inode.  The dentry ref is stored later
566          * by vfsmount's mnt_root.  The parent is dealt with later. */
567         struct dentry *d_root = get_dentry(sb, 0,  "/");        /* probably right */
568
569         /* a lot of here on down is normally done in lookup() or create, since
570          * get_dentry isn't a fully usable dentry.  The two FS-specific settings are
571          * normally inherited from a parent within the same FS in get_dentry, but we
572          * have none here. */
573         d_root->d_op = d_op;
574         d_root->d_fs_info = d_fs_info;
575         struct inode *inode = get_inode(d_root);
576         if (!inode)
577                 panic("This FS sucks!");
578         inode->i_ino = root_ino;
579         /* TODO: add the inode to the appropriate list (off i_list) */
580         /* TODO: do we need to read in the inode?  can we do this on demand? */
581         /* if this FS is already mounted, we'll need to do something different. */
582         sb->s_op->read_inode(inode);
583         icache_put(sb, inode);
584         /* Link the dentry and SB to the VFS mount */
585         vmnt->mnt_root = d_root;                                /* ref comes from get_dentry */
586         vmnt->mnt_sb = sb;
587         /* If there is no mount point, there is no parent.  This is true only for
588          * the rootfs. */
589         if (vmnt->mnt_mountpoint) {
590                 kref_get(&vmnt->mnt_mountpoint->d_kref, 1);     /* held by d_root */
591                 d_root->d_parent = vmnt->mnt_mountpoint;        /* dentry of the root */
592         } else {
593                 d_root->d_parent = d_root;                      /* set root as its own parent */
594         }
595         /* insert the dentry into the dentry cache.  when's the earliest we can?
596          * when's the earliest we should?  what about concurrent accesses to the
597          * same dentry?  should be locking the dentry... */
598         dcache_put(sb, d_root);
599         kref_put(&inode->i_kref);               /* give up the ref from get_inode() */
600 }
601
602 /* Dentry Functions */
603
604 /* Helper to alloc and initialize a generic dentry.  The following needs to be
605  * set still: d_op (if no parent), d_fs_info (opt), d_inode, connect the inode
606  * to the dentry (and up the d_kref again), maybe dcache_put().  The inode
607  * stitching is done in get_inode() or lookup (depending on the FS).
608  * The setting of the d_op might be problematic when dealing with mounts.  Just
609  * overwrite it.
610  *
611  * If the name is longer than the inline name, it will kmalloc a buffer, so
612  * don't worry about the storage for *name after calling this. */
613 struct dentry *get_dentry(struct super_block *sb, struct dentry *parent,
614                           char *name)
615 {
616         assert(name);
617         size_t name_len = strnlen(name, MAX_FILENAME_SZ);       /* not including \0! */
618         struct dentry *dentry = kmem_cache_alloc(dentry_kcache, 0);
619         char *l_name = 0;
620
621         if (!dentry)
622                 return 0;
623         //memset(dentry, 0, sizeof(struct dentry));
624         kref_init(&dentry->d_kref, dentry_release, 1);  /* this ref is returned */
625         spinlock_init(&dentry->d_lock);
626         TAILQ_INIT(&dentry->d_subdirs);
627         dentry->d_time = 0;
628         kref_get(&sb->s_kref, 1);
629         dentry->d_sb = sb;                                      /* storing a ref here... */
630         dentry->d_mount_point = FALSE;
631         dentry->d_mounted_fs = 0;
632         if (parent)     {                                               /* no parent for rootfs mount */
633                 kref_get(&parent->d_kref, 1);
634                 dentry->d_op = parent->d_op;    /* d_op set in init_sb for parentless */
635         }
636         dentry->d_parent = parent;
637         dentry->d_flags = DENTRY_USED;
638         dentry->d_fs_info = 0;
639         if (name_len < DNAME_INLINE_LEN) {
640                 strncpy(dentry->d_iname, name, name_len);
641                 dentry->d_iname[name_len] = '\0';
642                 qstr_builder(dentry, 0);
643         } else {
644                 l_name = kmalloc(name_len + 1, 0);
645                 assert(l_name);
646                 strncpy(l_name, name, name_len);
647                 l_name[name_len] = '\0';
648                 qstr_builder(dentry, l_name);
649         }
650         /* Catch bugs by aggressively zeroing this (o/w we use old stuff) */
651         dentry->d_inode = 0;
652         return dentry;
653 }
654
655 /* Called when the dentry is unreferenced (after kref == 0).  This works closely
656  * with the resurrection in dcache_get().
657  *
658  * The dentry is still in the dcache, but needs to be un-USED and added to the
659  * LRU dentry list.  Even dentries that were used in a failed lookup need to be
660  * cached - they ought to be the negative dentries.  Note that all dentries have
661  * parents, even negative ones (it is needed to find it in the dcache). */
662 void dentry_release(struct kref *kref)
663 {
664         struct dentry *dentry = container_of(kref, struct dentry, d_kref);
665
666         printd("'Releasing' dentry %08p: %s\n", dentry, dentry->d_name.name);
667         /* DYING dentries (recently unlinked / rmdir'd) just get freed */
668         if (dentry->d_flags & DENTRY_DYING) {
669                 __dentry_free(dentry);
670                 return;
671         }
672         /* This lock ensures the USED state and the TAILQ membership is in sync.
673          * Also used to check the refcnt, though that might not be necessary. */
674         spin_lock(&dentry->d_lock);
675         /* While locked, we need to double check the kref, in case someone already
676          * reup'd it.  Re-up? you're crazy!  Reee-up, you're outta yo mind! */
677         if (!kref_refcnt(&dentry->d_kref)) {
678                 /* and make sure it wasn't USED, then UNUSED again */
679                 /* TODO: think about issues with this */
680                 if (dentry->d_flags & DENTRY_USED) {
681                         dentry->d_flags &= ~DENTRY_USED;
682                         spin_lock(&dentry->d_sb->s_lru_lock);
683                         TAILQ_INSERT_TAIL(&dentry->d_sb->s_lru_d, dentry, d_lru);
684                         spin_unlock(&dentry->d_sb->s_lru_lock);
685                 } else {
686                         warn("This should be rare.  Tell brho this happened.");
687                 }
688         }
689         spin_unlock(&dentry->d_lock);
690 }
691
692 /* Called when we really dealloc and get rid of a dentry (like when it is
693  * removed from the dcache, either for memory or correctness reasons)
694  *
695  * This has to handle two types of dentries: full ones (ones that had been used)
696  * and ones that had been just for lookups - hence the check for d_inode.
697  *
698  * Note that dentries pin and kref their inodes.  When all the dentries are
699  * gone, we want the inode to be released via kref.  The inode has internal /
700  * weak references to the dentry, which are not refcounted. */
701 void __dentry_free(struct dentry *dentry)
702 {
703         if (dentry->d_inode)
704                 printk("Freeing dentry %08p: %s\n", dentry, dentry->d_name.name);
705         assert(dentry->d_op);   /* catch bugs.  a while back, some lacked d_op */
706         dentry->d_op->d_release(dentry);
707         /* TODO: check/test the boundaries on this. */
708         if (dentry->d_name.len > DNAME_INLINE_LEN)
709                 kfree((void*)dentry->d_name.name);
710         kref_put(&dentry->d_sb->s_kref);
711         if (dentry->d_parent)
712                 kref_put(&dentry->d_parent->d_kref);
713         if (dentry->d_mounted_fs)
714                 kref_put(&dentry->d_mounted_fs->mnt_kref);
715         if (dentry->d_inode) {
716                 TAILQ_REMOVE(&dentry->d_inode->i_dentry, dentry, d_alias);
717                 kref_put(&dentry->d_inode->i_kref);     /* dentries kref inodes */
718         }
719         kmem_cache_free(dentry_kcache, dentry);
720 }
721
722 /* Looks up the dentry for the given path, returning a refcnt'd dentry (or 0).
723  * Permissions are applied for the current user, which is quite a broken system
724  * at the moment.  Flags are lookup flags. */
725 struct dentry *lookup_dentry(char *path, int flags)
726 {
727         struct dentry *dentry;
728         struct nameidata nd_r = {0}, *nd = &nd_r;
729         int error;
730
731         error = path_lookup(path, flags, nd);
732         if (error) {
733                 path_release(nd);
734                 set_errno(-error);
735                 return 0;
736         }
737         dentry = nd->dentry;
738         kref_get(&dentry->d_kref, 1);
739         path_release(nd);
740         return dentry;
741 }
742
743 /* Get a dentry from the dcache.  At a minimum, we need the name hash and parent
744  * in what_i_want, though most uses will probably be from a get_dentry() call.
745  * We pass in the SB in the off chance that we don't want to use a get'd dentry.
746  *
747  * The unusual variable name (instead of just "key" or something) is named after
748  * ex-SPC Castro's porn folder.  Caller deals with the memory for what_i_want.
749  *
750  * If the dentry is negative, we don't return the actual result - instead, we
751  * set the negative flag in 'what i want'.  The reason is we don't want to
752  * kref_get() and then immediately put (causing dentry_release()).  This also
753  * means that dentry_release() should never get someone who wasn't USED (barring
754  * the race, which it handles).  And we don't need to ever have a dentry set as
755  * USED and NEGATIVE (which is always wrong, but would be needed for a cleaner
756  * dentry_release()).
757  *
758  * This is where we do the "kref resurrection" - we are returning a kref'd
759  * object, even if it wasn't kref'd before.  This means the dcache does NOT hold
760  * krefs (it is a weak/internal ref), but it is a source of kref generation.  We
761  * sync up with the possible freeing of the dentry by locking the table.  See
762  * Doc/kref for more info. */
763 struct dentry *dcache_get(struct super_block *sb, struct dentry *what_i_want)
764 {
765         struct dentry *found;
766         /* This lock protects the hash, as well as ensures the returned object
767          * doesn't get deleted/freed out from under us */
768         spin_lock(&sb->s_dcache_lock);
769         found = hashtable_search(sb->s_dcache, what_i_want);
770         if (found) {
771                 if (found->d_flags & DENTRY_NEGATIVE) {
772                         what_i_want->d_flags |= DENTRY_NEGATIVE;
773                         spin_unlock(&sb->s_dcache_lock);
774                         return 0;
775                 }
776                 spin_lock(&found->d_lock);
777                 __kref_get(&found->d_kref, 1);  /* prob could be done outside the lock*/
778                 /* If we're here (after kreffing) and it is not USED, we are the one who
779                  * should resurrect */
780                 if (!(found->d_flags & DENTRY_USED)) {
781                         found->d_flags |= DENTRY_USED;
782                         spin_lock(&sb->s_lru_lock);
783                         TAILQ_REMOVE(&sb->s_lru_d, found, d_lru);
784                         spin_unlock(&sb->s_lru_lock);
785                 }
786                 spin_unlock(&found->d_lock);
787         }
788         spin_unlock(&sb->s_dcache_lock);
789         return found;
790 }
791
792 /* Adds a dentry to the dcache.  Note the *dentry is both the key and the value.
793  * If the value was already in there (which can happen iff it was negative), for
794  * now we'll remove it and put the new one in there. */
795 void dcache_put(struct super_block *sb, struct dentry *key_val)
796 {
797         struct dentry *old;
798         int retval;
799         spin_lock(&sb->s_dcache_lock);
800         old = hashtable_remove(sb->s_dcache, key_val);
801         if (old) {
802                 assert(old->d_flags & DENTRY_NEGATIVE);
803                 assert(!(old->d_flags & DENTRY_USED));
804                 assert(!kref_refcnt(&old->d_kref));
805                 spin_lock(&sb->s_lru_lock);
806                 TAILQ_REMOVE(&sb->s_lru_d, old, d_lru);
807                 spin_unlock(&sb->s_lru_lock);
808                 __dentry_free(old);
809         }
810         /* this returns 0 on failure (TODO: Fix this ghetto shit) */
811         retval = hashtable_insert(sb->s_dcache, key_val, key_val);
812         assert(retval);
813         spin_unlock(&sb->s_dcache_lock);
814 }
815
816 /* Will remove and return the dentry.  Caller deallocs the key, but the retval
817  * won't have a reference.  * Returns 0 if it wasn't found.  Callers can't
818  * assume much - they should not use the reference they *get back*, (if they
819  * already had one for key, they can use that).  There may be other users out
820  * there. */
821 struct dentry *dcache_remove(struct super_block *sb, struct dentry *key)
822 {
823         struct dentry *retval;
824         spin_lock(&sb->s_dcache_lock);
825         retval = hashtable_remove(sb->s_dcache, key);
826         spin_unlock(&sb->s_dcache_lock);
827         return retval;
828 }
829
830 /* This will clean out the LRU list, which are the unused dentries of the dentry
831  * cache.  This will optionally only free the negative ones.  Note that we grab
832  * the hash lock for the time we traverse the LRU list - this prevents someone
833  * from getting a kref from the dcache, which could cause us trouble (we rip
834  * someone off the list, who isn't unused, and they try to rip them off the
835  * list). */
836 void dcache_prune(struct super_block *sb, bool negative_only)
837 {
838         struct dentry *d_i, *temp;
839         struct dentry_tailq victims = TAILQ_HEAD_INITIALIZER(victims);
840
841         spin_lock(&sb->s_dcache_lock);
842         spin_lock(&sb->s_lru_lock);
843         TAILQ_FOREACH_SAFE(d_i, &sb->s_lru_d, d_lru, temp) {
844                 if (!(d_i->d_flags & DENTRY_USED)) {
845                         if (negative_only && !(d_i->d_flags & DENTRY_NEGATIVE))
846                                 continue;
847                         /* another place where we'd be better off with tools, not sol'ns */
848                         hashtable_remove(sb->s_dcache, d_i);
849                         TAILQ_REMOVE(&sb->s_lru_d, d_i, d_lru);
850                         TAILQ_INSERT_HEAD(&victims, d_i, d_lru);
851                 }
852         }
853         spin_unlock(&sb->s_lru_lock);
854         spin_unlock(&sb->s_dcache_lock);
855         /* Now do the actual freeing, outside of the hash/LRU list locks.  This is
856          * necessary since __dentry_free() will decref its parent, which may get
857          * released and try to add itself to the LRU. */
858         TAILQ_FOREACH_SAFE(d_i, &victims, d_lru, temp) {
859                 TAILQ_REMOVE(&victims, d_i, d_lru);
860                 assert(!kref_refcnt(&d_i->d_kref));
861                 __dentry_free(d_i);
862         }
863         /* It is possible at this point that there are new items on the LRU.  We
864          * could loop back until that list is empty, if we care about this. */
865 }
866
867 /* Inode Functions */
868
869 /* Creates and initializes a new inode.  Generic fields are filled in.
870  * FS-specific fields are filled in by the callout.  Specific fields are filled
871  * in in read_inode() based on what's on the disk for a given i_no, or when the
872  * inode is created (for new objects).
873  *
874  * i_no is set by the caller.  Note that this means this inode can be for an
875  * inode that is already on disk, or it can be used when creating. */
876 struct inode *get_inode(struct dentry *dentry)
877 {
878         struct super_block *sb = dentry->d_sb;
879         /* FS allocs and sets the following: i_op, i_fop, i_pm.pm_op, and any FS
880          * specific stuff. */
881         struct inode *inode = sb->s_op->alloc_inode(sb);
882         if (!inode) {
883                 set_errno(ENOMEM);
884                 return 0;
885         }
886         TAILQ_INSERT_HEAD(&sb->s_inodes, inode, i_sb_list);             /* weak inode ref */
887         TAILQ_INIT(&inode->i_dentry);
888         TAILQ_INSERT_TAIL(&inode->i_dentry, dentry, d_alias);   /* weak dentry ref*/
889         /* one for the dentry->d_inode, one passed out */
890         kref_init(&inode->i_kref, inode_release, 2);
891         dentry->d_inode = inode;
892         inode->i_ino = 0;                                       /* set by caller later */
893         inode->i_blksize = sb->s_blocksize;
894         spinlock_init(&inode->i_lock);
895         kref_get(&sb->s_kref, 1);                       /* could allow the dentry to pin it */
896         inode->i_sb = sb;
897         inode->i_rdev = 0;                                      /* this has no real meaning yet */
898         inode->i_bdev = sb->s_bdev;                     /* storing an uncounted ref */
899         inode->i_state = 0;                                     /* need real states, like I_NEW */
900         inode->dirtied_when = 0;
901         inode->i_flags = 0;
902         atomic_set(&inode->i_writecount, 0);
903         /* Set up the page_map structures.  Default is to use the embedded one.
904          * Might push some of this back into specific FSs.  For now, the FS tells us
905          * what pm_op they want via i_pm.pm_op, which we set again in pm_init() */
906         inode->i_mapping = &inode->i_pm;
907         pm_init(inode->i_mapping, inode->i_pm.pm_op, inode);
908         return inode;
909 }
910
911 /* Helper: loads/ reads in the inode numbered ino and attaches it to dentry */
912 void load_inode(struct dentry *dentry, unsigned int ino)
913 {
914         struct inode *inode;
915
916         /* look it up in the inode cache first */
917         inode = icache_get(dentry->d_sb, ino);
918         if (inode) {
919                 /* connect the dentry to its inode */
920                 TAILQ_INSERT_TAIL(&inode->i_dentry, dentry, d_alias);
921                 dentry->d_inode = inode;        /* storing the ref we got from icache_get */
922                 return;
923         }
924         /* otherwise, we need to do it manually */
925         inode = get_inode(dentry);
926         inode->i_ino = ino;
927         dentry->d_sb->s_op->read_inode(inode);
928         /* TODO: race here, two creators could miss in the cache, and then get here.
929          * need a way to sync across a blocking call.  needs to be either at this
930          * point in the code or per the ino (dentries could be different) */
931         icache_put(dentry->d_sb, inode);
932         kref_put(&inode->i_kref);
933 }
934
935 /* Helper op, used when creating regular files, directories, symlinks, etc.
936  * Note we make a distinction between the mode and the file type (for now).
937  * After calling this, call the FS specific version (create or mkdir), which
938  * will set the i_ino, the filetype, and do any other FS-specific stuff.  Also
939  * note that a lot of inode stuff was initialized in get_inode/alloc_inode.  The
940  * stuff here is pertinent to the specific creator (user), mode, and time.  Also
941  * note we don't pass this an nd, like Linux does... */
942 static struct inode *create_inode(struct dentry *dentry, int mode)
943 {
944         /* note it is the i_ino that uniquely identifies a file in the specific
945          * filesystem.  there's a diff between creating an inode (even for an in-use
946          * ino) and then filling it in, and vs creating a brand new one.
947          * get_inode() sets it to 0, and it should be filled in later in an
948          * FS-specific manner. */
949         struct inode *inode = get_inode(dentry);
950         if (!inode)
951                 return 0;
952         inode->i_mode = mode & S_PMASK; /* note that after this, we have no type */
953         inode->i_nlink = 1;
954         inode->i_size = 0;
955         inode->i_blocks = 0;
956         inode->i_atime.tv_sec = 0;              /* TODO: now! */
957         inode->i_ctime.tv_sec = 0;
958         inode->i_mtime.tv_sec = 0;
959         inode->i_atime.tv_nsec = 0;             /* are these supposed to be the extra ns? */
960         inode->i_ctime.tv_nsec = 0;
961         inode->i_mtime.tv_nsec = 0;
962         inode->i_bdev = inode->i_sb->s_bdev;
963         /* when we have notions of users, do something here: */
964         inode->i_uid = 0;
965         inode->i_gid = 0;
966         return inode;
967 }
968
969 /* Create a new disk inode in dir associated with dentry, with the given mode.
970  * called when creating a regular file.  dir is the directory/parent.  dentry is
971  * the dentry of the inode we are creating.  Note the lack of the nd... */
972 int create_file(struct inode *dir, struct dentry *dentry, int mode)
973 {
974         struct inode *new_file = create_inode(dentry, mode);
975         if (!new_file)
976                 return -1;
977         dir->i_op->create(dir, dentry, mode, 0);
978         icache_put(new_file->i_sb, new_file);
979         kref_put(&new_file->i_kref);
980         return 0;
981 }
982
983 /* Creates a new inode for a directory associated with dentry in dir with the
984  * given mode. */
985 int create_dir(struct inode *dir, struct dentry *dentry, int mode)
986 {
987         struct inode *new_dir = create_inode(dentry, mode);
988         if (!new_dir)
989                 return -1;
990         dir->i_op->mkdir(dir, dentry, mode);
991         dir->i_nlink++;         /* Directories get a hardlink for every child dir */
992         /* Make sure my parent tracks me.  This is okay, since no directory (dir)
993          * can have more than one dentry */
994         struct dentry *parent = TAILQ_FIRST(&dir->i_dentry);
995         assert(parent && parent == TAILQ_LAST(&dir->i_dentry, dentry_tailq));
996         /* parent dentry tracks dentry as a subdir, weak reference */
997         TAILQ_INSERT_TAIL(&parent->d_subdirs, dentry, d_subdirs_link);
998         icache_put(new_dir->i_sb, new_dir);
999         kref_put(&new_dir->i_kref);
1000         return 0;
1001 }
1002
1003 /* Creates a new inode for a symlink associated with dentry in dir, containing
1004  * the symlink symname */
1005 int create_symlink(struct inode *dir, struct dentry *dentry,
1006                    const char *symname, int mode)
1007 {
1008         struct inode *new_sym = create_inode(dentry, mode);
1009         if (!new_sym)
1010                 return -1;
1011         dir->i_op->symlink(dir, dentry, symname);
1012         icache_put(new_sym->i_sb, new_sym);
1013         kref_put(&new_sym->i_kref);
1014         return 0;
1015 }
1016
1017 /* Returns 0 if the given mode is acceptable for the inode, and an appropriate
1018  * error code if not.  Needs to be writen, based on some sensible rules, and
1019  * will also probably use 'current' */
1020 int check_perms(struct inode *inode, int access_mode)
1021 {
1022         return 0;       /* anything goes! */
1023 }
1024
1025 /* Called after all external refs are gone to clean up the inode.  Once this is
1026  * called, all dentries pointing here are already done (one of them triggered
1027  * this via kref_put(). */
1028 void inode_release(struct kref *kref)
1029 {
1030         struct inode *inode = container_of(kref, struct inode, i_kref);
1031         TAILQ_REMOVE(&inode->i_sb->s_inodes, inode, i_sb_list);
1032         icache_remove(inode->i_sb, inode->i_ino);
1033         /* Might need to write back or delete the file/inode */
1034         if (inode->i_nlink) {
1035                 if (inode->i_state & I_STATE_DIRTY)
1036                         inode->i_sb->s_op->write_inode(inode, TRUE);
1037         } else {
1038                 inode->i_sb->s_op->delete_inode(inode);
1039         }
1040         /* Either way, we dealloc the in-memory version */
1041         inode->i_sb->s_op->dealloc_inode(inode);        /* FS-specific clean-up */
1042         kref_put(&inode->i_sb->s_kref);
1043         /* TODO: clean this up */
1044         assert(inode->i_mapping == &inode->i_pm);
1045         kmem_cache_free(inode_kcache, inode);
1046         /* TODO: (BDEV) */
1047         // kref_put(inode->i_bdev->kref); /* assuming it's a bdev */
1048 }
1049
1050 /* Fills in kstat with the stat information for the inode */
1051 void stat_inode(struct inode *inode, struct kstat *kstat)
1052 {
1053         kstat->st_dev = inode->i_sb->s_dev;
1054         kstat->st_ino = inode->i_ino;
1055         kstat->st_mode = inode->i_mode;
1056         kstat->st_nlink = inode->i_nlink;
1057         kstat->st_uid = inode->i_uid;
1058         kstat->st_gid = inode->i_gid;
1059         kstat->st_rdev = inode->i_rdev;
1060         kstat->st_size = inode->i_size;
1061         kstat->st_blksize = inode->i_blksize;
1062         kstat->st_blocks = inode->i_blocks;
1063         kstat->st_atime = inode->i_atime;
1064         kstat->st_mtime = inode->i_mtime;
1065         kstat->st_ctime = inode->i_ctime;
1066 }
1067
1068 /* Inode Cache management.  In general, search on the ino, get a refcnt'd value
1069  * back.  Remove does not give you a reference back - it should only be called
1070  * in inode_release(). */
1071 struct inode *icache_get(struct super_block *sb, unsigned int ino)
1072 {
1073         /* This is the same style as in pid2proc, it's the "safely create a strong
1074          * reference from a weak one, so long as other strong ones exist" pattern */
1075         spin_lock(&sb->s_icache_lock);
1076         struct inode *inode = hashtable_search(sb->s_icache, (void*)ino);
1077         if (inode)
1078                 if (!kref_get_not_zero(&inode->i_kref, 1))
1079                         inode = 0;
1080         spin_unlock(&sb->s_icache_lock);
1081         return inode;
1082 }
1083
1084 void icache_put(struct super_block *sb, struct inode *inode)
1085 {
1086         spin_lock(&sb->s_icache_lock);
1087         /* there's a race in load_ino() that could trigger this */
1088         assert(!hashtable_search(sb->s_icache, (void*)inode->i_ino));
1089         hashtable_insert(sb->s_icache, (void*)inode->i_ino, inode);
1090         spin_unlock(&sb->s_icache_lock);
1091 }
1092
1093 struct inode *icache_remove(struct super_block *sb, unsigned int ino)
1094 {
1095         struct inode *inode;
1096         /* Presumably these hashtable removals could be easier since callers
1097          * actually know who they are (same with the pid2proc hash) */
1098         spin_lock(&sb->s_icache_lock);
1099         inode = hashtable_remove(sb->s_icache, (void*)ino);
1100         spin_unlock(&sb->s_icache_lock);
1101         assert(inode && !kref_refcnt(&inode->i_kref));
1102         return inode;
1103 }
1104
1105 /* File functions */
1106
1107 /* Read count bytes from the file into buf, starting at *offset, which is increased
1108  * accordingly, returning the number of bytes transfered.  Most filesystems will
1109  * use this function for their f_op->read.  Note, this uses the page cache.
1110  * Want to try out page remapping later on... */
1111 ssize_t generic_file_read(struct file *file, char *buf, size_t count,
1112                           off_t *offset)
1113 {
1114         struct page *page;
1115         int error;
1116         off_t page_off;
1117         unsigned long first_idx, last_idx;
1118         size_t copy_amt;
1119         char *buf_end;
1120
1121         /* Consider pushing some error checking higher in the VFS */
1122         if (!count)
1123                 return 0;
1124         if (*offset == file->f_dentry->d_inode->i_size)
1125                 return 0; /* EOF */
1126         /* Make sure we don't go past the end of the file */
1127         if (*offset + count > file->f_dentry->d_inode->i_size) {
1128                 count = file->f_dentry->d_inode->i_size - *offset;
1129         }
1130         page_off = *offset & (PGSIZE - 1);
1131         first_idx = *offset >> PGSHIFT;
1132         last_idx = (*offset + count) >> PGSHIFT;
1133         buf_end = buf + count;
1134         /* For each file page, make sure it's in the page cache, then copy it out.
1135          * TODO: will probably need to consider concurrently truncated files here.*/
1136         for (int i = first_idx; i <= last_idx; i++) {
1137                 error = file_load_page(file, i, &page);
1138                 assert(!error); /* TODO: handle ENOMEM and friends */
1139                 copy_amt = MIN(PGSIZE - page_off, buf_end - buf);
1140                 /* TODO: (UMEM) think about this.  if it's a user buffer, we're relying
1141                  * on current to detect whose it is (which should work for async calls).
1142                  * Also, need to propagate errors properly...  Probably should do a
1143                  * user_mem_check, then free, and also to make a distinction between
1144                  * when the kernel wants a read/write (TODO: KFOP) */
1145                 if (current) {
1146                         memcpy_to_user(current, buf, page2kva(page) + page_off, copy_amt);
1147                 } else {
1148                         memcpy(buf, page2kva(page) + page_off, copy_amt);
1149                 }
1150                 buf += copy_amt;
1151                 page_off = 0;
1152                 page_decref(page);      /* it's still in the cache, we just don't need it */
1153         }
1154         assert(buf == buf_end);
1155         *offset += count;
1156         return count;
1157 }
1158
1159 /* Write count bytes from buf to the file, starting at *offset, which is increased
1160  * accordingly, returning the number of bytes transfered.  Most filesystems will
1161  * use this function for their f_op->write.  Note, this uses the page cache.
1162  * Changes don't get flushed to disc til there is an fsync, page cache eviction,
1163  * or other means of trying to writeback the pages. */
1164 ssize_t generic_file_write(struct file *file, const char *buf, size_t count,
1165                            off_t *offset)
1166 {
1167         struct page *page;
1168         int error;
1169         off_t page_off;
1170         unsigned long first_idx, last_idx;
1171         size_t copy_amt;
1172         const char *buf_end;
1173
1174         /* Consider pushing some error checking higher in the VFS */
1175         if (!count)
1176                 return 0;
1177         /* Extend the file.  Should put more checks in here, and maybe do this per
1178          * page in the for loop below. */
1179         if (*offset + count > file->f_dentry->d_inode->i_size)
1180                 file->f_dentry->d_inode->i_size = *offset + count;
1181         page_off = *offset & (PGSIZE - 1);
1182         first_idx = *offset >> PGSHIFT;
1183         last_idx = (*offset + count) >> PGSHIFT;
1184         buf_end = buf + count;
1185         /* For each file page, make sure it's in the page cache, then write it.*/
1186         for (int i = first_idx; i <= last_idx; i++) {
1187                 error = file_load_page(file, i, &page);
1188                 assert(!error); /* TODO: handle ENOMEM and friends */
1189                 copy_amt = MIN(PGSIZE - page_off, buf_end - buf);
1190                 /* TODO: (UMEM) (KFOP) think about this.  if it's a user buffer, we're
1191                  * relying on current to detect whose it is (which should work for async
1192                  * calls). */
1193                 if (current) {
1194                         memcpy_from_user(current, page2kva(page) + page_off, buf, copy_amt);
1195                 } else {
1196                         memcpy(page2kva(page) + page_off, buf, copy_amt);
1197                 }
1198                 buf += copy_amt;
1199                 page_off = 0;
1200                 page_decref(page);      /* it's still in the cache, we just don't need it */
1201         }
1202         assert(buf == buf_end);
1203         *offset += count;
1204         return count;
1205 }
1206
1207 /* Directories usually use this for their read method, which is the way glibc
1208  * currently expects us to do a readdir (short of doing linux's getdents).  Will
1209  * probably need work, based on whatever real programs want. */
1210 ssize_t generic_dir_read(struct file *file, char *u_buf, size_t count,
1211                          off_t *offset)
1212 {
1213         struct kdirent dir_r = {0}, *dirent = &dir_r;
1214         int retval = 1;
1215         size_t amt_copied = 0;
1216         char *buf_end = u_buf + count;
1217
1218         if (!S_ISDIR(file->f_dentry->d_inode->i_mode)) {
1219                 set_errno(ENOTDIR);
1220                 return -1;
1221         }
1222         if (!count)
1223                 return 0;
1224         /* start readdir from where it left off: */
1225         dirent->d_off = *offset;
1226         for (; (u_buf < buf_end) && (retval == 1); u_buf += sizeof(struct kdirent)){
1227                 /* TODO: UMEM/KFOP (pin the u_buf in the syscall, ditch the local copy,
1228                  * get rid of this memcpy and reliance on current, etc).  Might be
1229                  * tricky with the dirent->d_off and trust issues */
1230                 retval = file->f_op->readdir(file, dirent);
1231                 if (retval < 0) {
1232                         set_errno(-retval);
1233                         break;
1234                 }
1235                 /* Slight info exposure: could be extra crap after the name in the
1236                  * dirent (like the name of a deleted file) */
1237                 if (current) {
1238                         memcpy_to_user(current, u_buf, dirent, sizeof(struct dirent));
1239                 } else {
1240                         memcpy(u_buf, dirent, sizeof(struct dirent));
1241                 }
1242                 amt_copied += sizeof(struct dirent);
1243         }
1244         /* Next time read is called, we pick up where we left off */
1245         *offset = dirent->d_off;        /* UMEM */
1246         /* important to tell them how much they got.  they often keep going til they
1247          * get 0 back (in the case of ls).  it's also how much has been read, but it
1248          * isn't how much the f_pos has moved (which is opaque to the VFS). */
1249         return amt_copied;
1250 }
1251
1252 /* Opens the file, using permissions from current for lack of a better option.
1253  * It will attempt to create the file if it does not exist and O_CREAT is
1254  * specified.  This will return 0 on failure, and set errno.  TODO: There's some
1255  * stuff that we don't do, esp related file truncating/creation.  flags are for
1256  * opening, the mode is for creating.  The flags related to how to create
1257  * (O_CREAT_FLAGS) are handled in this function, not in create_file().
1258  *
1259  * It's tempting to split this into a do_file_create and a do_file_open, based
1260  * on the O_CREAT flag, but the O_CREAT flag can be ignored if the file exists
1261  * already and O_EXCL isn't specified.  We could have open call create if it
1262  * fails, but for now we'll keep it as is. */
1263 struct file *do_file_open(char *path, int flags, int mode)
1264 {
1265         struct file *file = 0;
1266         struct dentry *file_d;
1267         struct inode *parent_i;
1268         struct nameidata nd_r = {0}, *nd = &nd_r;
1269         int error;
1270
1271         /* The file might exist, lets try to just open it right away */
1272         nd->intent = LOOKUP_OPEN;
1273         error = path_lookup(path, LOOKUP_FOLLOW, nd);
1274         if (!error) {
1275                 /* Still need to make sure we didn't want to O_EXCL create */
1276                 if ((flags & O_CREAT) && (flags & O_EXCL)) {
1277                         set_errno(EEXIST);
1278                         goto out_path_only;
1279                 }
1280                 file_d = nd->dentry;
1281                 kref_get(&file_d->d_kref, 1);
1282                 goto open_the_file;
1283         }
1284         /* So it didn't already exist, release the path from the previous lookup,
1285          * and then we try to create it. */
1286         path_release(nd);       
1287         /* get the parent, following links.  this means you get the parent of the
1288          * final link (which may not be in 'path' in the first place. */
1289         nd->intent = LOOKUP_CREATE;
1290         error = path_lookup(path, LOOKUP_PARENT | LOOKUP_FOLLOW, nd);
1291         if (error) {
1292                 set_errno(-error);
1293                 goto out_path_only;
1294         }
1295         /* see if the target is there (shouldn't be), and handle accordingly */
1296         file_d = do_lookup(nd->dentry, nd->last.name); 
1297         if (!file_d) {
1298                 if (!(flags & O_CREAT)) {
1299                         set_errno(ENOENT);
1300                         goto out_path_only;
1301                 }
1302                 /* Create the inode/file.  get a fresh dentry too: */
1303                 file_d = get_dentry(nd->dentry->d_sb, nd->dentry, nd->last.name);
1304                 parent_i = nd->dentry->d_inode;
1305                 /* Note that the mode technically should only apply to future opens,
1306                  * but we apply it immediately. */
1307                 if (create_file(parent_i, file_d, mode))        /* sets errno */
1308                         goto out_file_d;
1309                 dcache_put(file_d->d_sb, file_d);
1310         } else {        /* something already exists */
1311                 /* this can happen due to concurrent access, but needs to be thought
1312                  * through */
1313                 panic("File shouldn't be here!");
1314                 if ((flags & O_CREAT) && (flags & O_EXCL)) {
1315                         /* wanted to create, not open, bail out */
1316                         set_errno(EEXIST);
1317                         goto out_file_d;
1318                 }
1319         }
1320 open_the_file:
1321         /* now open the file (freshly created or if it already existed).  At this
1322          * point, file_d is a refcnt'd dentry, regardless of which branch we took.*/
1323         if (flags & O_TRUNC)
1324                 warn("File truncation not supported yet.");
1325         file = dentry_open(file_d, flags);                              /* sets errno */
1326         /* Note the fall through to the exit paths.  File is 0 by default and if
1327          * dentry_open fails. */
1328 out_file_d:
1329         kref_put(&file_d->d_kref);
1330 out_path_only:
1331         path_release(nd);
1332         return file;
1333 }
1334
1335 /* Path is the location of the symlink, sometimes called the "new path", and
1336  * symname is who we link to, sometimes called the "old path". */
1337 int do_symlink(char *path, const char *symname, int mode)
1338 {
1339         struct dentry *sym_d;
1340         struct inode *parent_i;
1341         struct nameidata nd_r = {0}, *nd = &nd_r;
1342         int error;
1343         int retval = -1;
1344
1345         nd->intent = LOOKUP_CREATE;
1346         /* get the parent, but don't follow links */
1347         error = path_lookup(path, LOOKUP_PARENT, nd);
1348         if (error) {
1349                 set_errno(-error);
1350                 goto out_path_only;
1351         }
1352         /* see if the target is already there, handle accordingly */
1353         sym_d = do_lookup(nd->dentry, nd->last.name); 
1354         if (sym_d) {
1355                 set_errno(EEXIST);
1356                 goto out_sym_d;
1357         }
1358         /* Doesn't already exist, let's try to make it: */
1359         sym_d = get_dentry(nd->dentry->d_sb, nd->dentry, nd->last.name);
1360         if (!sym_d) {
1361                 set_errno(ENOMEM);
1362                 goto out_path_only;
1363         }
1364         parent_i = nd->dentry->d_inode;
1365         if (create_symlink(parent_i, sym_d, symname, mode))
1366                 goto out_sym_d;
1367         dcache_put(sym_d->d_sb, sym_d);
1368         retval = 0;                             /* Note the fall through to the exit paths */
1369 out_sym_d:
1370         kref_put(&sym_d->d_kref);
1371 out_path_only:
1372         path_release(nd);
1373         return retval;
1374 }
1375
1376 /* Makes a hard link for the file behind old_path to new_path */
1377 int do_link(char *old_path, char *new_path)
1378 {
1379         struct dentry *link_d, *old_d;
1380         struct inode *inode, *parent_dir;
1381         struct nameidata nd_r = {0}, *nd = &nd_r;
1382         int error;
1383         int retval = -1;
1384
1385         nd->intent = LOOKUP_CREATE;
1386         /* get the absolute parent of the new_path */
1387         error = path_lookup(new_path, LOOKUP_PARENT | LOOKUP_FOLLOW, nd);
1388         if (error) {
1389                 set_errno(-error);
1390                 goto out_path_only;
1391         }
1392         parent_dir = nd->dentry->d_inode;
1393         /* see if the new target is already there, handle accordingly */
1394         link_d = do_lookup(nd->dentry, nd->last.name); 
1395         if (link_d) {
1396                 set_errno(EEXIST);
1397                 goto out_link_d;
1398         }
1399         /* Doesn't already exist, let's try to make it.  Still need to stitch it to
1400          * an inode and set its FS-specific stuff after this.*/
1401         link_d = get_dentry(nd->dentry->d_sb, nd->dentry, nd->last.name);
1402         if (!link_d) {
1403                 set_errno(ENOMEM);
1404                 goto out_path_only;
1405         }
1406         /* Now let's get the old_path target */
1407         old_d = lookup_dentry(old_path, LOOKUP_FOLLOW);
1408         if (!old_d)                                     /* errno set by lookup_dentry */
1409                 goto out_link_d;
1410         /* For now, can only link to files */
1411         if (!S_ISREG(old_d->d_inode->i_mode)) {
1412                 set_errno(EPERM);
1413                 goto out_both_ds;
1414         }
1415         /* Must be on the same FS */
1416         if (old_d->d_sb != link_d->d_sb) {
1417                 set_errno(EXDEV);
1418                 goto out_both_ds;
1419         }
1420         /* Do whatever FS specific stuff there is first (which is also a chance to
1421          * bail out). */
1422         error = parent_dir->i_op->link(old_d, parent_dir, link_d);
1423         if (error) {
1424                 set_errno(-error);
1425                 goto out_both_ds;
1426         }
1427         /* Finally stitch it up */
1428         inode = old_d->d_inode;
1429         kref_get(&inode->i_kref, 1);
1430         link_d->d_inode = inode;
1431         inode->i_nlink++;
1432         TAILQ_INSERT_TAIL(&inode->i_dentry, link_d, d_alias);   /* weak ref */
1433         dcache_put(link_d->d_sb, link_d);
1434         retval = 0;                             /* Note the fall through to the exit paths */
1435 out_both_ds:
1436         kref_put(&old_d->d_kref);
1437 out_link_d:
1438         kref_put(&link_d->d_kref);
1439 out_path_only:
1440         path_release(nd);
1441         return retval;
1442 }
1443
1444 /* Unlinks path from the directory tree.  Read the Documentation for more info.
1445  */
1446 int do_unlink(char *path)
1447 {
1448         struct dentry *dentry;
1449         struct inode *parent_dir;
1450         struct nameidata nd_r = {0}, *nd = &nd_r;
1451         int error;
1452         int retval = -1;
1453
1454         /* get the parent of the target, and don't follow a final link */
1455         error = path_lookup(path, LOOKUP_PARENT, nd);
1456         if (error) {
1457                 set_errno(-error);
1458                 goto out_path_only;
1459         }
1460         parent_dir = nd->dentry->d_inode;
1461         /* make sure the target is there */
1462         dentry = do_lookup(nd->dentry, nd->last.name); 
1463         if (!dentry) {
1464                 set_errno(ENOENT);
1465                 goto out_path_only;
1466         }
1467         /* Make sure the target is not a directory */
1468         if (S_ISDIR(dentry->d_inode->i_mode)) {
1469                 set_errno(EISDIR);
1470                 goto out_dentry;
1471         }
1472         /* Remove the dentry from its parent */
1473         error = parent_dir->i_op->unlink(parent_dir, dentry);
1474         if (error) {
1475                 set_errno(-error);
1476                 goto out_dentry;
1477         }
1478         /* Now that our parent doesn't track us, we need to make sure we aren't
1479          * findable via the dentry cache.  DYING, so we will be freed in
1480          * dentry_release() */
1481         dentry->d_flags |= DENTRY_DYING;
1482         dcache_remove(dentry->d_sb, dentry);
1483         dentry->d_inode->i_nlink--;     /* TODO: race here, esp with a decref */
1484         /* At this point, the dentry is unlinked from the FS, and the inode has one
1485          * less link.  When the in-memory objects (dentry, inode) are going to be
1486          * released (after all open files are closed, and maybe after entries are
1487          * evicted from the cache), then nlinks will get checked and the FS-file
1488          * will get removed from the disk */
1489         retval = 0;                             /* Note the fall through to the exit paths */
1490 out_dentry:
1491         kref_put(&dentry->d_kref);
1492 out_path_only:
1493         path_release(nd);
1494         return retval;
1495 }
1496
1497 /* Checks to see if path can be accessed via mode.  Need to actually send the
1498  * mode along somehow, so this doesn't do much now.  This is an example of
1499  * decent error propagation from the lower levels via int retvals. */
1500 int do_access(char *path, int mode)
1501 {
1502         struct nameidata nd_r = {0}, *nd = &nd_r;
1503         int retval = 0;
1504         nd->intent = LOOKUP_ACCESS;
1505         retval = path_lookup(path, 0, nd);
1506         path_release(nd);       
1507         return retval;
1508 }
1509
1510 int do_chmod(char *path, int mode)
1511 {
1512         struct nameidata nd_r = {0}, *nd = &nd_r;
1513         int retval = 0;
1514         retval = path_lookup(path, 0, nd);
1515         if (!retval) {
1516                 #if 0
1517                 /* TODO: when we have notions of uid, check for the proc's uid */
1518                 if (nd->dentry->d_inode->i_uid != UID_OF_ME)
1519                         retval = -EPERM;
1520                 else
1521                 #endif
1522                         nd->dentry->d_inode->i_mode |= mode & S_PMASK;
1523         }
1524         path_release(nd);       
1525         return retval;
1526 }
1527
1528 /* Make a directory at path with mode.  Returns -1 and sets errno on errors */
1529 int do_mkdir(char *path, int mode)
1530 {
1531         struct dentry *dentry;
1532         struct inode *parent_i;
1533         struct nameidata nd_r = {0}, *nd = &nd_r;
1534         int error;
1535         int retval = -1;
1536
1537         nd->intent = LOOKUP_CREATE;
1538         /* get the parent, but don't follow links */
1539         error = path_lookup(path, LOOKUP_PARENT, nd);
1540         if (error) {
1541                 set_errno(-error);
1542                 goto out_path_only;
1543         }
1544         /* see if the target is already there, handle accordingly */
1545         dentry = do_lookup(nd->dentry, nd->last.name); 
1546         if (dentry) {
1547                 set_errno(EEXIST);
1548                 goto out_dentry;
1549         }
1550         /* Doesn't already exist, let's try to make it: */
1551         dentry = get_dentry(nd->dentry->d_sb, nd->dentry, nd->last.name);
1552         if (!dentry) {
1553                 set_errno(ENOMEM);
1554                 goto out_path_only;
1555         }
1556         parent_i = nd->dentry->d_inode;
1557         if (create_dir(parent_i, dentry, mode))
1558                 goto out_dentry;
1559         dcache_put(dentry->d_sb, dentry);
1560         retval = 0;                             /* Note the fall through to the exit paths */
1561 out_dentry:
1562         kref_put(&dentry->d_kref);
1563 out_path_only:
1564         path_release(nd);
1565         return retval;
1566 }
1567
1568 int do_rmdir(char *path)
1569 {
1570         struct dentry *dentry;
1571         struct inode *parent_i;
1572         struct nameidata nd_r = {0}, *nd = &nd_r;
1573         int error;
1574         int retval = -1;
1575
1576         /* get the parent, following links (probably want this), and we must get a
1577          * directory.  Note, current versions of path_lookup can't handle both
1578          * PARENT and DIRECTORY, at least, it doesn't check that *path is a
1579          * directory. */
1580         error = path_lookup(path, LOOKUP_PARENT | LOOKUP_FOLLOW | LOOKUP_DIRECTORY,
1581                             nd);
1582         if (error) {
1583                 set_errno(-error);
1584                 goto out_path_only;
1585         }
1586         /* make sure the target is already there, handle accordingly */
1587         dentry = do_lookup(nd->dentry, nd->last.name); 
1588         if (!dentry) {
1589                 set_errno(ENOENT);
1590                 goto out_path_only;
1591         }
1592         if (!S_ISDIR(dentry->d_inode->i_mode)) {
1593                 set_errno(ENOTDIR);
1594                 goto out_dentry;
1595         }
1596         if (dentry->d_mount_point) {
1597                 set_errno(EBUSY);
1598                 goto out_dentry;
1599         }
1600         /* TODO: make sure we aren't a mount or processes root (EBUSY) */
1601         /* Now for the removal.  the FSs will check if they are empty */
1602         parent_i = nd->dentry->d_inode;
1603         error = parent_i->i_op->rmdir(parent_i, dentry);
1604         if (error < 0) {
1605                 set_errno(-error);
1606                 goto out_dentry;
1607         }
1608         /* Now that our parent doesn't track us, we need to make sure we aren't
1609          * findable via the dentry cache.  DYING, so we will be freed in
1610          * dentry_release() */
1611         dentry->d_flags |= DENTRY_DYING;
1612         dcache_remove(dentry->d_sb, dentry);
1613         /* Decref ourselves, so inode_release() knows we are done */
1614         dentry->d_inode->i_nlink--;
1615         TAILQ_REMOVE(&nd->dentry->d_subdirs, dentry, d_subdirs_link);
1616         parent_i->i_nlink--;            /* TODO: race on this, esp since its a decref */
1617         /* we still have d_parent and a kref on our parent, which will go away when
1618          * the in-memory dentry object goes away. */
1619         retval = 0;                             /* Note the fall through to the exit paths */
1620 out_dentry:
1621         kref_put(&dentry->d_kref);
1622 out_path_only:
1623         path_release(nd);
1624         return retval;
1625 }
1626
1627 /* Opens and returns the file specified by dentry */
1628 struct file *dentry_open(struct dentry *dentry, int flags)
1629 {
1630         struct inode *inode;
1631         int desired_mode;
1632         struct file *file = kmem_cache_alloc(file_kcache, 0);
1633         if (!file) {
1634                 set_errno(ENOMEM);
1635                 return 0;
1636         }
1637         inode = dentry->d_inode;
1638         /* Do the mode first, since we can still error out.  f_mode stores how the
1639          * OS file is open, which can be more restrictive than the i_mode */
1640         switch (flags & (O_RDONLY | O_WRONLY | O_RDWR)) {
1641                 case O_RDONLY:
1642                         desired_mode = S_IRUSR;
1643                         break;
1644                 case O_WRONLY:
1645                         desired_mode = S_IWUSR;
1646                         break;
1647                 case O_RDWR:
1648                         desired_mode = S_IRUSR | S_IWUSR;
1649                         break;
1650                 default:
1651                         goto error_access;
1652         }
1653         if (check_perms(inode, desired_mode))
1654                 goto error_access;
1655         file->f_mode = desired_mode;
1656         /* one for the ref passed out, and *none* for the sb TAILQ */
1657         kref_init(&file->f_kref, file_release, 1);
1658         /* Add to the list of all files of this SB */
1659         TAILQ_INSERT_TAIL(&inode->i_sb->s_files, file, f_list);
1660         kref_get(&dentry->d_kref, 1);
1661         file->f_dentry = dentry;
1662         kref_get(&inode->i_sb->s_mount->mnt_kref, 1);
1663         file->f_vfsmnt = inode->i_sb->s_mount;          /* saving a ref to the vmnt...*/
1664         file->f_op = inode->i_fop;
1665         /* Don't store open mode or creation flags */
1666         file->f_flags = flags & ~(O_ACCMODE | O_CREAT_FLAGS);
1667         file->f_pos = 0;
1668         file->f_uid = inode->i_uid;
1669         file->f_gid = inode->i_gid;
1670         file->f_error = 0;
1671 //      struct event_poll_tailq         f_ep_links;
1672         spinlock_init(&file->f_ep_lock);
1673         file->f_fs_info = 0;                                            /* prob overriden by the fs */
1674         file->f_mapping = inode->i_mapping;
1675         file->f_op->open(inode, file);
1676         return file;
1677 error_access:
1678         set_errno(EACCES);
1679         kmem_cache_free(file_kcache, file);
1680         return 0;
1681 }
1682
1683 /* Closes a file, fsync, whatever else is necessary.  Called when the kref hits
1684  * 0.  Note that the file is not refcounted on the s_files list, nor is the
1685  * f_mapping refcounted (it is pinned by the i_mapping). */
1686 void file_release(struct kref *kref)
1687 {
1688         struct file *file = container_of(kref, struct file, f_kref);
1689
1690         struct super_block *sb = file->f_dentry->d_sb;
1691         spin_lock(&sb->s_lock);
1692         TAILQ_REMOVE(&sb->s_files, file, f_list);
1693         spin_unlock(&sb->s_lock);
1694
1695         /* TODO: fsync (BLK).  also, we may want to parallelize the blocking that
1696          * could happen in here (spawn kernel threads)... */
1697         file->f_op->release(file->f_dentry->d_inode, file);
1698         /* Clean up the other refs we hold */
1699         kref_put(&file->f_dentry->d_kref);
1700         kref_put(&file->f_vfsmnt->mnt_kref);
1701         kmem_cache_free(file_kcache, file);
1702 }
1703
1704 /* Makes sure the index'th page from file is loaded in the page cache and
1705  * returns its location via **pp.  Note this will give you a refcnt'd reference.
1706  * This may block! TODO: (BLK) */
1707 int file_load_page(struct file *file, unsigned long index, struct page **pp)
1708 {
1709         struct page_map *pm = file->f_mapping;
1710         struct page *page;
1711         int error;
1712         bool page_was_mapped = TRUE;
1713
1714         page = pm_find_page(pm, index);
1715         while (!page) {
1716                 /* kpage_alloc, since we want the page to persist after the proc
1717                  * dies (can be used by others, until the inode shuts down). */
1718                 if (kpage_alloc(&page))
1719                         return -ENOMEM;
1720                 /* might want to initialize other things, perhaps in page_alloc() */
1721                 page->pg_flags = 0;
1722                 error = pm_insert_page(pm, index, page);
1723                 switch (error) {
1724                         case 0:
1725                                 page_was_mapped = FALSE;
1726                                 break;
1727                         case -EEXIST:
1728                                 /* the page was mapped already (benign race), just get rid of
1729                                  * our page and try again (the only case that uses the while) */
1730                                 page_decref(page);
1731                                 page = pm_find_page(pm, index);
1732                                 break;
1733                         default:
1734                                 /* something is wrong, bail out! */
1735                                 page_decref(page);
1736                                 return error;
1737                 }
1738         }
1739         /* At this point, page is a refcnt'd page, and we return the reference.
1740          * Also, there's an unlikely race where we're not in the page cache anymore,
1741          * and this all is useless work. */
1742         *pp = page;
1743         /* if the page was in the map, we need to do some checks, and might have to
1744          * read in the page later.  If the page was freshly inserted to the pm by
1745          * us, we skip this since we are the one doing the readpage(). */
1746         if (page_was_mapped) {
1747                 /* is it already here and up to date?  if so, we're done */
1748                 if (page->pg_flags & PG_UPTODATE)
1749                         return 0;
1750                 /* if not, try to lock the page (could BLOCK) */
1751                 lock_page(page);
1752                 /* we got it, is our page still in the cache?  check the mapping.  if
1753                  * not, start over, perhaps with EAGAIN and outside support */
1754                 if (!page->pg_mapping)
1755                         panic("Page is not in the mapping!  Haven't implemented this!");
1756                 /* double check, are we up to date?  if so, we're done */
1757                 if (page->pg_flags & PG_UPTODATE) {
1758                         unlock_page(page);
1759                         return 0;
1760                 }
1761         }
1762         /* if we're here, the page is locked by us, and it needs to be read in */
1763         assert(page->pg_mapping == pm);
1764         error = pm->pm_op->readpage(pm, page);
1765         assert(!error);
1766         /* Try to sleep on the IO.  The page will be unlocked when the IO is done */
1767         lock_page(page);
1768         unlock_page(page);
1769         assert(page->pg_flags & PG_UPTODATE);
1770         return 0;
1771 }
1772
1773 /* Process-related File management functions */
1774
1775 /* Given any FD, get the appropriate file, 0 o/w */
1776 struct file *get_file_from_fd(struct files_struct *open_files, int file_desc)
1777 {
1778         struct file *retval = 0;
1779         if (file_desc < 0)
1780                 return 0;
1781         spin_lock(&open_files->lock);
1782         if (file_desc < open_files->max_fdset) {
1783                 if (GET_BITMASK_BIT(open_files->open_fds->fds_bits, file_desc)) {
1784                         /* while max_files and max_fdset might not line up, we should never
1785                          * have a valid fdset higher than files */
1786                         assert(file_desc < open_files->max_files);
1787                         retval = open_files->fd[file_desc];
1788                         assert(retval);
1789                         kref_get(&retval->f_kref, 1);
1790                 }
1791         }
1792         spin_unlock(&open_files->lock);
1793         return retval;
1794 }
1795
1796 /* Remove FD from the open files, if it was there, and return f.  Currently,
1797  * this decref's f, so the return value is not consumable or even usable.  This
1798  * hasn't been thought through yet. */
1799 struct file *put_file_from_fd(struct files_struct *open_files, int file_desc)
1800 {
1801         struct file *file = 0;
1802         if (file_desc < 0)
1803                 return 0;
1804         spin_lock(&open_files->lock);
1805         if (file_desc < open_files->max_fdset) {
1806                 if (GET_BITMASK_BIT(open_files->open_fds->fds_bits, file_desc)) {
1807                         /* while max_files and max_fdset might not line up, we should never
1808                          * have a valid fdset higher than files */
1809                         assert(file_desc < open_files->max_files);
1810                         file = open_files->fd[file_desc];
1811                         open_files->fd[file_desc] = 0;
1812                         assert(file);
1813                         kref_put(&file->f_kref);
1814                         CLR_BITMASK_BIT(open_files->open_fds->fds_bits, file_desc);
1815                 }
1816         }
1817         spin_unlock(&open_files->lock);
1818         return file;
1819 }
1820
1821 /* Inserts the file in the files_struct, returning the corresponding new file
1822  * descriptor, or an error code.  We start looking for open fds from low_fd. */
1823 int insert_file(struct files_struct *open_files, struct file *file, int low_fd)
1824 {
1825         int slot = -1;
1826         if ((low_fd < 0) || (low_fd > NR_FILE_DESC_MAX))
1827                 return -EINVAL;
1828         spin_lock(&open_files->lock);
1829         for (int i = low_fd; i < open_files->max_fdset; i++) {
1830                 if (GET_BITMASK_BIT(open_files->open_fds->fds_bits, i))
1831                         continue;
1832                 slot = i;
1833                 SET_BITMASK_BIT(open_files->open_fds->fds_bits, slot);
1834                 assert(slot < open_files->max_files && open_files->fd[slot] == 0);
1835                 kref_get(&file->f_kref, 1);
1836                 open_files->fd[slot] = file;
1837                 if (slot >= open_files->next_fd)
1838                         open_files->next_fd = slot + 1;
1839                 break;
1840         }
1841         if (slot == -1) /* should expand the FD array and fd_set */
1842                 warn("Ran out of file descriptors, deal with me!");
1843         spin_unlock(&open_files->lock);
1844         return slot;
1845 }
1846
1847 /* Closes all open files.  Mostly just a "put" for all files.  If cloexec, it
1848  * will only close files that are opened with O_CLOEXEC. */
1849 void close_all_files(struct files_struct *open_files, bool cloexec)
1850 {
1851         struct file *file;
1852         spin_lock(&open_files->lock);
1853         for (int i = 0; i < open_files->max_fdset; i++) {
1854                 if (GET_BITMASK_BIT(open_files->open_fds->fds_bits, i)) {
1855                         /* while max_files and max_fdset might not line up, we should never
1856                          * have a valid fdset higher than files */
1857                         assert(i < open_files->max_files);
1858                         file = open_files->fd[i];
1859                         if (cloexec && !(file->f_flags & O_CLOEXEC))
1860                                 continue;
1861                         /* Actually close the file */
1862                         open_files->fd[i] = 0;
1863                         assert(file);
1864                         kref_put(&file->f_kref);
1865                         CLR_BITMASK_BIT(open_files->open_fds->fds_bits, i);
1866                 }
1867         }
1868         spin_unlock(&open_files->lock);
1869 }
1870
1871 /* Inserts all of the files from src into dst, used by sys_fork(). */
1872 void clone_files(struct files_struct *src, struct files_struct *dst)
1873 {
1874         struct file *file;
1875         spin_lock(&src->lock);
1876         spin_lock(&dst->lock);
1877         for (int i = 0; i < src->max_fdset; i++) {
1878                 if (GET_BITMASK_BIT(src->open_fds->fds_bits, i)) {
1879                         /* while max_files and max_fdset might not line up, we should never
1880                          * have a valid fdset higher than files */
1881                         assert(i < src->max_files);
1882                         file = src->fd[i];
1883                         assert(i < dst->max_files && dst->fd[i] == 0);
1884                         SET_BITMASK_BIT(dst->open_fds->fds_bits, i);
1885                         dst->fd[i] = file;
1886                         assert(file);
1887                         kref_get(&file->f_kref, 1);
1888                         if (i >= dst->next_fd)
1889                                 dst->next_fd = i + 1;
1890                 }
1891         }
1892         spin_unlock(&dst->lock);
1893         spin_unlock(&src->lock);
1894 }
1895
1896 /* Change the working directory of the given fs env (one per process, at this
1897  * point).  Returns 0 for success, -ERROR for whatever error. */
1898 int do_chdir(struct fs_struct *fs_env, char *path)
1899 {
1900         struct nameidata nd_r = {0}, *nd = &nd_r;
1901         int retval;
1902         retval = path_lookup(path, LOOKUP_DIRECTORY, nd);
1903         if (!retval) {
1904                 /* nd->dentry is the place we want our PWD to be */
1905                 kref_get(&nd->dentry->d_kref, 1);
1906                 kref_put(&fs_env->pwd->d_kref);
1907                 fs_env->pwd = nd->dentry;
1908         }
1909         path_release(nd);
1910         return retval;
1911 }
1912
1913 /* Returns a null-terminated string of up to length cwd_l containing the
1914  * absolute path of fs_env, (up to fs_env's root).  Be sure to kfree the char*
1915  * "kfree_this" when you are done with it.  We do this since it's easier to
1916  * build this string going backwards.  Note cwd_l is not a strlen, it's an
1917  * absolute size. */
1918 char *do_getcwd(struct fs_struct *fs_env, char **kfree_this, size_t cwd_l)
1919 {
1920         struct dentry *dentry = fs_env->pwd;
1921         size_t link_len;
1922         char *path_start, *kbuf;
1923
1924         if (cwd_l < 2) {
1925                 set_errno(ERANGE);
1926                 return 0;
1927         }
1928         kbuf = kmalloc(cwd_l, 0);
1929         if (!kbuf) {
1930                 set_errno(ENOMEM);
1931                 return 0;
1932         }
1933         *kfree_this = kbuf;
1934         kbuf[cwd_l - 1] = '\0';
1935         kbuf[cwd_l - 2] = '/';
1936         /* for each dentry in the path, all the way back to the root of fs_env, we
1937          * grab the dentry name, push path_start back enough, and write in the name,
1938          * using /'s to terminate.  We skip the root, since we don't want it's
1939          * actual name, just "/", which is set before each loop. */
1940         path_start = kbuf + cwd_l - 2;  /* the last byte written */
1941         while (dentry != fs_env->root) {
1942                 link_len = dentry->d_name.len;          /* this does not count the \0 */
1943                 if (path_start - (link_len + 2) < kbuf) {
1944                         kfree(kbuf);
1945                         set_errno(ERANGE);
1946                         return 0;
1947                 }
1948                 path_start -= link_len + 1;     /* the 1 is for the \0 */
1949                 strncpy(path_start, dentry->d_name.name, link_len);
1950                 path_start--;
1951                 *path_start = '/';
1952                 dentry = dentry->d_parent;      
1953         }
1954         return path_start;
1955 }
1956
1957 static void print_dir(struct dentry *dentry, char *buf, int depth)
1958 {
1959         struct dentry *child_d;
1960         struct dirent next = {0};
1961         struct file *dir;
1962         int retval;
1963
1964         if (!S_ISDIR(dentry->d_inode->i_mode)) {
1965                 warn("Thought this was only directories!!");
1966                 return;
1967         }
1968         /* Print this dentry */
1969         printk("%s%s/ nlink: %d\n", buf, dentry->d_name.name,
1970                dentry->d_inode->i_nlink);
1971         if (dentry->d_mount_point) {
1972                 dentry = dentry->d_mounted_fs->mnt_root;
1973         }
1974         if (depth >= 32)
1975                 return;
1976         /* Set buffer for our kids */
1977         buf[depth] = '\t';
1978         dir = dentry_open(dentry, 0);
1979         if (!dir)
1980                 panic("Filesystem seems inconsistent - unable to open a dir!");
1981         /* Process every child, recursing on directories */
1982         while (1) {
1983                 retval = dir->f_op->readdir(dir, &next);
1984                 if (retval >= 0) {
1985                         /* Skip .., ., and empty entries */
1986                         if (!strcmp("..", next.d_name) || !strcmp(".", next.d_name) ||
1987                             next.d_ino == 0)
1988                                 goto loop_next;
1989                         /* there is an entry, now get its dentry */
1990                         child_d = do_lookup(dentry, next.d_name);
1991                         if (!child_d)
1992                                 panic("Inconsistent FS, dirent doesn't have a dentry!");
1993                         /* Recurse for directories, or just print the name for others */
1994                         switch (child_d->d_inode->i_mode & __S_IFMT) {
1995                                 case (__S_IFDIR):
1996                                         print_dir(child_d, buf, depth + 1);
1997                                         break;
1998                                 case (__S_IFREG):
1999                                         printk("%s%s size(B): %d nlink: %d\n", buf, next.d_name,
2000                                                child_d->d_inode->i_size, child_d->d_inode->i_nlink);
2001                                         break;
2002                                 case (__S_IFLNK):
2003                                         printk("%s%s -> %s\n", buf, next.d_name,
2004                                                child_d->d_inode->i_op->readlink(child_d));
2005                                         break;
2006                                 case (__S_IFCHR):
2007                                         printk("%s%s (char device) nlink: %d\n", buf, next.d_name,
2008                                                child_d->d_inode->i_nlink);
2009                                         break;
2010                                 case (__S_IFBLK):
2011                                         printk("%s%s (block device) nlink: %d\n", buf, next.d_name,
2012                                                child_d->d_inode->i_nlink);
2013                                         break;
2014                                 default:
2015                                         warn("Look around you!  Unknown filetype!");
2016                         }
2017                         kref_put(&child_d->d_kref);     
2018                 }
2019 loop_next:
2020                 if (retval <= 0)
2021                         break;
2022         }
2023         /* Reset buffer to the way it was */
2024         buf[depth] = '\0';
2025         kref_put(&dir->f_kref);
2026 }
2027
2028 /* Debugging */
2029 int ls_dash_r(char *path)
2030 {
2031         struct nameidata nd_r = {0}, *nd = &nd_r;
2032         int error;
2033         char buf[32] = {0};
2034
2035         error = path_lookup(path, LOOKUP_ACCESS | LOOKUP_DIRECTORY, nd);
2036         if (error) {
2037                 path_release(nd);
2038                 return error;
2039         }
2040         print_dir(nd->dentry, buf, 0);
2041         path_release(nd);
2042         return 0;
2043 }