1// Copyright (c) 2019, Google Inc.
2// All rights reserved.
3//
4// Redistribution and use in source and binary forms, with or without
5// modification, are permitted provided that the following conditions are
6// met:
7//
8// * Redistributions of source code must retain the above copyright
9// notice, this list of conditions and the following disclaimer.
10// * Redistributions in binary form must reproduce the above
11// copyright notice, this list of conditions and the following disclaimer
12// in the documentation and/or other materials provided with the
13// distribution.
14// * Neither the name of Google Inc. nor the names of its
15// contributors may be used to endorse or promote products derived from
16// this software without specific prior written permission.
17//
18// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
21// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
22// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
23// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
24// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
28// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29
30#ifndef COMMON_LINUX_SYMBOL_COLLECTOR_CLIENT_H_
31#define COMMON_LINUX_SYMBOL_COLLECTOR_CLIENT_H_
32
33#include <string>
34
35#include "common/linux/libcurl_wrapper.h"
36#include "common/using_std_string.h"
37
38namespace google_breakpad {
39namespace sym_upload {
40
41struct UploadUrlResponse {
42 string upload_url;
43 string upload_key;
44};
45
46enum SymbolStatus {
47 Found,
48 Missing,
49 Unknown
50};
51
52enum CompleteUploadResult {
53 Ok,
54 DuplicateData,
55 Error
56};
57
58// Helper class to communicate with a sym-upload-v2 service over HTTP/REST,
59// via libcurl.
60class SymbolCollectorClient {
61 public:
62 static bool CreateUploadUrl(
63 LibcurlWrapper* libcurl_wrapper,
64 const string& api_url,
65 const string& api_key,
66 UploadUrlResponse* uploadUrlResponse);
67
68 static CompleteUploadResult CompleteUpload(
69 LibcurlWrapper* libcurl_wrapper,
70 const string& api_url,
71 const string& api_key,
72 const string& upload_key,
73 const string& debug_file,
74 const string& debug_id,
75 const string& type);
76
77 static SymbolStatus CheckSymbolStatus(
78 LibcurlWrapper* libcurl_wrapper,
79 const string& api_url,
80 const string& api_key,
81 const string& debug_file,
82 const string& debug_id);
83};
84
85} // namespace sym_upload
86} // namespace google_breakpad
87
88#endif // COMMON_LINUX_SYMBOL_COLLECTOR_CLIENT_H_
89