2 Unix SMB/CIFS implementation.
3 client error handling routines
4 Copyright (C) Andrew Tridgell 1994-1998
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
25 /*****************************************************
26 RAP error codes - a small start but will be extended.
28 XXX: Perhaps these should move into a common function because they're
29 duplicated in clirap2.c
31 *******************************************************/
39 {5, "RAP5: User has insufficient privilege" },
40 {50, "RAP50: Not supported by server" },
41 {65, "RAP65: Access denied" },
42 {86, "RAP86: The specified password is invalid" },
43 {2220, "RAP2220: Group does not exist" },
44 {2221, "RAP2221: User does not exist" },
45 {2226, "RAP2226: Operation only permitted on a Primary Domain Controller" },
46 {2237, "RAP2237: User is not in group" },
47 {2242, "RAP2242: The password of this user has expired." },
48 {2243, "RAP2243: The password of this user cannot change." },
49 {2244, "RAP2244: This password cannot be used now (password history conflict)." },
50 {2245, "RAP2245: The password is shorter than required." },
51 {2246, "RAP2246: The password of this user is too recent to change."},
53 /* these really shouldn't be here ... */
54 {0x80, "Not listening on called name"},
55 {0x81, "Not listening for calling name"},
56 {0x82, "Called name not present"},
57 {0x83, "Called name present, but insufficient resources"},
62 /****************************************************************************
63 return a description of an SMB error
64 ****************************************************************************/
65 static const char *cli_smb_errstr(struct cli_state
*cli
)
67 return smb_dos_errstr(cli
->inbuf
);
70 /***************************************************************************
71 Return an error message - either an NT error, SMB error or a RAP error.
72 Note some of the NT errors are actually warnings or "informational" errors
73 in which case they can be safely ignored.
74 ****************************************************************************/
76 const char *cli_errstr(struct cli_state
*cli
)
78 static fstring cli_error_message
;
79 uint32 flgs2
= SVAL(cli
->inbuf
,smb_flg2
), errnum
;
83 if (!cli
->initialised
) {
84 fstrcpy(cli_error_message
, "[Programmer's error] cli_errstr called on unitialized cli_stat struct!\n");
85 return cli_error_message
;
88 /* Was it server socket error ? */
89 if (cli
->fd
== -1 && cli
->smb_rw_error
) {
90 switch(cli
->smb_rw_error
) {
92 slprintf(cli_error_message
, sizeof(cli_error_message
) - 1,
93 "Call timed out: server did not respond after %d milliseconds",
97 slprintf(cli_error_message
, sizeof(cli_error_message
) - 1,
98 "Call returned zero bytes (EOF)\n" );
101 slprintf(cli_error_message
, sizeof(cli_error_message
) - 1,
102 "Read error: %s\n", strerror(errno
) );
105 slprintf(cli_error_message
, sizeof(cli_error_message
) - 1,
106 "Write error: %s\n", strerror(errno
) );
109 slprintf(cli_error_message
, sizeof(cli_error_message
) - 1,
110 "Unknown error code %d\n", cli
->smb_rw_error
);
113 return cli_error_message
;
116 /* Case #1: RAP error */
117 if (cli
->rap_error
) {
118 for (i
= 0; rap_errmap
[i
].message
!= NULL
; i
++) {
119 if (rap_errmap
[i
].err
== cli
->rap_error
) {
120 return rap_errmap
[i
].message
;
124 slprintf(cli_error_message
, sizeof(cli_error_message
) - 1, "RAP code %d",
127 return cli_error_message
;
130 /* Case #2: 32-bit NT errors */
131 if (flgs2
& FLAGS2_32_BIT_ERROR_CODES
) {
132 NTSTATUS status
= NT_STATUS(IVAL(cli
->inbuf
,smb_rcls
));
134 return nt_errstr(status
);
137 cli_dos_error(cli
, &errclass
, &errnum
);
139 /* Case #3: SMB error */
141 return cli_smb_errstr(cli
);
145 /* Return the 32-bit NT status code from the last packet */
146 NTSTATUS
cli_nt_error(struct cli_state
*cli
)
148 int flgs2
= SVAL(cli
->inbuf
,smb_flg2
);
150 if (!(flgs2
& FLAGS2_32_BIT_ERROR_CODES
)) {
151 int class = CVAL(cli
->inbuf
,smb_rcls
);
152 int code
= SVAL(cli
->inbuf
,smb_err
);
153 return dos_to_ntstatus(class, code
);
156 return NT_STATUS(IVAL(cli
->inbuf
,smb_rcls
));
160 /* Return the DOS error from the last packet - an error class and an error
162 void cli_dos_error(struct cli_state
*cli
, uint8
*eclass
, uint32
*ecode
)
168 if(!cli
->initialised
) return;
170 flgs2
= SVAL(cli
->inbuf
,smb_flg2
);
172 if (flgs2
& FLAGS2_32_BIT_ERROR_CODES
) {
173 NTSTATUS ntstatus
= NT_STATUS(IVAL(cli
->inbuf
, smb_rcls
));
174 ntstatus_to_dos(ntstatus
, eclass
, ecode
);
178 rcls
= CVAL(cli
->inbuf
,smb_rcls
);
179 code
= SVAL(cli
->inbuf
,smb_err
);
181 if (eclass
) *eclass
= rcls
;
182 if (ecode
) *ecode
= code
;
185 /* Return a UNIX errno from a dos error class, error number tuple */
187 static int cli_errno_from_dos(uint8 eclass
, uint32 num
)
189 if (eclass
== ERRDOS
) {
191 case ERRbadfile
: return ENOENT
;
192 case ERRbadpath
: return ENOTDIR
;
193 case ERRnoaccess
: return EACCES
;
194 case ERRfilexists
: return EEXIST
;
195 case ERRrename
: return EEXIST
;
196 case ERRbadshare
: return EBUSY
;
197 case ERRlock
: return EBUSY
;
198 case ERRinvalidname
: return ENOENT
;
199 case ERRnosuchshare
: return ENODEV
;
203 if (eclass
== ERRSRV
) {
205 case ERRbadpw
: return EPERM
;
206 case ERRaccess
: return EACCES
;
207 case ERRnoresource
: return ENOMEM
;
208 case ERRinvdevice
: return ENODEV
;
209 case ERRinvnetname
: return ENODEV
;
213 /* for other cases */
217 /* Return a UNIX errno from a NT status code */
222 {NT_STATUS_ACCESS_VIOLATION
, EACCES
},
223 {NT_STATUS_NO_SUCH_FILE
, ENOENT
},
224 {NT_STATUS_NO_SUCH_DEVICE
, ENODEV
},
225 {NT_STATUS_INVALID_HANDLE
, EBADF
},
226 {NT_STATUS_NO_MEMORY
, ENOMEM
},
227 {NT_STATUS_ACCESS_DENIED
, EACCES
},
228 {NT_STATUS_OBJECT_NAME_NOT_FOUND
, ENOENT
},
229 {NT_STATUS_SHARING_VIOLATION
, EBUSY
},
230 {NT_STATUS_OBJECT_PATH_INVALID
, ENOTDIR
},
231 {NT_STATUS_OBJECT_NAME_COLLISION
, EEXIST
},
232 {NT_STATUS_PATH_NOT_COVERED
, ENOENT
},
236 static int cli_errno_from_nt(NTSTATUS status
)
239 DEBUG(10,("cli_errno_from_nt: 32 bit codes: code=%08x\n", NT_STATUS_V(status
)));
241 /* Status codes without this bit set are not errors */
243 if (!(NT_STATUS_V(status
) & 0xc0000000))
246 for (i
=0;nt_errno_map
[i
].error
;i
++) {
247 if (NT_STATUS_V(nt_errno_map
[i
].status
) ==
248 NT_STATUS_V(status
)) return nt_errno_map
[i
].error
;
251 /* for all other cases - a default code */
255 /* Return a UNIX errno appropriate for the error received in the last
258 int cli_errno(struct cli_state
*cli
)
262 if (cli_is_dos_error(cli
)) {
266 cli_dos_error(cli
, &eclass
, &ecode
);
267 return cli_errno_from_dos(eclass
, ecode
);
270 status
= cli_nt_error(cli
);
272 return cli_errno_from_nt(status
);
275 /* Return true if the last packet was in error */
277 BOOL
cli_is_error(struct cli_state
*cli
)
279 uint32 flgs2
= SVAL(cli
->inbuf
,smb_flg2
), rcls
= 0;
281 if (flgs2
& FLAGS2_32_BIT_ERROR_CODES
) {
282 /* Return error is error bits are set */
283 rcls
= IVAL(cli
->inbuf
, smb_rcls
);
284 return (rcls
& 0xF0000000) == 0xC0000000;
287 /* Return error if error class in non-zero */
289 rcls
= CVAL(cli
->inbuf
, smb_rcls
);
293 /* Return true if the last error was an NT error */
295 BOOL
cli_is_nt_error(struct cli_state
*cli
)
297 uint32 flgs2
= SVAL(cli
->inbuf
,smb_flg2
);
299 return cli_is_error(cli
) && (flgs2
& FLAGS2_32_BIT_ERROR_CODES
);
302 /* Return true if the last error was a DOS error */
304 BOOL
cli_is_dos_error(struct cli_state
*cli
)
306 uint32 flgs2
= SVAL(cli
->inbuf
,smb_flg2
);
308 return cli_is_error(cli
) && !(flgs2
& FLAGS2_32_BIT_ERROR_CODES
);