Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 1 | /* |
| 2 | * fs/cifs/sess.c |
| 3 | * |
| 4 | * SMB/CIFS session setup handling routines |
| 5 | * |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 6 | * Copyright (c) International Business Machines Corp., 2006, 2007 |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 7 | * Author(s): Steve French (sfrench@us.ibm.com) |
| 8 | * |
| 9 | * This library is free software; you can redistribute it and/or modify |
| 10 | * it under the terms of the GNU Lesser General Public License as published |
| 11 | * by the Free Software Foundation; either version 2.1 of the License, or |
| 12 | * (at your option) any later version. |
| 13 | * |
| 14 | * This library is distributed in the hope that it will be useful, |
| 15 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 16 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See |
| 17 | * the GNU Lesser General Public License for more details. |
| 18 | * |
| 19 | * You should have received a copy of the GNU Lesser General Public License |
| 20 | * along with this library; if not, write to the Free Software |
| 21 | * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| 22 | */ |
| 23 | |
| 24 | #include "cifspdu.h" |
| 25 | #include "cifsglob.h" |
| 26 | #include "cifsproto.h" |
| 27 | #include "cifs_unicode.h" |
| 28 | #include "cifs_debug.h" |
| 29 | #include "ntlmssp.h" |
| 30 | #include "nterr.h" |
Steve French | 9c53588 | 2006-06-01 05:09:10 +0000 | [diff] [blame] | 31 | #include <linux/utsname.h> |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 32 | |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 33 | extern void SMBNTencrypt(unsigned char *passwd, unsigned char *c8, |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 34 | unsigned char *p24); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 35 | |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 36 | static __u32 cifs_ssetup_hdr(struct cifsSesInfo *ses, SESSION_SETUP_ANDX *pSMB) |
| 37 | { |
| 38 | __u32 capabilities = 0; |
| 39 | |
| 40 | /* init fields common to all four types of SessSetup */ |
| 41 | /* note that header is initialized to zero in header_assemble */ |
| 42 | pSMB->req.AndXCommand = 0xFF; |
| 43 | pSMB->req.MaxBufferSize = cpu_to_le16(ses->server->maxBuf); |
| 44 | pSMB->req.MaxMpxCount = cpu_to_le16(ses->server->maxReq); |
| 45 | |
| 46 | /* Now no need to set SMBFLG_CASELESS or obsolete CANONICAL PATH */ |
| 47 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 48 | /* BB verify whether signing required on neg or just on auth frame |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 49 | (and NTLM case) */ |
| 50 | |
| 51 | capabilities = CAP_LARGE_FILES | CAP_NT_SMBS | CAP_LEVEL_II_OPLOCKS | |
| 52 | CAP_LARGE_WRITE_X | CAP_LARGE_READ_X; |
| 53 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 54 | if (ses->server->secMode & |
| 55 | (SECMODE_SIGN_REQUIRED | SECMODE_SIGN_ENABLED)) |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 56 | pSMB->req.hdr.Flags2 |= SMBFLG2_SECURITY_SIGNATURE; |
| 57 | |
| 58 | if (ses->capabilities & CAP_UNICODE) { |
| 59 | pSMB->req.hdr.Flags2 |= SMBFLG2_UNICODE; |
| 60 | capabilities |= CAP_UNICODE; |
| 61 | } |
| 62 | if (ses->capabilities & CAP_STATUS32) { |
| 63 | pSMB->req.hdr.Flags2 |= SMBFLG2_ERR_STATUS; |
| 64 | capabilities |= CAP_STATUS32; |
| 65 | } |
| 66 | if (ses->capabilities & CAP_DFS) { |
| 67 | pSMB->req.hdr.Flags2 |= SMBFLG2_DFS; |
| 68 | capabilities |= CAP_DFS; |
| 69 | } |
Steve French | 26f5736 | 2007-08-30 22:09:15 +0000 | [diff] [blame] | 70 | if (ses->capabilities & CAP_UNIX) |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 71 | capabilities |= CAP_UNIX; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 72 | |
| 73 | /* BB check whether to init vcnum BB */ |
| 74 | return capabilities; |
| 75 | } |
| 76 | |
Steve French | 3870253 | 2007-07-08 15:40:40 +0000 | [diff] [blame] | 77 | static void unicode_ssetup_strings(char **pbcc_area, struct cifsSesInfo *ses, |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 78 | const struct nls_table *nls_cp) |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 79 | { |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 80 | char *bcc_ptr = *pbcc_area; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 81 | int bytes_ret = 0; |
| 82 | |
| 83 | /* BB FIXME add check that strings total less |
| 84 | than 335 or will need to send them as arrays */ |
| 85 | |
Steve French | 0223cf0 | 2006-06-27 19:50:57 +0000 | [diff] [blame] | 86 | /* unicode strings, must be word aligned before the call */ |
| 87 | /* if ((long) bcc_ptr % 2) { |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 88 | *bcc_ptr = 0; |
| 89 | bcc_ptr++; |
Steve French | 0223cf0 | 2006-06-27 19:50:57 +0000 | [diff] [blame] | 90 | } */ |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 91 | /* copy user */ |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 92 | if (ses->userName == NULL) { |
Steve French | 6e659c6 | 2006-11-08 23:10:46 +0000 | [diff] [blame] | 93 | /* null user mount */ |
| 94 | *bcc_ptr = 0; |
| 95 | *(bcc_ptr+1) = 0; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 96 | } else { /* 300 should be long enough for any conceivable user name */ |
| 97 | bytes_ret = cifs_strtoUCS((__le16 *) bcc_ptr, ses->userName, |
| 98 | 300, nls_cp); |
| 99 | } |
| 100 | bcc_ptr += 2 * bytes_ret; |
| 101 | bcc_ptr += 2; /* account for null termination */ |
| 102 | /* copy domain */ |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 103 | if (ses->domainName == NULL) { |
Steve French | 6e659c6 | 2006-11-08 23:10:46 +0000 | [diff] [blame] | 104 | /* Sending null domain better than using a bogus domain name (as |
| 105 | we did briefly in 2.6.18) since server will use its default */ |
| 106 | *bcc_ptr = 0; |
| 107 | *(bcc_ptr+1) = 0; |
| 108 | bytes_ret = 0; |
| 109 | } else |
Steve French | 3870253 | 2007-07-08 15:40:40 +0000 | [diff] [blame] | 110 | bytes_ret = cifs_strtoUCS((__le16 *) bcc_ptr, ses->domainName, |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 111 | 256, nls_cp); |
| 112 | bcc_ptr += 2 * bytes_ret; |
| 113 | bcc_ptr += 2; /* account for null terminator */ |
| 114 | |
| 115 | /* Copy OS version */ |
| 116 | bytes_ret = cifs_strtoUCS((__le16 *)bcc_ptr, "Linux version ", 32, |
| 117 | nls_cp); |
| 118 | bcc_ptr += 2 * bytes_ret; |
Serge E. Hallyn | 96b644b | 2006-10-02 02:18:13 -0700 | [diff] [blame] | 119 | bytes_ret = cifs_strtoUCS((__le16 *) bcc_ptr, init_utsname()->release, |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 120 | 32, nls_cp); |
| 121 | bcc_ptr += 2 * bytes_ret; |
| 122 | bcc_ptr += 2; /* trailing null */ |
| 123 | |
| 124 | bytes_ret = cifs_strtoUCS((__le16 *) bcc_ptr, CIFS_NETWORK_OPSYS, |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 125 | 32, nls_cp); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 126 | bcc_ptr += 2 * bytes_ret; |
| 127 | bcc_ptr += 2; /* trailing null */ |
| 128 | |
| 129 | *pbcc_area = bcc_ptr; |
| 130 | } |
| 131 | |
Steve French | 3870253 | 2007-07-08 15:40:40 +0000 | [diff] [blame] | 132 | static void ascii_ssetup_strings(char **pbcc_area, struct cifsSesInfo *ses, |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 133 | const struct nls_table *nls_cp) |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 134 | { |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 135 | char *bcc_ptr = *pbcc_area; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 136 | |
| 137 | /* copy user */ |
| 138 | /* BB what about null user mounts - check that we do this BB */ |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 139 | /* copy user */ |
| 140 | if (ses->userName == NULL) { |
| 141 | /* BB what about null user mounts - check that we do this BB */ |
| 142 | } else { /* 300 should be long enough for any conceivable user name */ |
| 143 | strncpy(bcc_ptr, ses->userName, 300); |
| 144 | } |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 145 | /* BB improve check for overflow */ |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 146 | bcc_ptr += strnlen(ses->userName, 300); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 147 | *bcc_ptr = 0; |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 148 | bcc_ptr++; /* account for null termination */ |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 149 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 150 | /* copy domain */ |
| 151 | |
| 152 | if (ses->domainName != NULL) { |
| 153 | strncpy(bcc_ptr, ses->domainName, 256); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 154 | bcc_ptr += strnlen(ses->domainName, 256); |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 155 | } /* else we will send a null domain name |
Steve French | 6e659c6 | 2006-11-08 23:10:46 +0000 | [diff] [blame] | 156 | so the server will default to its own domain */ |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 157 | *bcc_ptr = 0; |
| 158 | bcc_ptr++; |
| 159 | |
| 160 | /* BB check for overflow here */ |
| 161 | |
| 162 | strcpy(bcc_ptr, "Linux version "); |
| 163 | bcc_ptr += strlen("Linux version "); |
Serge E. Hallyn | 96b644b | 2006-10-02 02:18:13 -0700 | [diff] [blame] | 164 | strcpy(bcc_ptr, init_utsname()->release); |
| 165 | bcc_ptr += strlen(init_utsname()->release) + 1; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 166 | |
| 167 | strcpy(bcc_ptr, CIFS_NETWORK_OPSYS); |
| 168 | bcc_ptr += strlen(CIFS_NETWORK_OPSYS) + 1; |
| 169 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 170 | *pbcc_area = bcc_ptr; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 171 | } |
| 172 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 173 | static int decode_unicode_ssetup(char **pbcc_area, int bleft, |
| 174 | struct cifsSesInfo *ses, |
| 175 | const struct nls_table *nls_cp) |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 176 | { |
| 177 | int rc = 0; |
| 178 | int words_left, len; |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 179 | char *data = *pbcc_area; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 180 | |
| 181 | |
| 182 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 183 | cFYI(1, ("bleft %d", bleft)); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 184 | |
| 185 | |
Steve French | 8e6f195 | 2007-01-22 01:19:30 +0000 | [diff] [blame] | 186 | /* SMB header is unaligned, so cifs servers word align start of |
| 187 | Unicode strings */ |
| 188 | data++; |
| 189 | bleft--; /* Windows servers do not always double null terminate |
| 190 | their final Unicode string - in which case we |
| 191 | now will not attempt to decode the byte of junk |
| 192 | which follows it */ |
Steve French | 50c2f75 | 2007-07-13 00:33:32 +0000 | [diff] [blame] | 193 | |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 194 | words_left = bleft / 2; |
| 195 | |
| 196 | /* save off server operating system */ |
| 197 | len = UniStrnlen((wchar_t *) data, words_left); |
| 198 | |
| 199 | /* We look for obvious messed up bcc or strings in response so we do not go off |
| 200 | the end since (at least) WIN2K and Windows XP have a major bug in not null |
| 201 | terminating last Unicode string in response */ |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 202 | if (len >= words_left) |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 203 | return rc; |
| 204 | |
Steve French | 26f5736 | 2007-08-30 22:09:15 +0000 | [diff] [blame] | 205 | kfree(ses->serverOS); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 206 | /* UTF-8 string will not grow more than four times as big as UCS-16 */ |
| 207 | ses->serverOS = kzalloc(4 * len, GFP_KERNEL); |
Steve French | 26f5736 | 2007-08-30 22:09:15 +0000 | [diff] [blame] | 208 | if (ses->serverOS != NULL) |
| 209 | cifs_strfromUCS_le(ses->serverOS, (__le16 *)data, len, nls_cp); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 210 | data += 2 * (len + 1); |
| 211 | words_left -= len + 1; |
| 212 | |
| 213 | /* save off server network operating system */ |
| 214 | len = UniStrnlen((wchar_t *) data, words_left); |
| 215 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 216 | if (len >= words_left) |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 217 | return rc; |
| 218 | |
Steve French | 26f5736 | 2007-08-30 22:09:15 +0000 | [diff] [blame] | 219 | kfree(ses->serverNOS); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 220 | ses->serverNOS = kzalloc(4 * len, GFP_KERNEL); /* BB this is wrong length FIXME BB */ |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 221 | if (ses->serverNOS != NULL) { |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 222 | cifs_strfromUCS_le(ses->serverNOS, (__le16 *)data, len, |
| 223 | nls_cp); |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 224 | if (strncmp(ses->serverNOS, "NT LAN Manager 4", 16) == 0) { |
| 225 | cFYI(1, ("NT4 server")); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 226 | ses->flags |= CIFS_SES_NT4; |
| 227 | } |
| 228 | } |
| 229 | data += 2 * (len + 1); |
| 230 | words_left -= len + 1; |
| 231 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 232 | /* save off server domain */ |
| 233 | len = UniStrnlen((wchar_t *) data, words_left); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 234 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 235 | if (len > words_left) |
| 236 | return rc; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 237 | |
Steve French | 26f5736 | 2007-08-30 22:09:15 +0000 | [diff] [blame] | 238 | kfree(ses->serverDomain); |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 239 | ses->serverDomain = kzalloc(2 * (len + 1), GFP_KERNEL); /* BB FIXME wrong length */ |
| 240 | if (ses->serverDomain != NULL) { |
| 241 | cifs_strfromUCS_le(ses->serverDomain, (__le16 *)data, len, |
| 242 | nls_cp); |
| 243 | ses->serverDomain[2*len] = 0; |
| 244 | ses->serverDomain[(2*len) + 1] = 0; |
| 245 | } |
| 246 | data += 2 * (len + 1); |
| 247 | words_left -= len + 1; |
| 248 | |
| 249 | cFYI(1, ("words left: %d", words_left)); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 250 | |
| 251 | return rc; |
| 252 | } |
| 253 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 254 | static int decode_ascii_ssetup(char **pbcc_area, int bleft, |
| 255 | struct cifsSesInfo *ses, |
| 256 | const struct nls_table *nls_cp) |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 257 | { |
| 258 | int rc = 0; |
| 259 | int len; |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 260 | char *bcc_ptr = *pbcc_area; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 261 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 262 | cFYI(1, ("decode sessetup ascii. bleft %d", bleft)); |
Steve French | 50c2f75 | 2007-07-13 00:33:32 +0000 | [diff] [blame] | 263 | |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 264 | len = strnlen(bcc_ptr, bleft); |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 265 | if (len >= bleft) |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 266 | return rc; |
Steve French | 50c2f75 | 2007-07-13 00:33:32 +0000 | [diff] [blame] | 267 | |
Steve French | 26f5736 | 2007-08-30 22:09:15 +0000 | [diff] [blame] | 268 | kfree(ses->serverOS); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 269 | |
| 270 | ses->serverOS = kzalloc(len + 1, GFP_KERNEL); |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 271 | if (ses->serverOS) |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 272 | strncpy(ses->serverOS, bcc_ptr, len); |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 273 | if (strncmp(ses->serverOS, "OS/2", 4) == 0) { |
| 274 | cFYI(1, ("OS/2 server")); |
Steve French | 9ac00b7 | 2006-09-30 04:13:17 +0000 | [diff] [blame] | 275 | ses->flags |= CIFS_SES_OS2; |
| 276 | } |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 277 | |
| 278 | bcc_ptr += len + 1; |
| 279 | bleft -= len + 1; |
| 280 | |
| 281 | len = strnlen(bcc_ptr, bleft); |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 282 | if (len >= bleft) |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 283 | return rc; |
| 284 | |
Steve French | 26f5736 | 2007-08-30 22:09:15 +0000 | [diff] [blame] | 285 | kfree(ses->serverNOS); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 286 | |
| 287 | ses->serverNOS = kzalloc(len + 1, GFP_KERNEL); |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 288 | if (ses->serverNOS) |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 289 | strncpy(ses->serverNOS, bcc_ptr, len); |
| 290 | |
| 291 | bcc_ptr += len + 1; |
| 292 | bleft -= len + 1; |
| 293 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 294 | len = strnlen(bcc_ptr, bleft); |
| 295 | if (len > bleft) |
| 296 | return rc; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 297 | |
Steve French | 9ac00b7 | 2006-09-30 04:13:17 +0000 | [diff] [blame] | 298 | /* No domain field in LANMAN case. Domain is |
| 299 | returned by old servers in the SMB negprot response */ |
| 300 | /* BB For newer servers which do not support Unicode, |
| 301 | but thus do return domain here we could add parsing |
| 302 | for it later, but it is not very important */ |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 303 | cFYI(1, ("ascii: bytes left %d", bleft)); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 304 | |
| 305 | return rc; |
| 306 | } |
| 307 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 308 | int |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 309 | CIFS_SessSetup(unsigned int xid, struct cifsSesInfo *ses, int first_time, |
| 310 | const struct nls_table *nls_cp) |
| 311 | { |
| 312 | int rc = 0; |
| 313 | int wct; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 314 | struct smb_hdr *smb_buf; |
| 315 | char *bcc_ptr; |
Steve French | 750d115 | 2006-06-27 06:28:30 +0000 | [diff] [blame] | 316 | char *str_area; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 317 | SESSION_SETUP_ANDX *pSMB; |
| 318 | __u32 capabilities; |
| 319 | int count; |
| 320 | int resp_buf_type = 0; |
Steve French | 750d115 | 2006-06-27 06:28:30 +0000 | [diff] [blame] | 321 | struct kvec iov[2]; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 322 | enum securityEnum type; |
| 323 | __u16 action; |
| 324 | int bytes_remaining; |
Steve French | 254e55e | 2006-06-04 05:53:15 +0000 | [diff] [blame] | 325 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 326 | if (ses == NULL) |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 327 | return -EINVAL; |
| 328 | |
| 329 | type = ses->server->secType; |
Steve French | f40c562 | 2006-06-28 00:13:38 +0000 | [diff] [blame] | 330 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 331 | cFYI(1, ("sess setup type %d", type)); |
| 332 | if (type == LANMAN) { |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 333 | #ifndef CONFIG_CIFS_WEAK_PW_HASH |
| 334 | /* LANMAN and plaintext are less secure and off by default. |
| 335 | So we make this explicitly be turned on in kconfig (in the |
| 336 | build) and turned on at runtime (changed from the default) |
| 337 | in proc/fs/cifs or via mount parm. Unfortunately this is |
| 338 | needed for old Win (e.g. Win95), some obscure NAS and OS/2 */ |
| 339 | return -EOPNOTSUPP; |
| 340 | #endif |
| 341 | wct = 10; /* lanman 2 style sessionsetup */ |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 342 | } else if ((type == NTLM) || (type == NTLMv2)) { |
Steve French | 9312f67 | 2006-06-04 22:21:07 +0000 | [diff] [blame] | 343 | /* For NTLMv2 failures eventually may need to retry NTLM */ |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 344 | wct = 13; /* old style NTLM sessionsetup */ |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 345 | } else /* same size: negotiate or auth, NTLMSSP or extended security */ |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 346 | wct = 12; |
| 347 | |
| 348 | rc = small_smb_init_no_tc(SMB_COM_SESSION_SETUP_ANDX, wct, ses, |
| 349 | (void **)&smb_buf); |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 350 | if (rc) |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 351 | return rc; |
| 352 | |
| 353 | pSMB = (SESSION_SETUP_ANDX *)smb_buf; |
| 354 | |
| 355 | capabilities = cifs_ssetup_hdr(ses, pSMB); |
Steve French | 750d115 | 2006-06-27 06:28:30 +0000 | [diff] [blame] | 356 | |
| 357 | /* we will send the SMB in two pieces, |
| 358 | a fixed length beginning part, and a |
| 359 | second part which will include the strings |
| 360 | and rest of bcc area, in order to avoid having |
| 361 | to do a large buffer 17K allocation */ |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 362 | iov[0].iov_base = (char *)pSMB; |
| 363 | iov[0].iov_len = smb_buf->smb_buf_length + 4; |
Steve French | 750d115 | 2006-06-27 06:28:30 +0000 | [diff] [blame] | 364 | |
| 365 | /* 2000 big enough to fit max user, domain, NOS name etc. */ |
| 366 | str_area = kmalloc(2000, GFP_KERNEL); |
Cyrill Gorcunov | 5e6e623 | 2007-08-18 00:15:20 +0000 | [diff] [blame] | 367 | if (str_area == NULL) { |
| 368 | cifs_small_buf_release(smb_buf); |
| 369 | return -ENOMEM; |
| 370 | } |
Steve French | 750d115 | 2006-06-27 06:28:30 +0000 | [diff] [blame] | 371 | bcc_ptr = str_area; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 372 | |
Steve French | 9ac00b7 | 2006-09-30 04:13:17 +0000 | [diff] [blame] | 373 | ses->flags &= ~CIFS_SES_LANMAN; |
| 374 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 375 | if (type == LANMAN) { |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 376 | #ifdef CONFIG_CIFS_WEAK_PW_HASH |
Steve French | 7c7b25b | 2006-06-01 19:20:10 +0000 | [diff] [blame] | 377 | char lnm_session_key[CIFS_SESS_KEY_SIZE]; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 378 | |
| 379 | /* no capabilities flags in old lanman negotiation */ |
| 380 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 381 | pSMB->old_req.PasswordLength = cpu_to_le16(CIFS_SESS_KEY_SIZE); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 382 | /* BB calculate hash with password */ |
| 383 | /* and copy into bcc */ |
| 384 | |
Steve French | 7c7b25b | 2006-06-01 19:20:10 +0000 | [diff] [blame] | 385 | calc_lanman_hash(ses, lnm_session_key); |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 386 | ses->flags |= CIFS_SES_LANMAN; |
Steve French | 750d115 | 2006-06-27 06:28:30 +0000 | [diff] [blame] | 387 | /* #ifdef CONFIG_CIFS_DEBUG2 |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 388 | cifs_dump_mem("cryptkey: ",ses->server->cryptKey, |
Steve French | 7c7b25b | 2006-06-01 19:20:10 +0000 | [diff] [blame] | 389 | CIFS_SESS_KEY_SIZE); |
Steve French | 750d115 | 2006-06-27 06:28:30 +0000 | [diff] [blame] | 390 | #endif */ |
Steve French | 7c7b25b | 2006-06-01 19:20:10 +0000 | [diff] [blame] | 391 | memcpy(bcc_ptr, (char *)lnm_session_key, CIFS_SESS_KEY_SIZE); |
| 392 | bcc_ptr += CIFS_SESS_KEY_SIZE; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 393 | |
| 394 | /* can not sign if LANMAN negotiated so no need |
| 395 | to calculate signing key? but what if server |
| 396 | changed to do higher than lanman dialect and |
| 397 | we reconnected would we ever calc signing_key? */ |
| 398 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 399 | cFYI(1, ("Negotiating LANMAN setting up strings")); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 400 | /* Unicode not allowed for LANMAN dialects */ |
| 401 | ascii_ssetup_strings(&bcc_ptr, ses, nls_cp); |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 402 | #endif |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 403 | } else if (type == NTLM) { |
Steve French | 7c7b25b | 2006-06-01 19:20:10 +0000 | [diff] [blame] | 404 | char ntlm_session_key[CIFS_SESS_KEY_SIZE]; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 405 | |
| 406 | pSMB->req_no_secext.Capabilities = cpu_to_le32(capabilities); |
| 407 | pSMB->req_no_secext.CaseInsensitivePasswordLength = |
Steve French | 7c7b25b | 2006-06-01 19:20:10 +0000 | [diff] [blame] | 408 | cpu_to_le16(CIFS_SESS_KEY_SIZE); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 409 | pSMB->req_no_secext.CaseSensitivePasswordLength = |
Steve French | 7c7b25b | 2006-06-01 19:20:10 +0000 | [diff] [blame] | 410 | cpu_to_le16(CIFS_SESS_KEY_SIZE); |
Steve French | 50c2f75 | 2007-07-13 00:33:32 +0000 | [diff] [blame] | 411 | |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 412 | /* calculate session key */ |
| 413 | SMBNTencrypt(ses->password, ses->server->cryptKey, |
| 414 | ntlm_session_key); |
| 415 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 416 | if (first_time) /* should this be moved into common code |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 417 | with similar ntlmv2 path? */ |
Steve French | b609f06 | 2007-07-09 07:55:14 +0000 | [diff] [blame] | 418 | cifs_calculate_mac_key(&ses->server->mac_signing_key, |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 419 | ntlm_session_key, ses->password); |
| 420 | /* copy session key */ |
| 421 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 422 | memcpy(bcc_ptr, (char *)ntlm_session_key, CIFS_SESS_KEY_SIZE); |
Steve French | 7c7b25b | 2006-06-01 19:20:10 +0000 | [diff] [blame] | 423 | bcc_ptr += CIFS_SESS_KEY_SIZE; |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 424 | memcpy(bcc_ptr, (char *)ntlm_session_key, CIFS_SESS_KEY_SIZE); |
Steve French | 7c7b25b | 2006-06-01 19:20:10 +0000 | [diff] [blame] | 425 | bcc_ptr += CIFS_SESS_KEY_SIZE; |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 426 | if (ses->capabilities & CAP_UNICODE) { |
Steve French | 0223cf0 | 2006-06-27 19:50:57 +0000 | [diff] [blame] | 427 | /* unicode strings must be word aligned */ |
| 428 | if (iov[0].iov_len % 2) { |
| 429 | *bcc_ptr = 0; |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 430 | bcc_ptr++; |
| 431 | } |
Steve French | 7c7b25b | 2006-06-01 19:20:10 +0000 | [diff] [blame] | 432 | unicode_ssetup_strings(&bcc_ptr, ses, nls_cp); |
Steve French | 0223cf0 | 2006-06-27 19:50:57 +0000 | [diff] [blame] | 433 | } else |
Steve French | 7c7b25b | 2006-06-01 19:20:10 +0000 | [diff] [blame] | 434 | ascii_ssetup_strings(&bcc_ptr, ses, nls_cp); |
| 435 | } else if (type == NTLMv2) { |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 436 | char *v2_sess_key = |
Steve French | 6d027cf | 2006-06-05 16:26:05 +0000 | [diff] [blame] | 437 | kmalloc(sizeof(struct ntlmv2_resp), GFP_KERNEL); |
Steve French | f64b23a | 2006-06-05 05:27:37 +0000 | [diff] [blame] | 438 | |
| 439 | /* BB FIXME change all users of v2_sess_key to |
| 440 | struct ntlmv2_resp */ |
Steve French | 7c7b25b | 2006-06-01 19:20:10 +0000 | [diff] [blame] | 441 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 442 | if (v2_sess_key == NULL) { |
Steve French | 7c7b25b | 2006-06-01 19:20:10 +0000 | [diff] [blame] | 443 | cifs_small_buf_release(smb_buf); |
| 444 | return -ENOMEM; |
| 445 | } |
| 446 | |
| 447 | pSMB->req_no_secext.Capabilities = cpu_to_le32(capabilities); |
| 448 | |
| 449 | /* LM2 password would be here if we supported it */ |
| 450 | pSMB->req_no_secext.CaseInsensitivePasswordLength = 0; |
| 451 | /* cpu_to_le16(LM2_SESS_KEY_SIZE); */ |
| 452 | |
| 453 | pSMB->req_no_secext.CaseSensitivePasswordLength = |
Steve French | f64b23a | 2006-06-05 05:27:37 +0000 | [diff] [blame] | 454 | cpu_to_le16(sizeof(struct ntlmv2_resp)); |
Steve French | 7c7b25b | 2006-06-01 19:20:10 +0000 | [diff] [blame] | 455 | |
| 456 | /* calculate session key */ |
Steve French | 1717ffc | 2006-06-08 05:41:32 +0000 | [diff] [blame] | 457 | setup_ntlmv2_rsp(ses, v2_sess_key, nls_cp); |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 458 | if (first_time) /* should this be moved into common code |
| 459 | with similar ntlmv2 path? */ |
Steve French | 7c7b25b | 2006-06-01 19:20:10 +0000 | [diff] [blame] | 460 | /* cifs_calculate_ntlmv2_mac_key(ses->server->mac_signing_key, |
| 461 | response BB FIXME, v2_sess_key); */ |
| 462 | |
| 463 | /* copy session key */ |
| 464 | |
| 465 | /* memcpy(bcc_ptr, (char *)ntlm_session_key,LM2_SESS_KEY_SIZE); |
| 466 | bcc_ptr += LM2_SESS_KEY_SIZE; */ |
Steve French | 3870253 | 2007-07-08 15:40:40 +0000 | [diff] [blame] | 467 | memcpy(bcc_ptr, (char *)v2_sess_key, |
| 468 | sizeof(struct ntlmv2_resp)); |
Steve French | f64b23a | 2006-06-05 05:27:37 +0000 | [diff] [blame] | 469 | bcc_ptr += sizeof(struct ntlmv2_resp); |
| 470 | kfree(v2_sess_key); |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 471 | if (ses->capabilities & CAP_UNICODE) { |
| 472 | if (iov[0].iov_len % 2) { |
Steve French | 0223cf0 | 2006-06-27 19:50:57 +0000 | [diff] [blame] | 473 | *bcc_ptr = 0; |
Steve French | 26f5736 | 2007-08-30 22:09:15 +0000 | [diff] [blame] | 474 | bcc_ptr++; |
| 475 | } |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 476 | unicode_ssetup_strings(&bcc_ptr, ses, nls_cp); |
Steve French | 0223cf0 | 2006-06-27 19:50:57 +0000 | [diff] [blame] | 477 | } else |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 478 | ascii_ssetup_strings(&bcc_ptr, ses, nls_cp); |
| 479 | } else /* NTLMSSP or SPNEGO */ { |
| 480 | pSMB->req.hdr.Flags2 |= SMBFLG2_EXT_SEC; |
| 481 | capabilities |= CAP_EXTENDED_SECURITY; |
| 482 | pSMB->req.Capabilities = cpu_to_le32(capabilities); |
| 483 | /* BB set password lengths */ |
| 484 | } |
| 485 | |
Steve French | 750d115 | 2006-06-27 06:28:30 +0000 | [diff] [blame] | 486 | count = (long) bcc_ptr - (long) str_area; |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 487 | smb_buf->smb_buf_length += count; |
| 488 | |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 489 | BCC_LE(smb_buf) = cpu_to_le16(count); |
| 490 | |
Steve French | 750d115 | 2006-06-27 06:28:30 +0000 | [diff] [blame] | 491 | iov[1].iov_base = str_area; |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 492 | iov[1].iov_len = count; |
Steve French | 750d115 | 2006-06-27 06:28:30 +0000 | [diff] [blame] | 493 | rc = SendReceive2(xid, ses, iov, 2 /* num_iovecs */, &resp_buf_type, 0); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 494 | /* SMB request buf freed in SendReceive2 */ |
| 495 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 496 | cFYI(1, ("ssetup rc from sendrecv2 is %d", rc)); |
| 497 | if (rc) |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 498 | goto ssetup_exit; |
| 499 | |
| 500 | pSMB = (SESSION_SETUP_ANDX *)iov[0].iov_base; |
| 501 | smb_buf = (struct smb_hdr *)iov[0].iov_base; |
| 502 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 503 | if ((smb_buf->WordCount != 3) && (smb_buf->WordCount != 4)) { |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 504 | rc = -EIO; |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 505 | cERROR(1, ("bad word count %d", smb_buf->WordCount)); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 506 | goto ssetup_exit; |
| 507 | } |
| 508 | action = le16_to_cpu(pSMB->resp.Action); |
| 509 | if (action & GUEST_LOGIN) |
Steve French | 189acaa | 2006-06-23 02:33:48 +0000 | [diff] [blame] | 510 | cFYI(1, ("Guest login")); /* BB mark SesInfo struct? */ |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 511 | ses->Suid = smb_buf->Uid; /* UID left in wire format (le) */ |
| 512 | cFYI(1, ("UID = %d ", ses->Suid)); |
| 513 | /* response can have either 3 or 4 word count - Samba sends 3 */ |
| 514 | /* and lanman response is 3 */ |
| 515 | bytes_remaining = BCC(smb_buf); |
| 516 | bcc_ptr = pByteArea(smb_buf); |
| 517 | |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 518 | if (smb_buf->WordCount == 4) { |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 519 | __u16 blob_len; |
| 520 | blob_len = le16_to_cpu(pSMB->resp.SecurityBlobLength); |
| 521 | bcc_ptr += blob_len; |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 522 | if (blob_len > bytes_remaining) { |
| 523 | cERROR(1, ("bad security blob length %d", blob_len)); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 524 | rc = -EINVAL; |
| 525 | goto ssetup_exit; |
| 526 | } |
| 527 | bytes_remaining -= blob_len; |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 528 | } |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 529 | |
| 530 | /* BB check if Unicode and decode strings */ |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 531 | if (smb_buf->Flags2 & SMBFLG2_UNICODE) |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 532 | rc = decode_unicode_ssetup(&bcc_ptr, bytes_remaining, |
| 533 | ses, nls_cp); |
| 534 | else |
Steve French | 63135e0 | 2007-07-17 17:34:02 +0000 | [diff] [blame] | 535 | rc = decode_ascii_ssetup(&bcc_ptr, bytes_remaining, |
| 536 | ses, nls_cp); |
Steve French | 50c2f75 | 2007-07-13 00:33:32 +0000 | [diff] [blame] | 537 | |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 538 | ssetup_exit: |
Steve French | 750d115 | 2006-06-27 06:28:30 +0000 | [diff] [blame] | 539 | kfree(str_area); |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 540 | if (resp_buf_type == CIFS_SMALL_BUFFER) { |
| 541 | cFYI(1, ("ssetup freeing small buf %p", iov[0].iov_base)); |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 542 | cifs_small_buf_release(iov[0].iov_base); |
Steve French | 790fe57 | 2007-07-07 19:25:05 +0000 | [diff] [blame] | 543 | } else if (resp_buf_type == CIFS_LARGE_BUFFER) |
Steve French | 3979877 | 2006-05-31 22:40:51 +0000 | [diff] [blame] | 544 | cifs_buf_release(iov[0].iov_base); |
| 545 | |
| 546 | return rc; |
| 547 | } |