945fb083cea7a9e456c3bef0871d4c7d9d99b358
[sfrench/cifs-2.6.git] / fs / cifs / cifsfs.c
1 // SPDX-License-Identifier: LGPL-2.1
2 /*
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  */
10
11 /* Note that BB means BUGBUG (ie something to fix eventually) */
12
13 #include <linux/module.h>
14 #include <linux/fs.h>
15 #include <linux/mount.h>
16 #include <linux/slab.h>
17 #include <linux/init.h>
18 #include <linux/list.h>
19 #include <linux/seq_file.h>
20 #include <linux/vfs.h>
21 #include <linux/mempool.h>
22 #include <linux/delay.h>
23 #include <linux/kthread.h>
24 #include <linux/freezer.h>
25 #include <linux/namei.h>
26 #include <linux/random.h>
27 #include <linux/uuid.h>
28 #include <linux/xattr.h>
29 #include <uapi/linux/magic.h>
30 #include <net/ipv6.h>
31 #include "cifsfs.h"
32 #include "cifspdu.h"
33 #define DECLARE_GLOBALS_HERE
34 #include "cifsglob.h"
35 #include "cifsproto.h"
36 #include "cifs_debug.h"
37 #include "cifs_fs_sb.h"
38 #include <linux/mm.h>
39 #include <linux/key-type.h>
40 #include "cifs_spnego.h"
41 #include "fscache.h"
42 #ifdef CONFIG_CIFS_DFS_UPCALL
43 #include "dfs_cache.h"
44 #endif
45 #ifdef CONFIG_CIFS_SWN_UPCALL
46 #include "netlink.h"
47 #endif
48 #include "fs_context.h"
49 #include "cached_dir.h"
50
51 /*
52  * DOS dates from 1980/1/1 through 2107/12/31
53  * Protocol specifications indicate the range should be to 119, which
54  * limits maximum year to 2099. But this range has not been checked.
55  */
56 #define SMB_DATE_MAX (127<<9 | 12<<5 | 31)
57 #define SMB_DATE_MIN (0<<9 | 1<<5 | 1)
58 #define SMB_TIME_MAX (23<<11 | 59<<5 | 29)
59
60 int cifsFYI = 0;
61 bool traceSMB;
62 bool enable_oplocks = true;
63 bool linuxExtEnabled = true;
64 bool lookupCacheEnabled = true;
65 bool disable_legacy_dialects; /* false by default */
66 bool enable_gcm_256 = true;
67 bool require_gcm_256; /* false by default */
68 bool enable_negotiate_signing; /* false by default */
69 unsigned int global_secflags = CIFSSEC_DEF;
70 /* unsigned int ntlmv2_support = 0; */
71 unsigned int sign_CIFS_PDUs = 1;
72
73 /*
74  * Global transaction id (XID) information
75  */
76 unsigned int GlobalCurrentXid;  /* protected by GlobalMid_Sem */
77 unsigned int GlobalTotalActiveXid; /* prot by GlobalMid_Sem */
78 unsigned int GlobalMaxActiveXid;        /* prot by GlobalMid_Sem */
79 spinlock_t GlobalMid_Lock; /* protects above & list operations on midQ entries */
80
81 /*
82  *  Global counters, updated atomically
83  */
84 atomic_t sesInfoAllocCount;
85 atomic_t tconInfoAllocCount;
86 atomic_t tcpSesNextId;
87 atomic_t tcpSesAllocCount;
88 atomic_t tcpSesReconnectCount;
89 atomic_t tconInfoReconnectCount;
90
91 atomic_t mid_count;
92 atomic_t buf_alloc_count;
93 atomic_t small_buf_alloc_count;
94 #ifdef CONFIG_CIFS_STATS2
95 atomic_t total_buf_alloc_count;
96 atomic_t total_small_buf_alloc_count;
97 #endif/* STATS2 */
98 struct list_head        cifs_tcp_ses_list;
99 spinlock_t              cifs_tcp_ses_lock;
100 static const struct super_operations cifs_super_ops;
101 unsigned int CIFSMaxBufSize = CIFS_MAX_MSGSIZE;
102 module_param(CIFSMaxBufSize, uint, 0444);
103 MODULE_PARM_DESC(CIFSMaxBufSize, "Network buffer size (not including header) "
104                                  "for CIFS requests. "
105                                  "Default: 16384 Range: 8192 to 130048");
106 unsigned int cifs_min_rcv = CIFS_MIN_RCV_POOL;
107 module_param(cifs_min_rcv, uint, 0444);
108 MODULE_PARM_DESC(cifs_min_rcv, "Network buffers in pool. Default: 4 Range: "
109                                 "1 to 64");
110 unsigned int cifs_min_small = 30;
111 module_param(cifs_min_small, uint, 0444);
112 MODULE_PARM_DESC(cifs_min_small, "Small network buffers in pool. Default: 30 "
113                                  "Range: 2 to 256");
114 unsigned int cifs_max_pending = CIFS_MAX_REQ;
115 module_param(cifs_max_pending, uint, 0444);
116 MODULE_PARM_DESC(cifs_max_pending, "Simultaneous requests to server for "
117                                    "CIFS/SMB1 dialect (N/A for SMB3) "
118                                    "Default: 32767 Range: 2 to 32767.");
119 #ifdef CONFIG_CIFS_STATS2
120 unsigned int slow_rsp_threshold = 1;
121 module_param(slow_rsp_threshold, uint, 0644);
122 MODULE_PARM_DESC(slow_rsp_threshold, "Amount of time (in seconds) to wait "
123                                    "before logging that a response is delayed. "
124                                    "Default: 1 (if set to 0 disables msg).");
125 #endif /* STATS2 */
126
127 module_param(enable_oplocks, bool, 0644);
128 MODULE_PARM_DESC(enable_oplocks, "Enable or disable oplocks. Default: y/Y/1");
129
130 module_param(enable_gcm_256, bool, 0644);
131 MODULE_PARM_DESC(enable_gcm_256, "Enable requesting strongest (256 bit) GCM encryption. Default: n/N/0");
132
133 module_param(require_gcm_256, bool, 0644);
134 MODULE_PARM_DESC(require_gcm_256, "Require strongest (256 bit) GCM encryption. Default: n/N/0");
135
136 module_param(enable_negotiate_signing, bool, 0644);
137 MODULE_PARM_DESC(enable_negotiate_signing, "Enable negotiating packet signing algorithm with server. Default: n/N/0");
138
139 module_param(disable_legacy_dialects, bool, 0644);
140 MODULE_PARM_DESC(disable_legacy_dialects, "To improve security it may be "
141                                   "helpful to restrict the ability to "
142                                   "override the default dialects (SMB2.1, "
143                                   "SMB3 and SMB3.02) on mount with old "
144                                   "dialects (CIFS/SMB1 and SMB2) since "
145                                   "vers=1.0 (CIFS/SMB1) and vers=2.0 are weaker"
146                                   " and less secure. Default: n/N/0");
147
148 extern mempool_t *cifs_sm_req_poolp;
149 extern mempool_t *cifs_req_poolp;
150 extern mempool_t *cifs_mid_poolp;
151
152 struct workqueue_struct *cifsiod_wq;
153 struct workqueue_struct *decrypt_wq;
154 struct workqueue_struct *fileinfo_put_wq;
155 struct workqueue_struct *cifsoplockd_wq;
156 struct workqueue_struct *deferredclose_wq;
157 __u32 cifs_lock_secret;
158
159 /*
160  * Bumps refcount for cifs super block.
161  * Note that it should be only called if a referece to VFS super block is
162  * already held, e.g. in open-type syscalls context. Otherwise it can race with
163  * atomic_dec_and_test in deactivate_locked_super.
164  */
165 void
166 cifs_sb_active(struct super_block *sb)
167 {
168         struct cifs_sb_info *server = CIFS_SB(sb);
169
170         if (atomic_inc_return(&server->active) == 1)
171                 atomic_inc(&sb->s_active);
172 }
173
174 void
175 cifs_sb_deactive(struct super_block *sb)
176 {
177         struct cifs_sb_info *server = CIFS_SB(sb);
178
179         if (atomic_dec_and_test(&server->active))
180                 deactivate_super(sb);
181 }
182
183 static int
184 cifs_read_super(struct super_block *sb)
185 {
186         struct inode *inode;
187         struct cifs_sb_info *cifs_sb;
188         struct cifs_tcon *tcon;
189         struct timespec64 ts;
190         int rc = 0;
191
192         cifs_sb = CIFS_SB(sb);
193         tcon = cifs_sb_master_tcon(cifs_sb);
194
195         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_POSIXACL)
196                 sb->s_flags |= SB_POSIXACL;
197
198         if (tcon->snapshot_time)
199                 sb->s_flags |= SB_RDONLY;
200
201         if (tcon->ses->capabilities & tcon->ses->server->vals->cap_large_files)
202                 sb->s_maxbytes = MAX_LFS_FILESIZE;
203         else
204                 sb->s_maxbytes = MAX_NON_LFS;
205
206         /*
207          * Some very old servers like DOS and OS/2 used 2 second granularity
208          * (while all current servers use 100ns granularity - see MS-DTYP)
209          * but 1 second is the maximum allowed granularity for the VFS
210          * so for old servers set time granularity to 1 second while for
211          * everything else (current servers) set it to 100ns.
212          */
213         if ((tcon->ses->server->vals->protocol_id == SMB10_PROT_ID) &&
214             ((tcon->ses->capabilities &
215               tcon->ses->server->vals->cap_nt_find) == 0) &&
216             !tcon->unix_ext) {
217                 sb->s_time_gran = 1000000000; /* 1 second is max allowed gran */
218                 ts = cnvrtDosUnixTm(cpu_to_le16(SMB_DATE_MIN), 0, 0);
219                 sb->s_time_min = ts.tv_sec;
220                 ts = cnvrtDosUnixTm(cpu_to_le16(SMB_DATE_MAX),
221                                     cpu_to_le16(SMB_TIME_MAX), 0);
222                 sb->s_time_max = ts.tv_sec;
223         } else {
224                 /*
225                  * Almost every server, including all SMB2+, uses DCE TIME
226                  * ie 100 nanosecond units, since 1601.  See MS-DTYP and MS-FSCC
227                  */
228                 sb->s_time_gran = 100;
229                 ts = cifs_NTtimeToUnix(0);
230                 sb->s_time_min = ts.tv_sec;
231                 ts = cifs_NTtimeToUnix(cpu_to_le64(S64_MAX));
232                 sb->s_time_max = ts.tv_sec;
233         }
234
235         sb->s_magic = CIFS_SUPER_MAGIC;
236         sb->s_op = &cifs_super_ops;
237         sb->s_xattr = cifs_xattr_handlers;
238         rc = super_setup_bdi(sb);
239         if (rc)
240                 goto out_no_root;
241         /* tune readahead according to rsize if readahead size not set on mount */
242         if (cifs_sb->ctx->rsize == 0)
243                 cifs_sb->ctx->rsize =
244                         tcon->ses->server->ops->negotiate_rsize(tcon, cifs_sb->ctx);
245         if (cifs_sb->ctx->rasize)
246                 sb->s_bdi->ra_pages = cifs_sb->ctx->rasize / PAGE_SIZE;
247         else
248                 sb->s_bdi->ra_pages = cifs_sb->ctx->rsize / PAGE_SIZE;
249
250         sb->s_blocksize = CIFS_MAX_MSGSIZE;
251         sb->s_blocksize_bits = 14;      /* default 2**14 = CIFS_MAX_MSGSIZE */
252         inode = cifs_root_iget(sb);
253
254         if (IS_ERR(inode)) {
255                 rc = PTR_ERR(inode);
256                 goto out_no_root;
257         }
258
259         if (tcon->nocase)
260                 sb->s_d_op = &cifs_ci_dentry_ops;
261         else
262                 sb->s_d_op = &cifs_dentry_ops;
263
264         sb->s_root = d_make_root(inode);
265         if (!sb->s_root) {
266                 rc = -ENOMEM;
267                 goto out_no_root;
268         }
269
270 #ifdef CONFIG_CIFS_NFSD_EXPORT
271         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_SERVER_INUM) {
272                 cifs_dbg(FYI, "export ops supported\n");
273                 sb->s_export_op = &cifs_export_ops;
274         }
275 #endif /* CONFIG_CIFS_NFSD_EXPORT */
276
277         return 0;
278
279 out_no_root:
280         cifs_dbg(VFS, "%s: get root inode failed\n", __func__);
281         return rc;
282 }
283
284 static void cifs_kill_sb(struct super_block *sb)
285 {
286         struct cifs_sb_info *cifs_sb = CIFS_SB(sb);
287
288         /*
289          * We ned to release all dentries for the cached directories
290          * before we kill the sb.
291          */
292         if (cifs_sb->root) {
293                 close_all_cached_dirs(cifs_sb);
294
295                 /* finally release root dentry */
296                 dput(cifs_sb->root);
297                 cifs_sb->root = NULL;
298         }
299
300         kill_anon_super(sb);
301         cifs_umount(cifs_sb);
302 }
303
304 static int
305 cifs_statfs(struct dentry *dentry, struct kstatfs *buf)
306 {
307         struct super_block *sb = dentry->d_sb;
308         struct cifs_sb_info *cifs_sb = CIFS_SB(sb);
309         struct cifs_tcon *tcon = cifs_sb_master_tcon(cifs_sb);
310         struct TCP_Server_Info *server = tcon->ses->server;
311         unsigned int xid;
312         int rc = 0;
313
314         xid = get_xid();
315
316         if (le32_to_cpu(tcon->fsAttrInfo.MaxPathNameComponentLength) > 0)
317                 buf->f_namelen =
318                        le32_to_cpu(tcon->fsAttrInfo.MaxPathNameComponentLength);
319         else
320                 buf->f_namelen = PATH_MAX;
321
322         buf->f_fsid.val[0] = tcon->vol_serial_number;
323         /* are using part of create time for more randomness, see man statfs */
324         buf->f_fsid.val[1] =  (int)le64_to_cpu(tcon->vol_create_time);
325
326         buf->f_files = 0;       /* undefined */
327         buf->f_ffree = 0;       /* unlimited */
328
329         if (server->ops->queryfs)
330                 rc = server->ops->queryfs(xid, tcon, cifs_sb, buf);
331
332         free_xid(xid);
333         return rc;
334 }
335
336 static long cifs_fallocate(struct file *file, int mode, loff_t off, loff_t len)
337 {
338         struct cifs_sb_info *cifs_sb = CIFS_FILE_SB(file);
339         struct cifs_tcon *tcon = cifs_sb_master_tcon(cifs_sb);
340         struct TCP_Server_Info *server = tcon->ses->server;
341
342         if (server->ops->fallocate)
343                 return server->ops->fallocate(file, tcon, mode, off, len);
344
345         return -EOPNOTSUPP;
346 }
347
348 static int cifs_permission(struct user_namespace *mnt_userns,
349                            struct inode *inode, int mask)
350 {
351         struct cifs_sb_info *cifs_sb;
352
353         cifs_sb = CIFS_SB(inode->i_sb);
354
355         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_NO_PERM) {
356                 if ((mask & MAY_EXEC) && !execute_ok(inode))
357                         return -EACCES;
358                 else
359                         return 0;
360         } else /* file mode might have been restricted at mount time
361                 on the client (above and beyond ACL on servers) for
362                 servers which do not support setting and viewing mode bits,
363                 so allowing client to check permissions is useful */
364                 return generic_permission(&init_user_ns, inode, mask);
365 }
366
367 static struct kmem_cache *cifs_inode_cachep;
368 static struct kmem_cache *cifs_req_cachep;
369 static struct kmem_cache *cifs_mid_cachep;
370 static struct kmem_cache *cifs_sm_req_cachep;
371 mempool_t *cifs_sm_req_poolp;
372 mempool_t *cifs_req_poolp;
373 mempool_t *cifs_mid_poolp;
374
375 static struct inode *
376 cifs_alloc_inode(struct super_block *sb)
377 {
378         struct cifsInodeInfo *cifs_inode;
379         cifs_inode = alloc_inode_sb(sb, cifs_inode_cachep, GFP_KERNEL);
380         if (!cifs_inode)
381                 return NULL;
382         cifs_inode->cifsAttrs = 0x20;   /* default */
383         cifs_inode->time = 0;
384         /*
385          * Until the file is open and we have gotten oplock info back from the
386          * server, can not assume caching of file data or metadata.
387          */
388         cifs_set_oplock_level(cifs_inode, 0);
389         cifs_inode->flags = 0;
390         spin_lock_init(&cifs_inode->writers_lock);
391         cifs_inode->writers = 0;
392         cifs_inode->netfs.inode.i_blkbits = 14;  /* 2**14 = CIFS_MAX_MSGSIZE */
393         cifs_inode->server_eof = 0;
394         cifs_inode->uniqueid = 0;
395         cifs_inode->createtime = 0;
396         cifs_inode->epoch = 0;
397         spin_lock_init(&cifs_inode->open_file_lock);
398         generate_random_uuid(cifs_inode->lease_key);
399
400         /*
401          * Can not set i_flags here - they get immediately overwritten to zero
402          * by the VFS.
403          */
404         /* cifs_inode->netfs.inode.i_flags = S_NOATIME | S_NOCMTIME; */
405         INIT_LIST_HEAD(&cifs_inode->openFileList);
406         INIT_LIST_HEAD(&cifs_inode->llist);
407         INIT_LIST_HEAD(&cifs_inode->deferred_closes);
408         spin_lock_init(&cifs_inode->deferred_lock);
409         return &cifs_inode->netfs.inode;
410 }
411
412 static void
413 cifs_free_inode(struct inode *inode)
414 {
415         kmem_cache_free(cifs_inode_cachep, CIFS_I(inode));
416 }
417
418 static void
419 cifs_evict_inode(struct inode *inode)
420 {
421         truncate_inode_pages_final(&inode->i_data);
422         if (inode->i_state & I_PINNING_FSCACHE_WB)
423                 cifs_fscache_unuse_inode_cookie(inode, true);
424         cifs_fscache_release_inode_cookie(inode);
425         clear_inode(inode);
426 }
427
428 static void
429 cifs_show_address(struct seq_file *s, struct TCP_Server_Info *server)
430 {
431         struct sockaddr_in *sa = (struct sockaddr_in *) &server->dstaddr;
432         struct sockaddr_in6 *sa6 = (struct sockaddr_in6 *) &server->dstaddr;
433
434         seq_puts(s, ",addr=");
435
436         switch (server->dstaddr.ss_family) {
437         case AF_INET:
438                 seq_printf(s, "%pI4", &sa->sin_addr.s_addr);
439                 break;
440         case AF_INET6:
441                 seq_printf(s, "%pI6", &sa6->sin6_addr.s6_addr);
442                 if (sa6->sin6_scope_id)
443                         seq_printf(s, "%%%u", sa6->sin6_scope_id);
444                 break;
445         default:
446                 seq_puts(s, "(unknown)");
447         }
448         if (server->rdma)
449                 seq_puts(s, ",rdma");
450 }
451
452 static void
453 cifs_show_security(struct seq_file *s, struct cifs_ses *ses)
454 {
455         if (ses->sectype == Unspecified) {
456                 if (ses->user_name == NULL)
457                         seq_puts(s, ",sec=none");
458                 return;
459         }
460
461         seq_puts(s, ",sec=");
462
463         switch (ses->sectype) {
464         case NTLMv2:
465                 seq_puts(s, "ntlmv2");
466                 break;
467         case Kerberos:
468                 seq_puts(s, "krb5");
469                 break;
470         case RawNTLMSSP:
471                 seq_puts(s, "ntlmssp");
472                 break;
473         default:
474                 /* shouldn't ever happen */
475                 seq_puts(s, "unknown");
476                 break;
477         }
478
479         if (ses->sign)
480                 seq_puts(s, "i");
481
482         if (ses->sectype == Kerberos)
483                 seq_printf(s, ",cruid=%u",
484                            from_kuid_munged(&init_user_ns, ses->cred_uid));
485 }
486
487 static void
488 cifs_show_cache_flavor(struct seq_file *s, struct cifs_sb_info *cifs_sb)
489 {
490         seq_puts(s, ",cache=");
491
492         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_STRICT_IO)
493                 seq_puts(s, "strict");
494         else if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_DIRECT_IO)
495                 seq_puts(s, "none");
496         else if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_RW_CACHE)
497                 seq_puts(s, "singleclient"); /* assume only one client access */
498         else if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_RO_CACHE)
499                 seq_puts(s, "ro"); /* read only caching assumed */
500         else
501                 seq_puts(s, "loose");
502 }
503
504 /*
505  * cifs_show_devname() is used so we show the mount device name with correct
506  * format (e.g. forward slashes vs. back slashes) in /proc/mounts
507  */
508 static int cifs_show_devname(struct seq_file *m, struct dentry *root)
509 {
510         struct cifs_sb_info *cifs_sb = CIFS_SB(root->d_sb);
511         char *devname = kstrdup(cifs_sb->ctx->source, GFP_KERNEL);
512
513         if (devname == NULL)
514                 seq_puts(m, "none");
515         else {
516                 convert_delimiter(devname, '/');
517                 /* escape all spaces in share names */
518                 seq_escape(m, devname, " \t");
519                 kfree(devname);
520         }
521         return 0;
522 }
523
524 /*
525  * cifs_show_options() is for displaying mount options in /proc/mounts.
526  * Not all settable options are displayed but most of the important
527  * ones are.
528  */
529 static int
530 cifs_show_options(struct seq_file *s, struct dentry *root)
531 {
532         struct cifs_sb_info *cifs_sb = CIFS_SB(root->d_sb);
533         struct cifs_tcon *tcon = cifs_sb_master_tcon(cifs_sb);
534         struct sockaddr *srcaddr;
535         srcaddr = (struct sockaddr *)&tcon->ses->server->srcaddr;
536
537         seq_show_option(s, "vers", tcon->ses->server->vals->version_string);
538         cifs_show_security(s, tcon->ses);
539         cifs_show_cache_flavor(s, cifs_sb);
540
541         if (tcon->no_lease)
542                 seq_puts(s, ",nolease");
543         if (cifs_sb->ctx->multiuser)
544                 seq_puts(s, ",multiuser");
545         else if (tcon->ses->user_name)
546                 seq_show_option(s, "username", tcon->ses->user_name);
547
548         if (tcon->ses->domainName && tcon->ses->domainName[0] != 0)
549                 seq_show_option(s, "domain", tcon->ses->domainName);
550
551         if (srcaddr->sa_family != AF_UNSPEC) {
552                 struct sockaddr_in *saddr4;
553                 struct sockaddr_in6 *saddr6;
554                 saddr4 = (struct sockaddr_in *)srcaddr;
555                 saddr6 = (struct sockaddr_in6 *)srcaddr;
556                 if (srcaddr->sa_family == AF_INET6)
557                         seq_printf(s, ",srcaddr=%pI6c",
558                                    &saddr6->sin6_addr);
559                 else if (srcaddr->sa_family == AF_INET)
560                         seq_printf(s, ",srcaddr=%pI4",
561                                    &saddr4->sin_addr.s_addr);
562                 else
563                         seq_printf(s, ",srcaddr=BAD-AF:%i",
564                                    (int)(srcaddr->sa_family));
565         }
566
567         seq_printf(s, ",uid=%u",
568                    from_kuid_munged(&init_user_ns, cifs_sb->ctx->linux_uid));
569         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_OVERR_UID)
570                 seq_puts(s, ",forceuid");
571         else
572                 seq_puts(s, ",noforceuid");
573
574         seq_printf(s, ",gid=%u",
575                    from_kgid_munged(&init_user_ns, cifs_sb->ctx->linux_gid));
576         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_OVERR_GID)
577                 seq_puts(s, ",forcegid");
578         else
579                 seq_puts(s, ",noforcegid");
580
581         cifs_show_address(s, tcon->ses->server);
582
583         if (!tcon->unix_ext)
584                 seq_printf(s, ",file_mode=0%ho,dir_mode=0%ho",
585                                            cifs_sb->ctx->file_mode,
586                                            cifs_sb->ctx->dir_mode);
587         if (cifs_sb->ctx->iocharset)
588                 seq_printf(s, ",iocharset=%s", cifs_sb->ctx->iocharset);
589         if (tcon->seal)
590                 seq_puts(s, ",seal");
591         else if (tcon->ses->server->ignore_signature)
592                 seq_puts(s, ",signloosely");
593         if (tcon->nocase)
594                 seq_puts(s, ",nocase");
595         if (tcon->nodelete)
596                 seq_puts(s, ",nodelete");
597         if (cifs_sb->ctx->no_sparse)
598                 seq_puts(s, ",nosparse");
599         if (tcon->local_lease)
600                 seq_puts(s, ",locallease");
601         if (tcon->retry)
602                 seq_puts(s, ",hard");
603         else
604                 seq_puts(s, ",soft");
605         if (tcon->use_persistent)
606                 seq_puts(s, ",persistenthandles");
607         else if (tcon->use_resilient)
608                 seq_puts(s, ",resilienthandles");
609         if (tcon->posix_extensions)
610                 seq_puts(s, ",posix");
611         else if (tcon->unix_ext)
612                 seq_puts(s, ",unix");
613         else
614                 seq_puts(s, ",nounix");
615         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_NO_DFS)
616                 seq_puts(s, ",nodfs");
617         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_POSIX_PATHS)
618                 seq_puts(s, ",posixpaths");
619         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_SET_UID)
620                 seq_puts(s, ",setuids");
621         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_UID_FROM_ACL)
622                 seq_puts(s, ",idsfromsid");
623         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_SERVER_INUM)
624                 seq_puts(s, ",serverino");
625         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_RWPIDFORWARD)
626                 seq_puts(s, ",rwpidforward");
627         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_NOPOSIXBRL)
628                 seq_puts(s, ",forcemand");
629         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_NO_XATTR)
630                 seq_puts(s, ",nouser_xattr");
631         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_MAP_SPECIAL_CHR)
632                 seq_puts(s, ",mapchars");
633         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_MAP_SFM_CHR)
634                 seq_puts(s, ",mapposix");
635         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_UNX_EMUL)
636                 seq_puts(s, ",sfu");
637         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_NO_BRL)
638                 seq_puts(s, ",nobrl");
639         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_NO_HANDLE_CACHE)
640                 seq_puts(s, ",nohandlecache");
641         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_MODE_FROM_SID)
642                 seq_puts(s, ",modefromsid");
643         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_CIFS_ACL)
644                 seq_puts(s, ",cifsacl");
645         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_DYNPERM)
646                 seq_puts(s, ",dynperm");
647         if (root->d_sb->s_flags & SB_POSIXACL)
648                 seq_puts(s, ",acl");
649         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_MF_SYMLINKS)
650                 seq_puts(s, ",mfsymlinks");
651         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_FSCACHE)
652                 seq_puts(s, ",fsc");
653         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_NOSSYNC)
654                 seq_puts(s, ",nostrictsync");
655         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_NO_PERM)
656                 seq_puts(s, ",noperm");
657         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_CIFS_BACKUPUID)
658                 seq_printf(s, ",backupuid=%u",
659                            from_kuid_munged(&init_user_ns,
660                                             cifs_sb->ctx->backupuid));
661         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_CIFS_BACKUPGID)
662                 seq_printf(s, ",backupgid=%u",
663                            from_kgid_munged(&init_user_ns,
664                                             cifs_sb->ctx->backupgid));
665
666         seq_printf(s, ",rsize=%u", cifs_sb->ctx->rsize);
667         seq_printf(s, ",wsize=%u", cifs_sb->ctx->wsize);
668         seq_printf(s, ",bsize=%u", cifs_sb->ctx->bsize);
669         if (cifs_sb->ctx->rasize)
670                 seq_printf(s, ",rasize=%u", cifs_sb->ctx->rasize);
671         if (tcon->ses->server->min_offload)
672                 seq_printf(s, ",esize=%u", tcon->ses->server->min_offload);
673         seq_printf(s, ",echo_interval=%lu",
674                         tcon->ses->server->echo_interval / HZ);
675
676         /* Only display max_credits if it was overridden on mount */
677         if (tcon->ses->server->max_credits != SMB2_MAX_CREDITS_AVAILABLE)
678                 seq_printf(s, ",max_credits=%u", tcon->ses->server->max_credits);
679
680         if (tcon->snapshot_time)
681                 seq_printf(s, ",snapshot=%llu", tcon->snapshot_time);
682         if (tcon->handle_timeout)
683                 seq_printf(s, ",handletimeout=%u", tcon->handle_timeout);
684
685         /*
686          * Display file and directory attribute timeout in seconds.
687          * If file and directory attribute timeout the same then actimeo
688          * was likely specified on mount
689          */
690         if (cifs_sb->ctx->acdirmax == cifs_sb->ctx->acregmax)
691                 seq_printf(s, ",actimeo=%lu", cifs_sb->ctx->acregmax / HZ);
692         else {
693                 seq_printf(s, ",acdirmax=%lu", cifs_sb->ctx->acdirmax / HZ);
694                 seq_printf(s, ",acregmax=%lu", cifs_sb->ctx->acregmax / HZ);
695         }
696
697         if (tcon->ses->chan_max > 1)
698                 seq_printf(s, ",multichannel,max_channels=%zu",
699                            tcon->ses->chan_max);
700
701         if (tcon->use_witness)
702                 seq_puts(s, ",witness");
703
704         return 0;
705 }
706
707 static void cifs_umount_begin(struct super_block *sb)
708 {
709         struct cifs_sb_info *cifs_sb = CIFS_SB(sb);
710         struct cifs_tcon *tcon;
711
712         if (cifs_sb == NULL)
713                 return;
714
715         tcon = cifs_sb_master_tcon(cifs_sb);
716
717         spin_lock(&cifs_tcp_ses_lock);
718         spin_lock(&tcon->tc_lock);
719         if ((tcon->tc_count > 1) || (tcon->status == TID_EXITING)) {
720                 /* we have other mounts to same share or we have
721                    already tried to force umount this and woken up
722                    all waiting network requests, nothing to do */
723                 spin_unlock(&tcon->tc_lock);
724                 spin_unlock(&cifs_tcp_ses_lock);
725                 return;
726         } else if (tcon->tc_count == 1)
727                 tcon->status = TID_EXITING;
728         spin_unlock(&tcon->tc_lock);
729         spin_unlock(&cifs_tcp_ses_lock);
730
731         /* cancel_brl_requests(tcon); */ /* BB mark all brl mids as exiting */
732         /* cancel_notify_requests(tcon); */
733         if (tcon->ses && tcon->ses->server) {
734                 cifs_dbg(FYI, "wake up tasks now - umount begin not complete\n");
735                 wake_up_all(&tcon->ses->server->request_q);
736                 wake_up_all(&tcon->ses->server->response_q);
737                 msleep(1); /* yield */
738                 /* we have to kick the requests once more */
739                 wake_up_all(&tcon->ses->server->response_q);
740                 msleep(1);
741         }
742
743         return;
744 }
745
746 #ifdef CONFIG_CIFS_STATS2
747 static int cifs_show_stats(struct seq_file *s, struct dentry *root)
748 {
749         /* BB FIXME */
750         return 0;
751 }
752 #endif
753
754 static int cifs_write_inode(struct inode *inode, struct writeback_control *wbc)
755 {
756         fscache_unpin_writeback(wbc, cifs_inode_cookie(inode));
757         return 0;
758 }
759
760 static int cifs_drop_inode(struct inode *inode)
761 {
762         struct cifs_sb_info *cifs_sb = CIFS_SB(inode->i_sb);
763
764         /* no serverino => unconditional eviction */
765         return !(cifs_sb->mnt_cifs_flags & CIFS_MOUNT_SERVER_INUM) ||
766                 generic_drop_inode(inode);
767 }
768
769 static const struct super_operations cifs_super_ops = {
770         .statfs = cifs_statfs,
771         .alloc_inode = cifs_alloc_inode,
772         .write_inode    = cifs_write_inode,
773         .free_inode = cifs_free_inode,
774         .drop_inode     = cifs_drop_inode,
775         .evict_inode    = cifs_evict_inode,
776 /*      .show_path      = cifs_show_path, */ /* Would we ever need show path? */
777         .show_devname   = cifs_show_devname,
778 /*      .delete_inode   = cifs_delete_inode,  */  /* Do not need above
779         function unless later we add lazy close of inodes or unless the
780         kernel forgets to call us with the same number of releases (closes)
781         as opens */
782         .show_options = cifs_show_options,
783         .umount_begin   = cifs_umount_begin,
784 #ifdef CONFIG_CIFS_STATS2
785         .show_stats = cifs_show_stats,
786 #endif
787 };
788
789 /*
790  * Get root dentry from superblock according to prefix path mount option.
791  * Return dentry with refcount + 1 on success and NULL otherwise.
792  */
793 static struct dentry *
794 cifs_get_root(struct smb3_fs_context *ctx, struct super_block *sb)
795 {
796         struct dentry *dentry;
797         struct cifs_sb_info *cifs_sb = CIFS_SB(sb);
798         char *full_path = NULL;
799         char *s, *p;
800         char sep;
801
802         if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_USE_PREFIX_PATH)
803                 return dget(sb->s_root);
804
805         full_path = cifs_build_path_to_root(ctx, cifs_sb,
806                                 cifs_sb_master_tcon(cifs_sb), 0);
807         if (full_path == NULL)
808                 return ERR_PTR(-ENOMEM);
809
810         cifs_dbg(FYI, "Get root dentry for %s\n", full_path);
811
812         sep = CIFS_DIR_SEP(cifs_sb);
813         dentry = dget(sb->s_root);
814         s = full_path;
815
816         do {
817                 struct inode *dir = d_inode(dentry);
818                 struct dentry *child;
819
820                 if (!S_ISDIR(dir->i_mode)) {
821                         dput(dentry);
822                         dentry = ERR_PTR(-ENOTDIR);
823                         break;
824                 }
825
826                 /* skip separators */
827                 while (*s == sep)
828                         s++;
829                 if (!*s)
830                         break;
831                 p = s++;
832                 /* next separator */
833                 while (*s && *s != sep)
834                         s++;
835
836                 child = lookup_positive_unlocked(p, dentry, s - p);
837                 dput(dentry);
838                 dentry = child;
839         } while (!IS_ERR(dentry));
840         kfree(full_path);
841         return dentry;
842 }
843
844 static int cifs_set_super(struct super_block *sb, void *data)
845 {
846         struct cifs_mnt_data *mnt_data = data;
847         sb->s_fs_info = mnt_data->cifs_sb;
848         return set_anon_super(sb, NULL);
849 }
850
851 struct dentry *
852 cifs_smb3_do_mount(struct file_system_type *fs_type,
853               int flags, struct smb3_fs_context *old_ctx)
854 {
855         int rc;
856         struct super_block *sb = NULL;
857         struct cifs_sb_info *cifs_sb = NULL;
858         struct cifs_mnt_data mnt_data;
859         struct dentry *root;
860
861         /*
862          * Prints in Kernel / CIFS log the attempted mount operation
863          *      If CIFS_DEBUG && cifs_FYI
864          */
865         if (cifsFYI)
866                 cifs_dbg(FYI, "Devname: %s flags: %d\n", old_ctx->UNC, flags);
867         else
868                 cifs_info("Attempting to mount %s\n", old_ctx->UNC);
869
870         cifs_sb = kzalloc(sizeof(struct cifs_sb_info), GFP_KERNEL);
871         if (cifs_sb == NULL) {
872                 root = ERR_PTR(-ENOMEM);
873                 goto out;
874         }
875
876         cifs_sb->ctx = kzalloc(sizeof(struct smb3_fs_context), GFP_KERNEL);
877         if (!cifs_sb->ctx) {
878                 root = ERR_PTR(-ENOMEM);
879                 goto out;
880         }
881         rc = smb3_fs_context_dup(cifs_sb->ctx, old_ctx);
882         if (rc) {
883                 root = ERR_PTR(rc);
884                 goto out;
885         }
886
887         rc = cifs_setup_volume_info(cifs_sb->ctx, NULL, NULL);
888         if (rc) {
889                 root = ERR_PTR(rc);
890                 goto out;
891         }
892
893         rc = cifs_setup_cifs_sb(cifs_sb);
894         if (rc) {
895                 root = ERR_PTR(rc);
896                 goto out;
897         }
898
899         rc = cifs_mount(cifs_sb, cifs_sb->ctx);
900         if (rc) {
901                 if (!(flags & SB_SILENT))
902                         cifs_dbg(VFS, "cifs_mount failed w/return code = %d\n",
903                                  rc);
904                 root = ERR_PTR(rc);
905                 goto out;
906         }
907
908         mnt_data.ctx = cifs_sb->ctx;
909         mnt_data.cifs_sb = cifs_sb;
910         mnt_data.flags = flags;
911
912         /* BB should we make this contingent on mount parm? */
913         flags |= SB_NODIRATIME | SB_NOATIME;
914
915         sb = sget(fs_type, cifs_match_super, cifs_set_super, flags, &mnt_data);
916         if (IS_ERR(sb)) {
917                 root = ERR_CAST(sb);
918                 cifs_umount(cifs_sb);
919                 cifs_sb = NULL;
920                 goto out;
921         }
922
923         if (sb->s_root) {
924                 cifs_dbg(FYI, "Use existing superblock\n");
925                 cifs_umount(cifs_sb);
926                 cifs_sb = NULL;
927         } else {
928                 rc = cifs_read_super(sb);
929                 if (rc) {
930                         root = ERR_PTR(rc);
931                         goto out_super;
932                 }
933
934                 sb->s_flags |= SB_ACTIVE;
935         }
936
937         root = cifs_get_root(cifs_sb ? cifs_sb->ctx : old_ctx, sb);
938         if (IS_ERR(root))
939                 goto out_super;
940
941         if (cifs_sb)
942                 cifs_sb->root = dget(root);
943
944         cifs_dbg(FYI, "dentry root is: %p\n", root);
945         return root;
946
947 out_super:
948         deactivate_locked_super(sb);
949         return root;
950 out:
951         if (cifs_sb) {
952                 if (!sb || IS_ERR(sb)) {  /* otherwise kill_sb will handle */
953                         kfree(cifs_sb->prepath);
954                         smb3_cleanup_fs_context(cifs_sb->ctx);
955                         kfree(cifs_sb);
956                 }
957         }
958         return root;
959 }
960
961
962 static ssize_t
963 cifs_loose_read_iter(struct kiocb *iocb, struct iov_iter *iter)
964 {
965         ssize_t rc;
966         struct inode *inode = file_inode(iocb->ki_filp);
967
968         if (iocb->ki_flags & IOCB_DIRECT)
969                 return cifs_user_readv(iocb, iter);
970
971         rc = cifs_revalidate_mapping(inode);
972         if (rc)
973                 return rc;
974
975         return generic_file_read_iter(iocb, iter);
976 }
977
978 static ssize_t cifs_file_write_iter(struct kiocb *iocb, struct iov_iter *from)
979 {
980         struct inode *inode = file_inode(iocb->ki_filp);
981         struct cifsInodeInfo *cinode = CIFS_I(inode);
982         ssize_t written;
983         int rc;
984
985         if (iocb->ki_filp->f_flags & O_DIRECT) {
986                 written = cifs_user_writev(iocb, from);
987                 if (written > 0 && CIFS_CACHE_READ(cinode)) {
988                         cifs_zap_mapping(inode);
989                         cifs_dbg(FYI,
990                                  "Set no oplock for inode=%p after a write operation\n",
991                                  inode);
992                         cinode->oplock = 0;
993                 }
994                 return written;
995         }
996
997         written = cifs_get_writer(cinode);
998         if (written)
999                 return written;
1000
1001         written = generic_file_write_iter(iocb, from);
1002
1003         if (CIFS_CACHE_WRITE(CIFS_I(inode)))
1004                 goto out;
1005
1006         rc = filemap_fdatawrite(inode->i_mapping);
1007         if (rc)
1008                 cifs_dbg(FYI, "cifs_file_write_iter: %d rc on %p inode\n",
1009                          rc, inode);
1010
1011 out:
1012         cifs_put_writer(cinode);
1013         return written;
1014 }
1015
1016 static loff_t cifs_llseek(struct file *file, loff_t offset, int whence)
1017 {
1018         struct cifsFileInfo *cfile = file->private_data;
1019         struct cifs_tcon *tcon;
1020
1021         /*
1022          * whence == SEEK_END || SEEK_DATA || SEEK_HOLE => we must revalidate
1023          * the cached file length
1024          */
1025         if (whence != SEEK_SET && whence != SEEK_CUR) {
1026                 int rc;
1027                 struct inode *inode = file_inode(file);
1028
1029                 /*
1030                  * We need to be sure that all dirty pages are written and the
1031                  * server has the newest file length.
1032                  */
1033                 if (!CIFS_CACHE_READ(CIFS_I(inode)) && inode->i_mapping &&
1034                     inode->i_mapping->nrpages != 0) {
1035                         rc = filemap_fdatawait(inode->i_mapping);
1036                         if (rc) {
1037                                 mapping_set_error(inode->i_mapping, rc);
1038                                 return rc;
1039                         }
1040                 }
1041                 /*
1042                  * Some applications poll for the file length in this strange
1043                  * way so we must seek to end on non-oplocked files by
1044                  * setting the revalidate time to zero.
1045                  */
1046                 CIFS_I(inode)->time = 0;
1047
1048                 rc = cifs_revalidate_file_attr(file);
1049                 if (rc < 0)
1050                         return (loff_t)rc;
1051         }
1052         if (cfile && cfile->tlink) {
1053                 tcon = tlink_tcon(cfile->tlink);
1054                 if (tcon->ses->server->ops->llseek)
1055                         return tcon->ses->server->ops->llseek(file, tcon,
1056                                                               offset, whence);
1057         }
1058         return generic_file_llseek(file, offset, whence);
1059 }
1060
1061 static int
1062 cifs_setlease(struct file *file, long arg, struct file_lock **lease, void **priv)
1063 {
1064         /*
1065          * Note that this is called by vfs setlease with i_lock held to
1066          * protect *lease from going away.
1067          */
1068         struct inode *inode = file_inode(file);
1069         struct cifsFileInfo *cfile = file->private_data;
1070
1071         if (!(S_ISREG(inode->i_mode)))
1072                 return -EINVAL;
1073
1074         /* Check if file is oplocked if this is request for new lease */
1075         if (arg == F_UNLCK ||
1076             ((arg == F_RDLCK) && CIFS_CACHE_READ(CIFS_I(inode))) ||
1077             ((arg == F_WRLCK) && CIFS_CACHE_WRITE(CIFS_I(inode))))
1078                 return generic_setlease(file, arg, lease, priv);
1079         else if (tlink_tcon(cfile->tlink)->local_lease &&
1080                  !CIFS_CACHE_READ(CIFS_I(inode)))
1081                 /*
1082                  * If the server claims to support oplock on this file, then we
1083                  * still need to check oplock even if the local_lease mount
1084                  * option is set, but there are servers which do not support
1085                  * oplock for which this mount option may be useful if the user
1086                  * knows that the file won't be changed on the server by anyone
1087                  * else.
1088                  */
1089                 return generic_setlease(file, arg, lease, priv);
1090         else
1091                 return -EAGAIN;
1092 }
1093
1094 struct file_system_type cifs_fs_type = {
1095         .owner = THIS_MODULE,
1096         .name = "cifs",
1097         .init_fs_context = smb3_init_fs_context,
1098         .parameters = smb3_fs_parameters,
1099         .kill_sb = cifs_kill_sb,
1100         .fs_flags = FS_RENAME_DOES_D_MOVE,
1101 };
1102 MODULE_ALIAS_FS("cifs");
1103
1104 struct file_system_type smb3_fs_type = {
1105         .owner = THIS_MODULE,
1106         .name = "smb3",
1107         .init_fs_context = smb3_init_fs_context,
1108         .parameters = smb3_fs_parameters,
1109         .kill_sb = cifs_kill_sb,
1110         .fs_flags = FS_RENAME_DOES_D_MOVE,
1111 };
1112 MODULE_ALIAS_FS("smb3");
1113 MODULE_ALIAS("smb3");
1114
1115 const struct inode_operations cifs_dir_inode_ops = {
1116         .create = cifs_create,
1117         .atomic_open = cifs_atomic_open,
1118         .lookup = cifs_lookup,
1119         .getattr = cifs_getattr,
1120         .unlink = cifs_unlink,
1121         .link = cifs_hardlink,
1122         .mkdir = cifs_mkdir,
1123         .rmdir = cifs_rmdir,
1124         .rename = cifs_rename2,
1125         .permission = cifs_permission,
1126         .setattr = cifs_setattr,
1127         .symlink = cifs_symlink,
1128         .mknod   = cifs_mknod,
1129         .listxattr = cifs_listxattr,
1130 };
1131
1132 const struct inode_operations cifs_file_inode_ops = {
1133         .setattr = cifs_setattr,
1134         .getattr = cifs_getattr,
1135         .permission = cifs_permission,
1136         .listxattr = cifs_listxattr,
1137         .fiemap = cifs_fiemap,
1138 };
1139
1140 const struct inode_operations cifs_symlink_inode_ops = {
1141         .get_link = cifs_get_link,
1142         .permission = cifs_permission,
1143         .listxattr = cifs_listxattr,
1144 };
1145
1146 static loff_t cifs_remap_file_range(struct file *src_file, loff_t off,
1147                 struct file *dst_file, loff_t destoff, loff_t len,
1148                 unsigned int remap_flags)
1149 {
1150         struct inode *src_inode = file_inode(src_file);
1151         struct inode *target_inode = file_inode(dst_file);
1152         struct cifsFileInfo *smb_file_src = src_file->private_data;
1153         struct cifsFileInfo *smb_file_target;
1154         struct cifs_tcon *target_tcon;
1155         unsigned int xid;
1156         int rc;
1157
1158         if (remap_flags & ~(REMAP_FILE_DEDUP | REMAP_FILE_ADVISORY))
1159                 return -EINVAL;
1160
1161         cifs_dbg(FYI, "clone range\n");
1162
1163         xid = get_xid();
1164
1165         if (!src_file->private_data || !dst_file->private_data) {
1166                 rc = -EBADF;
1167                 cifs_dbg(VFS, "missing cifsFileInfo on copy range src file\n");
1168                 goto out;
1169         }
1170
1171         smb_file_target = dst_file->private_data;
1172         target_tcon = tlink_tcon(smb_file_target->tlink);
1173
1174         /*
1175          * Note: cifs case is easier than btrfs since server responsible for
1176          * checks for proper open modes and file type and if it wants
1177          * server could even support copy of range where source = target
1178          */
1179         lock_two_nondirectories(target_inode, src_inode);
1180
1181         if (len == 0)
1182                 len = src_inode->i_size - off;
1183
1184         cifs_dbg(FYI, "about to flush pages\n");
1185         /* should we flush first and last page first */
1186         truncate_inode_pages_range(&target_inode->i_data, destoff,
1187                                    PAGE_ALIGN(destoff + len)-1);
1188
1189         if (target_tcon->ses->server->ops->duplicate_extents)
1190                 rc = target_tcon->ses->server->ops->duplicate_extents(xid,
1191                         smb_file_src, smb_file_target, off, len, destoff);
1192         else
1193                 rc = -EOPNOTSUPP;
1194
1195         /* force revalidate of size and timestamps of target file now
1196            that target is updated on the server */
1197         CIFS_I(target_inode)->time = 0;
1198         /* although unlocking in the reverse order from locking is not
1199            strictly necessary here it is a little cleaner to be consistent */
1200         unlock_two_nondirectories(src_inode, target_inode);
1201 out:
1202         free_xid(xid);
1203         return rc < 0 ? rc : len;
1204 }
1205
1206 ssize_t cifs_file_copychunk_range(unsigned int xid,
1207                                 struct file *src_file, loff_t off,
1208                                 struct file *dst_file, loff_t destoff,
1209                                 size_t len, unsigned int flags)
1210 {
1211         struct inode *src_inode = file_inode(src_file);
1212         struct inode *target_inode = file_inode(dst_file);
1213         struct cifsFileInfo *smb_file_src;
1214         struct cifsFileInfo *smb_file_target;
1215         struct cifs_tcon *src_tcon;
1216         struct cifs_tcon *target_tcon;
1217         ssize_t rc;
1218
1219         cifs_dbg(FYI, "copychunk range\n");
1220
1221         if (!src_file->private_data || !dst_file->private_data) {
1222                 rc = -EBADF;
1223                 cifs_dbg(VFS, "missing cifsFileInfo on copy range src file\n");
1224                 goto out;
1225         }
1226
1227         rc = -EXDEV;
1228         smb_file_target = dst_file->private_data;
1229         smb_file_src = src_file->private_data;
1230         src_tcon = tlink_tcon(smb_file_src->tlink);
1231         target_tcon = tlink_tcon(smb_file_target->tlink);
1232
1233         if (src_tcon->ses != target_tcon->ses) {
1234                 cifs_dbg(VFS, "source and target of copy not on same server\n");
1235                 goto out;
1236         }
1237
1238         rc = -EOPNOTSUPP;
1239         if (!target_tcon->ses->server->ops->copychunk_range)
1240                 goto out;
1241
1242         /*
1243          * Note: cifs case is easier than btrfs since server responsible for
1244          * checks for proper open modes and file type and if it wants
1245          * server could even support copy of range where source = target
1246          */
1247         lock_two_nondirectories(target_inode, src_inode);
1248
1249         cifs_dbg(FYI, "about to flush pages\n");
1250         /* should we flush first and last page first */
1251         truncate_inode_pages(&target_inode->i_data, 0);
1252
1253         rc = file_modified(dst_file);
1254         if (!rc)
1255                 rc = target_tcon->ses->server->ops->copychunk_range(xid,
1256                         smb_file_src, smb_file_target, off, len, destoff);
1257
1258         file_accessed(src_file);
1259
1260         /* force revalidate of size and timestamps of target file now
1261          * that target is updated on the server
1262          */
1263         CIFS_I(target_inode)->time = 0;
1264         /* although unlocking in the reverse order from locking is not
1265          * strictly necessary here it is a little cleaner to be consistent
1266          */
1267         unlock_two_nondirectories(src_inode, target_inode);
1268
1269 out:
1270         return rc;
1271 }
1272
1273 /*
1274  * Directory operations under CIFS/SMB2/SMB3 are synchronous, so fsync()
1275  * is a dummy operation.
1276  */
1277 static int cifs_dir_fsync(struct file *file, loff_t start, loff_t end, int datasync)
1278 {
1279         cifs_dbg(FYI, "Sync directory - name: %pD datasync: 0x%x\n",
1280                  file, datasync);
1281
1282         return 0;
1283 }
1284
1285 static ssize_t cifs_copy_file_range(struct file *src_file, loff_t off,
1286                                 struct file *dst_file, loff_t destoff,
1287                                 size_t len, unsigned int flags)
1288 {
1289         unsigned int xid = get_xid();
1290         ssize_t rc;
1291         struct cifsFileInfo *cfile = dst_file->private_data;
1292
1293         if (cfile->swapfile)
1294                 return -EOPNOTSUPP;
1295
1296         rc = cifs_file_copychunk_range(xid, src_file, off, dst_file, destoff,
1297                                         len, flags);
1298         free_xid(xid);
1299
1300         if (rc == -EOPNOTSUPP || rc == -EXDEV)
1301                 rc = generic_copy_file_range(src_file, off, dst_file,
1302                                              destoff, len, flags);
1303         return rc;
1304 }
1305
1306 const struct file_operations cifs_file_ops = {
1307         .read_iter = cifs_loose_read_iter,
1308         .write_iter = cifs_file_write_iter,
1309         .open = cifs_open,
1310         .release = cifs_close,
1311         .lock = cifs_lock,
1312         .flock = cifs_flock,
1313         .fsync = cifs_fsync,
1314         .flush = cifs_flush,
1315         .mmap  = cifs_file_mmap,
1316         .splice_read = generic_file_splice_read,
1317         .splice_write = iter_file_splice_write,
1318         .llseek = cifs_llseek,
1319         .unlocked_ioctl = cifs_ioctl,
1320         .copy_file_range = cifs_copy_file_range,
1321         .remap_file_range = cifs_remap_file_range,
1322         .setlease = cifs_setlease,
1323         .fallocate = cifs_fallocate,
1324 };
1325
1326 const struct file_operations cifs_file_strict_ops = {
1327         .read_iter = cifs_strict_readv,
1328         .write_iter = cifs_strict_writev,
1329         .open = cifs_open,
1330         .release = cifs_close,
1331         .lock = cifs_lock,
1332         .flock = cifs_flock,
1333         .fsync = cifs_strict_fsync,
1334         .flush = cifs_flush,
1335         .mmap = cifs_file_strict_mmap,
1336         .splice_read = generic_file_splice_read,
1337         .splice_write = iter_file_splice_write,
1338         .llseek = cifs_llseek,
1339         .unlocked_ioctl = cifs_ioctl,
1340         .copy_file_range = cifs_copy_file_range,
1341         .remap_file_range = cifs_remap_file_range,
1342         .setlease = cifs_setlease,
1343         .fallocate = cifs_fallocate,
1344 };
1345
1346 const struct file_operations cifs_file_direct_ops = {
1347         .read_iter = cifs_direct_readv,
1348         .write_iter = cifs_direct_writev,
1349         .open = cifs_open,
1350         .release = cifs_close,
1351         .lock = cifs_lock,
1352         .flock = cifs_flock,
1353         .fsync = cifs_fsync,
1354         .flush = cifs_flush,
1355         .mmap = cifs_file_mmap,
1356         .splice_read = generic_file_splice_read,
1357         .splice_write = iter_file_splice_write,
1358         .unlocked_ioctl  = cifs_ioctl,
1359         .copy_file_range = cifs_copy_file_range,
1360         .remap_file_range = cifs_remap_file_range,
1361         .llseek = cifs_llseek,
1362         .setlease = cifs_setlease,
1363         .fallocate = cifs_fallocate,
1364 };
1365
1366 const struct file_operations cifs_file_nobrl_ops = {
1367         .read_iter = cifs_loose_read_iter,
1368         .write_iter = cifs_file_write_iter,
1369         .open = cifs_open,
1370         .release = cifs_close,
1371         .fsync = cifs_fsync,
1372         .flush = cifs_flush,
1373         .mmap  = cifs_file_mmap,
1374         .splice_read = generic_file_splice_read,
1375         .splice_write = iter_file_splice_write,
1376         .llseek = cifs_llseek,
1377         .unlocked_ioctl = cifs_ioctl,
1378         .copy_file_range = cifs_copy_file_range,
1379         .remap_file_range = cifs_remap_file_range,
1380         .setlease = cifs_setlease,
1381         .fallocate = cifs_fallocate,
1382 };
1383
1384 const struct file_operations cifs_file_strict_nobrl_ops = {
1385         .read_iter = cifs_strict_readv,
1386         .write_iter = cifs_strict_writev,
1387         .open = cifs_open,
1388         .release = cifs_close,
1389         .fsync = cifs_strict_fsync,
1390         .flush = cifs_flush,
1391         .mmap = cifs_file_strict_mmap,
1392         .splice_read = generic_file_splice_read,
1393         .splice_write = iter_file_splice_write,
1394         .llseek = cifs_llseek,
1395         .unlocked_ioctl = cifs_ioctl,
1396         .copy_file_range = cifs_copy_file_range,
1397         .remap_file_range = cifs_remap_file_range,
1398         .setlease = cifs_setlease,
1399         .fallocate = cifs_fallocate,
1400 };
1401
1402 const struct file_operations cifs_file_direct_nobrl_ops = {
1403         .read_iter = cifs_direct_readv,
1404         .write_iter = cifs_direct_writev,
1405         .open = cifs_open,
1406         .release = cifs_close,
1407         .fsync = cifs_fsync,
1408         .flush = cifs_flush,
1409         .mmap = cifs_file_mmap,
1410         .splice_read = generic_file_splice_read,
1411         .splice_write = iter_file_splice_write,
1412         .unlocked_ioctl  = cifs_ioctl,
1413         .copy_file_range = cifs_copy_file_range,
1414         .remap_file_range = cifs_remap_file_range,
1415         .llseek = cifs_llseek,
1416         .setlease = cifs_setlease,
1417         .fallocate = cifs_fallocate,
1418 };
1419
1420 const struct file_operations cifs_dir_ops = {
1421         .iterate_shared = cifs_readdir,
1422         .release = cifs_closedir,
1423         .read    = generic_read_dir,
1424         .unlocked_ioctl  = cifs_ioctl,
1425         .copy_file_range = cifs_copy_file_range,
1426         .remap_file_range = cifs_remap_file_range,
1427         .llseek = generic_file_llseek,
1428         .fsync = cifs_dir_fsync,
1429 };
1430
1431 static void
1432 cifs_init_once(void *inode)
1433 {
1434         struct cifsInodeInfo *cifsi = inode;
1435
1436         inode_init_once(&cifsi->netfs.inode);
1437         init_rwsem(&cifsi->lock_sem);
1438 }
1439
1440 static int __init
1441 cifs_init_inodecache(void)
1442 {
1443         cifs_inode_cachep = kmem_cache_create("cifs_inode_cache",
1444                                               sizeof(struct cifsInodeInfo),
1445                                               0, (SLAB_RECLAIM_ACCOUNT|
1446                                                 SLAB_MEM_SPREAD|SLAB_ACCOUNT),
1447                                               cifs_init_once);
1448         if (cifs_inode_cachep == NULL)
1449                 return -ENOMEM;
1450
1451         return 0;
1452 }
1453
1454 static void
1455 cifs_destroy_inodecache(void)
1456 {
1457         /*
1458          * Make sure all delayed rcu free inodes are flushed before we
1459          * destroy cache.
1460          */
1461         rcu_barrier();
1462         kmem_cache_destroy(cifs_inode_cachep);
1463 }
1464
1465 static int
1466 cifs_init_request_bufs(void)
1467 {
1468         /*
1469          * SMB2 maximum header size is bigger than CIFS one - no problems to
1470          * allocate some more bytes for CIFS.
1471          */
1472         size_t max_hdr_size = MAX_SMB2_HDR_SIZE;
1473
1474         if (CIFSMaxBufSize < 8192) {
1475         /* Buffer size can not be smaller than 2 * PATH_MAX since maximum
1476         Unicode path name has to fit in any SMB/CIFS path based frames */
1477                 CIFSMaxBufSize = 8192;
1478         } else if (CIFSMaxBufSize > 1024*127) {
1479                 CIFSMaxBufSize = 1024 * 127;
1480         } else {
1481                 CIFSMaxBufSize &= 0x1FE00; /* Round size to even 512 byte mult*/
1482         }
1483 /*
1484         cifs_dbg(VFS, "CIFSMaxBufSize %d 0x%x\n",
1485                  CIFSMaxBufSize, CIFSMaxBufSize);
1486 */
1487         cifs_req_cachep = kmem_cache_create_usercopy("cifs_request",
1488                                             CIFSMaxBufSize + max_hdr_size, 0,
1489                                             SLAB_HWCACHE_ALIGN, 0,
1490                                             CIFSMaxBufSize + max_hdr_size,
1491                                             NULL);
1492         if (cifs_req_cachep == NULL)
1493                 return -ENOMEM;
1494
1495         if (cifs_min_rcv < 1)
1496                 cifs_min_rcv = 1;
1497         else if (cifs_min_rcv > 64) {
1498                 cifs_min_rcv = 64;
1499                 cifs_dbg(VFS, "cifs_min_rcv set to maximum (64)\n");
1500         }
1501
1502         cifs_req_poolp = mempool_create_slab_pool(cifs_min_rcv,
1503                                                   cifs_req_cachep);
1504
1505         if (cifs_req_poolp == NULL) {
1506                 kmem_cache_destroy(cifs_req_cachep);
1507                 return -ENOMEM;
1508         }
1509         /* MAX_CIFS_SMALL_BUFFER_SIZE bytes is enough for most SMB responses and
1510         almost all handle based requests (but not write response, nor is it
1511         sufficient for path based requests).  A smaller size would have
1512         been more efficient (compacting multiple slab items on one 4k page)
1513         for the case in which debug was on, but this larger size allows
1514         more SMBs to use small buffer alloc and is still much more
1515         efficient to alloc 1 per page off the slab compared to 17K (5page)
1516         alloc of large cifs buffers even when page debugging is on */
1517         cifs_sm_req_cachep = kmem_cache_create_usercopy("cifs_small_rq",
1518                         MAX_CIFS_SMALL_BUFFER_SIZE, 0, SLAB_HWCACHE_ALIGN,
1519                         0, MAX_CIFS_SMALL_BUFFER_SIZE, NULL);
1520         if (cifs_sm_req_cachep == NULL) {
1521                 mempool_destroy(cifs_req_poolp);
1522                 kmem_cache_destroy(cifs_req_cachep);
1523                 return -ENOMEM;
1524         }
1525
1526         if (cifs_min_small < 2)
1527                 cifs_min_small = 2;
1528         else if (cifs_min_small > 256) {
1529                 cifs_min_small = 256;
1530                 cifs_dbg(FYI, "cifs_min_small set to maximum (256)\n");
1531         }
1532
1533         cifs_sm_req_poolp = mempool_create_slab_pool(cifs_min_small,
1534                                                      cifs_sm_req_cachep);
1535
1536         if (cifs_sm_req_poolp == NULL) {
1537                 mempool_destroy(cifs_req_poolp);
1538                 kmem_cache_destroy(cifs_req_cachep);
1539                 kmem_cache_destroy(cifs_sm_req_cachep);
1540                 return -ENOMEM;
1541         }
1542
1543         return 0;
1544 }
1545
1546 static void
1547 cifs_destroy_request_bufs(void)
1548 {
1549         mempool_destroy(cifs_req_poolp);
1550         kmem_cache_destroy(cifs_req_cachep);
1551         mempool_destroy(cifs_sm_req_poolp);
1552         kmem_cache_destroy(cifs_sm_req_cachep);
1553 }
1554
1555 static int init_mids(void)
1556 {
1557         cifs_mid_cachep = kmem_cache_create("cifs_mpx_ids",
1558                                             sizeof(struct mid_q_entry), 0,
1559                                             SLAB_HWCACHE_ALIGN, NULL);
1560         if (cifs_mid_cachep == NULL)
1561                 return -ENOMEM;
1562
1563         /* 3 is a reasonable minimum number of simultaneous operations */
1564         cifs_mid_poolp = mempool_create_slab_pool(3, cifs_mid_cachep);
1565         if (cifs_mid_poolp == NULL) {
1566                 kmem_cache_destroy(cifs_mid_cachep);
1567                 return -ENOMEM;
1568         }
1569
1570         return 0;
1571 }
1572
1573 static void destroy_mids(void)
1574 {
1575         mempool_destroy(cifs_mid_poolp);
1576         kmem_cache_destroy(cifs_mid_cachep);
1577 }
1578
1579 static int __init
1580 init_cifs(void)
1581 {
1582         int rc = 0;
1583         cifs_proc_init();
1584         INIT_LIST_HEAD(&cifs_tcp_ses_list);
1585 /*
1586  *  Initialize Global counters
1587  */
1588         atomic_set(&sesInfoAllocCount, 0);
1589         atomic_set(&tconInfoAllocCount, 0);
1590         atomic_set(&tcpSesNextId, 0);
1591         atomic_set(&tcpSesAllocCount, 0);
1592         atomic_set(&tcpSesReconnectCount, 0);
1593         atomic_set(&tconInfoReconnectCount, 0);
1594
1595         atomic_set(&buf_alloc_count, 0);
1596         atomic_set(&small_buf_alloc_count, 0);
1597 #ifdef CONFIG_CIFS_STATS2
1598         atomic_set(&total_buf_alloc_count, 0);
1599         atomic_set(&total_small_buf_alloc_count, 0);
1600         if (slow_rsp_threshold < 1)
1601                 cifs_dbg(FYI, "slow_response_threshold msgs disabled\n");
1602         else if (slow_rsp_threshold > 32767)
1603                 cifs_dbg(VFS,
1604                        "slow response threshold set higher than recommended (0 to 32767)\n");
1605 #endif /* CONFIG_CIFS_STATS2 */
1606
1607         atomic_set(&mid_count, 0);
1608         GlobalCurrentXid = 0;
1609         GlobalTotalActiveXid = 0;
1610         GlobalMaxActiveXid = 0;
1611         spin_lock_init(&cifs_tcp_ses_lock);
1612         spin_lock_init(&GlobalMid_Lock);
1613
1614         cifs_lock_secret = get_random_u32();
1615
1616         if (cifs_max_pending < 2) {
1617                 cifs_max_pending = 2;
1618                 cifs_dbg(FYI, "cifs_max_pending set to min of 2\n");
1619         } else if (cifs_max_pending > CIFS_MAX_REQ) {
1620                 cifs_max_pending = CIFS_MAX_REQ;
1621                 cifs_dbg(FYI, "cifs_max_pending set to max of %u\n",
1622                          CIFS_MAX_REQ);
1623         }
1624
1625         cifsiod_wq = alloc_workqueue("cifsiod", WQ_FREEZABLE|WQ_MEM_RECLAIM, 0);
1626         if (!cifsiod_wq) {
1627                 rc = -ENOMEM;
1628                 goto out_clean_proc;
1629         }
1630
1631         /*
1632          * Consider in future setting limit!=0 maybe to min(num_of_cores - 1, 3)
1633          * so that we don't launch too many worker threads but
1634          * Documentation/core-api/workqueue.rst recommends setting it to 0
1635          */
1636
1637         /* WQ_UNBOUND allows decrypt tasks to run on any CPU */
1638         decrypt_wq = alloc_workqueue("smb3decryptd",
1639                                      WQ_UNBOUND|WQ_FREEZABLE|WQ_MEM_RECLAIM, 0);
1640         if (!decrypt_wq) {
1641                 rc = -ENOMEM;
1642                 goto out_destroy_cifsiod_wq;
1643         }
1644
1645         fileinfo_put_wq = alloc_workqueue("cifsfileinfoput",
1646                                      WQ_UNBOUND|WQ_FREEZABLE|WQ_MEM_RECLAIM, 0);
1647         if (!fileinfo_put_wq) {
1648                 rc = -ENOMEM;
1649                 goto out_destroy_decrypt_wq;
1650         }
1651
1652         cifsoplockd_wq = alloc_workqueue("cifsoplockd",
1653                                          WQ_FREEZABLE|WQ_MEM_RECLAIM, 0);
1654         if (!cifsoplockd_wq) {
1655                 rc = -ENOMEM;
1656                 goto out_destroy_fileinfo_put_wq;
1657         }
1658
1659         deferredclose_wq = alloc_workqueue("deferredclose",
1660                                            WQ_FREEZABLE|WQ_MEM_RECLAIM, 0);
1661         if (!deferredclose_wq) {
1662                 rc = -ENOMEM;
1663                 goto out_destroy_cifsoplockd_wq;
1664         }
1665
1666         rc = cifs_init_inodecache();
1667         if (rc)
1668                 goto out_destroy_deferredclose_wq;
1669
1670         rc = init_mids();
1671         if (rc)
1672                 goto out_destroy_inodecache;
1673
1674         rc = cifs_init_request_bufs();
1675         if (rc)
1676                 goto out_destroy_mids;
1677
1678 #ifdef CONFIG_CIFS_DFS_UPCALL
1679         rc = dfs_cache_init();
1680         if (rc)
1681                 goto out_destroy_request_bufs;
1682 #endif /* CONFIG_CIFS_DFS_UPCALL */
1683 #ifdef CONFIG_CIFS_UPCALL
1684         rc = init_cifs_spnego();
1685         if (rc)
1686                 goto out_destroy_dfs_cache;
1687 #endif /* CONFIG_CIFS_UPCALL */
1688 #ifdef CONFIG_CIFS_SWN_UPCALL
1689         rc = cifs_genl_init();
1690         if (rc)
1691                 goto out_register_key_type;
1692 #endif /* CONFIG_CIFS_SWN_UPCALL */
1693
1694         rc = init_cifs_idmap();
1695         if (rc)
1696                 goto out_cifs_swn_init;
1697
1698         rc = register_filesystem(&cifs_fs_type);
1699         if (rc)
1700                 goto out_init_cifs_idmap;
1701
1702         rc = register_filesystem(&smb3_fs_type);
1703         if (rc) {
1704                 unregister_filesystem(&cifs_fs_type);
1705                 goto out_init_cifs_idmap;
1706         }
1707
1708         return 0;
1709
1710 out_init_cifs_idmap:
1711         exit_cifs_idmap();
1712 out_cifs_swn_init:
1713 #ifdef CONFIG_CIFS_SWN_UPCALL
1714         cifs_genl_exit();
1715 out_register_key_type:
1716 #endif
1717 #ifdef CONFIG_CIFS_UPCALL
1718         exit_cifs_spnego();
1719 out_destroy_dfs_cache:
1720 #endif
1721 #ifdef CONFIG_CIFS_DFS_UPCALL
1722         dfs_cache_destroy();
1723 out_destroy_request_bufs:
1724 #endif
1725         cifs_destroy_request_bufs();
1726 out_destroy_mids:
1727         destroy_mids();
1728 out_destroy_inodecache:
1729         cifs_destroy_inodecache();
1730 out_destroy_deferredclose_wq:
1731         destroy_workqueue(deferredclose_wq);
1732 out_destroy_cifsoplockd_wq:
1733         destroy_workqueue(cifsoplockd_wq);
1734 out_destroy_fileinfo_put_wq:
1735         destroy_workqueue(fileinfo_put_wq);
1736 out_destroy_decrypt_wq:
1737         destroy_workqueue(decrypt_wq);
1738 out_destroy_cifsiod_wq:
1739         destroy_workqueue(cifsiod_wq);
1740 out_clean_proc:
1741         cifs_proc_clean();
1742         return rc;
1743 }
1744
1745 static void __exit
1746 exit_cifs(void)
1747 {
1748         cifs_dbg(NOISY, "exit_smb3\n");
1749         unregister_filesystem(&cifs_fs_type);
1750         unregister_filesystem(&smb3_fs_type);
1751         cifs_dfs_release_automount_timer();
1752         exit_cifs_idmap();
1753 #ifdef CONFIG_CIFS_SWN_UPCALL
1754         cifs_genl_exit();
1755 #endif
1756 #ifdef CONFIG_CIFS_UPCALL
1757         exit_cifs_spnego();
1758 #endif
1759 #ifdef CONFIG_CIFS_DFS_UPCALL
1760         dfs_cache_destroy();
1761 #endif
1762         cifs_destroy_request_bufs();
1763         destroy_mids();
1764         cifs_destroy_inodecache();
1765         destroy_workqueue(deferredclose_wq);
1766         destroy_workqueue(cifsoplockd_wq);
1767         destroy_workqueue(decrypt_wq);
1768         destroy_workqueue(fileinfo_put_wq);
1769         destroy_workqueue(cifsiod_wq);
1770         cifs_proc_clean();
1771 }
1772
1773 MODULE_AUTHOR("Steve French");
1774 MODULE_LICENSE("GPL");  /* combination of LGPL + GPL source behaves as GPL */
1775 MODULE_DESCRIPTION
1776         ("VFS to access SMB3 servers e.g. Samba, Macs, Azure and Windows (and "
1777         "also older servers complying with the SNIA CIFS Specification)");
1778 MODULE_VERSION(CIFS_VERSION);
1779 MODULE_SOFTDEP("ecb");
1780 MODULE_SOFTDEP("hmac");
1781 MODULE_SOFTDEP("md5");
1782 MODULE_SOFTDEP("nls");
1783 MODULE_SOFTDEP("aes");
1784 MODULE_SOFTDEP("cmac");
1785 MODULE_SOFTDEP("sha256");
1786 MODULE_SOFTDEP("sha512");
1787 MODULE_SOFTDEP("aead2");
1788 MODULE_SOFTDEP("ccm");
1789 MODULE_SOFTDEP("gcm");
1790 module_init(init_cifs)
1791 module_exit(exit_cifs)