4 * Copyright (C) International Business Machines Corp., 2002,2008
5 * Author(s): Steve French (sfrench@us.ibm.com)
6 * Jeremy Allison (jra@samba.org)
8 * This library is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU Lesser General Public License as published
10 * by the Free Software Foundation; either version 2.1 of the License, or
11 * (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
16 * the GNU Lesser General Public License for more details.
23 #include <linux/in6.h>
24 #include <linux/inet.h>
25 #include <linux/slab.h>
26 #include <linux/mempool.h>
27 #include <linux/workqueue.h>
28 #include "cifs_fs_sb.h"
30 #include <crypto/internal/hash.h>
31 #include <linux/scatterlist.h>
32 #include <uapi/linux/cifs/cifs_mount.h>
35 #define CIFS_MAGIC_NUMBER 0xFF534D42 /* the first four bytes of SMB PDUs */
37 #define SMB_PATH_MAX 260
39 #define RFC1001_PORT 139
42 * The sizes of various internal tables and strings
44 #define MAX_UID_INFO 16
45 #define MAX_SES_INFO 2
46 #define MAX_TCON_INFO 4
48 #define MAX_TREE_SIZE (2 + CIFS_NI_MAXHOST + 1 + CIFS_MAX_SHARE_LEN + 1)
50 #define CIFS_MIN_RCV_POOL 4
52 #define MAX_REOPEN_ATT 5 /* these many maximum attempts to reopen a file */
54 * default attribute cache timeout (jiffies)
56 #define CIFS_DEF_ACTIMEO (1 * HZ)
59 * max attribute cache timeout (jiffies) - 2^30
61 #define CIFS_MAX_ACTIMEO (1 << 30)
64 * Max persistent and resilient handle timeout (milliseconds).
65 * Windows durable max was 960000 (16 minutes)
67 #define SMB3_MAX_HANDLE_TIMEOUT 960000
70 * MAX_REQ is the maximum number of requests that WE will send
71 * on one socket concurrently.
73 #define CIFS_MAX_REQ 32767
75 #define RFC1001_NAME_LEN 15
76 #define RFC1001_NAME_LEN_WITH_NULL (RFC1001_NAME_LEN + 1)
78 /* maximum length of ip addr as a string (including ipv6 and sctp) */
79 #define SERVER_NAME_LENGTH 80
80 #define SERVER_NAME_LEN_WITH_NULL (SERVER_NAME_LENGTH + 1)
82 /* echo interval in seconds */
83 #define SMB_ECHO_INTERVAL_MIN 1
84 #define SMB_ECHO_INTERVAL_MAX 600
85 #define SMB_ECHO_INTERVAL_DEFAULT 60
87 /* maximum number of PDUs in one compound */
88 #define MAX_COMPOUND 5
91 * Default number of credits to keep available for SMB3.
92 * This value is chosen somewhat arbitrarily. The Windows client
93 * defaults to 128 credits, the Windows server allows clients up to
94 * 512 credits (or 8K for later versions), and the NetApp server
95 * does not limit clients at all. Choose a high enough default value
96 * such that the client shouldn't limit performance, but allow mount
97 * to override (until you approach 64K, where we limit credits to 65000
98 * to reduce possibility of seeing more server credit overflow bugs.
100 #define SMB2_MAX_CREDITS_AVAILABLE 32000
104 #ifndef XATTR_DOS_ATTRIB
105 #define XATTR_DOS_ATTRIB "user.DOSATTRIB"
109 * CIFS vfs client Status information (based on what we know.)
112 /* associated with each tcp and smb session */
122 Unspecified = 0, /* not specified */
123 LANMAN, /* Legacy LANMAN auth */
124 NTLM, /* Legacy NTLM012 auth with NTLM hash */
125 NTLMv2, /* Legacy NTLM auth with NTLMv2 hash */
126 RawNTLMSSP, /* NTLMSSP without SPNEGO, NTLMv2 hash */
127 Kerberos, /* Kerberos via SPNEGO */
135 /* crypto security descriptor definition */
137 struct shash_desc shash;
141 /* crypto hashing related structure/fields, not specific to a sec mech */
142 struct cifs_secmech {
143 struct crypto_shash *hmacmd5; /* hmac-md5 hash function */
144 struct crypto_shash *md5; /* md5 hash function */
145 struct crypto_shash *hmacsha256; /* hmac-sha256 hash function */
146 struct crypto_shash *cmacaes; /* block-cipher based MAC function */
147 struct crypto_shash *sha512; /* sha512 hash function */
148 struct sdesc *sdeschmacmd5; /* ctxt to generate ntlmv2 hash, CR1 */
149 struct sdesc *sdescmd5; /* ctxt to generate cifs/smb signature */
150 struct sdesc *sdeschmacsha256; /* ctxt to generate smb2 signature */
151 struct sdesc *sdesccmacaes; /* ctxt to generate smb3 signature */
152 struct sdesc *sdescsha512; /* ctxt to generate smb3.11 signing key */
153 struct crypto_aead *ccmaesencrypt; /* smb3 encryption aead */
154 struct crypto_aead *ccmaesdecrypt; /* smb3 decryption aead */
157 /* per smb session structure/fields */
158 struct ntlmssp_auth {
159 bool sesskey_per_smbsess; /* whether session key is per smb session */
160 __u32 client_flags; /* sent by client in type 1 ntlmsssp exchange */
161 __u32 server_flags; /* sent by server in type 2 ntlmssp exchange */
162 unsigned char ciphertext[CIFS_CPHTXT_SIZE]; /* sent to server */
163 char cryptkey[CIFS_CRYPTO_KEY_SIZE]; /* used by ntlmssp */
171 struct cifs_sid osid;
172 struct cifs_sid gsid;
173 struct cifs_ntace *ntaces;
174 struct cifs_ace *aces;
178 *****************************************************************
179 * Except the CIFS PDUs themselves all the
180 * globally interesting structs should go here
181 *****************************************************************
185 * A smb_rqst represents a complete request to be issued to a server. It's
186 * formed by a kvec array, followed by an array of pages. Page data is assumed
187 * to start at the beginning of the first page.
190 struct kvec *rq_iov; /* array of kvecs */
191 unsigned int rq_nvec; /* number of kvecs in array */
192 struct page **rq_pages; /* pointer to array of page ptrs */
193 unsigned int rq_offset; /* the offset to the 1st page */
194 unsigned int rq_npages; /* number pages in array */
195 unsigned int rq_pagesz; /* page size to use */
196 unsigned int rq_tailsz; /* length of last page */
200 struct TCP_Server_Info;
204 struct dfs_info3_param;
206 struct smb3_fs_context;
208 struct cifs_readdata;
209 struct cifs_writedata;
210 struct cifs_io_parms;
211 struct cifs_search_info;
212 struct cifsInodeInfo;
213 struct cifs_open_parms;
216 struct smb_version_operations {
217 int (*send_cancel)(struct TCP_Server_Info *, struct smb_rqst *,
218 struct mid_q_entry *);
219 bool (*compare_fids)(struct cifsFileInfo *, struct cifsFileInfo *);
220 /* setup request: allocate mid, sign message */
221 struct mid_q_entry *(*setup_request)(struct cifs_ses *,
222 struct TCP_Server_Info *,
224 /* setup async request: allocate mid, sign message */
225 struct mid_q_entry *(*setup_async_request)(struct TCP_Server_Info *,
227 /* check response: verify signature, map error */
228 int (*check_receive)(struct mid_q_entry *, struct TCP_Server_Info *,
230 void (*add_credits)(struct TCP_Server_Info *server,
231 const struct cifs_credits *credits,
233 void (*set_credits)(struct TCP_Server_Info *, const int);
234 int * (*get_credits_field)(struct TCP_Server_Info *, const int);
235 unsigned int (*get_credits)(struct mid_q_entry *);
236 __u64 (*get_next_mid)(struct TCP_Server_Info *);
237 void (*revert_current_mid)(struct TCP_Server_Info *server,
238 const unsigned int val);
239 /* data offset from read response message */
240 unsigned int (*read_data_offset)(char *);
242 * Data length from read response message
243 * When in_remaining is true, the returned data length is in
244 * message field DataRemaining for out-of-band data read (e.g through
245 * Memory Registration RDMA write in SMBD).
246 * Otherwise, the returned data length is in message field DataLength.
248 unsigned int (*read_data_length)(char *, bool in_remaining);
249 /* map smb to linux error */
250 int (*map_error)(char *, bool);
251 /* find mid corresponding to the response message */
252 struct mid_q_entry * (*find_mid)(struct TCP_Server_Info *, char *);
253 void (*dump_detail)(void *buf, struct TCP_Server_Info *ptcp_info);
254 void (*clear_stats)(struct cifs_tcon *);
255 void (*print_stats)(struct seq_file *m, struct cifs_tcon *);
256 void (*dump_share_caps)(struct seq_file *, struct cifs_tcon *);
257 /* verify the message */
258 int (*check_message)(char *, unsigned int, struct TCP_Server_Info *);
259 bool (*is_oplock_break)(char *, struct TCP_Server_Info *);
260 int (*handle_cancelled_mid)(struct mid_q_entry *, struct TCP_Server_Info *);
261 void (*downgrade_oplock)(struct TCP_Server_Info *server,
262 struct cifsInodeInfo *cinode, __u32 oplock,
263 unsigned int epoch, bool *purge_cache);
264 /* process transaction2 response */
265 bool (*check_trans2)(struct mid_q_entry *, struct TCP_Server_Info *,
267 /* check if we need to negotiate */
268 bool (*need_neg)(struct TCP_Server_Info *);
269 /* negotiate to the server */
270 int (*negotiate)(const unsigned int, struct cifs_ses *);
271 /* set negotiated write size */
272 unsigned int (*negotiate_wsize)(struct cifs_tcon *tcon, struct smb3_fs_context *ctx);
273 /* set negotiated read size */
274 unsigned int (*negotiate_rsize)(struct cifs_tcon *tcon, struct smb3_fs_context *ctx);
275 /* setup smb sessionn */
276 int (*sess_setup)(const unsigned int, struct cifs_ses *,
277 const struct nls_table *);
278 /* close smb session */
279 int (*logoff)(const unsigned int, struct cifs_ses *);
280 /* connect to a server share */
281 int (*tree_connect)(const unsigned int, struct cifs_ses *, const char *,
282 struct cifs_tcon *, const struct nls_table *);
283 /* close tree connecion */
284 int (*tree_disconnect)(const unsigned int, struct cifs_tcon *);
285 /* get DFS referrals */
286 int (*get_dfs_refer)(const unsigned int, struct cifs_ses *,
287 const char *, struct dfs_info3_param **,
288 unsigned int *, const struct nls_table *, int);
289 /* informational QFS call */
290 void (*qfs_tcon)(const unsigned int, struct cifs_tcon *,
291 struct cifs_sb_info *);
292 /* check if a path is accessible or not */
293 int (*is_path_accessible)(const unsigned int, struct cifs_tcon *,
294 struct cifs_sb_info *, const char *);
295 /* query path data from the server */
296 int (*query_path_info)(const unsigned int, struct cifs_tcon *,
297 struct cifs_sb_info *, const char *,
298 FILE_ALL_INFO *, bool *, bool *);
299 /* query file data from the server */
300 int (*query_file_info)(const unsigned int, struct cifs_tcon *,
301 struct cifs_fid *, FILE_ALL_INFO *);
302 /* query reparse tag from srv to determine which type of special file */
303 int (*query_reparse_tag)(const unsigned int xid, struct cifs_tcon *tcon,
304 struct cifs_sb_info *cifs_sb, const char *path,
306 /* get server index number */
307 int (*get_srv_inum)(const unsigned int, struct cifs_tcon *,
308 struct cifs_sb_info *, const char *,
309 u64 *uniqueid, FILE_ALL_INFO *);
310 /* set size by path */
311 int (*set_path_size)(const unsigned int, struct cifs_tcon *,
312 const char *, __u64, struct cifs_sb_info *, bool);
313 /* set size by file handle */
314 int (*set_file_size)(const unsigned int, struct cifs_tcon *,
315 struct cifsFileInfo *, __u64, bool);
317 int (*set_file_info)(struct inode *, const char *, FILE_BASIC_INFO *,
319 int (*set_compression)(const unsigned int, struct cifs_tcon *,
320 struct cifsFileInfo *);
321 /* check if we can send an echo or nor */
322 bool (*can_echo)(struct TCP_Server_Info *);
323 /* send echo request */
324 int (*echo)(struct TCP_Server_Info *);
325 /* create directory */
326 int (*posix_mkdir)(const unsigned int xid, struct inode *inode,
327 umode_t mode, struct cifs_tcon *tcon,
328 const char *full_path,
329 struct cifs_sb_info *cifs_sb);
330 int (*mkdir)(const unsigned int xid, struct inode *inode, umode_t mode,
331 struct cifs_tcon *tcon, const char *name,
332 struct cifs_sb_info *sb);
333 /* set info on created directory */
334 void (*mkdir_setinfo)(struct inode *, const char *,
335 struct cifs_sb_info *, struct cifs_tcon *,
337 /* remove directory */
338 int (*rmdir)(const unsigned int, struct cifs_tcon *, const char *,
339 struct cifs_sb_info *);
341 int (*unlink)(const unsigned int, struct cifs_tcon *, const char *,
342 struct cifs_sb_info *);
343 /* open, rename and delete file */
344 int (*rename_pending_delete)(const char *, struct dentry *,
346 /* send rename request */
347 int (*rename)(const unsigned int, struct cifs_tcon *, const char *,
348 const char *, struct cifs_sb_info *);
349 /* send create hardlink request */
350 int (*create_hardlink)(const unsigned int, struct cifs_tcon *,
351 const char *, const char *,
352 struct cifs_sb_info *);
353 /* query symlink target */
354 int (*query_symlink)(const unsigned int, struct cifs_tcon *,
355 struct cifs_sb_info *, const char *,
357 /* open a file for non-posix mounts */
358 int (*open)(const unsigned int, struct cifs_open_parms *,
359 __u32 *, FILE_ALL_INFO *);
360 /* set fid protocol-specific info */
361 void (*set_fid)(struct cifsFileInfo *, struct cifs_fid *, __u32);
363 void (*close)(const unsigned int, struct cifs_tcon *,
365 /* close a file, returning file attributes and timestamps */
366 void (*close_getattr)(const unsigned int xid, struct cifs_tcon *tcon,
367 struct cifsFileInfo *pfile_info);
368 /* send a flush request to the server */
369 int (*flush)(const unsigned int, struct cifs_tcon *, struct cifs_fid *);
370 /* async read from the server */
371 int (*async_readv)(struct cifs_readdata *);
372 /* async write to the server */
373 int (*async_writev)(struct cifs_writedata *,
374 void (*release)(struct kref *));
375 /* sync read from the server */
376 int (*sync_read)(const unsigned int, struct cifs_fid *,
377 struct cifs_io_parms *, unsigned int *, char **,
379 /* sync write to the server */
380 int (*sync_write)(const unsigned int, struct cifs_fid *,
381 struct cifs_io_parms *, unsigned int *, struct kvec *,
383 /* open dir, start readdir */
384 int (*query_dir_first)(const unsigned int, struct cifs_tcon *,
385 const char *, struct cifs_sb_info *,
386 struct cifs_fid *, __u16,
387 struct cifs_search_info *);
388 /* continue readdir */
389 int (*query_dir_next)(const unsigned int, struct cifs_tcon *,
391 __u16, struct cifs_search_info *srch_inf);
393 int (*close_dir)(const unsigned int, struct cifs_tcon *,
395 /* calculate a size of SMB message */
396 unsigned int (*calc_smb_size)(void *buf, struct TCP_Server_Info *ptcpi);
397 /* check for STATUS_PENDING and process the response if yes */
398 bool (*is_status_pending)(char *buf, struct TCP_Server_Info *server);
399 /* check for STATUS_NETWORK_SESSION_EXPIRED */
400 bool (*is_session_expired)(char *);
401 /* send oplock break response */
402 int (*oplock_response)(struct cifs_tcon *, struct cifs_fid *,
403 struct cifsInodeInfo *);
404 /* query remote filesystem */
405 int (*queryfs)(const unsigned int, struct cifs_tcon *,
406 struct cifs_sb_info *, struct kstatfs *);
407 /* send mandatory brlock to the server */
408 int (*mand_lock)(const unsigned int, struct cifsFileInfo *, __u64,
409 __u64, __u32, int, int, bool);
410 /* unlock range of mandatory locks */
411 int (*mand_unlock_range)(struct cifsFileInfo *, struct file_lock *,
413 /* push brlocks from the cache to the server */
414 int (*push_mand_locks)(struct cifsFileInfo *);
415 /* get lease key of the inode */
416 void (*get_lease_key)(struct inode *, struct cifs_fid *);
417 /* set lease key of the inode */
418 void (*set_lease_key)(struct inode *, struct cifs_fid *);
419 /* generate new lease key */
420 void (*new_lease_key)(struct cifs_fid *);
421 int (*generate_signingkey)(struct cifs_ses *);
422 int (*calc_signature)(struct smb_rqst *, struct TCP_Server_Info *,
423 bool allocate_crypto);
424 int (*set_integrity)(const unsigned int, struct cifs_tcon *tcon,
425 struct cifsFileInfo *src_file);
426 int (*enum_snapshots)(const unsigned int xid, struct cifs_tcon *tcon,
427 struct cifsFileInfo *src_file, void __user *);
428 int (*notify)(const unsigned int xid, struct file *pfile,
430 int (*query_mf_symlink)(unsigned int, struct cifs_tcon *,
431 struct cifs_sb_info *, const unsigned char *,
432 char *, unsigned int *);
433 int (*create_mf_symlink)(unsigned int, struct cifs_tcon *,
434 struct cifs_sb_info *, const unsigned char *,
435 char *, unsigned int *);
436 /* if we can do cache read operations */
437 bool (*is_read_op)(__u32);
438 /* set oplock level for the inode */
439 void (*set_oplock_level)(struct cifsInodeInfo *, __u32, unsigned int,
441 /* create lease context buffer for CREATE request */
442 char * (*create_lease_buf)(u8 *lease_key, u8 oplock);
443 /* parse lease context buffer and return oplock/epoch info */
444 __u8 (*parse_lease_buf)(void *buf, unsigned int *epoch, char *lkey);
445 ssize_t (*copychunk_range)(const unsigned int,
446 struct cifsFileInfo *src_file,
447 struct cifsFileInfo *target_file,
448 u64 src_off, u64 len, u64 dest_off);
449 int (*duplicate_extents)(const unsigned int, struct cifsFileInfo *src,
450 struct cifsFileInfo *target_file, u64 src_off, u64 len,
452 int (*validate_negotiate)(const unsigned int, struct cifs_tcon *);
453 ssize_t (*query_all_EAs)(const unsigned int, struct cifs_tcon *,
454 const unsigned char *, const unsigned char *, char *,
455 size_t, struct cifs_sb_info *);
456 int (*set_EA)(const unsigned int, struct cifs_tcon *, const char *,
457 const char *, const void *, const __u16,
458 const struct nls_table *, struct cifs_sb_info *);
459 struct cifs_ntsd * (*get_acl)(struct cifs_sb_info *, struct inode *,
460 const char *, u32 *, u32);
461 struct cifs_ntsd * (*get_acl_by_fid)(struct cifs_sb_info *,
462 const struct cifs_fid *, u32 *, u32);
463 int (*set_acl)(struct cifs_ntsd *, __u32, struct inode *, const char *,
465 /* writepages retry size */
466 unsigned int (*wp_retry_size)(struct inode *);
467 /* get mtu credits */
468 int (*wait_mtu_credits)(struct TCP_Server_Info *, unsigned int,
469 unsigned int *, struct cifs_credits *);
470 /* adjust previously taken mtu credits to request size */
471 int (*adjust_credits)(struct TCP_Server_Info *server,
472 struct cifs_credits *credits,
473 const unsigned int payload_size);
474 /* check if we need to issue closedir */
475 bool (*dir_needs_close)(struct cifsFileInfo *);
476 long (*fallocate)(struct file *, struct cifs_tcon *, int, loff_t,
478 /* init transform request - used for encryption for now */
479 int (*init_transform_rq)(struct TCP_Server_Info *, int num_rqst,
480 struct smb_rqst *, struct smb_rqst *);
481 int (*is_transform_hdr)(void *buf);
482 int (*receive_transform)(struct TCP_Server_Info *,
483 struct mid_q_entry **, char **, int *);
484 enum securityEnum (*select_sectype)(struct TCP_Server_Info *,
486 int (*next_header)(char *);
487 /* ioctl passthrough for query_info */
488 int (*ioctl_query_info)(const unsigned int xid,
489 struct cifs_tcon *tcon,
490 struct cifs_sb_info *cifs_sb,
491 __le16 *path, int is_dir,
493 /* make unix special files (block, char, fifo, socket) */
494 int (*make_node)(unsigned int xid,
496 struct dentry *dentry,
497 struct cifs_tcon *tcon,
498 const char *full_path,
500 dev_t device_number);
501 /* version specific fiemap implementation */
502 int (*fiemap)(struct cifs_tcon *tcon, struct cifsFileInfo *,
503 struct fiemap_extent_info *, u64, u64);
504 /* version specific llseek implementation */
505 loff_t (*llseek)(struct file *, struct cifs_tcon *, loff_t, int);
506 /* Check for STATUS_IO_TIMEOUT */
507 bool (*is_status_io_timeout)(char *buf);
508 /* Check for STATUS_NETWORK_NAME_DELETED */
509 void (*is_network_name_deleted)(char *buf, struct TCP_Server_Info *srv);
512 struct smb_version_values {
513 char *version_string;
515 __u32 req_capabilities;
516 __u32 large_lock_type;
517 __u32 exclusive_lock_type;
518 __u32 shared_lock_type;
519 __u32 unlock_lock_type;
520 size_t header_preamble_size;
522 size_t max_header_size;
523 size_t read_rsp_size;
525 unsigned int cap_unix;
526 unsigned int cap_nt_find;
527 unsigned int cap_large_files;
528 __u16 signing_enabled;
529 __u16 signing_required;
530 size_t create_lease_size;
533 #define HEADER_SIZE(server) (server->vals->header_size)
534 #define MAX_HEADER_SIZE(server) (server->vals->max_header_size)
537 * CIFS superblock mount flags (mnt_cifs_flags) to consider when
538 * trying to reuse existing superblock for a new mount
540 #define CIFS_MOUNT_MASK (CIFS_MOUNT_NO_PERM | CIFS_MOUNT_SET_UID | \
541 CIFS_MOUNT_SERVER_INUM | CIFS_MOUNT_DIRECT_IO | \
542 CIFS_MOUNT_NO_XATTR | CIFS_MOUNT_MAP_SPECIAL_CHR | \
543 CIFS_MOUNT_MAP_SFM_CHR | \
544 CIFS_MOUNT_UNX_EMUL | CIFS_MOUNT_NO_BRL | \
545 CIFS_MOUNT_CIFS_ACL | CIFS_MOUNT_OVERR_UID | \
546 CIFS_MOUNT_OVERR_GID | CIFS_MOUNT_DYNPERM | \
547 CIFS_MOUNT_NOPOSIXBRL | CIFS_MOUNT_NOSSYNC | \
548 CIFS_MOUNT_FSCACHE | CIFS_MOUNT_MF_SYMLINKS | \
549 CIFS_MOUNT_MULTIUSER | CIFS_MOUNT_STRICT_IO | \
550 CIFS_MOUNT_CIFS_BACKUPUID | CIFS_MOUNT_CIFS_BACKUPGID | \
551 CIFS_MOUNT_UID_FROM_ACL | CIFS_MOUNT_NO_HANDLE_CACHE | \
552 CIFS_MOUNT_NO_DFS | CIFS_MOUNT_MODE_FROM_SID | \
553 CIFS_MOUNT_RO_CACHE | CIFS_MOUNT_RW_CACHE)
556 * Generic VFS superblock mount flags (s_flags) to consider when
557 * trying to reuse existing superblock for a new mount
559 #define CIFS_MS_MASK (SB_RDONLY | SB_MANDLOCK | SB_NOEXEC | SB_NOSUID | \
560 SB_NODEV | SB_SYNCHRONOUS)
562 struct cifs_mnt_data {
563 struct cifs_sb_info *cifs_sb;
564 struct smb3_fs_context *ctx;
568 static inline unsigned int
569 get_rfc1002_length(void *buf)
571 return be32_to_cpu(*((__be32 *)buf)) & 0xffffff;
575 inc_rfc1001_len(void *buf, int count)
577 be32_add_cpu((__be32 *)buf, count);
580 struct TCP_Server_Info {
581 struct list_head tcp_ses_list;
582 struct list_head smb_ses_list;
583 __u64 conn_id; /* connection identifier (useful for debugging) */
584 int srv_count; /* reference counter */
585 /* 15 character server name + 0x20 16th byte indicating type = srv */
586 char server_RFC1001_name[RFC1001_NAME_LEN_WITH_NULL];
587 struct smb_version_operations *ops;
588 struct smb_version_values *vals;
589 enum statusEnum tcpStatus; /* what we think the status is */
590 char *hostname; /* hostname portion of UNC string */
591 struct socket *ssocket;
592 struct sockaddr_storage dstaddr;
593 struct sockaddr_storage srcaddr; /* locally bind to this IP */
597 wait_queue_head_t response_q;
598 wait_queue_head_t request_q; /* if more than maxmpx to srvr must block*/
599 struct list_head pending_mid_q;
600 bool noblocksnd; /* use blocking sendmsg */
601 bool noautotune; /* do not autotune send buf sizes */
603 unsigned int credits; /* send no more requests at once */
604 unsigned int max_credits; /* can override large 32000 default at mnt */
605 unsigned int in_flight; /* number of requests on the wire to server */
606 unsigned int max_in_flight; /* max number of requests that were on wire */
607 spinlock_t req_lock; /* protect the two values above */
608 struct mutex srv_mutex;
609 struct task_struct *tsk;
610 char server_GUID[16];
612 bool sign; /* is signing enabled on this connection? */
613 bool ignore_signature:1; /* skip validation of signatures in SMB2/3 rsp */
614 bool session_estab; /* mark when very first sess is established */
615 int echo_credits; /* echo reserved slots */
616 int oplock_credits; /* oplock break reserved slots */
617 bool echoes:1; /* enable echoes */
618 __u8 client_guid[SMB2_CLIENT_GUID_SIZE]; /* Client GUID */
619 u16 dialect; /* dialect index that server chose */
620 bool oplocks:1; /* enable oplocks */
621 unsigned int maxReq; /* Clients should submit no more */
622 /* than maxReq distinct unanswered SMBs to the server when using */
623 /* multiplexed reads or writes (for SMB1/CIFS only, not SMB2/SMB3) */
624 unsigned int maxBuf; /* maxBuf specifies the maximum */
625 /* message size the server can send or receive for non-raw SMBs */
626 /* maxBuf is returned by SMB NegotiateProtocol so maxBuf is only 0 */
627 /* when socket is setup (and during reconnect) before NegProt sent */
628 unsigned int max_rw; /* maxRw specifies the maximum */
629 /* message size the server can send or receive for */
630 /* SMB_COM_WRITE_RAW or SMB_COM_READ_RAW. */
631 unsigned int capabilities; /* selective disabling of caps by smb sess */
632 int timeAdj; /* Adjust for difference in server time zone in sec */
633 __u64 CurrentMid; /* multiplex id - rotating counter */
634 char cryptkey[CIFS_CRYPTO_KEY_SIZE]; /* used by ntlm, ntlmv2 etc */
635 /* 16th byte of RFC1001 workstation name is always null */
636 char workstation_RFC1001_name[RFC1001_NAME_LEN_WITH_NULL];
637 __u32 sequence_number; /* for signing, protected by srv_mutex */
638 __u32 reconnect_instance; /* incremented on each reconnect */
639 struct session_key session_key;
640 unsigned long lstrp; /* when we got last response from this server */
641 struct cifs_secmech secmech; /* crypto sec mech functs, descriptors */
642 #define CIFS_NEGFLAVOR_LANMAN 0 /* wct == 13, LANMAN */
643 #define CIFS_NEGFLAVOR_UNENCAP 1 /* wct == 17, but no ext_sec */
644 #define CIFS_NEGFLAVOR_EXTENDED 2 /* wct == 17, ext_sec bit set */
645 char negflavor; /* NEGOTIATE response flavor */
646 /* extended security flavors that server supports */
647 bool sec_ntlmssp; /* supports NTLMSSP */
648 bool sec_kerberosu2u; /* supports U2U Kerberos */
649 bool sec_kerberos; /* supports plain Kerberos */
650 bool sec_mskerberos; /* supports legacy MS Kerberos */
651 bool large_buf; /* is current buffer large? */
652 /* use SMBD connection instead of socket */
654 /* point to the SMBD connection if RDMA is used instead of socket */
655 struct smbd_connection *smbd_conn;
656 struct delayed_work echo; /* echo ping workqueue job */
657 char *smallbuf; /* pointer to current "small" buffer */
658 char *bigbuf; /* pointer to current "big" buffer */
659 /* Total size of this PDU. Only valid from cifs_demultiplex_thread */
660 unsigned int pdu_size;
661 unsigned int total_read; /* total amount of data read in this pass */
662 atomic_t in_send; /* requests trying to send */
663 atomic_t num_waiters; /* blocked waiting to get in sendrecv */
664 #ifdef CONFIG_CIFS_FSCACHE
665 struct fscache_cookie *fscache; /* client index cache cookie */
667 #ifdef CONFIG_CIFS_STATS2
668 atomic_t num_cmds[NUMBER_OF_SMB2_COMMANDS]; /* total requests by cmd */
669 atomic_t smb2slowcmd[NUMBER_OF_SMB2_COMMANDS]; /* count resps > 1 sec */
670 __u64 time_per_cmd[NUMBER_OF_SMB2_COMMANDS]; /* total time per cmd */
671 __u32 slowest_cmd[NUMBER_OF_SMB2_COMMANDS];
672 __u32 fastest_cmd[NUMBER_OF_SMB2_COMMANDS];
674 unsigned int max_read;
675 unsigned int max_write;
676 unsigned int min_offload;
677 __le16 compress_algorithm;
679 /* save initital negprot hash */
680 __u8 preauth_sha_hash[SMB2_PREAUTH_HASH_SIZE];
681 bool posix_ext_supported;
682 struct delayed_work reconnect; /* reconnect workqueue job */
683 struct mutex reconnect_mutex; /* prevent simultaneous reconnects */
684 unsigned long echo_interval;
687 * Number of targets available for reconnect. The more targets
688 * the more tasks have to wait to let the demultiplex thread
692 bool noblockcnt; /* use non-blocking connect() */
693 bool is_channel; /* if a session channel */
694 #ifdef CONFIG_CIFS_SWN_UPCALL
695 bool use_swn_dstaddr;
696 struct sockaddr_storage swn_dstaddr;
700 struct cifs_credits {
702 unsigned int instance;
705 static inline unsigned int
706 in_flight(struct TCP_Server_Info *server)
709 spin_lock(&server->req_lock);
710 num = server->in_flight;
711 spin_unlock(&server->req_lock);
716 has_credits(struct TCP_Server_Info *server, int *credits, int num_credits)
719 spin_lock(&server->req_lock);
721 spin_unlock(&server->req_lock);
722 return num >= num_credits;
726 add_credits(struct TCP_Server_Info *server, const struct cifs_credits *credits,
729 server->ops->add_credits(server, credits, optype);
733 add_credits_and_wake_if(struct TCP_Server_Info *server,
734 const struct cifs_credits *credits, const int optype)
736 if (credits->value) {
737 server->ops->add_credits(server, credits, optype);
738 wake_up(&server->request_q);
743 set_credits(struct TCP_Server_Info *server, const int val)
745 server->ops->set_credits(server, val);
749 adjust_credits(struct TCP_Server_Info *server, struct cifs_credits *credits,
750 const unsigned int payload_size)
752 return server->ops->adjust_credits ?
753 server->ops->adjust_credits(server, credits, payload_size) : 0;
757 get_next_mid64(struct TCP_Server_Info *server)
759 return cpu_to_le64(server->ops->get_next_mid(server));
763 get_next_mid(struct TCP_Server_Info *server)
765 __u16 mid = server->ops->get_next_mid(server);
767 * The value in the SMB header should be little endian for easy
768 * on-the-wire decoding.
770 return cpu_to_le16(mid);
774 revert_current_mid(struct TCP_Server_Info *server, const unsigned int val)
776 if (server->ops->revert_current_mid)
777 server->ops->revert_current_mid(server, val);
781 revert_current_mid_from_hdr(struct TCP_Server_Info *server,
782 const struct smb2_sync_hdr *shdr)
784 unsigned int num = le16_to_cpu(shdr->CreditCharge);
786 return revert_current_mid(server, num > 0 ? num : 1);
790 get_mid(const struct smb_hdr *smb)
792 return le16_to_cpu(smb->Mid);
796 compare_mid(__u16 mid, const struct smb_hdr *smb)
798 return mid == le16_to_cpu(smb->Mid);
802 * When the server supports very large reads and writes via POSIX extensions,
803 * we can allow up to 2^24-1, minus the size of a READ/WRITE_AND_X header, not
804 * including the RFC1001 length.
806 * Note that this might make for "interesting" allocation problems during
807 * writeback however as we have to allocate an array of pointers for the
808 * pages. A 16M write means ~32kb page array with PAGE_SIZE == 4096.
810 * For reads, there is a similar problem as we need to allocate an array
811 * of kvecs to handle the receive, though that should only need to be done
814 #define CIFS_MAX_WSIZE ((1<<24) - 1 - sizeof(WRITE_REQ) + 4)
815 #define CIFS_MAX_RSIZE ((1<<24) - sizeof(READ_RSP) + 4)
818 * When the server doesn't allow large posix writes, only allow a rsize/wsize
819 * of 2^17-1 minus the size of the call header. That allows for a read or
820 * write up to the maximum size described by RFC1002.
822 #define CIFS_MAX_RFC1002_WSIZE ((1<<17) - 1 - sizeof(WRITE_REQ) + 4)
823 #define CIFS_MAX_RFC1002_RSIZE ((1<<17) - 1 - sizeof(READ_RSP) + 4)
826 * The default wsize is 1M. find_get_pages seems to return a maximum of 256
827 * pages in a single call. With PAGE_SIZE == 4k, this means we can fill
828 * a single wsize request with a single call.
830 #define CIFS_DEFAULT_IOSIZE (1024 * 1024)
831 #define SMB3_DEFAULT_IOSIZE (4 * 1024 * 1024)
834 * Windows only supports a max of 60kb reads and 65535 byte writes. Default to
835 * those values when posix extensions aren't in force. In actuality here, we
836 * use 65536 to allow for a write that is a multiple of 4k. Most servers seem
837 * to be ok with the extra byte even though Windows doesn't send writes that
842 * https://blogs.msdn.com/b/openspecification/archive/2009/04/10/smb-maximum-transmit-buffer-size-and-performance-tuning.aspx
844 #define CIFS_DEFAULT_NON_POSIX_RSIZE (60 * 1024)
845 #define CIFS_DEFAULT_NON_POSIX_WSIZE (65536)
848 * Macros to allow the TCP_Server_Info->net field and related code to drop out
849 * when CONFIG_NET_NS isn't set.
854 static inline struct net *cifs_net_ns(struct TCP_Server_Info *srv)
859 static inline void cifs_set_net_ns(struct TCP_Server_Info *srv, struct net *net)
866 static inline struct net *cifs_net_ns(struct TCP_Server_Info *srv)
871 static inline void cifs_set_net_ns(struct TCP_Server_Info *srv, struct net *net)
877 struct cifs_server_iface {
879 unsigned int rdma_capable : 1;
880 unsigned int rss_capable : 1;
881 struct sockaddr_storage sockaddr;
885 struct TCP_Server_Info *server;
886 __u8 signkey[SMB3_SIGN_KEY_SIZE];
890 * Session structure. One of these for each uid session with a particular host
893 struct list_head smb_ses_list;
894 struct list_head tcon_list;
895 struct cifs_tcon *tcon_ipc;
896 struct mutex session_mutex;
897 struct TCP_Server_Info *server; /* pointer to server info */
898 int ses_count; /* reference counter */
899 enum statusEnum status;
900 unsigned overrideSecFlg; /* if non-zero override global sec flags */
901 char *serverOS; /* name of operating system underlying server */
902 char *serverNOS; /* name of network operating system of server */
903 char *serverDomain; /* security realm of server */
904 __u64 Suid; /* remote smb uid */
905 kuid_t linux_uid; /* overriding owner of files on the mount */
906 kuid_t cred_uid; /* owner of credentials */
907 unsigned int capabilities;
908 char ip_addr[INET6_ADDRSTRLEN + 1]; /* Max ipv6 (or v4) addr string len */
909 char *user_name; /* must not be null except during init of sess
910 and after mount option parsing we fill it */
913 struct session_key auth_key;
914 struct ntlmssp_auth *ntlmssp; /* ciphertext, flags, server challenge */
915 enum securityEnum sectype; /* what security flavor was specified? */
916 bool sign; /* is signing required? */
917 bool need_reconnect:1; /* connection reset, uid now invalid */
919 bool binding:1; /* are we binding the session? */
921 __u8 smb3signingkey[SMB3_SIGN_KEY_SIZE];
922 __u8 smb3encryptionkey[SMB3_ENC_DEC_KEY_SIZE];
923 __u8 smb3decryptionkey[SMB3_ENC_DEC_KEY_SIZE];
924 __u8 preauth_sha_hash[SMB2_PREAUTH_HASH_SIZE];
926 __u8 binding_preauth_sha_hash[SMB2_PREAUTH_HASH_SIZE];
929 * Network interfaces available on the server this session is
932 * Other channels can be opened by connecting and binding this
933 * session to interfaces from this list.
935 * iface_lock should be taken when accessing any of these fields
937 spinlock_t iface_lock;
938 struct cifs_server_iface *iface_list;
940 unsigned long iface_last_update; /* jiffies */
942 #define CIFS_MAX_CHANNELS 16
943 struct cifs_chan chans[CIFS_MAX_CHANNELS];
944 struct cifs_chan *binding_chan;
947 atomic_t chan_seq; /* round robin state */
951 * When binding a new channel, we need to access the channel which isn't fully
956 struct cifs_chan *cifs_ses_binding_channel(struct cifs_ses *ses)
959 return ses->binding_chan;
965 * Returns the server pointer of the session. When binding a new
966 * channel this returns the last channel which isn't fully established
969 * This function should be use for negprot/sess.setup codepaths. For
970 * the other requests see cifs_pick_channel().
973 struct TCP_Server_Info *cifs_ses_server(struct cifs_ses *ses)
976 return ses->binding_chan->server;
982 cap_unix(struct cifs_ses *ses)
984 return ses->server->vals->cap_unix & ses->capabilities;
988 bool is_valid:1; /* Do we have a useable root fid */
989 bool file_all_info_is_valid:1;
991 unsigned long time; /* jiffies of when lease was taken */
992 struct kref refcount;
993 struct cifs_fid *fid;
994 struct mutex fid_mutex;
995 struct cifs_tcon *tcon;
996 struct dentry *dentry;
997 struct work_struct lease_break;
998 struct smb2_file_all_info file_all_info;
1002 * there is one of these for each connection to a resource on a particular
1006 struct list_head tcon_list;
1008 struct list_head rlist; /* reconnect list */
1009 atomic_t num_local_opens; /* num of all opens including disconnected */
1010 atomic_t num_remote_opens; /* num of all network opens on server */
1011 struct list_head openFileList;
1012 spinlock_t open_file_lock; /* protects list above */
1013 struct cifs_ses *ses; /* pointer to session associated with */
1014 char treeName[MAX_TREE_SIZE + 1]; /* UNC name of resource in ASCII */
1015 char *nativeFileSystem;
1016 char *password; /* for share-level security */
1017 __u32 tid; /* The 4 byte tree id */
1018 __u16 Flags; /* optional support bits */
1019 enum statusEnum tidStatus;
1020 atomic_t num_smbs_sent;
1023 atomic_t num_writes;
1025 atomic_t num_flushes;
1026 atomic_t num_oplock_brks;
1028 atomic_t num_closes;
1029 atomic_t num_deletes;
1030 atomic_t num_mkdirs;
1031 atomic_t num_posixopens;
1032 atomic_t num_posixmkdirs;
1033 atomic_t num_rmdirs;
1034 atomic_t num_renames;
1035 atomic_t num_t2renames;
1036 atomic_t num_ffirst;
1038 atomic_t num_fclose;
1039 atomic_t num_hardlinks;
1040 atomic_t num_symlinks;
1042 atomic_t num_acl_get;
1043 atomic_t num_acl_set;
1046 atomic_t smb2_com_sent[NUMBER_OF_SMB2_COMMANDS];
1047 atomic_t smb2_com_failed[NUMBER_OF_SMB2_COMMANDS];
1051 __u64 bytes_written;
1052 spinlock_t stat_lock; /* protects the two fields above */
1053 FILE_SYSTEM_DEVICE_INFO fsDevInfo;
1054 FILE_SYSTEM_ATTRIBUTE_INFO fsAttrInfo; /* ok if fs name truncated */
1055 FILE_SYSTEM_UNIX_INFO fsUnixInfo;
1056 bool ipc:1; /* set if connection to IPC$ share (always also pipe) */
1057 bool pipe:1; /* set if connection to pipe share */
1058 bool print:1; /* set if connection to printer share */
1061 bool nohandlecache:1; /* if strange server resource prob can turn off */
1063 bool seal:1; /* transport encryption for this mounted share */
1064 bool unix_ext:1; /* if false disable Linux extensions to CIFS protocol
1065 for this mount even if server would support */
1066 bool posix_extensions; /* if true SMB3.11 posix extensions enabled */
1067 bool local_lease:1; /* check leases (only) on local system not remote */
1068 bool broken_posix_open; /* e.g. Samba server versions < 3.3.2, 3.2.9 */
1069 bool broken_sparse_sup; /* if server or share does not support sparse */
1070 bool need_reconnect:1; /* connection reset, tid now invalid */
1071 bool need_reopen_files:1; /* need to reopen tcon file handles */
1072 bool use_resilient:1; /* use resilient instead of durable handles */
1073 bool use_persistent:1; /* use persistent instead of durable handles */
1074 bool no_lease:1; /* Do not request leases on files or directories */
1075 bool use_witness:1; /* use witness protocol */
1076 __le32 capabilities;
1078 __u32 maximal_access;
1079 __u32 vol_serial_number;
1080 __le64 vol_create_time;
1081 __u64 snapshot_time; /* for timewarp tokens - timestamp of snapshot */
1082 __u32 handle_timeout; /* persistent and durable handle timeout in ms */
1083 __u32 ss_flags; /* sector size flags */
1084 __u32 perf_sector_size; /* best sector size for perf */
1086 __u32 max_bytes_chunk;
1087 __u32 max_bytes_copy;
1088 #ifdef CONFIG_CIFS_FSCACHE
1089 u64 resource_id; /* server resource id */
1090 struct fscache_cookie *fscache; /* cookie for share */
1092 struct list_head pending_opens; /* list of incomplete opens */
1093 struct cached_fid crfid; /* Cached root fid */
1094 /* BB add field for back pointer to sb struct(s)? */
1095 #ifdef CONFIG_CIFS_DFS_UPCALL
1098 struct list_head ulist; /* cache update list */
1103 * This is a refcounted and timestamped container for a tcon pointer. The
1104 * container holds a tcon reference. It is considered safe to free one of
1105 * these when the tl_count goes to 0. The tl_time is the time of the last
1106 * "get" on the container.
1109 struct rb_node tl_rbnode;
1111 unsigned long tl_flags;
1112 #define TCON_LINK_MASTER 0
1113 #define TCON_LINK_PENDING 1
1114 #define TCON_LINK_IN_TREE 2
1115 unsigned long tl_time;
1117 struct cifs_tcon *tl_tcon;
1120 extern struct tcon_link *cifs_sb_tlink(struct cifs_sb_info *cifs_sb);
1121 extern void smb3_free_compound_rqst(int num_rqst, struct smb_rqst *rqst);
1123 static inline struct cifs_tcon *
1124 tlink_tcon(struct tcon_link *tlink)
1126 return tlink->tl_tcon;
1129 static inline struct tcon_link *
1130 cifs_sb_master_tlink(struct cifs_sb_info *cifs_sb)
1132 return cifs_sb->master_tlink;
1135 extern void cifs_put_tlink(struct tcon_link *tlink);
1137 static inline struct tcon_link *
1138 cifs_get_tlink(struct tcon_link *tlink)
1140 if (tlink && !IS_ERR(tlink))
1141 atomic_inc(&tlink->tl_count);
1145 /* This function is always expected to succeed */
1146 extern struct cifs_tcon *cifs_sb_master_tcon(struct cifs_sb_info *cifs_sb);
1148 #define CIFS_OPLOCK_NO_CHANGE 0xfe
1150 struct cifs_pending_open {
1151 struct list_head olist;
1152 struct tcon_link *tlink;
1157 struct cifs_deferred_close {
1158 struct list_head dlist;
1159 struct tcon_link *tlink;
1161 __u64 persistent_fid;
1166 * This info hangs off the cifsFileInfo structure, pointed to by llist.
1167 * This is used to track byte stream locks on the file
1169 struct cifsLockInfo {
1170 struct list_head llist; /* pointer to next cifsLockInfo */
1171 struct list_head blist; /* pointer to locks blocked on this */
1172 wait_queue_head_t block_q;
1181 * One of these for each open instance of a file
1183 struct cifs_search_info {
1184 loff_t index_of_last_entry;
1185 __u16 entries_in_buffer;
1188 char *ntwrk_buf_start;
1189 char *srch_entries_start;
1191 const char *presume_name;
1192 unsigned int resume_name_len;
1196 bool smallBuf:1; /* so we know which buf_release function to call */
1199 #define ACL_NO_MODE ((umode_t)(-1))
1200 struct cifs_open_parms {
1201 struct cifs_tcon *tcon;
1202 struct cifs_sb_info *cifs_sb;
1207 struct cifs_fid *fid;
1214 __u64 persistent_fid; /* persist file id for smb2 */
1215 __u64 volatile_fid; /* volatile file id for smb2 */
1216 __u8 lease_key[SMB2_LEASE_KEY_SIZE]; /* lease key for smb2 */
1217 __u8 create_guid[16];
1219 struct cifs_pending_open *pending_open;
1221 #ifdef CONFIG_CIFS_DEBUG2
1223 #endif /* CIFS_DEBUG2 */
1227 struct cifs_fid_locks {
1228 struct list_head llist;
1229 struct cifsFileInfo *cfile; /* fid that owns locks */
1230 struct list_head locks; /* locks held by fid above */
1233 struct cifsFileInfo {
1234 /* following two lists are protected by tcon->open_file_lock */
1235 struct list_head tlist; /* pointer to next fid owned by tcon */
1236 struct list_head flist; /* next fid (file instance) for this inode */
1237 /* lock list below protected by cifsi->lock_sem */
1238 struct cifs_fid_locks *llist; /* brlocks held by this fid */
1239 kuid_t uid; /* allows finding which FileInfo structure */
1240 __u32 pid; /* process id who opened file */
1241 struct cifs_fid fid; /* file id from remote */
1242 struct list_head rlist; /* reconnect list */
1243 /* BB add lock scope info here if needed */ ;
1244 /* lock scope id (0 if none) */
1245 struct dentry *dentry;
1246 struct tcon_link *tlink;
1247 unsigned int f_flags;
1248 bool invalidHandle:1; /* file closed via session abend */
1250 bool oplock_break_cancelled:1;
1251 unsigned int oplock_epoch; /* epoch from the lease break */
1252 __u32 oplock_level; /* oplock/lease level from the lease break */
1254 spinlock_t file_info_lock; /* protects four flag/count fields above */
1255 struct mutex fh_mutex; /* prevents reopen race after dead ses*/
1256 struct cifs_search_info srch_inf;
1257 struct work_struct oplock_break; /* work for oplock breaks */
1258 struct work_struct put; /* work for the final part of _put */
1259 struct delayed_work deferred;
1260 bool deferred_close_scheduled; /* Flag to indicate close is scheduled */
1263 struct cifs_io_parms {
1265 __u64 persistent_fid; /* persist file id for smb2 */
1266 __u64 volatile_fid; /* volatile file id for smb2 */
1269 unsigned int length;
1270 struct cifs_tcon *tcon;
1271 struct TCP_Server_Info *server;
1274 struct cifs_aio_ctx {
1275 struct kref refcount;
1276 struct list_head list;
1277 struct mutex aio_mutex;
1278 struct completion done;
1279 struct iov_iter iter;
1281 struct cifsFileInfo *cfile;
1284 unsigned int npages;
1287 unsigned int total_len;
1290 * Indicates if this aio_ctx is for direct_io,
1291 * If yes, iter is a copy of the user passed iov_iter
1296 /* asynchronous read support */
1297 struct cifs_readdata {
1298 struct kref refcount;
1299 struct list_head list;
1300 struct completion done;
1301 struct cifsFileInfo *cfile;
1302 struct address_space *mapping;
1303 struct cifs_aio_ctx *ctx;
1306 unsigned int got_bytes;
1309 struct work_struct work;
1310 int (*read_into_pages)(struct TCP_Server_Info *server,
1311 struct cifs_readdata *rdata,
1313 int (*copy_into_pages)(struct TCP_Server_Info *server,
1314 struct cifs_readdata *rdata,
1315 struct iov_iter *iter);
1317 struct TCP_Server_Info *server;
1318 #ifdef CONFIG_CIFS_SMB_DIRECT
1321 unsigned int pagesz;
1322 unsigned int page_offset;
1323 unsigned int tailsz;
1324 struct cifs_credits credits;
1325 unsigned int nr_pages;
1326 struct page **pages;
1329 /* asynchronous write support */
1330 struct cifs_writedata {
1331 struct kref refcount;
1332 struct list_head list;
1333 struct completion done;
1334 enum writeback_sync_modes sync_mode;
1335 struct work_struct work;
1336 struct cifsFileInfo *cfile;
1337 struct cifs_aio_ctx *ctx;
1342 struct TCP_Server_Info *server;
1343 #ifdef CONFIG_CIFS_SMB_DIRECT
1346 unsigned int pagesz;
1347 unsigned int page_offset;
1348 unsigned int tailsz;
1349 struct cifs_credits credits;
1350 unsigned int nr_pages;
1351 struct page **pages;
1355 * Take a reference on the file private data. Must be called with
1356 * cfile->file_info_lock held.
1359 cifsFileInfo_get_locked(struct cifsFileInfo *cifs_file)
1364 struct cifsFileInfo *cifsFileInfo_get(struct cifsFileInfo *cifs_file);
1365 void _cifsFileInfo_put(struct cifsFileInfo *cifs_file, bool wait_oplock_hdlr,
1367 void cifsFileInfo_put(struct cifsFileInfo *cifs_file);
1369 #define CIFS_CACHE_READ_FLG 1
1370 #define CIFS_CACHE_HANDLE_FLG 2
1371 #define CIFS_CACHE_RH_FLG (CIFS_CACHE_READ_FLG | CIFS_CACHE_HANDLE_FLG)
1372 #define CIFS_CACHE_WRITE_FLG 4
1373 #define CIFS_CACHE_RW_FLG (CIFS_CACHE_READ_FLG | CIFS_CACHE_WRITE_FLG)
1374 #define CIFS_CACHE_RHW_FLG (CIFS_CACHE_RW_FLG | CIFS_CACHE_HANDLE_FLG)
1376 #define CIFS_CACHE_READ(cinode) ((cinode->oplock & CIFS_CACHE_READ_FLG) || (CIFS_SB(cinode->vfs_inode.i_sb)->mnt_cifs_flags & CIFS_MOUNT_RO_CACHE))
1377 #define CIFS_CACHE_HANDLE(cinode) (cinode->oplock & CIFS_CACHE_HANDLE_FLG)
1378 #define CIFS_CACHE_WRITE(cinode) ((cinode->oplock & CIFS_CACHE_WRITE_FLG) || (CIFS_SB(cinode->vfs_inode.i_sb)->mnt_cifs_flags & CIFS_MOUNT_RW_CACHE))
1381 * One of these for each file inode
1384 struct cifsInodeInfo {
1385 bool can_cache_brlcks;
1386 struct list_head llist; /* locks helb by this inode */
1388 * NOTE: Some code paths call down_read(lock_sem) twice, so
1389 * we must always use cifs_down_write() instead of down_write()
1390 * for this semaphore to avoid deadlocks.
1392 struct rw_semaphore lock_sem; /* protect the fields above */
1393 /* BB add in lists for dirty pages i.e. write caching info for oplock */
1394 struct list_head openFileList;
1395 spinlock_t open_file_lock; /* protects openFileList */
1396 __u32 cifsAttrs; /* e.g. DOS archive bit, sparse, compressed, system */
1397 unsigned int oplock; /* oplock/lease level we have */
1398 unsigned int epoch; /* used to track lease state changes */
1399 #define CIFS_INODE_PENDING_OPLOCK_BREAK (0) /* oplock break in progress */
1400 #define CIFS_INODE_PENDING_WRITERS (1) /* Writes in progress */
1401 #define CIFS_INODE_FLAG_UNUSED (2) /* Unused flag */
1402 #define CIFS_INO_DELETE_PENDING (3) /* delete pending on server */
1403 #define CIFS_INO_INVALID_MAPPING (4) /* pagecache is invalid */
1404 #define CIFS_INO_LOCK (5) /* lock bit for synchronization */
1405 #define CIFS_INO_MODIFIED_ATTR (6) /* Indicate change in mtime/ctime */
1406 unsigned long flags;
1407 spinlock_t writers_lock;
1408 unsigned int writers; /* Number of writers on this inode */
1409 unsigned long time; /* jiffies of last update of inode */
1410 u64 server_eof; /* current file size on server -- protected by i_lock */
1411 u64 uniqueid; /* server inode number */
1412 u64 createtime; /* creation time on server */
1413 __u8 lease_key[SMB2_LEASE_KEY_SIZE]; /* lease key for this inode */
1414 #ifdef CONFIG_CIFS_FSCACHE
1415 struct fscache_cookie *fscache;
1417 struct inode vfs_inode;
1418 struct list_head deferred_closes; /* list of deferred closes */
1419 spinlock_t deferred_lock; /* protection on deferred list */
1420 bool lease_granted; /* Flag to indicate whether lease or oplock is granted. */
1423 static inline struct cifsInodeInfo *
1424 CIFS_I(struct inode *inode)
1426 return container_of(inode, struct cifsInodeInfo, vfs_inode);
1429 static inline struct cifs_sb_info *
1430 CIFS_SB(struct super_block *sb)
1432 return sb->s_fs_info;
1435 static inline struct cifs_sb_info *
1436 CIFS_FILE_SB(struct file *file)
1438 return CIFS_SB(file_inode(file)->i_sb);
1441 static inline char CIFS_DIR_SEP(const struct cifs_sb_info *cifs_sb)
1443 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_POSIX_PATHS)
1450 convert_delimiter(char *path, char delim)
1452 char old_delim, *pos;
1460 while ((pos = strchr(pos, old_delim)))
1464 #define cifs_stats_inc atomic_inc
1466 static inline void cifs_stats_bytes_written(struct cifs_tcon *tcon,
1470 spin_lock(&tcon->stat_lock);
1471 tcon->bytes_written += bytes;
1472 spin_unlock(&tcon->stat_lock);
1476 static inline void cifs_stats_bytes_read(struct cifs_tcon *tcon,
1479 spin_lock(&tcon->stat_lock);
1480 tcon->bytes_read += bytes;
1481 spin_unlock(&tcon->stat_lock);
1486 * This is the prototype for the mid receive function. This function is for
1487 * receiving the rest of the SMB frame, starting with the WordCount (which is
1488 * just after the MID in struct smb_hdr). Note:
1490 * - This will be called by cifsd, with no locks held.
1491 * - The mid will still be on the pending_mid_q.
1492 * - mid->resp_buf will point to the current buffer.
1494 * Returns zero on a successful receive, or an error. The receive state in
1495 * the TCP_Server_Info will also be updated.
1497 typedef int (mid_receive_t)(struct TCP_Server_Info *server,
1498 struct mid_q_entry *mid);
1501 * This is the prototype for the mid callback function. This is called once the
1502 * mid has been received off of the socket. When creating one, take special
1503 * care to avoid deadlocks. Things to bear in mind:
1505 * - it will be called by cifsd, with no locks held
1506 * - the mid will be removed from any lists
1508 typedef void (mid_callback_t)(struct mid_q_entry *mid);
1511 * This is the protopyte for mid handle function. This is called once the mid
1512 * has been recognized after decryption of the message.
1514 typedef int (mid_handle_t)(struct TCP_Server_Info *server,
1515 struct mid_q_entry *mid);
1517 /* one of these for every pending CIFS request to the server */
1518 struct mid_q_entry {
1519 struct list_head qhead; /* mids waiting on reply from this server */
1520 struct kref refcount;
1521 struct TCP_Server_Info *server; /* server corresponding to this mid */
1522 __u64 mid; /* multiplex id */
1523 __u16 credits; /* number of credits consumed by this mid */
1524 __u16 credits_received; /* number of credits from the response */
1525 __u32 pid; /* process id */
1526 __u32 sequence_number; /* for CIFS signing */
1527 unsigned long when_alloc; /* when mid was created */
1528 #ifdef CONFIG_CIFS_STATS2
1529 unsigned long when_sent; /* time when smb send finished */
1530 unsigned long when_received; /* when demux complete (taken off wire) */
1532 mid_receive_t *receive; /* call receive callback */
1533 mid_callback_t *callback; /* call completion callback */
1534 mid_handle_t *handle; /* call handle mid callback */
1535 void *callback_data; /* general purpose pointer for callback */
1536 struct task_struct *creator;
1537 void *resp_buf; /* pointer to received SMB header */
1538 unsigned int resp_buf_size;
1539 int mid_state; /* wish this were enum but can not pass to wait_event */
1540 unsigned int mid_flags;
1541 __le16 command; /* smb command code */
1542 unsigned int optype; /* operation type */
1543 bool large_buf:1; /* if valid response, is pointer to large buf */
1544 bool multiRsp:1; /* multiple trans2 responses for one request */
1545 bool multiEnd:1; /* both received */
1546 bool decrypted:1; /* decrypted entry */
1549 struct close_cancelled_open {
1550 struct cifs_fid fid;
1551 struct cifs_tcon *tcon;
1552 struct work_struct work;
1557 /* Make code in transport.c a little cleaner by moving
1558 update of optional stats into function below */
1559 static inline void cifs_in_send_inc(struct TCP_Server_Info *server)
1561 atomic_inc(&server->in_send);
1564 static inline void cifs_in_send_dec(struct TCP_Server_Info *server)
1566 atomic_dec(&server->in_send);
1569 static inline void cifs_num_waiters_inc(struct TCP_Server_Info *server)
1571 atomic_inc(&server->num_waiters);
1574 static inline void cifs_num_waiters_dec(struct TCP_Server_Info *server)
1576 atomic_dec(&server->num_waiters);
1579 #ifdef CONFIG_CIFS_STATS2
1580 static inline void cifs_save_when_sent(struct mid_q_entry *mid)
1582 mid->when_sent = jiffies;
1585 static inline void cifs_save_when_sent(struct mid_q_entry *mid)
1590 /* for pending dnotify requests */
1591 struct dir_notify_req {
1592 struct list_head lhead;
1599 __u32 filter; /* CompletionFilter (for multishot) */
1604 struct dfs_info3_param {
1605 int flags; /* DFSREF_REFERRAL_SERVER, DFSREF_STORAGE_SERVER*/
1615 * common struct for holding inode info when searching for or updating an
1616 * inode with new info
1619 #define CIFS_FATTR_DFS_REFERRAL 0x1
1620 #define CIFS_FATTR_DELETE_PENDING 0x2
1621 #define CIFS_FATTR_NEED_REVAL 0x4
1622 #define CIFS_FATTR_INO_COLLISION 0x8
1623 #define CIFS_FATTR_UNKNOWN_NLINK 0x10
1624 #define CIFS_FATTR_FAKE_ROOT_INO 0x20
1637 unsigned int cf_nlink;
1638 unsigned int cf_dtype;
1639 struct timespec64 cf_atime;
1640 struct timespec64 cf_mtime;
1641 struct timespec64 cf_ctime;
1645 static inline void free_dfs_info_param(struct dfs_info3_param *param)
1648 kfree(param->path_name);
1649 kfree(param->node_name);
1653 static inline void free_dfs_info_array(struct dfs_info3_param *param,
1654 int number_of_items)
1657 if ((number_of_items == 0) || (param == NULL))
1659 for (i = 0; i < number_of_items; i++) {
1660 kfree(param[i].path_name);
1661 kfree(param[i].node_name);
1666 static inline bool is_interrupt_error(int error)
1671 case -ERESTARTNOHAND:
1672 case -ERESTARTNOINTR:
1678 static inline bool is_retryable_error(int error)
1680 if (is_interrupt_error(error) || error == -EAGAIN)
1686 /* cifs_get_writable_file() flags */
1687 #define FIND_WR_ANY 0
1688 #define FIND_WR_FSUID_ONLY 1
1689 #define FIND_WR_WITH_DELETE 2
1692 #define MID_REQUEST_ALLOCATED 1
1693 #define MID_REQUEST_SUBMITTED 2
1694 #define MID_RESPONSE_RECEIVED 4
1695 #define MID_RETRY_NEEDED 8 /* session closed while this request out */
1696 #define MID_RESPONSE_MALFORMED 0x10
1697 #define MID_SHUTDOWN 0x20
1700 #define MID_WAIT_CANCELLED 1 /* Cancelled while waiting for response */
1701 #define MID_DELETED 2 /* Mid has been dequeued/deleted */
1703 /* Types of response buffer returned from SendReceive2 */
1704 #define CIFS_NO_BUFFER 0 /* Response buffer not returned */
1705 #define CIFS_SMALL_BUFFER 1
1706 #define CIFS_LARGE_BUFFER 2
1707 #define CIFS_IOVEC 4 /* array of response buffers */
1709 /* Type of Request to SendReceive2 */
1710 #define CIFS_BLOCKING_OP 1 /* operation can block */
1711 #define CIFS_NON_BLOCKING 2 /* do not block waiting for credits */
1712 #define CIFS_TIMEOUT_MASK 0x003 /* only one of above set in req */
1713 #define CIFS_LOG_ERROR 0x010 /* log NT STATUS if non-zero */
1714 #define CIFS_LARGE_BUF_OP 0x020 /* large request buffer */
1715 #define CIFS_NO_RSP_BUF 0x040 /* no response buffer required */
1717 /* Type of request operation */
1718 #define CIFS_ECHO_OP 0x080 /* echo request */
1719 #define CIFS_OBREAK_OP 0x0100 /* oplock break request */
1720 #define CIFS_NEG_OP 0x0200 /* negotiate request */
1721 #define CIFS_CP_CREATE_CLOSE_OP 0x0400 /* compound create+close request */
1722 /* Lower bitmask values are reserved by others below. */
1723 #define CIFS_SESS_OP 0x2000 /* session setup request */
1724 #define CIFS_OP_MASK 0x2780 /* mask request type */
1726 #define CIFS_HAS_CREDITS 0x0400 /* already has credits */
1727 #define CIFS_TRANSFORM_REQ 0x0800 /* transform request before sending */
1728 #define CIFS_NO_SRV_RSP 0x1000 /* there is no server response */
1730 /* Security Flags: indicate type of session setup needed */
1731 #define CIFSSEC_MAY_SIGN 0x00001
1732 #define CIFSSEC_MAY_NTLM 0x00002
1733 #define CIFSSEC_MAY_NTLMV2 0x00004
1734 #define CIFSSEC_MAY_KRB5 0x00008
1735 #ifdef CONFIG_CIFS_WEAK_PW_HASH
1736 #define CIFSSEC_MAY_LANMAN 0x00010
1737 #define CIFSSEC_MAY_PLNTXT 0x00020
1739 #define CIFSSEC_MAY_LANMAN 0
1740 #define CIFSSEC_MAY_PLNTXT 0
1741 #endif /* weak passwords */
1742 #define CIFSSEC_MAY_SEAL 0x00040 /* not supported yet */
1743 #define CIFSSEC_MAY_NTLMSSP 0x00080 /* raw ntlmssp with ntlmv2 */
1745 #define CIFSSEC_MUST_SIGN 0x01001
1746 /* note that only one of the following can be set so the
1747 result of setting MUST flags more than once will be to
1748 require use of the stronger protocol */
1749 #define CIFSSEC_MUST_NTLM 0x02002
1750 #define CIFSSEC_MUST_NTLMV2 0x04004
1751 #define CIFSSEC_MUST_KRB5 0x08008
1752 #ifdef CONFIG_CIFS_WEAK_PW_HASH
1753 #define CIFSSEC_MUST_LANMAN 0x10010
1754 #define CIFSSEC_MUST_PLNTXT 0x20020
1755 #ifdef CONFIG_CIFS_UPCALL
1756 #define CIFSSEC_MASK 0xBF0BF /* allows weak security but also krb5 */
1758 #define CIFSSEC_MASK 0xB70B7 /* current flags supported if weak */
1760 #else /* do not allow weak pw hash */
1761 #define CIFSSEC_MUST_LANMAN 0
1762 #define CIFSSEC_MUST_PLNTXT 0
1763 #ifdef CONFIG_CIFS_UPCALL
1764 #define CIFSSEC_MASK 0x8F08F /* flags supported if no weak allowed */
1766 #define CIFSSEC_MASK 0x87087 /* flags supported if no weak allowed */
1768 #endif /* WEAK_PW_HASH */
1769 #define CIFSSEC_MUST_SEAL 0x40040 /* not supported yet */
1770 #define CIFSSEC_MUST_NTLMSSP 0x80080 /* raw ntlmssp with ntlmv2 */
1772 #define CIFSSEC_DEF (CIFSSEC_MAY_SIGN | CIFSSEC_MAY_NTLMV2 | CIFSSEC_MAY_NTLMSSP)
1773 #define CIFSSEC_MAX (CIFSSEC_MUST_SIGN | CIFSSEC_MUST_NTLMV2)
1774 #define CIFSSEC_AUTH_MASK (CIFSSEC_MAY_NTLM | CIFSSEC_MAY_NTLMV2 | CIFSSEC_MAY_LANMAN | CIFSSEC_MAY_PLNTXT | CIFSSEC_MAY_KRB5 | CIFSSEC_MAY_NTLMSSP)
1776 *****************************************************************
1777 * All constants go here
1778 *****************************************************************
1781 #define UID_HASH (16)
1784 * Note that ONE module should define _DECLARE_GLOBALS_HERE to cause the
1785 * following to be declared.
1788 /****************************************************************************
1789 * Locking notes. All updates to global variables and lists should be
1790 * protected by spinlocks or semaphores.
1794 * GlobalMid_Lock protects:
1795 * list operations on pending_mid_q and oplockQ
1796 * updates to XID counters, multiplex id and SMB sequence numbers
1797 * list operations on global DnotifyReqList
1798 * tcp_ses_lock protects:
1799 * list operations on tcp and SMB session lists
1800 * tcon->open_file_lock protects the list of open files hanging off the tcon
1801 * inode->open_file_lock protects the openFileList hanging off the inode
1802 * cfile->file_info_lock protects counters and fields in cifs file struct
1803 * f_owner.lock protects certain per file struct operations
1804 * mapping->page_lock protects certain per page operations
1806 * Note that the cifs_tcon.open_file_lock should be taken before
1807 * not after the cifsInodeInfo.open_file_lock
1811 * cifsInodeInfo->lock_sem protects:
1812 * the list of locks held by the inode
1814 ****************************************************************************/
1816 #ifdef DECLARE_GLOBALS_HERE
1817 #define GLOBAL_EXTERN
1819 #define GLOBAL_EXTERN extern
1823 * the list of TCP_Server_Info structures, ie each of the sockets
1824 * connecting our client to a distinct server (ip address), is
1825 * chained together by cifs_tcp_ses_list. The list of all our SMB
1826 * sessions (and from that the tree connections) can be found
1827 * by iterating over cifs_tcp_ses_list
1829 GLOBAL_EXTERN struct list_head cifs_tcp_ses_list;
1832 * This lock protects the cifs_tcp_ses_list, the list of smb sessions per
1833 * tcp session, and the list of tcon's per smb session. It also protects
1834 * the reference counters for the server, smb session, and tcon. It also
1835 * protects some fields in the TCP_Server_Info struct such as dstaddr. Finally,
1836 * changes to the tcon->tidStatus should be done while holding this lock.
1837 * generally the locks should be taken in order tcp_ses_lock before
1838 * tcon->open_file_lock and that before file->file_info_lock since the
1839 * structure order is cifs_socket-->cifs_ses-->cifs_tcon-->cifs_file
1841 GLOBAL_EXTERN spinlock_t cifs_tcp_ses_lock;
1844 * Global transaction id (XID) information
1846 GLOBAL_EXTERN unsigned int GlobalCurrentXid; /* protected by GlobalMid_Sem */
1847 GLOBAL_EXTERN unsigned int GlobalTotalActiveXid; /* prot by GlobalMid_Sem */
1848 GLOBAL_EXTERN unsigned int GlobalMaxActiveXid; /* prot by GlobalMid_Sem */
1849 GLOBAL_EXTERN spinlock_t GlobalMid_Lock; /* protects above & list operations */
1850 /* on midQ entries */
1852 * Global counters, updated atomically
1854 GLOBAL_EXTERN atomic_t sesInfoAllocCount;
1855 GLOBAL_EXTERN atomic_t tconInfoAllocCount;
1856 GLOBAL_EXTERN atomic_t tcpSesNextId;
1857 GLOBAL_EXTERN atomic_t tcpSesAllocCount;
1858 GLOBAL_EXTERN atomic_t tcpSesReconnectCount;
1859 GLOBAL_EXTERN atomic_t tconInfoReconnectCount;
1861 /* Various Debug counters */
1862 GLOBAL_EXTERN atomic_t bufAllocCount; /* current number allocated */
1863 #ifdef CONFIG_CIFS_STATS2
1864 GLOBAL_EXTERN atomic_t totBufAllocCount; /* total allocated over all time */
1865 GLOBAL_EXTERN atomic_t totSmBufAllocCount;
1866 extern unsigned int slow_rsp_threshold; /* number of secs before logging */
1868 GLOBAL_EXTERN atomic_t smBufAllocCount;
1869 GLOBAL_EXTERN atomic_t midCount;
1872 extern bool enable_oplocks; /* enable or disable oplocks */
1873 extern bool lookupCacheEnabled;
1874 extern unsigned int global_secflags; /* if on, session setup sent
1875 with more secure ntlmssp2 challenge/resp */
1876 extern unsigned int sign_CIFS_PDUs; /* enable smb packet signing */
1877 extern bool enable_gcm_256; /* allow optional negotiate of strongest signing (aes-gcm-256) */
1878 extern bool require_gcm_256; /* require use of strongest signing (aes-gcm-256) */
1879 extern bool linuxExtEnabled;/*enable Linux/Unix CIFS extensions*/
1880 extern unsigned int CIFSMaxBufSize; /* max size not including hdr */
1881 extern unsigned int cifs_min_rcv; /* min size of big ntwrk buf pool */
1882 extern unsigned int cifs_min_small; /* min size of small buf pool */
1883 extern unsigned int cifs_max_pending; /* MAX requests at once to server*/
1884 extern bool disable_legacy_dialects; /* forbid vers=1.0 and vers=2.0 mounts */
1886 void cifs_oplock_break(struct work_struct *work);
1887 void cifs_queue_oplock_break(struct cifsFileInfo *cfile);
1888 void smb2_deferred_work_close(struct work_struct *work);
1890 extern const struct slow_work_ops cifs_oplock_break_ops;
1891 extern struct workqueue_struct *cifsiod_wq;
1892 extern struct workqueue_struct *decrypt_wq;
1893 extern struct workqueue_struct *fileinfo_put_wq;
1894 extern struct workqueue_struct *cifsoplockd_wq;
1895 extern struct workqueue_struct *deferredclose_wq;
1896 extern __u32 cifs_lock_secret;
1898 extern mempool_t *cifs_mid_poolp;
1900 /* Operations for different SMB versions */
1901 #define SMB1_VERSION_STRING "1.0"
1902 extern struct smb_version_operations smb1_operations;
1903 extern struct smb_version_values smb1_values;
1904 #define SMB20_VERSION_STRING "2.0"
1905 extern struct smb_version_operations smb20_operations;
1906 extern struct smb_version_values smb20_values;
1907 #define SMB21_VERSION_STRING "2.1"
1908 extern struct smb_version_operations smb21_operations;
1909 extern struct smb_version_values smb21_values;
1910 #define SMBDEFAULT_VERSION_STRING "default"
1911 extern struct smb_version_values smbdefault_values;
1912 #define SMB3ANY_VERSION_STRING "3"
1913 extern struct smb_version_values smb3any_values;
1914 #define SMB30_VERSION_STRING "3.0"
1915 extern struct smb_version_operations smb30_operations;
1916 extern struct smb_version_values smb30_values;
1917 #define SMB302_VERSION_STRING "3.02"
1918 #define ALT_SMB302_VERSION_STRING "3.0.2"
1919 /*extern struct smb_version_operations smb302_operations;*/ /* not needed yet */
1920 extern struct smb_version_values smb302_values;
1921 #define SMB311_VERSION_STRING "3.1.1"
1922 #define ALT_SMB311_VERSION_STRING "3.11"
1923 extern struct smb_version_operations smb311_operations;
1924 extern struct smb_version_values smb311_values;
1926 static inline char *get_security_type_str(enum securityEnum sectype)
1930 return "RawNTLMSSP";
1944 static inline bool is_smb1_server(struct TCP_Server_Info *server)
1946 return strcmp(server->vals->version_string, SMB1_VERSION_STRING) == 0;
1949 static inline bool is_tcon_dfs(struct cifs_tcon *tcon)
1952 * For SMB1, see MS-CIFS 2.4.55 SMB_COM_TREE_CONNECT_ANDX (0x75) and MS-CIFS 3.3.4.4 DFS
1953 * Subsystem Notifies That a Share Is a DFS Share.
1955 * For SMB2+, see MS-SMB2 2.2.10 SMB2 TREE_CONNECT Response and MS-SMB2 3.3.4.14 Server
1956 * Application Updates a Share.
1958 if (!tcon || !tcon->ses || !tcon->ses->server)
1960 return is_smb1_server(tcon->ses->server) ? tcon->Flags & SMB_SHARE_IS_IN_DFS :
1961 tcon->share_flags & (SHI1005_FLAGS_DFS | SHI1005_FLAGS_DFS_ROOT);
1964 #endif /* _CIFS_GLOB_H */