Merge git://git.kernel.org/pub/scm/linux/kernel/git/herbert/crypto-2.6
[deliverable/linux.git] / fs / cifs / cifsfs.c
1 /*
2 * fs/cifs/cifsfs.c
3 *
4 * Copyright (C) International Business Machines Corp., 2002,2008
5 * Author(s): Steve French (sfrench@us.ibm.com)
6 *
7 * Common Internet FileSystem (CIFS) client
8 *
9 * This library is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU Lesser General Public License as published
11 * by the Free Software Foundation; either version 2.1 of the License, or
12 * (at your option) any later version.
13 *
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
17 * the GNU Lesser General Public License for more details.
18 *
19 * You should have received a copy of the GNU Lesser General Public License
20 * along with this library; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22 */
23
24 /* Note that BB means BUGBUG (ie something to fix eventually) */
25
26 #include <linux/module.h>
27 #include <linux/fs.h>
28 #include <linux/mount.h>
29 #include <linux/slab.h>
30 #include <linux/init.h>
31 #include <linux/list.h>
32 #include <linux/seq_file.h>
33 #include <linux/vfs.h>
34 #include <linux/mempool.h>
35 #include <linux/delay.h>
36 #include <linux/kthread.h>
37 #include <linux/freezer.h>
38 #include <linux/namei.h>
39 #include <linux/random.h>
40 #include <net/ipv6.h>
41 #include "cifsfs.h"
42 #include "cifspdu.h"
43 #define DECLARE_GLOBALS_HERE
44 #include "cifsglob.h"
45 #include "cifsproto.h"
46 #include "cifs_debug.h"
47 #include "cifs_fs_sb.h"
48 #include <linux/mm.h>
49 #include <linux/key-type.h>
50 #include "cifs_spnego.h"
51 #include "fscache.h"
52 #ifdef CONFIG_CIFS_SMB2
53 #include "smb2pdu.h"
54 #endif
55
56 int cifsFYI = 0;
57 int traceSMB = 0;
58 bool enable_oplocks = true;
59 unsigned int linuxExtEnabled = 1;
60 unsigned int lookupCacheEnabled = 1;
61 unsigned int global_secflags = CIFSSEC_DEF;
62 /* unsigned int ntlmv2_support = 0; */
63 unsigned int sign_CIFS_PDUs = 1;
64 static const struct super_operations cifs_super_ops;
65 unsigned int CIFSMaxBufSize = CIFS_MAX_MSGSIZE;
66 module_param(CIFSMaxBufSize, uint, 0);
67 MODULE_PARM_DESC(CIFSMaxBufSize, "Network buffer size (not including header). "
68 "Default: 16384 Range: 8192 to 130048");
69 unsigned int cifs_min_rcv = CIFS_MIN_RCV_POOL;
70 module_param(cifs_min_rcv, uint, 0);
71 MODULE_PARM_DESC(cifs_min_rcv, "Network buffers in pool. Default: 4 Range: "
72 "1 to 64");
73 unsigned int cifs_min_small = 30;
74 module_param(cifs_min_small, uint, 0);
75 MODULE_PARM_DESC(cifs_min_small, "Small network buffers in pool. Default: 30 "
76 "Range: 2 to 256");
77 unsigned int cifs_max_pending = CIFS_MAX_REQ;
78 module_param(cifs_max_pending, uint, 0444);
79 MODULE_PARM_DESC(cifs_max_pending, "Simultaneous requests to server. "
80 "Default: 32767 Range: 2 to 32767.");
81 module_param(enable_oplocks, bool, 0644);
82 MODULE_PARM_DESC(enable_oplocks, "Enable or disable oplocks. Default: y/Y/1");
83
84 extern mempool_t *cifs_sm_req_poolp;
85 extern mempool_t *cifs_req_poolp;
86 extern mempool_t *cifs_mid_poolp;
87
88 struct workqueue_struct *cifsiod_wq;
89
90 #ifdef CONFIG_CIFS_SMB2
91 __u8 cifs_client_guid[SMB2_CLIENT_GUID_SIZE];
92 #endif
93
94 /*
95 * Bumps refcount for cifs super block.
96 * Note that it should be only called if a referece to VFS super block is
97 * already held, e.g. in open-type syscalls context. Otherwise it can race with
98 * atomic_dec_and_test in deactivate_locked_super.
99 */
100 void
101 cifs_sb_active(struct super_block *sb)
102 {
103 struct cifs_sb_info *server = CIFS_SB(sb);
104
105 if (atomic_inc_return(&server->active) == 1)
106 atomic_inc(&sb->s_active);
107 }
108
109 void
110 cifs_sb_deactive(struct super_block *sb)
111 {
112 struct cifs_sb_info *server = CIFS_SB(sb);
113
114 if (atomic_dec_and_test(&server->active))
115 deactivate_super(sb);
116 }
117
118 static int
119 cifs_read_super(struct super_block *sb)
120 {
121 struct inode *inode;
122 struct cifs_sb_info *cifs_sb;
123 int rc = 0;
124
125 cifs_sb = CIFS_SB(sb);
126
127 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_POSIXACL)
128 sb->s_flags |= MS_POSIXACL;
129
130 if (cifs_sb_master_tcon(cifs_sb)->ses->capabilities & CAP_LARGE_FILES)
131 sb->s_maxbytes = MAX_LFS_FILESIZE;
132 else
133 sb->s_maxbytes = MAX_NON_LFS;
134
135 /* BB FIXME fix time_gran to be larger for LANMAN sessions */
136 sb->s_time_gran = 100;
137
138 sb->s_magic = CIFS_MAGIC_NUMBER;
139 sb->s_op = &cifs_super_ops;
140 sb->s_bdi = &cifs_sb->bdi;
141 sb->s_blocksize = CIFS_MAX_MSGSIZE;
142 sb->s_blocksize_bits = 14; /* default 2**14 = CIFS_MAX_MSGSIZE */
143 inode = cifs_root_iget(sb);
144
145 if (IS_ERR(inode)) {
146 rc = PTR_ERR(inode);
147 goto out_no_root;
148 }
149
150 sb->s_root = d_make_root(inode);
151 if (!sb->s_root) {
152 rc = -ENOMEM;
153 goto out_no_root;
154 }
155
156 /* do that *after* d_make_root() - we want NULL ->d_op for root here */
157 if (cifs_sb_master_tcon(cifs_sb)->nocase)
158 sb->s_d_op = &cifs_ci_dentry_ops;
159 else
160 sb->s_d_op = &cifs_dentry_ops;
161
162 #ifdef CONFIG_CIFS_NFSD_EXPORT
163 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_SERVER_INUM) {
164 cFYI(1, "export ops supported");
165 sb->s_export_op = &cifs_export_ops;
166 }
167 #endif /* CONFIG_CIFS_NFSD_EXPORT */
168
169 return 0;
170
171 out_no_root:
172 cERROR(1, "cifs_read_super: get root inode failed");
173 return rc;
174 }
175
176 static void cifs_kill_sb(struct super_block *sb)
177 {
178 struct cifs_sb_info *cifs_sb = CIFS_SB(sb);
179 kill_anon_super(sb);
180 cifs_umount(cifs_sb);
181 }
182
183 static int
184 cifs_statfs(struct dentry *dentry, struct kstatfs *buf)
185 {
186 struct super_block *sb = dentry->d_sb;
187 struct cifs_sb_info *cifs_sb = CIFS_SB(sb);
188 struct cifs_tcon *tcon = cifs_sb_master_tcon(cifs_sb);
189 struct TCP_Server_Info *server = tcon->ses->server;
190 unsigned int xid;
191 int rc = 0;
192
193 xid = get_xid();
194
195 /*
196 * PATH_MAX may be too long - it would presumably be total path,
197 * but note that some servers (includinng Samba 3) have a shorter
198 * maximum path.
199 *
200 * Instead could get the real value via SMB_QUERY_FS_ATTRIBUTE_INFO.
201 */
202 buf->f_namelen = PATH_MAX;
203 buf->f_files = 0; /* undefined */
204 buf->f_ffree = 0; /* unlimited */
205
206 if (server->ops->queryfs)
207 rc = server->ops->queryfs(xid, tcon, buf);
208
209 free_xid(xid);
210 return 0;
211 }
212
213 static int cifs_permission(struct inode *inode, int mask)
214 {
215 struct cifs_sb_info *cifs_sb;
216
217 cifs_sb = CIFS_SB(inode->i_sb);
218
219 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_NO_PERM) {
220 if ((mask & MAY_EXEC) && !execute_ok(inode))
221 return -EACCES;
222 else
223 return 0;
224 } else /* file mode might have been restricted at mount time
225 on the client (above and beyond ACL on servers) for
226 servers which do not support setting and viewing mode bits,
227 so allowing client to check permissions is useful */
228 return generic_permission(inode, mask);
229 }
230
231 static struct kmem_cache *cifs_inode_cachep;
232 static struct kmem_cache *cifs_req_cachep;
233 static struct kmem_cache *cifs_mid_cachep;
234 static struct kmem_cache *cifs_sm_req_cachep;
235 mempool_t *cifs_sm_req_poolp;
236 mempool_t *cifs_req_poolp;
237 mempool_t *cifs_mid_poolp;
238
239 static struct inode *
240 cifs_alloc_inode(struct super_block *sb)
241 {
242 struct cifsInodeInfo *cifs_inode;
243 cifs_inode = kmem_cache_alloc(cifs_inode_cachep, GFP_KERNEL);
244 if (!cifs_inode)
245 return NULL;
246 cifs_inode->cifsAttrs = 0x20; /* default */
247 cifs_inode->time = 0;
248 /*
249 * Until the file is open and we have gotten oplock info back from the
250 * server, can not assume caching of file data or metadata.
251 */
252 cifs_set_oplock_level(cifs_inode, 0);
253 cifs_inode->delete_pending = false;
254 cifs_inode->invalid_mapping = false;
255 cifs_inode->vfs_inode.i_blkbits = 14; /* 2**14 = CIFS_MAX_MSGSIZE */
256 cifs_inode->server_eof = 0;
257 cifs_inode->uniqueid = 0;
258 cifs_inode->createtime = 0;
259 #ifdef CONFIG_CIFS_SMB2
260 get_random_bytes(cifs_inode->lease_key, SMB2_LEASE_KEY_SIZE);
261 #endif
262 /*
263 * Can not set i_flags here - they get immediately overwritten to zero
264 * by the VFS.
265 */
266 /* cifs_inode->vfs_inode.i_flags = S_NOATIME | S_NOCMTIME; */
267 INIT_LIST_HEAD(&cifs_inode->openFileList);
268 INIT_LIST_HEAD(&cifs_inode->llist);
269 return &cifs_inode->vfs_inode;
270 }
271
272 static void cifs_i_callback(struct rcu_head *head)
273 {
274 struct inode *inode = container_of(head, struct inode, i_rcu);
275 kmem_cache_free(cifs_inode_cachep, CIFS_I(inode));
276 }
277
278 static void
279 cifs_destroy_inode(struct inode *inode)
280 {
281 call_rcu(&inode->i_rcu, cifs_i_callback);
282 }
283
284 static void
285 cifs_evict_inode(struct inode *inode)
286 {
287 truncate_inode_pages(&inode->i_data, 0);
288 clear_inode(inode);
289 cifs_fscache_release_inode_cookie(inode);
290 }
291
292 static void
293 cifs_show_address(struct seq_file *s, struct TCP_Server_Info *server)
294 {
295 struct sockaddr_in *sa = (struct sockaddr_in *) &server->dstaddr;
296 struct sockaddr_in6 *sa6 = (struct sockaddr_in6 *) &server->dstaddr;
297
298 seq_printf(s, ",addr=");
299
300 switch (server->dstaddr.ss_family) {
301 case AF_INET:
302 seq_printf(s, "%pI4", &sa->sin_addr.s_addr);
303 break;
304 case AF_INET6:
305 seq_printf(s, "%pI6", &sa6->sin6_addr.s6_addr);
306 if (sa6->sin6_scope_id)
307 seq_printf(s, "%%%u", sa6->sin6_scope_id);
308 break;
309 default:
310 seq_printf(s, "(unknown)");
311 }
312 }
313
314 static void
315 cifs_show_security(struct seq_file *s, struct TCP_Server_Info *server)
316 {
317 seq_printf(s, ",sec=");
318
319 switch (server->secType) {
320 case LANMAN:
321 seq_printf(s, "lanman");
322 break;
323 case NTLMv2:
324 seq_printf(s, "ntlmv2");
325 break;
326 case NTLM:
327 seq_printf(s, "ntlm");
328 break;
329 case Kerberos:
330 seq_printf(s, "krb5");
331 break;
332 case RawNTLMSSP:
333 seq_printf(s, "ntlmssp");
334 break;
335 default:
336 /* shouldn't ever happen */
337 seq_printf(s, "unknown");
338 break;
339 }
340
341 if (server->sec_mode & (SECMODE_SIGN_REQUIRED | SECMODE_SIGN_ENABLED))
342 seq_printf(s, "i");
343 }
344
345 static void
346 cifs_show_cache_flavor(struct seq_file *s, struct cifs_sb_info *cifs_sb)
347 {
348 seq_printf(s, ",cache=");
349
350 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_STRICT_IO)
351 seq_printf(s, "strict");
352 else if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_DIRECT_IO)
353 seq_printf(s, "none");
354 else
355 seq_printf(s, "loose");
356 }
357
358 /*
359 * cifs_show_options() is for displaying mount options in /proc/mounts.
360 * Not all settable options are displayed but most of the important
361 * ones are.
362 */
363 static int
364 cifs_show_options(struct seq_file *s, struct dentry *root)
365 {
366 struct cifs_sb_info *cifs_sb = CIFS_SB(root->d_sb);
367 struct cifs_tcon *tcon = cifs_sb_master_tcon(cifs_sb);
368 struct sockaddr *srcaddr;
369 srcaddr = (struct sockaddr *)&tcon->ses->server->srcaddr;
370
371 seq_printf(s, ",vers=%s", tcon->ses->server->vals->version_string);
372 cifs_show_security(s, tcon->ses->server);
373 cifs_show_cache_flavor(s, cifs_sb);
374
375 seq_printf(s, ",unc=");
376 seq_escape(s, tcon->treeName, " \t\n\\");
377
378 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_MULTIUSER)
379 seq_printf(s, ",multiuser");
380 else if (tcon->ses->user_name)
381 seq_printf(s, ",username=%s", tcon->ses->user_name);
382
383 if (tcon->ses->domainName)
384 seq_printf(s, ",domain=%s", tcon->ses->domainName);
385
386 if (srcaddr->sa_family != AF_UNSPEC) {
387 struct sockaddr_in *saddr4;
388 struct sockaddr_in6 *saddr6;
389 saddr4 = (struct sockaddr_in *)srcaddr;
390 saddr6 = (struct sockaddr_in6 *)srcaddr;
391 if (srcaddr->sa_family == AF_INET6)
392 seq_printf(s, ",srcaddr=%pI6c",
393 &saddr6->sin6_addr);
394 else if (srcaddr->sa_family == AF_INET)
395 seq_printf(s, ",srcaddr=%pI4",
396 &saddr4->sin_addr.s_addr);
397 else
398 seq_printf(s, ",srcaddr=BAD-AF:%i",
399 (int)(srcaddr->sa_family));
400 }
401
402 seq_printf(s, ",uid=%u",
403 from_kuid_munged(&init_user_ns, cifs_sb->mnt_uid));
404 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_OVERR_UID)
405 seq_printf(s, ",forceuid");
406 else
407 seq_printf(s, ",noforceuid");
408
409 seq_printf(s, ",gid=%u",
410 from_kgid_munged(&init_user_ns, cifs_sb->mnt_gid));
411 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_OVERR_GID)
412 seq_printf(s, ",forcegid");
413 else
414 seq_printf(s, ",noforcegid");
415
416 cifs_show_address(s, tcon->ses->server);
417
418 if (!tcon->unix_ext)
419 seq_printf(s, ",file_mode=0%ho,dir_mode=0%ho",
420 cifs_sb->mnt_file_mode,
421 cifs_sb->mnt_dir_mode);
422 if (tcon->seal)
423 seq_printf(s, ",seal");
424 if (tcon->nocase)
425 seq_printf(s, ",nocase");
426 if (tcon->retry)
427 seq_printf(s, ",hard");
428 if (tcon->unix_ext)
429 seq_printf(s, ",unix");
430 else
431 seq_printf(s, ",nounix");
432 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_POSIX_PATHS)
433 seq_printf(s, ",posixpaths");
434 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_SET_UID)
435 seq_printf(s, ",setuids");
436 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_SERVER_INUM)
437 seq_printf(s, ",serverino");
438 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_RWPIDFORWARD)
439 seq_printf(s, ",rwpidforward");
440 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_NOPOSIXBRL)
441 seq_printf(s, ",forcemand");
442 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_NO_XATTR)
443 seq_printf(s, ",nouser_xattr");
444 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_MAP_SPECIAL_CHR)
445 seq_printf(s, ",mapchars");
446 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_UNX_EMUL)
447 seq_printf(s, ",sfu");
448 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_NO_BRL)
449 seq_printf(s, ",nobrl");
450 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_CIFS_ACL)
451 seq_printf(s, ",cifsacl");
452 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_DYNPERM)
453 seq_printf(s, ",dynperm");
454 if (root->d_sb->s_flags & MS_POSIXACL)
455 seq_printf(s, ",acl");
456 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_MF_SYMLINKS)
457 seq_printf(s, ",mfsymlinks");
458 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_FSCACHE)
459 seq_printf(s, ",fsc");
460 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_NOSSYNC)
461 seq_printf(s, ",nostrictsync");
462 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_NO_PERM)
463 seq_printf(s, ",noperm");
464 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_CIFS_BACKUPUID)
465 seq_printf(s, ",backupuid=%u",
466 from_kuid_munged(&init_user_ns,
467 cifs_sb->mnt_backupuid));
468 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_CIFS_BACKUPGID)
469 seq_printf(s, ",backupgid=%u",
470 from_kgid_munged(&init_user_ns,
471 cifs_sb->mnt_backupgid));
472
473 seq_printf(s, ",rsize=%u", cifs_sb->rsize);
474 seq_printf(s, ",wsize=%u", cifs_sb->wsize);
475 /* convert actimeo and display it in seconds */
476 seq_printf(s, ",actimeo=%lu", cifs_sb->actimeo / HZ);
477
478 return 0;
479 }
480
481 static void cifs_umount_begin(struct super_block *sb)
482 {
483 struct cifs_sb_info *cifs_sb = CIFS_SB(sb);
484 struct cifs_tcon *tcon;
485
486 if (cifs_sb == NULL)
487 return;
488
489 tcon = cifs_sb_master_tcon(cifs_sb);
490
491 spin_lock(&cifs_tcp_ses_lock);
492 if ((tcon->tc_count > 1) || (tcon->tidStatus == CifsExiting)) {
493 /* we have other mounts to same share or we have
494 already tried to force umount this and woken up
495 all waiting network requests, nothing to do */
496 spin_unlock(&cifs_tcp_ses_lock);
497 return;
498 } else if (tcon->tc_count == 1)
499 tcon->tidStatus = CifsExiting;
500 spin_unlock(&cifs_tcp_ses_lock);
501
502 /* cancel_brl_requests(tcon); */ /* BB mark all brl mids as exiting */
503 /* cancel_notify_requests(tcon); */
504 if (tcon->ses && tcon->ses->server) {
505 cFYI(1, "wake up tasks now - umount begin not complete");
506 wake_up_all(&tcon->ses->server->request_q);
507 wake_up_all(&tcon->ses->server->response_q);
508 msleep(1); /* yield */
509 /* we have to kick the requests once more */
510 wake_up_all(&tcon->ses->server->response_q);
511 msleep(1);
512 }
513
514 return;
515 }
516
517 #ifdef CONFIG_CIFS_STATS2
518 static int cifs_show_stats(struct seq_file *s, struct dentry *root)
519 {
520 /* BB FIXME */
521 return 0;
522 }
523 #endif
524
525 static int cifs_remount(struct super_block *sb, int *flags, char *data)
526 {
527 *flags |= MS_NODIRATIME;
528 return 0;
529 }
530
531 static int cifs_drop_inode(struct inode *inode)
532 {
533 struct cifs_sb_info *cifs_sb = CIFS_SB(inode->i_sb);
534
535 /* no serverino => unconditional eviction */
536 return !(cifs_sb->mnt_cifs_flags & CIFS_MOUNT_SERVER_INUM) ||
537 generic_drop_inode(inode);
538 }
539
540 static const struct super_operations cifs_super_ops = {
541 .statfs = cifs_statfs,
542 .alloc_inode = cifs_alloc_inode,
543 .destroy_inode = cifs_destroy_inode,
544 .drop_inode = cifs_drop_inode,
545 .evict_inode = cifs_evict_inode,
546 /* .delete_inode = cifs_delete_inode, */ /* Do not need above
547 function unless later we add lazy close of inodes or unless the
548 kernel forgets to call us with the same number of releases (closes)
549 as opens */
550 .show_options = cifs_show_options,
551 .umount_begin = cifs_umount_begin,
552 .remount_fs = cifs_remount,
553 #ifdef CONFIG_CIFS_STATS2
554 .show_stats = cifs_show_stats,
555 #endif
556 };
557
558 /*
559 * Get root dentry from superblock according to prefix path mount option.
560 * Return dentry with refcount + 1 on success and NULL otherwise.
561 */
562 static struct dentry *
563 cifs_get_root(struct smb_vol *vol, struct super_block *sb)
564 {
565 struct dentry *dentry;
566 struct cifs_sb_info *cifs_sb = CIFS_SB(sb);
567 char *full_path = NULL;
568 char *s, *p;
569 char sep;
570
571 full_path = cifs_build_path_to_root(vol, cifs_sb,
572 cifs_sb_master_tcon(cifs_sb));
573 if (full_path == NULL)
574 return ERR_PTR(-ENOMEM);
575
576 cFYI(1, "Get root dentry for %s", full_path);
577
578 sep = CIFS_DIR_SEP(cifs_sb);
579 dentry = dget(sb->s_root);
580 p = s = full_path;
581
582 do {
583 struct inode *dir = dentry->d_inode;
584 struct dentry *child;
585
586 if (!dir) {
587 dput(dentry);
588 dentry = ERR_PTR(-ENOENT);
589 break;
590 }
591 if (!S_ISDIR(dir->i_mode)) {
592 dput(dentry);
593 dentry = ERR_PTR(-ENOTDIR);
594 break;
595 }
596
597 /* skip separators */
598 while (*s == sep)
599 s++;
600 if (!*s)
601 break;
602 p = s++;
603 /* next separator */
604 while (*s && *s != sep)
605 s++;
606
607 mutex_lock(&dir->i_mutex);
608 child = lookup_one_len(p, dentry, s - p);
609 mutex_unlock(&dir->i_mutex);
610 dput(dentry);
611 dentry = child;
612 } while (!IS_ERR(dentry));
613 kfree(full_path);
614 return dentry;
615 }
616
617 static int cifs_set_super(struct super_block *sb, void *data)
618 {
619 struct cifs_mnt_data *mnt_data = data;
620 sb->s_fs_info = mnt_data->cifs_sb;
621 return set_anon_super(sb, NULL);
622 }
623
624 static struct dentry *
625 cifs_do_mount(struct file_system_type *fs_type,
626 int flags, const char *dev_name, void *data)
627 {
628 int rc;
629 struct super_block *sb;
630 struct cifs_sb_info *cifs_sb;
631 struct smb_vol *volume_info;
632 struct cifs_mnt_data mnt_data;
633 struct dentry *root;
634
635 cFYI(1, "Devname: %s flags: %d ", dev_name, flags);
636
637 volume_info = cifs_get_volume_info((char *)data, dev_name);
638 if (IS_ERR(volume_info))
639 return ERR_CAST(volume_info);
640
641 cifs_sb = kzalloc(sizeof(struct cifs_sb_info), GFP_KERNEL);
642 if (cifs_sb == NULL) {
643 root = ERR_PTR(-ENOMEM);
644 goto out_nls;
645 }
646
647 cifs_sb->mountdata = kstrndup(data, PAGE_SIZE, GFP_KERNEL);
648 if (cifs_sb->mountdata == NULL) {
649 root = ERR_PTR(-ENOMEM);
650 goto out_cifs_sb;
651 }
652
653 cifs_setup_cifs_sb(volume_info, cifs_sb);
654
655 rc = cifs_mount(cifs_sb, volume_info);
656 if (rc) {
657 if (!(flags & MS_SILENT))
658 cERROR(1, "cifs_mount failed w/return code = %d", rc);
659 root = ERR_PTR(rc);
660 goto out_mountdata;
661 }
662
663 mnt_data.vol = volume_info;
664 mnt_data.cifs_sb = cifs_sb;
665 mnt_data.flags = flags;
666
667 /* BB should we make this contingent on mount parm? */
668 flags |= MS_NODIRATIME | MS_NOATIME;
669
670 sb = sget(fs_type, cifs_match_super, cifs_set_super, flags, &mnt_data);
671 if (IS_ERR(sb)) {
672 root = ERR_CAST(sb);
673 cifs_umount(cifs_sb);
674 goto out;
675 }
676
677 if (sb->s_root) {
678 cFYI(1, "Use existing superblock");
679 cifs_umount(cifs_sb);
680 } else {
681 rc = cifs_read_super(sb);
682 if (rc) {
683 root = ERR_PTR(rc);
684 goto out_super;
685 }
686
687 sb->s_flags |= MS_ACTIVE;
688 }
689
690 root = cifs_get_root(volume_info, sb);
691 if (IS_ERR(root))
692 goto out_super;
693
694 cFYI(1, "dentry root is: %p", root);
695 goto out;
696
697 out_super:
698 deactivate_locked_super(sb);
699 out:
700 cifs_cleanup_volume_info(volume_info);
701 return root;
702
703 out_mountdata:
704 kfree(cifs_sb->mountdata);
705 out_cifs_sb:
706 kfree(cifs_sb);
707 out_nls:
708 unload_nls(volume_info->local_nls);
709 goto out;
710 }
711
712 static ssize_t cifs_file_aio_write(struct kiocb *iocb, const struct iovec *iov,
713 unsigned long nr_segs, loff_t pos)
714 {
715 struct inode *inode = file_inode(iocb->ki_filp);
716 ssize_t written;
717 int rc;
718
719 written = generic_file_aio_write(iocb, iov, nr_segs, pos);
720
721 if (CIFS_I(inode)->clientCanCacheAll)
722 return written;
723
724 rc = filemap_fdatawrite(inode->i_mapping);
725 if (rc)
726 cFYI(1, "cifs_file_aio_write: %d rc on %p inode", rc, inode);
727
728 return written;
729 }
730
731 static loff_t cifs_llseek(struct file *file, loff_t offset, int whence)
732 {
733 /*
734 * whence == SEEK_END || SEEK_DATA || SEEK_HOLE => we must revalidate
735 * the cached file length
736 */
737 if (whence != SEEK_SET && whence != SEEK_CUR) {
738 int rc;
739 struct inode *inode = file_inode(file);
740
741 /*
742 * We need to be sure that all dirty pages are written and the
743 * server has the newest file length.
744 */
745 if (!CIFS_I(inode)->clientCanCacheRead && inode->i_mapping &&
746 inode->i_mapping->nrpages != 0) {
747 rc = filemap_fdatawait(inode->i_mapping);
748 if (rc) {
749 mapping_set_error(inode->i_mapping, rc);
750 return rc;
751 }
752 }
753 /*
754 * Some applications poll for the file length in this strange
755 * way so we must seek to end on non-oplocked files by
756 * setting the revalidate time to zero.
757 */
758 CIFS_I(inode)->time = 0;
759
760 rc = cifs_revalidate_file_attr(file);
761 if (rc < 0)
762 return (loff_t)rc;
763 }
764 return generic_file_llseek(file, offset, whence);
765 }
766
767 static int cifs_setlease(struct file *file, long arg, struct file_lock **lease)
768 {
769 /* note that this is called by vfs setlease with lock_flocks held
770 to protect *lease from going away */
771 struct inode *inode = file_inode(file);
772 struct cifsFileInfo *cfile = file->private_data;
773
774 if (!(S_ISREG(inode->i_mode)))
775 return -EINVAL;
776
777 /* check if file is oplocked */
778 if (((arg == F_RDLCK) &&
779 (CIFS_I(inode)->clientCanCacheRead)) ||
780 ((arg == F_WRLCK) &&
781 (CIFS_I(inode)->clientCanCacheAll)))
782 return generic_setlease(file, arg, lease);
783 else if (tlink_tcon(cfile->tlink)->local_lease &&
784 !CIFS_I(inode)->clientCanCacheRead)
785 /* If the server claims to support oplock on this
786 file, then we still need to check oplock even
787 if the local_lease mount option is set, but there
788 are servers which do not support oplock for which
789 this mount option may be useful if the user
790 knows that the file won't be changed on the server
791 by anyone else */
792 return generic_setlease(file, arg, lease);
793 else
794 return -EAGAIN;
795 }
796
797 struct file_system_type cifs_fs_type = {
798 .owner = THIS_MODULE,
799 .name = "cifs",
800 .mount = cifs_do_mount,
801 .kill_sb = cifs_kill_sb,
802 /* .fs_flags */
803 };
804 MODULE_ALIAS_FS("cifs");
805 const struct inode_operations cifs_dir_inode_ops = {
806 .create = cifs_create,
807 .atomic_open = cifs_atomic_open,
808 .lookup = cifs_lookup,
809 .getattr = cifs_getattr,
810 .unlink = cifs_unlink,
811 .link = cifs_hardlink,
812 .mkdir = cifs_mkdir,
813 .rmdir = cifs_rmdir,
814 .rename = cifs_rename,
815 .permission = cifs_permission,
816 /* revalidate:cifs_revalidate, */
817 .setattr = cifs_setattr,
818 .symlink = cifs_symlink,
819 .mknod = cifs_mknod,
820 #ifdef CONFIG_CIFS_XATTR
821 .setxattr = cifs_setxattr,
822 .getxattr = cifs_getxattr,
823 .listxattr = cifs_listxattr,
824 .removexattr = cifs_removexattr,
825 #endif
826 };
827
828 const struct inode_operations cifs_file_inode_ops = {
829 /* revalidate:cifs_revalidate, */
830 .setattr = cifs_setattr,
831 .getattr = cifs_getattr, /* do we need this anymore? */
832 .rename = cifs_rename,
833 .permission = cifs_permission,
834 #ifdef CONFIG_CIFS_XATTR
835 .setxattr = cifs_setxattr,
836 .getxattr = cifs_getxattr,
837 .listxattr = cifs_listxattr,
838 .removexattr = cifs_removexattr,
839 #endif
840 };
841
842 const struct inode_operations cifs_symlink_inode_ops = {
843 .readlink = generic_readlink,
844 .follow_link = cifs_follow_link,
845 .put_link = cifs_put_link,
846 .permission = cifs_permission,
847 /* BB add the following two eventually */
848 /* revalidate: cifs_revalidate,
849 setattr: cifs_notify_change, *//* BB do we need notify change */
850 #ifdef CONFIG_CIFS_XATTR
851 .setxattr = cifs_setxattr,
852 .getxattr = cifs_getxattr,
853 .listxattr = cifs_listxattr,
854 .removexattr = cifs_removexattr,
855 #endif
856 };
857
858 const struct file_operations cifs_file_ops = {
859 .read = do_sync_read,
860 .write = do_sync_write,
861 .aio_read = generic_file_aio_read,
862 .aio_write = cifs_file_aio_write,
863 .open = cifs_open,
864 .release = cifs_close,
865 .lock = cifs_lock,
866 .fsync = cifs_fsync,
867 .flush = cifs_flush,
868 .mmap = cifs_file_mmap,
869 .splice_read = generic_file_splice_read,
870 .llseek = cifs_llseek,
871 #ifdef CONFIG_CIFS_POSIX
872 .unlocked_ioctl = cifs_ioctl,
873 #endif /* CONFIG_CIFS_POSIX */
874 .setlease = cifs_setlease,
875 };
876
877 const struct file_operations cifs_file_strict_ops = {
878 .read = do_sync_read,
879 .write = do_sync_write,
880 .aio_read = cifs_strict_readv,
881 .aio_write = cifs_strict_writev,
882 .open = cifs_open,
883 .release = cifs_close,
884 .lock = cifs_lock,
885 .fsync = cifs_strict_fsync,
886 .flush = cifs_flush,
887 .mmap = cifs_file_strict_mmap,
888 .splice_read = generic_file_splice_read,
889 .llseek = cifs_llseek,
890 #ifdef CONFIG_CIFS_POSIX
891 .unlocked_ioctl = cifs_ioctl,
892 #endif /* CONFIG_CIFS_POSIX */
893 .setlease = cifs_setlease,
894 };
895
896 const struct file_operations cifs_file_direct_ops = {
897 /* BB reevaluate whether they can be done with directio, no cache */
898 .read = do_sync_read,
899 .write = do_sync_write,
900 .aio_read = cifs_user_readv,
901 .aio_write = cifs_user_writev,
902 .open = cifs_open,
903 .release = cifs_close,
904 .lock = cifs_lock,
905 .fsync = cifs_fsync,
906 .flush = cifs_flush,
907 .mmap = cifs_file_mmap,
908 .splice_read = generic_file_splice_read,
909 #ifdef CONFIG_CIFS_POSIX
910 .unlocked_ioctl = cifs_ioctl,
911 #endif /* CONFIG_CIFS_POSIX */
912 .llseek = cifs_llseek,
913 .setlease = cifs_setlease,
914 };
915
916 const struct file_operations cifs_file_nobrl_ops = {
917 .read = do_sync_read,
918 .write = do_sync_write,
919 .aio_read = generic_file_aio_read,
920 .aio_write = cifs_file_aio_write,
921 .open = cifs_open,
922 .release = cifs_close,
923 .fsync = cifs_fsync,
924 .flush = cifs_flush,
925 .mmap = cifs_file_mmap,
926 .splice_read = generic_file_splice_read,
927 .llseek = cifs_llseek,
928 #ifdef CONFIG_CIFS_POSIX
929 .unlocked_ioctl = cifs_ioctl,
930 #endif /* CONFIG_CIFS_POSIX */
931 .setlease = cifs_setlease,
932 };
933
934 const struct file_operations cifs_file_strict_nobrl_ops = {
935 .read = do_sync_read,
936 .write = do_sync_write,
937 .aio_read = cifs_strict_readv,
938 .aio_write = cifs_strict_writev,
939 .open = cifs_open,
940 .release = cifs_close,
941 .fsync = cifs_strict_fsync,
942 .flush = cifs_flush,
943 .mmap = cifs_file_strict_mmap,
944 .splice_read = generic_file_splice_read,
945 .llseek = cifs_llseek,
946 #ifdef CONFIG_CIFS_POSIX
947 .unlocked_ioctl = cifs_ioctl,
948 #endif /* CONFIG_CIFS_POSIX */
949 .setlease = cifs_setlease,
950 };
951
952 const struct file_operations cifs_file_direct_nobrl_ops = {
953 /* BB reevaluate whether they can be done with directio, no cache */
954 .read = do_sync_read,
955 .write = do_sync_write,
956 .aio_read = cifs_user_readv,
957 .aio_write = cifs_user_writev,
958 .open = cifs_open,
959 .release = cifs_close,
960 .fsync = cifs_fsync,
961 .flush = cifs_flush,
962 .mmap = cifs_file_mmap,
963 .splice_read = generic_file_splice_read,
964 #ifdef CONFIG_CIFS_POSIX
965 .unlocked_ioctl = cifs_ioctl,
966 #endif /* CONFIG_CIFS_POSIX */
967 .llseek = cifs_llseek,
968 .setlease = cifs_setlease,
969 };
970
971 const struct file_operations cifs_dir_ops = {
972 .readdir = cifs_readdir,
973 .release = cifs_closedir,
974 .read = generic_read_dir,
975 .unlocked_ioctl = cifs_ioctl,
976 .llseek = generic_file_llseek,
977 };
978
979 static void
980 cifs_init_once(void *inode)
981 {
982 struct cifsInodeInfo *cifsi = inode;
983
984 inode_init_once(&cifsi->vfs_inode);
985 init_rwsem(&cifsi->lock_sem);
986 }
987
988 static int
989 cifs_init_inodecache(void)
990 {
991 cifs_inode_cachep = kmem_cache_create("cifs_inode_cache",
992 sizeof(struct cifsInodeInfo),
993 0, (SLAB_RECLAIM_ACCOUNT|
994 SLAB_MEM_SPREAD),
995 cifs_init_once);
996 if (cifs_inode_cachep == NULL)
997 return -ENOMEM;
998
999 return 0;
1000 }
1001
1002 static void
1003 cifs_destroy_inodecache(void)
1004 {
1005 /*
1006 * Make sure all delayed rcu free inodes are flushed before we
1007 * destroy cache.
1008 */
1009 rcu_barrier();
1010 kmem_cache_destroy(cifs_inode_cachep);
1011 }
1012
1013 static int
1014 cifs_init_request_bufs(void)
1015 {
1016 size_t max_hdr_size = MAX_CIFS_HDR_SIZE;
1017 #ifdef CONFIG_CIFS_SMB2
1018 /*
1019 * SMB2 maximum header size is bigger than CIFS one - no problems to
1020 * allocate some more bytes for CIFS.
1021 */
1022 max_hdr_size = MAX_SMB2_HDR_SIZE;
1023 #endif
1024 if (CIFSMaxBufSize < 8192) {
1025 /* Buffer size can not be smaller than 2 * PATH_MAX since maximum
1026 Unicode path name has to fit in any SMB/CIFS path based frames */
1027 CIFSMaxBufSize = 8192;
1028 } else if (CIFSMaxBufSize > 1024*127) {
1029 CIFSMaxBufSize = 1024 * 127;
1030 } else {
1031 CIFSMaxBufSize &= 0x1FE00; /* Round size to even 512 byte mult*/
1032 }
1033 /* cERROR(1, "CIFSMaxBufSize %d 0x%x",CIFSMaxBufSize,CIFSMaxBufSize); */
1034 cifs_req_cachep = kmem_cache_create("cifs_request",
1035 CIFSMaxBufSize + max_hdr_size, 0,
1036 SLAB_HWCACHE_ALIGN, NULL);
1037 if (cifs_req_cachep == NULL)
1038 return -ENOMEM;
1039
1040 if (cifs_min_rcv < 1)
1041 cifs_min_rcv = 1;
1042 else if (cifs_min_rcv > 64) {
1043 cifs_min_rcv = 64;
1044 cERROR(1, "cifs_min_rcv set to maximum (64)");
1045 }
1046
1047 cifs_req_poolp = mempool_create_slab_pool(cifs_min_rcv,
1048 cifs_req_cachep);
1049
1050 if (cifs_req_poolp == NULL) {
1051 kmem_cache_destroy(cifs_req_cachep);
1052 return -ENOMEM;
1053 }
1054 /* MAX_CIFS_SMALL_BUFFER_SIZE bytes is enough for most SMB responses and
1055 almost all handle based requests (but not write response, nor is it
1056 sufficient for path based requests). A smaller size would have
1057 been more efficient (compacting multiple slab items on one 4k page)
1058 for the case in which debug was on, but this larger size allows
1059 more SMBs to use small buffer alloc and is still much more
1060 efficient to alloc 1 per page off the slab compared to 17K (5page)
1061 alloc of large cifs buffers even when page debugging is on */
1062 cifs_sm_req_cachep = kmem_cache_create("cifs_small_rq",
1063 MAX_CIFS_SMALL_BUFFER_SIZE, 0, SLAB_HWCACHE_ALIGN,
1064 NULL);
1065 if (cifs_sm_req_cachep == NULL) {
1066 mempool_destroy(cifs_req_poolp);
1067 kmem_cache_destroy(cifs_req_cachep);
1068 return -ENOMEM;
1069 }
1070
1071 if (cifs_min_small < 2)
1072 cifs_min_small = 2;
1073 else if (cifs_min_small > 256) {
1074 cifs_min_small = 256;
1075 cFYI(1, "cifs_min_small set to maximum (256)");
1076 }
1077
1078 cifs_sm_req_poolp = mempool_create_slab_pool(cifs_min_small,
1079 cifs_sm_req_cachep);
1080
1081 if (cifs_sm_req_poolp == NULL) {
1082 mempool_destroy(cifs_req_poolp);
1083 kmem_cache_destroy(cifs_req_cachep);
1084 kmem_cache_destroy(cifs_sm_req_cachep);
1085 return -ENOMEM;
1086 }
1087
1088 return 0;
1089 }
1090
1091 static void
1092 cifs_destroy_request_bufs(void)
1093 {
1094 mempool_destroy(cifs_req_poolp);
1095 kmem_cache_destroy(cifs_req_cachep);
1096 mempool_destroy(cifs_sm_req_poolp);
1097 kmem_cache_destroy(cifs_sm_req_cachep);
1098 }
1099
1100 static int
1101 cifs_init_mids(void)
1102 {
1103 cifs_mid_cachep = kmem_cache_create("cifs_mpx_ids",
1104 sizeof(struct mid_q_entry), 0,
1105 SLAB_HWCACHE_ALIGN, NULL);
1106 if (cifs_mid_cachep == NULL)
1107 return -ENOMEM;
1108
1109 /* 3 is a reasonable minimum number of simultaneous operations */
1110 cifs_mid_poolp = mempool_create_slab_pool(3, cifs_mid_cachep);
1111 if (cifs_mid_poolp == NULL) {
1112 kmem_cache_destroy(cifs_mid_cachep);
1113 return -ENOMEM;
1114 }
1115
1116 return 0;
1117 }
1118
1119 static void
1120 cifs_destroy_mids(void)
1121 {
1122 mempool_destroy(cifs_mid_poolp);
1123 kmem_cache_destroy(cifs_mid_cachep);
1124 }
1125
1126 static int __init
1127 init_cifs(void)
1128 {
1129 int rc = 0;
1130 cifs_proc_init();
1131 INIT_LIST_HEAD(&cifs_tcp_ses_list);
1132 #ifdef CONFIG_CIFS_DNOTIFY_EXPERIMENTAL /* unused temporarily */
1133 INIT_LIST_HEAD(&GlobalDnotifyReqList);
1134 INIT_LIST_HEAD(&GlobalDnotifyRsp_Q);
1135 #endif /* was needed for dnotify, and will be needed for inotify when VFS fix */
1136 /*
1137 * Initialize Global counters
1138 */
1139 atomic_set(&sesInfoAllocCount, 0);
1140 atomic_set(&tconInfoAllocCount, 0);
1141 atomic_set(&tcpSesAllocCount, 0);
1142 atomic_set(&tcpSesReconnectCount, 0);
1143 atomic_set(&tconInfoReconnectCount, 0);
1144
1145 atomic_set(&bufAllocCount, 0);
1146 atomic_set(&smBufAllocCount, 0);
1147 #ifdef CONFIG_CIFS_STATS2
1148 atomic_set(&totBufAllocCount, 0);
1149 atomic_set(&totSmBufAllocCount, 0);
1150 #endif /* CONFIG_CIFS_STATS2 */
1151
1152 atomic_set(&midCount, 0);
1153 GlobalCurrentXid = 0;
1154 GlobalTotalActiveXid = 0;
1155 GlobalMaxActiveXid = 0;
1156 spin_lock_init(&cifs_tcp_ses_lock);
1157 spin_lock_init(&cifs_file_list_lock);
1158 spin_lock_init(&GlobalMid_Lock);
1159
1160 #ifdef CONFIG_CIFS_SMB2
1161 get_random_bytes(cifs_client_guid, SMB2_CLIENT_GUID_SIZE);
1162 #endif
1163
1164 if (cifs_max_pending < 2) {
1165 cifs_max_pending = 2;
1166 cFYI(1, "cifs_max_pending set to min of 2");
1167 } else if (cifs_max_pending > CIFS_MAX_REQ) {
1168 cifs_max_pending = CIFS_MAX_REQ;
1169 cFYI(1, "cifs_max_pending set to max of %u", CIFS_MAX_REQ);
1170 }
1171
1172 cifsiod_wq = alloc_workqueue("cifsiod", WQ_FREEZABLE|WQ_MEM_RECLAIM, 0);
1173 if (!cifsiod_wq) {
1174 rc = -ENOMEM;
1175 goto out_clean_proc;
1176 }
1177
1178 rc = cifs_fscache_register();
1179 if (rc)
1180 goto out_destroy_wq;
1181
1182 rc = cifs_init_inodecache();
1183 if (rc)
1184 goto out_unreg_fscache;
1185
1186 rc = cifs_init_mids();
1187 if (rc)
1188 goto out_destroy_inodecache;
1189
1190 rc = cifs_init_request_bufs();
1191 if (rc)
1192 goto out_destroy_mids;
1193
1194 #ifdef CONFIG_CIFS_UPCALL
1195 rc = register_key_type(&cifs_spnego_key_type);
1196 if (rc)
1197 goto out_destroy_request_bufs;
1198 #endif /* CONFIG_CIFS_UPCALL */
1199
1200 #ifdef CONFIG_CIFS_ACL
1201 rc = init_cifs_idmap();
1202 if (rc)
1203 goto out_register_key_type;
1204 #endif /* CONFIG_CIFS_ACL */
1205
1206 rc = register_filesystem(&cifs_fs_type);
1207 if (rc)
1208 goto out_init_cifs_idmap;
1209
1210 return 0;
1211
1212 out_init_cifs_idmap:
1213 #ifdef CONFIG_CIFS_ACL
1214 exit_cifs_idmap();
1215 out_register_key_type:
1216 #endif
1217 #ifdef CONFIG_CIFS_UPCALL
1218 unregister_key_type(&cifs_spnego_key_type);
1219 out_destroy_request_bufs:
1220 #endif
1221 cifs_destroy_request_bufs();
1222 out_destroy_mids:
1223 cifs_destroy_mids();
1224 out_destroy_inodecache:
1225 cifs_destroy_inodecache();
1226 out_unreg_fscache:
1227 cifs_fscache_unregister();
1228 out_destroy_wq:
1229 destroy_workqueue(cifsiod_wq);
1230 out_clean_proc:
1231 cifs_proc_clean();
1232 return rc;
1233 }
1234
1235 static void __exit
1236 exit_cifs(void)
1237 {
1238 cFYI(DBG2, "exit_cifs");
1239 unregister_filesystem(&cifs_fs_type);
1240 cifs_dfs_release_automount_timer();
1241 #ifdef CONFIG_CIFS_ACL
1242 exit_cifs_idmap();
1243 #endif
1244 #ifdef CONFIG_CIFS_UPCALL
1245 unregister_key_type(&cifs_spnego_key_type);
1246 #endif
1247 cifs_destroy_request_bufs();
1248 cifs_destroy_mids();
1249 cifs_destroy_inodecache();
1250 cifs_fscache_unregister();
1251 destroy_workqueue(cifsiod_wq);
1252 cifs_proc_clean();
1253 }
1254
1255 MODULE_AUTHOR("Steve French <sfrench@us.ibm.com>");
1256 MODULE_LICENSE("GPL"); /* combination of LGPL + GPL source behaves as GPL */
1257 MODULE_DESCRIPTION
1258 ("VFS to access servers complying with the SNIA CIFS Specification "
1259 "e.g. Samba and Windows");
1260 MODULE_VERSION(CIFS_VERSION);
1261 module_init(init_cifs)
1262 module_exit(exit_cifs)
This page took 0.054869 seconds and 6 git commands to generate.