15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved.
25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be
35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file.
45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef NET_BASE_NET_ERRORS_H__
65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define NET_BASE_NET_ERRORS_H__
75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
86e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles)#include <string>
95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <vector>
105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/basictypes.h"
125d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)#include "base/files/file.h"
135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "net/base/net_export.h"
145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace net {
165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Error domain of the net module's error codes.
185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)NET_EXPORT extern const char kErrorDomain[];
195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Error values are negative.
215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)enum Error {
225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  // No error.
235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  OK = 0,
245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define NET_ERROR(label, value) ERR_ ## label = value,
265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "net/base/net_error_list.h"
275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#undef NET_ERROR
285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  // The value of the first certificate error code.
305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  ERR_CERT_BEGIN = ERR_CERT_COMMON_NAME_INVALID,
315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)};
325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns a textual representation of the error code for logging purposes.
346e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles)NET_EXPORT std::string ErrorToString(int error);
356e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles)
366e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles)// Same as above, but leaves off the leading "net::".
376e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles)NET_EXPORT std::string ErrorToShortString(int error);
385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns true if |error| is a certificate error code.
406e8cce623b6e4fe0c9e4af605d675dd9d0338c38Torne (Richard Coles)NET_EXPORT bool IsCertificateError(int error);
415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Map system error code to Error.
435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)NET_EXPORT Error MapSystemError(int os_error);
445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns a list of all the possible net error codes (not counting OK). This
465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// is intended for use with UMA histograms that are reporting the result of
475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// an action that is represented as a net error code.
485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)//
495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Note that the error codes are all positive (since histograms expect positive
505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// sample values). Also note that a guard bucket is created after any valid
515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// error code that is not followed immediately by a valid error code.
522a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)NET_EXPORT std::vector<int> GetAllErrorCodesForUma();
535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
545d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// A convenient function to translate file error to net error code.
555d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)NET_EXPORT Error FileErrorToNetError(base::File::Error file_error);
565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}  // namespace net
585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif  // NET_BASE_NET_ERRORS_H__
60