PCI: pci.txt fix __devexit() usage
[linux-2.6.22.y-op.git] / fs / cifs / cifsglob.h
blob74d3ccbb103bfdbaf82b56cb03272ceebf9c022e
1 /*
2 * fs/cifs/cifsglob.h
4 * Copyright (C) International Business Machines Corp., 2002,2006
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.
19 #include <linux/in.h>
20 #include <linux/in6.h>
21 #include "cifs_fs_sb.h"
23 * The sizes of various internal tables and strings
25 #define MAX_UID_INFO 16
26 #define MAX_SES_INFO 2
27 #define MAX_TCON_INFO 4
29 #define MAX_TREE_SIZE 2 + MAX_SERVER_SIZE + 1 + MAX_SHARE_SIZE + 1
30 #define MAX_SERVER_SIZE 15
31 #define MAX_SHARE_SIZE 64 /* used to be 20 - this should still be enough */
32 #define MAX_USERNAME_SIZE 32 /* 32 is to allow for 15 char names + null
33 termination then *2 for unicode versions */
34 #define MAX_PASSWORD_SIZE 16
36 #define CIFS_MIN_RCV_POOL 4
39 * MAX_REQ is the maximum number of requests that WE will send
40 * on one socket concurently. It also matches the most common
41 * value of max multiplex returned by servers. We may
42 * eventually want to use the negotiated value (in case
43 * future servers can handle more) when we are more confident that
44 * we will not have problems oveloading the socket with pending
45 * write data.
47 #define CIFS_MAX_REQ 50
49 #define SERVER_NAME_LENGTH 15
50 #define SERVER_NAME_LEN_WITH_NULL (SERVER_NAME_LENGTH + 1)
52 /* used to define string lengths for reversing unicode strings */
53 /* (256+1)*2 = 514 */
54 /* (max path length + 1 for null) * 2 for unicode */
55 #define MAX_NAME 514
57 #include "cifspdu.h"
59 #ifndef FALSE
60 #define FALSE 0
61 #endif
63 #ifndef TRUE
64 #define TRUE 1
65 #endif
67 #ifndef XATTR_DOS_ATTRIB
68 #define XATTR_DOS_ATTRIB "user.DOSATTRIB"
69 #endif
72 * This information is kept on every Server we know about.
74 * Some things to note:
77 #define SERVER_NAME_LEN_WITH_NULL (SERVER_NAME_LENGTH + 1)
80 * CIFS vfs client Status information (based on what we know.)
83 /* associated with each tcp and smb session */
84 enum statusEnum {
85 CifsNew = 0,
86 CifsGood,
87 CifsExiting,
88 CifsNeedReconnect
91 enum securityEnum {
92 LANMAN = 0, /* Legacy LANMAN auth */
93 NTLM, /* Legacy NTLM012 auth with NTLM hash */
94 NTLMv2, /* Legacy NTLM auth with NTLMv2 hash */
95 RawNTLMSSP, /* NTLMSSP without SPNEGO */
96 NTLMSSP, /* NTLMSSP via SPNEGO */
97 Kerberos /* Kerberos via SPNEGO */
100 enum protocolEnum {
101 IPV4 = 0,
102 IPV6,
103 SCTP
104 /* Netbios frames protocol not supported at this time */
108 *****************************************************************
109 * Except the CIFS PDUs themselves all the
110 * globally interesting structs should go here
111 *****************************************************************
114 struct TCP_Server_Info {
115 /* 15 character server name + 0x20 16th byte indicating type = srv */
116 char server_RFC1001_name[SERVER_NAME_LEN_WITH_NULL];
117 char unicode_server_Name[SERVER_NAME_LEN_WITH_NULL * 2];
118 struct socket *ssocket;
119 union {
120 struct sockaddr_in sockAddr;
121 struct sockaddr_in6 sockAddr6;
122 } addr;
123 wait_queue_head_t response_q;
124 wait_queue_head_t request_q; /* if more than maxmpx to srvr must block*/
125 struct list_head pending_mid_q;
126 void *Server_NlsInfo; /* BB - placeholder for future NLS info */
127 unsigned short server_codepage; /* codepage for the server */
128 unsigned long ip_address; /* IP addr for the server if known */
129 enum protocolEnum protocolType;
130 char versionMajor;
131 char versionMinor;
132 unsigned svlocal:1; /* local server or remote */
133 atomic_t socketUseCount; /* number of open cifs sessions on socket */
134 atomic_t inFlight; /* number of requests on the wire to server */
135 #ifdef CONFIG_CIFS_STATS2
136 atomic_t inSend; /* requests trying to send */
137 atomic_t num_waiters; /* blocked waiting to get in sendrecv */
138 #endif
139 enum statusEnum tcpStatus; /* what we think the status is */
140 struct semaphore tcpSem;
141 struct task_struct *tsk;
142 char server_GUID[16];
143 char secMode;
144 enum securityEnum secType;
145 unsigned int maxReq; /* Clients should submit no more */
146 /* than maxReq distinct unanswered SMBs to the server when using */
147 /* multiplexed reads or writes */
148 unsigned int maxBuf; /* maxBuf specifies the maximum */
149 /* message size the server can send or receive for non-raw SMBs */
150 unsigned int maxRw; /* maxRw specifies the maximum */
151 /* message size the server can send or receive for */
152 /* SMB_COM_WRITE_RAW or SMB_COM_READ_RAW. */
153 char sessid[4]; /* unique token id for this session */
154 /* (returned on Negotiate */
155 int capabilities; /* allow selective disabling of caps by smb sess */
156 int timeAdj; /* Adjust for difference in server time zone in sec */
157 __u16 CurrentMid; /* multiplex id - rotating counter */
158 char cryptKey[CIFS_CRYPTO_KEY_SIZE];
159 /* 16th byte of RFC1001 workstation name is always null */
160 char workstation_RFC1001_name[SERVER_NAME_LEN_WITH_NULL];
161 __u32 sequence_number; /* needed for CIFS PDU signature */
162 char mac_signing_key[CIFS_SESS_KEY_SIZE + 16];
163 unsigned long lstrp; /* when we got last response from this server */
167 * The following is our shortcut to user information. We surface the uid,
168 * and name. We always get the password on the fly in case it
169 * has changed. We also hang a list of sessions owned by this user off here.
171 struct cifsUidInfo {
172 struct list_head userList;
173 struct list_head sessionList; /* SMB sessions for this user */
174 uid_t linux_uid;
175 char user[MAX_USERNAME_SIZE + 1]; /* ascii name of user */
176 /* BB may need ptr or callback for PAM or WinBind info */
180 * Session structure. One of these for each uid session with a particular host
182 struct cifsSesInfo {
183 struct list_head cifsSessionList;
184 struct semaphore sesSem;
185 #if 0
186 struct cifsUidInfo *uidInfo; /* pointer to user info */
187 #endif
188 struct TCP_Server_Info *server; /* pointer to server info */
189 atomic_t inUse; /* # of mounts (tree connections) on this ses */
190 enum statusEnum status;
191 unsigned overrideSecFlg; /* if non-zero override global sec flags */
192 __u16 ipc_tid; /* special tid for connection to IPC share */
193 __u16 flags;
194 char *serverOS; /* name of operating system underlying server */
195 char *serverNOS; /* name of network operating system of server */
196 char *serverDomain; /* security realm of server */
197 int Suid; /* remote smb uid */
198 uid_t linux_uid; /* local Linux uid */
199 int capabilities;
200 char serverName[SERVER_NAME_LEN_WITH_NULL * 2]; /* BB make bigger for
201 TCP names - will ipv6 and sctp addresses fit? */
202 char userName[MAX_USERNAME_SIZE + 1];
203 char * domainName;
204 char * password;
206 /* no more than one of the following three session flags may be set */
207 #define CIFS_SES_NT4 1
208 #define CIFS_SES_OS2 2
209 #define CIFS_SES_W9X 4
210 /* following flag is set for old servers such as OS2 (and Win95?)
211 which do not negotiate NTLM or POSIX dialects, but instead
212 negotiate one of the older LANMAN dialects */
213 #define CIFS_SES_LANMAN 8
215 * there is one of these for each connection to a resource on a particular
216 * session
218 struct cifsTconInfo {
219 struct list_head cifsConnectionList;
220 struct list_head openFileList;
221 struct semaphore tconSem;
222 struct cifsSesInfo *ses; /* pointer to session associated with */
223 char treeName[MAX_TREE_SIZE + 1]; /* UNC name of resource in ASCII */
224 char *nativeFileSystem;
225 __u16 tid; /* The 2 byte tree id */
226 __u16 Flags; /* optional support bits */
227 enum statusEnum tidStatus;
228 atomic_t useCount; /* how many explicit/implicit mounts to share */
229 #ifdef CONFIG_CIFS_STATS
230 atomic_t num_smbs_sent;
231 atomic_t num_writes;
232 atomic_t num_reads;
233 atomic_t num_oplock_brks;
234 atomic_t num_opens;
235 atomic_t num_closes;
236 atomic_t num_deletes;
237 atomic_t num_mkdirs;
238 atomic_t num_rmdirs;
239 atomic_t num_renames;
240 atomic_t num_t2renames;
241 atomic_t num_ffirst;
242 atomic_t num_fnext;
243 atomic_t num_fclose;
244 atomic_t num_hardlinks;
245 atomic_t num_symlinks;
246 atomic_t num_locks;
247 atomic_t num_acl_get;
248 atomic_t num_acl_set;
249 #ifdef CONFIG_CIFS_STATS2
250 unsigned long long time_writes;
251 unsigned long long time_reads;
252 unsigned long long time_opens;
253 unsigned long long time_deletes;
254 unsigned long long time_closes;
255 unsigned long long time_mkdirs;
256 unsigned long long time_rmdirs;
257 unsigned long long time_renames;
258 unsigned long long time_t2renames;
259 unsigned long long time_ffirst;
260 unsigned long long time_fnext;
261 unsigned long long time_fclose;
262 #endif /* CONFIG_CIFS_STATS2 */
263 __u64 bytes_read;
264 __u64 bytes_written;
265 spinlock_t stat_lock;
266 #endif /* CONFIG_CIFS_STATS */
267 FILE_SYSTEM_DEVICE_INFO fsDevInfo;
268 FILE_SYSTEM_ATTRIBUTE_INFO fsAttrInfo; /* ok if fs name truncated */
269 FILE_SYSTEM_UNIX_INFO fsUnixInfo;
270 unsigned retry:1;
271 unsigned nocase:1;
272 /* BB add field for back pointer to sb struct? */
276 * This info hangs off the cifsFileInfo structure, pointed to by llist.
277 * This is used to track byte stream locks on the file
279 struct cifsLockInfo {
280 struct list_head llist; /* pointer to next cifsLockInfo */
281 __u64 offset;
282 __u64 length;
283 __u8 type;
287 * One of these for each open instance of a file
289 struct cifs_search_info {
290 loff_t index_of_last_entry;
291 __u16 entries_in_buffer;
292 __u16 info_level;
293 __u32 resume_key;
294 char * ntwrk_buf_start;
295 char * srch_entries_start;
296 char * presume_name;
297 unsigned int resume_name_len;
298 unsigned endOfSearch:1;
299 unsigned emptyDir:1;
300 unsigned unicode:1;
301 unsigned smallBuf:1; /* so we know which buf_release function to call */
304 struct cifsFileInfo {
305 struct list_head tlist; /* pointer to next fid owned by tcon */
306 struct list_head flist; /* next fid (file instance) for this inode */
307 unsigned int uid; /* allows finding which FileInfo structure */
308 __u32 pid; /* process id who opened file */
309 __u16 netfid; /* file id from remote */
310 /* BB add lock scope info here if needed */ ;
311 /* lock scope id (0 if none) */
312 struct file * pfile; /* needed for writepage */
313 struct inode * pInode; /* needed for oplock break */
314 struct semaphore lock_sem;
315 struct list_head llist; /* list of byte range locks we have. */
316 unsigned closePend:1; /* file is marked to close */
317 unsigned invalidHandle:1; /* file closed via session abend */
318 atomic_t wrtPending; /* handle in use - defer close */
319 struct semaphore fh_sem; /* prevents reopen race after dead ses*/
320 char * search_resume_name; /* BB removeme BB */
321 struct cifs_search_info srch_inf;
325 * One of these for each file inode
328 struct cifsInodeInfo {
329 struct list_head lockList;
330 /* BB add in lists for dirty pages - i.e. write caching info for oplock */
331 struct list_head openFileList;
332 int write_behind_rc;
333 __u32 cifsAttrs; /* e.g. DOS archive bit, sparse, compressed, system */
334 atomic_t inUse; /* num concurrent users (local openers cifs) of file*/
335 unsigned long time; /* jiffies of last update/check of inode */
336 unsigned clientCanCacheRead:1; /* read oplock */
337 unsigned clientCanCacheAll:1; /* read and writebehind oplock */
338 unsigned oplockPending:1;
339 struct inode vfs_inode;
342 static inline struct cifsInodeInfo *
343 CIFS_I(struct inode *inode)
345 return container_of(inode, struct cifsInodeInfo, vfs_inode);
348 static inline struct cifs_sb_info *
349 CIFS_SB(struct super_block *sb)
351 return sb->s_fs_info;
354 static inline char CIFS_DIR_SEP(const struct cifs_sb_info *cifs_sb)
356 if (cifs_sb->mnt_cifs_flags & CIFS_MOUNT_POSIX_PATHS)
357 return '/';
358 else
359 return '\\';
362 #ifdef CONFIG_CIFS_STATS
363 #define cifs_stats_inc atomic_inc
365 static inline void cifs_stats_bytes_written(struct cifsTconInfo *tcon,
366 unsigned int bytes)
368 if (bytes) {
369 spin_lock(&tcon->stat_lock);
370 tcon->bytes_written += bytes;
371 spin_unlock(&tcon->stat_lock);
375 static inline void cifs_stats_bytes_read(struct cifsTconInfo *tcon,
376 unsigned int bytes)
378 spin_lock(&tcon->stat_lock);
379 tcon->bytes_read += bytes;
380 spin_unlock(&tcon->stat_lock);
382 #else
384 #define cifs_stats_inc(field) do {} while(0)
385 #define cifs_stats_bytes_written(tcon, bytes) do {} while(0)
386 #define cifs_stats_bytes_read(tcon, bytes) do {} while(0)
388 #endif
390 /* one of these for every pending CIFS request to the server */
391 struct mid_q_entry {
392 struct list_head qhead; /* mids waiting on reply from this server */
393 __u16 mid; /* multiplex id */
394 __u16 pid; /* process id */
395 __u32 sequence_number; /* for CIFS signing */
396 unsigned long when_alloc; /* when mid was created */
397 #ifdef CONFIG_CIFS_STATS2
398 unsigned long when_sent; /* time when smb send finished */
399 unsigned long when_received; /* when demux complete (taken off wire) */
400 #endif
401 struct cifsSesInfo *ses; /* smb was sent to this server */
402 struct task_struct *tsk; /* task waiting for response */
403 struct smb_hdr *resp_buf; /* response buffer */
404 int midState; /* wish this were enum but can not pass to wait_event */
405 __u8 command; /* smb command code */
406 unsigned largeBuf:1; /* if valid response, is pointer to large buf */
407 unsigned multiRsp:1; /* multiple trans2 responses for one request */
408 unsigned multiEnd:1; /* both received */
411 struct oplock_q_entry {
412 struct list_head qhead;
413 struct inode * pinode;
414 struct cifsTconInfo * tcon;
415 __u16 netfid;
418 /* for pending dnotify requests */
419 struct dir_notify_req {
420 struct list_head lhead;
421 __le16 Pid;
422 __le16 PidHigh;
423 __u16 Mid;
424 __u16 Tid;
425 __u16 Uid;
426 __u16 netfid;
427 __u32 filter; /* CompletionFilter (for multishot) */
428 int multishot;
429 struct file * pfile;
432 #define MID_FREE 0
433 #define MID_REQUEST_ALLOCATED 1
434 #define MID_REQUEST_SUBMITTED 2
435 #define MID_RESPONSE_RECEIVED 4
436 #define MID_RETRY_NEEDED 8 /* session closed while this request out */
437 #define MID_NO_RESP_NEEDED 0x10
439 /* Types of response buffer returned from SendReceive2 */
440 #define CIFS_NO_BUFFER 0 /* Response buffer not returned */
441 #define CIFS_SMALL_BUFFER 1
442 #define CIFS_LARGE_BUFFER 2
443 #define CIFS_IOVEC 4 /* array of response buffers */
445 /* Security Flags: indicate type of session setup needed */
446 #define CIFSSEC_MAY_SIGN 0x00001
447 #define CIFSSEC_MAY_NTLM 0x00002
448 #define CIFSSEC_MAY_NTLMV2 0x00004
449 #define CIFSSEC_MAY_KRB5 0x00008
450 #ifdef CONFIG_CIFS_WEAK_PW_HASH
451 #define CIFSSEC_MAY_LANMAN 0x00010
452 #define CIFSSEC_MAY_PLNTXT 0x00020
453 #endif /* weak passwords */
454 #define CIFSSEC_MAY_SEAL 0x00040 /* not supported yet */
456 #define CIFSSEC_MUST_SIGN 0x01001
457 /* note that only one of the following can be set so the
458 result of setting MUST flags more than once will be to
459 require use of the stronger protocol */
460 #define CIFSSEC_MUST_NTLM 0x02002
461 #define CIFSSEC_MUST_NTLMV2 0x04004
462 #define CIFSSEC_MUST_KRB5 0x08008
463 #ifdef CONFIG_CIFS_WEAK_PW_HASH
464 #define CIFSSEC_MUST_LANMAN 0x10010
465 #define CIFSSEC_MUST_PLNTXT 0x20020
466 #define CIFSSEC_MASK 0x37037 /* current flags supported if weak */
467 #else
468 #define CIFSSEC_MASK 0x07007 /* flags supported if no weak config */
469 #endif /* WEAK_PW_HASH */
470 #define CIFSSEC_MUST_SEAL 0x40040 /* not supported yet */
472 #define CIFSSEC_DEF CIFSSEC_MAY_SIGN | CIFSSEC_MAY_NTLM | CIFSSEC_MAY_NTLMV2
473 #define CIFSSEC_MAX CIFSSEC_MUST_SIGN | CIFSSEC_MUST_NTLMV2
475 *****************************************************************
476 * All constants go here
477 *****************************************************************
480 #define UID_HASH (16)
483 * Note that ONE module should define _DECLARE_GLOBALS_HERE to cause the
484 * following to be declared.
487 /****************************************************************************
488 * Locking notes. All updates to global variables and lists should be
489 * protected by spinlocks or semaphores.
491 * Spinlocks
492 * ---------
493 * GlobalMid_Lock protects:
494 * list operations on pending_mid_q and oplockQ
495 * updates to XID counters, multiplex id and SMB sequence numbers
496 * GlobalSMBSesLock protects:
497 * list operations on tcp and SMB session lists and tCon lists
498 * f_owner.lock protects certain per file struct operations
499 * mapping->page_lock protects certain per page operations
501 * Semaphores
502 * ----------
503 * sesSem operations on smb session
504 * tconSem operations on tree connection
505 * fh_sem file handle reconnection operations
507 ****************************************************************************/
509 #ifdef DECLARE_GLOBALS_HERE
510 #define GLOBAL_EXTERN
511 #else
512 #define GLOBAL_EXTERN extern
513 #endif
516 * The list of servers that did not respond with NT LM 0.12.
517 * This list helps improve performance and eliminate the messages indicating
518 * that we had a communications error talking to the server in this list.
520 /* Feature not supported */
521 /* GLOBAL_EXTERN struct servers_not_supported *NotSuppList; */
524 * The following is a hash table of all the users we know about.
526 GLOBAL_EXTERN struct smbUidInfo *GlobalUidList[UID_HASH];
528 GLOBAL_EXTERN struct list_head GlobalServerList; /* BB not implemented yet */
529 GLOBAL_EXTERN struct list_head GlobalSMBSessionList;
530 GLOBAL_EXTERN struct list_head GlobalTreeConnectionList;
531 GLOBAL_EXTERN rwlock_t GlobalSMBSeslock; /* protects list inserts on 3 above */
533 GLOBAL_EXTERN struct list_head GlobalOplock_Q;
535 GLOBAL_EXTERN struct list_head GlobalDnotifyReqList; /* Outstanding dir notify requests */
536 GLOBAL_EXTERN struct list_head GlobalDnotifyRsp_Q;/* DirNotify response queue */
539 * Global transaction id (XID) information
541 GLOBAL_EXTERN unsigned int GlobalCurrentXid; /* protected by GlobalMid_Sem */
542 GLOBAL_EXTERN unsigned int GlobalTotalActiveXid; /* prot by GlobalMid_Sem */
543 GLOBAL_EXTERN unsigned int GlobalMaxActiveXid; /* prot by GlobalMid_Sem */
544 GLOBAL_EXTERN spinlock_t GlobalMid_Lock; /* protects above & list operations */
545 /* on midQ entries */
546 GLOBAL_EXTERN char Local_System_Name[15];
549 * Global counters, updated atomically
551 GLOBAL_EXTERN atomic_t sesInfoAllocCount;
552 GLOBAL_EXTERN atomic_t tconInfoAllocCount;
553 GLOBAL_EXTERN atomic_t tcpSesAllocCount;
554 GLOBAL_EXTERN atomic_t tcpSesReconnectCount;
555 GLOBAL_EXTERN atomic_t tconInfoReconnectCount;
557 /* Various Debug counters to remove someday (BB) */
558 GLOBAL_EXTERN atomic_t bufAllocCount; /* current number allocated */
559 #ifdef CONFIG_CIFS_STATS2
560 GLOBAL_EXTERN atomic_t totBufAllocCount; /* total allocated over all time */
561 GLOBAL_EXTERN atomic_t totSmBufAllocCount;
562 #endif
563 GLOBAL_EXTERN atomic_t smBufAllocCount;
564 GLOBAL_EXTERN atomic_t midCount;
566 /* Misc globals */
567 GLOBAL_EXTERN unsigned int multiuser_mount; /* if enabled allows new sessions
568 to be established on existing mount if we
569 have the uid/password or Kerberos credential
570 or equivalent for current user */
571 GLOBAL_EXTERN unsigned int oplockEnabled;
572 GLOBAL_EXTERN unsigned int experimEnabled;
573 GLOBAL_EXTERN unsigned int lookupCacheEnabled;
574 GLOBAL_EXTERN unsigned int extended_security; /* if on, session setup sent
575 with more secure ntlmssp2 challenge/resp */
576 GLOBAL_EXTERN unsigned int sign_CIFS_PDUs; /* enable smb packet signing */
577 GLOBAL_EXTERN unsigned int linuxExtEnabled;/*enable Linux/Unix CIFS extensions*/
578 GLOBAL_EXTERN unsigned int CIFSMaxBufSize; /* max size not including hdr */
579 GLOBAL_EXTERN unsigned int cifs_min_rcv; /* min size of big ntwrk buf pool */
580 GLOBAL_EXTERN unsigned int cifs_min_small; /* min size of small buf pool */
581 GLOBAL_EXTERN unsigned int cifs_max_pending; /* MAX requests at once to server*/