Merge tag 'devicetree-for-linus' of git://git.secretlab.ca/git/linux
[deliverable/linux.git] / fs / coda / dir.c
CommitLineData
1da177e4
LT
1
2/*
3 * Directory operations for Coda filesystem
4 * Original version: (C) 1996 P. Braam and M. Callahan
5 * Rewritten for Linux 2.1. (C) 1997 Carnegie Mellon University
6 *
7 * Carnegie Mellon encourages users to contribute improvements to
8 * the Coda project. Contact Peter Braam (coda@cs.cmu.edu).
9 */
10
11#include <linux/types.h>
12#include <linux/kernel.h>
13#include <linux/time.h>
14#include <linux/fs.h>
5a0e3ad6 15#include <linux/slab.h>
1da177e4
LT
16#include <linux/file.h>
17#include <linux/stat.h>
18#include <linux/errno.h>
19#include <linux/string.h>
b5ce1d83 20#include <linux/spinlock.h>
34286d66 21#include <linux/namei.h>
1da177e4
LT
22
23#include <asm/uaccess.h>
24
25#include <linux/coda.h>
1da177e4 26#include <linux/coda_psdev.h>
31a203df
AV
27#include "coda_linux.h"
28#include "coda_cache.h"
1da177e4 29
c98d8cfb
AB
30#include "coda_int.h"
31
1da177e4 32/* dir inode-ops */
ebfc3b49 33static int coda_create(struct inode *dir, struct dentry *new, umode_t mode, bool excl);
00cd8dd3 34static struct dentry *coda_lookup(struct inode *dir, struct dentry *target, unsigned int flags);
1da177e4
LT
35static int coda_link(struct dentry *old_dentry, struct inode *dir_inode,
36 struct dentry *entry);
37static int coda_unlink(struct inode *dir_inode, struct dentry *entry);
38static int coda_symlink(struct inode *dir_inode, struct dentry *entry,
39 const char *symname);
18bb1db3 40static int coda_mkdir(struct inode *dir_inode, struct dentry *entry, umode_t mode);
1da177e4
LT
41static int coda_rmdir(struct inode *dir_inode, struct dentry *entry);
42static int coda_rename(struct inode *old_inode, struct dentry *old_dentry,
43 struct inode *new_inode, struct dentry *new_dentry);
44
45/* dir file-ops */
e924f251 46static int coda_readdir(struct file *file, struct dir_context *ctx);
1da177e4
LT
47
48/* dentry ops */
0b728e19 49static int coda_dentry_revalidate(struct dentry *de, unsigned int flags);
fe15ce44 50static int coda_dentry_delete(const struct dentry *);
1da177e4
LT
51
52/* support routines */
e924f251 53static int coda_venus_readdir(struct file *, struct dir_context *);
1da177e4
LT
54
55/* same as fs/bad_inode.c */
56static int coda_return_EIO(void)
57{
58 return -EIO;
59}
60#define CODA_EIO_ERROR ((void *) (coda_return_EIO))
61
9501e4c4 62const struct dentry_operations coda_dentry_operations =
1da177e4
LT
63{
64 .d_revalidate = coda_dentry_revalidate,
65 .d_delete = coda_dentry_delete,
66};
67
754661f1 68const struct inode_operations coda_dir_inode_operations =
1da177e4
LT
69{
70 .create = coda_create,
71 .lookup = coda_lookup,
72 .link = coda_link,
73 .unlink = coda_unlink,
74 .symlink = coda_symlink,
75 .mkdir = coda_mkdir,
76 .rmdir = coda_rmdir,
77 .mknod = CODA_EIO_ERROR,
78 .rename = coda_rename,
79 .permission = coda_permission,
80 .getattr = coda_getattr,
81 .setattr = coda_setattr,
82};
83
4b6f5d20 84const struct file_operations coda_dir_operations = {
1da177e4
LT
85 .llseek = generic_file_llseek,
86 .read = generic_read_dir,
e924f251 87 .iterate = coda_readdir,
1da177e4 88 .open = coda_open,
1da177e4
LT
89 .release = coda_release,
90 .fsync = coda_fsync,
91};
92
93
94/* inode operations for directories */
95/* access routines: lookup, readlink, permission */
00cd8dd3 96static struct dentry *coda_lookup(struct inode *dir, struct dentry *entry, unsigned int flags)
1da177e4 97{
f4947fbc 98 struct super_block *sb = dir->i_sb;
1da177e4
LT
99 const char *name = entry->d_name.name;
100 size_t length = entry->d_name.len;
f4947fbc
AV
101 struct inode *inode;
102 int type = 0;
ed36f723
JH
103
104 if (length > CODA_MAXNAMLEN) {
105 printk(KERN_ERR "name too long: lookup, %s (%*s)\n",
1da177e4
LT
106 coda_i2s(dir), (int)length, name);
107 return ERR_PTR(-ENAMETOOLONG);
108 }
109
ed36f723
JH
110 /* control object, create inode on the fly */
111 if (coda_isroot(dir) && coda_iscontrol(name, length)) {
f4947fbc 112 inode = coda_cnode_makectl(sb);
ed36f723 113 type = CODA_NOCACHE;
f4947fbc
AV
114 } else {
115 struct CodaFid fid = { { 0, } };
116 int error = venus_lookup(sb, coda_i2f(dir), name, length,
117 &type, &fid);
118 inode = !error ? coda_cnode_make(&fid, sb) : ERR_PTR(error);
ed36f723
JH
119 }
120
f4947fbc 121 if (!IS_ERR(inode) && (type & CODA_NOCACHE))
ed36f723
JH
122 coda_flag_inode(inode, C_VATTR | C_PURGE);
123
f4947fbc
AV
124 if (inode == ERR_PTR(-ENOENT))
125 inode = NULL;
126
ed36f723 127 return d_splice_alias(inode, entry);
1da177e4
LT
128}
129
130
10556cb2 131int coda_permission(struct inode *inode, int mask)
1da177e4 132{
f7cc02b8 133 int error;
e6305c43 134
10556cb2 135 if (mask & MAY_NOT_BLOCK)
b74c79e9
NP
136 return -ECHILD;
137
e6305c43 138 mask &= MAY_READ | MAY_WRITE | MAY_EXEC;
1da177e4
LT
139
140 if (!mask)
f7cc02b8 141 return 0;
1da177e4 142
f696a365
MS
143 if ((mask & MAY_EXEC) && !execute_ok(inode))
144 return -EACCES;
145
1da177e4 146 if (coda_cache_check(inode, mask))
f7cc02b8 147 return 0;
1da177e4 148
f7cc02b8 149 error = venus_access(inode->i_sb, coda_i2f(inode), mask);
1da177e4
LT
150
151 if (!error)
152 coda_cache_enter(inode, mask);
153
d728900c 154 return error;
1da177e4
LT
155}
156
157
d728900c 158static inline void coda_dir_update_mtime(struct inode *dir)
1da177e4
LT
159{
160#ifdef REQUERY_VENUS_FOR_MTIME
161 /* invalidate the directory cnode's attributes so we refetch the
162 * attributes from venus next time the inode is referenced */
163 coda_flag_inode(dir, C_VATTR);
164#else
165 /* optimistically we can also act as if our nose bleeds. The
d728900c
JH
166 * granularity of the mtime is coarse anyways so we might actually be
167 * right most of the time. Note: we only do this for directories. */
1da177e4
LT
168 dir->i_mtime = dir->i_ctime = CURRENT_TIME_SEC;
169#endif
d728900c
JH
170}
171
172/* we have to wrap inc_nlink/drop_nlink because sometimes userspace uses a
173 * trick to fool GNU find's optimizations. If we can't be sure of the link
174 * (because of volume mount points) we set i_nlink to 1 which forces find
175 * to consider every child as a possible directory. We should also never
176 * see an increment or decrement for deleted directories where i_nlink == 0 */
177static inline void coda_dir_inc_nlink(struct inode *dir)
178{
179 if (dir->i_nlink >= 2)
180 inc_nlink(dir);
181}
182
183static inline void coda_dir_drop_nlink(struct inode *dir)
184{
185 if (dir->i_nlink > 2)
186 drop_nlink(dir);
1da177e4
LT
187}
188
189/* creation routines: create, mknod, mkdir, link, symlink */
ebfc3b49 190static int coda_create(struct inode *dir, struct dentry *de, umode_t mode, bool excl)
1da177e4 191{
f7cc02b8 192 int error;
1da177e4
LT
193 const char *name=de->d_name.name;
194 int length=de->d_name.len;
195 struct inode *inode;
196 struct CodaFid newfid;
197 struct coda_vattr attrs;
198
f7cc02b8 199 if (coda_isroot(dir) && coda_iscontrol(name, length))
1da177e4 200 return -EPERM;
1da177e4
LT
201
202 error = venus_create(dir->i_sb, coda_i2f(dir), name, length,
203 0, mode, &newfid, &attrs);
f7cc02b8
YA
204 if (error)
205 goto err_out;
1da177e4
LT
206
207 inode = coda_iget(dir->i_sb, &newfid, &attrs);
f7cc02b8
YA
208 if (IS_ERR(inode)) {
209 error = PTR_ERR(inode);
210 goto err_out;
1da177e4
LT
211 }
212
213 /* invalidate the directory cnode's attributes */
d728900c 214 coda_dir_update_mtime(dir);
1da177e4 215 d_instantiate(de, inode);
d728900c 216 return 0;
f7cc02b8
YA
217err_out:
218 d_drop(de);
219 return error;
1da177e4
LT
220}
221
18bb1db3 222static int coda_mkdir(struct inode *dir, struct dentry *de, umode_t mode)
1da177e4
LT
223{
224 struct inode *inode;
225 struct coda_vattr attrs;
226 const char *name = de->d_name.name;
227 int len = de->d_name.len;
228 int error;
229 struct CodaFid newfid;
230
f7cc02b8 231 if (coda_isroot(dir) && coda_iscontrol(name, len))
1da177e4 232 return -EPERM;
1da177e4
LT
233
234 attrs.va_mode = mode;
235 error = venus_mkdir(dir->i_sb, coda_i2f(dir),
236 name, len, &newfid, &attrs);
f7cc02b8
YA
237 if (error)
238 goto err_out;
1da177e4
LT
239
240 inode = coda_iget(dir->i_sb, &newfid, &attrs);
f7cc02b8
YA
241 if (IS_ERR(inode)) {
242 error = PTR_ERR(inode);
243 goto err_out;
1da177e4 244 }
d728900c 245
1da177e4 246 /* invalidate the directory cnode's attributes */
d728900c
JH
247 coda_dir_inc_nlink(dir);
248 coda_dir_update_mtime(dir);
1da177e4 249 d_instantiate(de, inode);
d728900c 250 return 0;
f7cc02b8
YA
251err_out:
252 d_drop(de);
253 return error;
1da177e4
LT
254}
255
256/* try to make de an entry in dir_inodde linked to source_de */
257static int coda_link(struct dentry *source_de, struct inode *dir_inode,
258 struct dentry *de)
259{
260 struct inode *inode = source_de->d_inode;
261 const char * name = de->d_name.name;
262 int len = de->d_name.len;
263 int error;
264
f7cc02b8 265 if (coda_isroot(dir_inode) && coda_iscontrol(name, len))
1da177e4 266 return -EPERM;
1da177e4
LT
267
268 error = venus_link(dir_inode->i_sb, coda_i2f(inode),
269 coda_i2f(dir_inode), (const char *)name, len);
d728900c 270 if (error) {
1da177e4 271 d_drop(de);
f7cc02b8 272 return error;
1da177e4
LT
273 }
274
d728900c 275 coda_dir_update_mtime(dir_inode);
7de9c6ee 276 ihold(inode);
1da177e4 277 d_instantiate(de, inode);
d8c76e6f 278 inc_nlink(inode);
f7cc02b8 279 return 0;
1da177e4
LT
280}
281
282
283static int coda_symlink(struct inode *dir_inode, struct dentry *de,
284 const char *symname)
285{
f7cc02b8 286 const char *name = de->d_name.name;
1da177e4
LT
287 int len = de->d_name.len;
288 int symlen;
f7cc02b8 289 int error;
1da177e4 290
f7cc02b8 291 if (coda_isroot(dir_inode) && coda_iscontrol(name, len))
1da177e4 292 return -EPERM;
1da177e4
LT
293
294 symlen = strlen(symname);
f7cc02b8 295 if (symlen > CODA_MAXPATHLEN)
1da177e4 296 return -ENAMETOOLONG;
1da177e4
LT
297
298 /*
299 * This entry is now negative. Since we do not create
d728900c 300 * an inode for the entry we have to drop it.
1da177e4
LT
301 */
302 d_drop(de);
d728900c 303 error = venus_symlink(dir_inode->i_sb, coda_i2f(dir_inode), name, len,
1da177e4
LT
304 symname, symlen);
305
306 /* mtime is no good anymore */
f7cc02b8 307 if (!error)
d728900c 308 coda_dir_update_mtime(dir_inode);
1da177e4 309
d728900c 310 return error;
1da177e4
LT
311}
312
313/* destruction routines: unlink, rmdir */
9fe76c76 314static int coda_unlink(struct inode *dir, struct dentry *de)
1da177e4
LT
315{
316 int error;
317 const char *name = de->d_name.name;
318 int len = de->d_name.len;
319
d728900c 320 error = venus_remove(dir->i_sb, coda_i2f(dir), name, len);
f7cc02b8 321 if (error)
d728900c 322 return error;
1da177e4 323
d728900c 324 coda_dir_update_mtime(dir);
9a53c3a7 325 drop_nlink(de->d_inode);
d728900c 326 return 0;
1da177e4
LT
327}
328
9fe76c76 329static int coda_rmdir(struct inode *dir, struct dentry *de)
1da177e4
LT
330{
331 const char *name = de->d_name.name;
332 int len = de->d_name.len;
8c6d2152 333 int error;
1da177e4 334
1da177e4 335 error = venus_rmdir(dir->i_sb, coda_i2f(dir), name, len);
8c6d2152
JH
336 if (!error) {
337 /* VFS may delete the child */
338 if (de->d_inode)
6d6b77f1 339 clear_nlink(de->d_inode);
1da177e4 340
8c6d2152
JH
341 /* fix the link count of the parent */
342 coda_dir_drop_nlink(dir);
343 coda_dir_update_mtime(dir);
d728900c 344 }
8c6d2152 345 return error;
1da177e4
LT
346}
347
348/* rename */
d728900c 349static int coda_rename(struct inode *old_dir, struct dentry *old_dentry,
1da177e4
LT
350 struct inode *new_dir, struct dentry *new_dentry)
351{
d728900c
JH
352 const char *old_name = old_dentry->d_name.name;
353 const char *new_name = new_dentry->d_name.name;
1da177e4
LT
354 int old_length = old_dentry->d_name.len;
355 int new_length = new_dentry->d_name.len;
d728900c 356 int error;
1da177e4 357
d728900c
JH
358 error = venus_rename(old_dir->i_sb, coda_i2f(old_dir),
359 coda_i2f(new_dir), old_length, new_length,
1da177e4 360 (const char *) old_name, (const char *)new_name);
f7cc02b8
YA
361 if (!error) {
362 if (new_dentry->d_inode) {
363 if (S_ISDIR(new_dentry->d_inode->i_mode)) {
d728900c
JH
364 coda_dir_drop_nlink(old_dir);
365 coda_dir_inc_nlink(new_dir);
366 }
367 coda_dir_update_mtime(old_dir);
368 coda_dir_update_mtime(new_dir);
1da177e4
LT
369 coda_flag_inode(new_dentry->d_inode, C_VATTR);
370 } else {
371 coda_flag_inode(old_dir, C_VATTR);
372 coda_flag_inode(new_dir, C_VATTR);
d728900c 373 }
1da177e4 374 }
1da177e4
LT
375 return error;
376}
377
378
379/* file operations for directories */
e924f251 380static int coda_readdir(struct file *coda_file, struct dir_context *ctx)
1da177e4 381{
1da177e4
LT
382 struct coda_file_info *cfi;
383 struct file *host_file;
1da177e4
LT
384 int ret;
385
386 cfi = CODA_FTOC(coda_file);
387 BUG_ON(!cfi || cfi->cfi_magic != CODA_MAGIC);
388 host_file = cfi->cfi_container;
389
97875253
JH
390 if (!host_file->f_op)
391 return -ENOTDIR;
392
e924f251 393 if (host_file->f_op->iterate) {
496ad9aa 394 struct inode *host_inode = file_inode(host_file);
bb6f619b
AV
395 mutex_lock(&host_inode->i_mutex);
396 ret = -ENOENT;
397 if (!IS_DEADDIR(host_inode)) {
398 ret = host_file->f_op->iterate(host_file, ctx);
399 file_accessed(host_file);
400 }
401 mutex_unlock(&host_inode->i_mutex);
e924f251
AV
402 return ret;
403 }
404 /* Venus: we must read Venus dirents from a file */
405 return coda_venus_readdir(coda_file, ctx);
1da177e4
LT
406}
407
408static inline unsigned int CDT2DT(unsigned char cdt)
409{
410 unsigned int dt;
411
412 switch(cdt) {
413 case CDT_UNKNOWN: dt = DT_UNKNOWN; break;
414 case CDT_FIFO: dt = DT_FIFO; break;
415 case CDT_CHR: dt = DT_CHR; break;
416 case CDT_DIR: dt = DT_DIR; break;
417 case CDT_BLK: dt = DT_BLK; break;
418 case CDT_REG: dt = DT_REG; break;
419 case CDT_LNK: dt = DT_LNK; break;
420 case CDT_SOCK: dt = DT_SOCK; break;
421 case CDT_WHT: dt = DT_WHT; break;
422 default: dt = DT_UNKNOWN; break;
423 }
424 return dt;
425}
426
427/* support routines */
e924f251 428static int coda_venus_readdir(struct file *coda_file, struct dir_context *ctx)
1da177e4 429{
97875253
JH
430 struct coda_file_info *cfi;
431 struct coda_inode_info *cii;
432 struct file *host_file;
433 struct dentry *de;
1da177e4 434 struct venus_dirent *vdir;
ee60498f 435 unsigned long vdir_size = offsetof(struct venus_dirent, d_name);
1da177e4
LT
436 unsigned int type;
437 struct qstr name;
438 ino_t ino;
97875253
JH
439 int ret;
440
441 cfi = CODA_FTOC(coda_file);
442 BUG_ON(!cfi || cfi->cfi_magic != CODA_MAGIC);
443 host_file = cfi->cfi_container;
444
445 de = coda_file->f_path.dentry;
446 cii = ITOC(de->d_inode);
1da177e4 447
f52720ca 448 vdir = kmalloc(sizeof(*vdir), GFP_KERNEL);
1da177e4
LT
449 if (!vdir) return -ENOMEM;
450
e924f251
AV
451 if (!dir_emit_dots(coda_file, ctx))
452 goto out;
453
1da177e4
LT
454 while (1) {
455 /* read entries from the directory file */
e924f251 456 ret = kernel_read(host_file, ctx->pos - 2, (char *)vdir,
1da177e4
LT
457 sizeof(*vdir));
458 if (ret < 0) {
97875253
JH
459 printk(KERN_ERR "coda readdir: read dir %s failed %d\n",
460 coda_f2s(&cii->c_fid), ret);
1da177e4
LT
461 break;
462 }
463 if (ret == 0) break; /* end of directory file reached */
464
465 /* catch truncated reads */
466 if (ret < vdir_size || ret < vdir_size + vdir->d_namlen) {
97875253
JH
467 printk(KERN_ERR "coda readdir: short read on %s\n",
468 coda_f2s(&cii->c_fid));
1da177e4
LT
469 ret = -EBADF;
470 break;
471 }
472 /* validate whether the directory file actually makes sense */
473 if (vdir->d_reclen < vdir_size + vdir->d_namlen) {
97875253
JH
474 printk(KERN_ERR "coda readdir: invalid dir %s\n",
475 coda_f2s(&cii->c_fid));
1da177e4
LT
476 ret = -EBADF;
477 break;
478 }
479
480 name.len = vdir->d_namlen;
481 name.name = vdir->d_name;
482
483 /* Make sure we skip '.' and '..', we already got those */
484 if (name.name[0] == '.' && (name.len == 1 ||
e924f251 485 (name.name[1] == '.' && name.len == 2)))
1da177e4
LT
486 vdir->d_fileno = name.len = 0;
487
488 /* skip null entries */
489 if (vdir->d_fileno && name.len) {
6b5e1223 490 ino = vdir->d_fileno;
1da177e4 491 type = CDT2DT(vdir->d_type);
e924f251
AV
492 if (!dir_emit(ctx, name.name, name.len, ino, type))
493 break;
1da177e4
LT
494 }
495 /* we'll always have progress because d_reclen is unsigned and
496 * we've already established it is non-zero. */
e924f251 497 ctx->pos += vdir->d_reclen;
97875253 498 }
5f47c7ea 499out:
1da177e4 500 kfree(vdir);
e924f251 501 return 0;
1da177e4
LT
502}
503
504/* called when a cache lookup succeeds */
0b728e19 505static int coda_dentry_revalidate(struct dentry *de, unsigned int flags)
1da177e4 506{
34286d66 507 struct inode *inode;
1da177e4
LT
508 struct coda_inode_info *cii;
509
0b728e19 510 if (flags & LOOKUP_RCU)
34286d66
NP
511 return -ECHILD;
512
513 inode = de->d_inode;
f7cc02b8 514 if (!inode || coda_isroot(inode))
1da177e4
LT
515 goto out;
516 if (is_bad_inode(inode))
517 goto bad;
518
519 cii = ITOC(de->d_inode);
520 if (!(cii->c_flags & (C_PURGE | C_FLUSH)))
521 goto out;
522
523 shrink_dcache_parent(de);
524
525 /* propagate for a flush */
526 if (cii->c_flags & C_FLUSH)
527 coda_flag_inode_children(inode, C_FLUSH);
528
b7ab39f6 529 if (de->d_count > 1)
1da177e4
LT
530 /* pretend it's valid, but don't change the flags */
531 goto out;
532
533 /* clear the flags. */
b5ce1d83 534 spin_lock(&cii->c_lock);
1da177e4 535 cii->c_flags &= ~(C_VATTR | C_PURGE | C_FLUSH);
b5ce1d83 536 spin_unlock(&cii->c_lock);
1da177e4 537bad:
1da177e4
LT
538 return 0;
539out:
1da177e4
LT
540 return 1;
541}
542
543/*
544 * This is the callback from dput() when d_count is going to 0.
545 * We use this to unhash dentries with bad inodes.
546 */
fe15ce44 547static int coda_dentry_delete(const struct dentry * dentry)
1da177e4
LT
548{
549 int flags;
550
551 if (!dentry->d_inode)
552 return 0;
553
554 flags = (ITOC(dentry->d_inode)->c_flags) & C_PURGE;
555 if (is_bad_inode(dentry->d_inode) || flags) {
556 return 1;
557 }
558 return 0;
559}
560
561
562
563/*
564 * This is called when we want to check if the inode has
565 * changed on the server. Coda makes this easy since the
566 * cache manager Venus issues a downcall to the kernel when this
567 * happens
568 */
569int coda_revalidate_inode(struct dentry *dentry)
570{
571 struct coda_vattr attr;
f7cc02b8 572 int error;
1da177e4
LT
573 int old_mode;
574 ino_t old_ino;
575 struct inode *inode = dentry->d_inode;
576 struct coda_inode_info *cii = ITOC(inode);
577
f7cc02b8
YA
578 if (!cii->c_flags)
579 return 0;
1da177e4
LT
580
581 if (cii->c_flags & (C_VATTR | C_PURGE | C_FLUSH)) {
582 error = venus_getattr(inode->i_sb, &(cii->c_fid), &attr);
f7cc02b8
YA
583 if (error)
584 return -EIO;
1da177e4
LT
585
586 /* this inode may be lost if:
587 - it's ino changed
588 - type changes must be permitted for repair and
589 missing mount points.
590 */
591 old_mode = inode->i_mode;
592 old_ino = inode->i_ino;
593 coda_vattr_to_iattr(inode, &attr);
594
595 if ((old_mode & S_IFMT) != (inode->i_mode & S_IFMT)) {
596 printk("Coda: inode %ld, fid %s changed type!\n",
597 inode->i_ino, coda_f2s(&(cii->c_fid)));
598 }
599
600 /* the following can happen when a local fid is replaced
601 with a global one, here we lose and declare the inode bad */
602 if (inode->i_ino != old_ino)
f7cc02b8 603 return -EIO;
1da177e4
LT
604
605 coda_flag_inode_children(inode, C_FLUSH);
b5ce1d83
YA
606
607 spin_lock(&cii->c_lock);
1da177e4 608 cii->c_flags &= ~(C_VATTR | C_PURGE | C_FLUSH);
b5ce1d83 609 spin_unlock(&cii->c_lock);
1da177e4 610 }
1da177e4 611 return 0;
1da177e4 612}
This page took 0.662627 seconds and 5 git commands to generate.