Add get_friendly_werror_msg().
[sfrench/samba-autobuild/.git] / source3 / libsmb / doserr.c
1 /*
2  *  Unix SMB/CIFS implementation.
3  *  DOS error routines
4  *  Copyright (C) Tim Potter 2002.
5  *
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 3 of the License, or
9  *  (at your option) any later version.
10  *
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.
15  *
16  *  You should have received a copy of the GNU General Public License
17  *  along with this program; if not, see <http://www.gnu.org/licenses/>.
18  */
19
20 /* DOS error codes.  please read doserr.h */
21
22 #include "includes.h"
23
24 typedef const struct {
25         const char *dos_errstr;
26         WERROR werror;
27 } werror_code_struct;
28
29 typedef const struct {
30         WERROR werror;
31         const char *friendly_errstr;
32 } werror_str_struct;
33
34 werror_code_struct dos_errs[] =
35 {
36         { "WERR_OK", WERR_OK },
37         { "WERR_GENERAL_FAILURE", WERR_GENERAL_FAILURE },
38         { "WERR_BADFILE", WERR_BADFILE },
39         { "WERR_ACCESS_DENIED", WERR_ACCESS_DENIED },
40         { "WERR_BADFID", WERR_BADFID },
41         { "WERR_BADFUNC", WERR_BADFUNC },
42         { "WERR_INSUFFICIENT_BUFFER", WERR_INSUFFICIENT_BUFFER },
43         { "WERR_SEM_TIMEOUT", WERR_SEM_TIMEOUT },
44         { "WERR_NO_SUCH_SHARE", WERR_NO_SUCH_SHARE },
45         { "WERR_ALREADY_EXISTS", WERR_ALREADY_EXISTS },
46         { "WERR_INVALID_PARAM", WERR_INVALID_PARAM },
47         { "WERR_NOT_SUPPORTED", WERR_NOT_SUPPORTED },
48         { "WERR_BAD_PASSWORD", WERR_BAD_PASSWORD },
49         { "WERR_NOMEM", WERR_NOMEM },
50         { "WERR_INVALID_NAME", WERR_INVALID_NAME },
51         { "WERR_UNKNOWN_LEVEL", WERR_UNKNOWN_LEVEL },
52         { "WERR_OBJECT_PATH_INVALID", WERR_OBJECT_PATH_INVALID },
53         { "WERR_NO_MORE_ITEMS", WERR_NO_MORE_ITEMS },
54         { "WERR_MORE_DATA", WERR_MORE_DATA },
55         { "WERR_UNKNOWN_PRINTER_DRIVER", WERR_UNKNOWN_PRINTER_DRIVER },
56         { "WERR_INVALID_PRINTER_NAME", WERR_INVALID_PRINTER_NAME },
57         { "WERR_PRINTER_ALREADY_EXISTS", WERR_PRINTER_ALREADY_EXISTS },
58         { "WERR_INVALID_DATATYPE", WERR_INVALID_DATATYPE },
59         { "WERR_INVALID_ENVIRONMENT", WERR_INVALID_ENVIRONMENT },
60         { "WERR_INVALID_FORM_NAME", WERR_INVALID_FORM_NAME },
61         { "WERR_INVALID_FORM_SIZE", WERR_INVALID_FORM_SIZE },
62         { "WERR_BUF_TOO_SMALL", WERR_BUF_TOO_SMALL },
63         { "WERR_JOB_NOT_FOUND", WERR_JOB_NOT_FOUND },
64         { "WERR_DEST_NOT_FOUND", WERR_DEST_NOT_FOUND },
65         { "WERR_NOT_LOCAL_DOMAIN", WERR_NOT_LOCAL_DOMAIN },
66         { "WERR_NO_LOGON_SERVERS", WERR_NO_LOGON_SERVERS },
67         { "WERR_NO_SUCH_LOGON_SESSION", WERR_NO_SUCH_LOGON_SESSION },
68         { "WERR_PRINTER_DRIVER_IN_USE", WERR_PRINTER_DRIVER_IN_USE },
69         { "WERR_STATUS_MORE_ENTRIES  ", WERR_STATUS_MORE_ENTRIES },
70         { "WERR_DFS_NO_SUCH_VOL", WERR_DFS_NO_SUCH_VOL },
71         { "WERR_DFS_NO_SUCH_SHARE", WERR_DFS_NO_SUCH_SHARE },
72         { "WERR_DFS_NO_SUCH_SERVER", WERR_DFS_NO_SUCH_SERVER },
73         { "WERR_DFS_INTERNAL_ERROR", WERR_DFS_INTERNAL_ERROR },
74         { "WERR_DFS_CANT_CREATE_JUNCT", WERR_DFS_CANT_CREATE_JUNCT },
75         { "WERR_MACHINE_LOCKED", WERR_MACHINE_LOCKED },
76         { "WERR_DOMAIN_CONTROLLER_NOT_FOUND", WERR_DOMAIN_CONTROLLER_NOT_FOUND },
77         { "WERR_SETUP_NOT_JOINED", WERR_SETUP_NOT_JOINED },
78         { "WERR_SETUP_ALREADY_JOINED", WERR_SETUP_ALREADY_JOINED },
79         { "WERR_SETUP_DOMAIN_CONTROLLER", WERR_SETUP_DOMAIN_CONTROLLER },
80         { "WERR_DEVICE_NOT_AVAILABLE", WERR_DEVICE_NOT_AVAILABLE },
81         { "WERR_LOGON_FAILURE", WERR_LOGON_FAILURE },
82         { "WERR_NO_SUCH_DOMAIN", WERR_NO_SUCH_DOMAIN },
83         { "WERR_INVALID_SECURITY_DESCRIPTOR", WERR_INVALID_SECURITY_DESCRIPTOR },
84         { "WERR_INVALID_OWNER", WERR_INVALID_OWNER },
85         { "WERR_SERVER_UNAVAILABLE", WERR_SERVER_UNAVAILABLE },
86         { "WERR_IO_PENDING", WERR_IO_PENDING },
87         { "WERR_INVALID_SERVICE_CONTROL", WERR_INVALID_SERVICE_CONTROL },
88         { "WERR_SERVICE_ALREADY_RUNNING", WERR_SERVICE_ALREADY_RUNNING },
89         { "WERR_NET_NAME_NOT_FOUND", WERR_NET_NAME_NOT_FOUND },
90         { "WERR_REG_CORRUPT", WERR_REG_CORRUPT },
91         { "WERR_REG_IO_FAILURE", WERR_REG_IO_FAILURE },
92         { "WERR_REG_FILE_INVALID", WERR_REG_FILE_INVALID },
93         { "WERR_SERVICE_DISABLED", WERR_SERVICE_DISABLED },
94         { "WERR_CAN_NOT_COMPLETE", WERR_CAN_NOT_COMPLETE},
95         { "WERR_INVALID_FLAGS", WERR_INVALID_FLAGS},
96         { NULL, W_ERROR(0) }
97 };
98
99 werror_str_struct dos_err_strs[] = {
100         { WERR_OK, "Success" },
101         { WERR_ACCESS_DENIED, "Access is denied" },
102         { WERR_INVALID_PARAM, "Invalid parameter" },
103         { WERR_NOT_SUPPORTED, "Not supported" },
104         { WERR_BAD_PASSWORD, "A bad password was supplied" },
105         { WERR_NOMEM, "Out of memory" },
106         { WERR_NO_LOGON_SERVERS, "No logon servers found" },
107         { WERR_NO_SUCH_LOGON_SESSION, "No such logon session" },
108         { WERR_DOMAIN_CONTROLLER_NOT_FOUND, "A domain controller could not be found" },
109         { WERR_SETUP_NOT_JOINED, "Join failed" },
110         { WERR_SETUP_ALREADY_JOINED, "Machine is already joined" },
111         { WERR_SETUP_DOMAIN_CONTROLLER, "Machine is a Domain Controller" },
112         { WERR_LOGON_FAILURE, "Invalid logon credentials" },
113 };
114
115 /*****************************************************************************
116  Returns a DOS error message.  not amazingly helpful, but better than a number.
117  *****************************************************************************/
118
119 const char *dos_errstr(WERROR werror)
120 {
121         char *result;
122         int idx = 0;
123
124         while (dos_errs[idx].dos_errstr != NULL) {
125                 if (W_ERROR_V(dos_errs[idx].werror) ==
126                     W_ERROR_V(werror))
127                         return dos_errs[idx].dos_errstr;
128                 idx++;
129         }
130
131         result = talloc_asprintf(talloc_tos(), "DOS code 0x%08x",
132                                  W_ERROR_V(werror));
133         SMB_ASSERT(result != NULL);
134         return result;
135 }
136
137 /*****************************************************************************
138  Get friendly error string for WERRORs
139  *****************************************************************************/
140
141 const char *get_friendly_werror_msg(WERROR werror)
142 {
143         int i = 0;
144
145         for (i = 0; i < ARRAY_SIZE(dos_err_strs); i++) {
146                 if (W_ERROR_V(dos_err_strs[i].werror) ==
147                     W_ERROR_V(werror)) {
148                         return dos_err_strs[i].friendly_errstr;
149                 }
150         }
151
152         return dos_errstr(werror);
153 }
154
155 /* compat function for samba4 */
156 const char *win_errstr(WERROR werror)
157 {
158         return dos_errstr(werror);
159 }