1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.6"/>
<title>GRPC Core: include/grpc/status.h Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
$(document).ready(function() { searchBox.OnSelectItem(0); });
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">GRPC Core
 <span id="projectnumber">0.11.0.0</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.6 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
<li>
<div id="MSearchBox" class="MSearchBoxInactive">
<span class="left">
<img id="MSearchSelect" src="search/mag_sel.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
</span><span class="right">
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</span>
</div>
</li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>Globals</span></a></li>
</ul>
</div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Macros</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(9)"><span class="SelectionMark"> </span>Pages</a></div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_d44c64559bbebec7f509842c48db8b23.html">include</a></li><li class="navelem"><a class="el" href="dir_9d7a14d6d9adcbe4c35dbdb88d867e2e.html">grpc</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">status.h</div> </div>
</div><!--header-->
<div class="contents">
<a href="status_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">/*</span></div>
<div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="comment"> * Copyright 2015, Google Inc.</span></div>
<div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment"> * All rights reserved.</span></div>
<div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span class="comment"> * Redistribution and use in source and binary forms, with or without</span></div>
<div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment"> * modification, are permitted provided that the following conditions are</span></div>
<div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment"> * met:</span></div>
<div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment"> * * Redistributions of source code must retain the above copyright</span></div>
<div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment"> * notice, this list of conditions and the following disclaimer.</span></div>
<div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment"> * * Redistributions in binary form must reproduce the above</span></div>
<div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment"> * copyright notice, this list of conditions and the following disclaimer</span></div>
<div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment"> * in the documentation and/or other materials provided with the</span></div>
<div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment"> * distribution.</span></div>
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="comment"> * * Neither the name of Google Inc. nor the names of its</span></div>
<div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="comment"> * contributors may be used to endorse or promote products derived from</span></div>
<div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="comment"> * this software without specific prior written permission.</span></div>
<div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="comment"> * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS</span></div>
<div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="comment"> * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT</span></div>
<div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="comment"> * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR</span></div>
<div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="comment"> * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT</span></div>
<div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="comment"> * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,</span></div>
<div class="line"><a name="l00025"></a><span class="lineno"> 25</span> <span class="comment"> * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT</span></div>
<div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="comment"> * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,</span></div>
<div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="comment"> * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY</span></div>
<div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="comment"> * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT</span></div>
<div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="comment"> * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE</span></div>
<div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="comment"> * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</span></div>
<div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="comment"> *</span></div>
<div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="comment"> */</span></div>
<div class="line"><a name="l00033"></a><span class="lineno"> 33</span> </div>
<div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="preprocessor">#ifndef GRPC_STATUS_H</span></div>
<div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="preprocessor"></span><span class="preprocessor">#define GRPC_STATUS_H</span></div>
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="preprocessor"></span></div>
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="preprocessor">#ifdef __cplusplus</span></div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="preprocessor"></span><span class="keyword">extern</span> <span class="stringliteral">"C"</span> {</div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="preprocessor">#endif</span></div>
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="preprocessor"></span></div>
<div class="line"><a name="l00041"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108eb"> 41</a></span> <span class="keyword">typedef</span> <span class="keyword">enum</span> {</div>
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span>  <span class="comment">/* Not an error; returned on success */</span></div>
<div class="line"><a name="l00043"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba9da5601150b267ab5509d151fa7df201"> 43</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba9da5601150b267ab5509d151fa7df201">GRPC_STATUS_OK</a> = 0,</div>
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span> </div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span>  <span class="comment">/* The operation was cancelled (typically by the caller). */</span></div>
<div class="line"><a name="l00046"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba30e6e0c37df1389dd4c460a53f831038"> 46</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba30e6e0c37df1389dd4c460a53f831038">GRPC_STATUS_CANCELLED</a> = 1,</div>
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span> </div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span>  <span class="comment">/* Unknown error. An example of where this error may be returned is</span></div>
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment"> if a Status value received from another address space belongs to</span></div>
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment"> an error-space that is not known in this address space. Also</span></div>
<div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="comment"> errors raised by APIs that do not return enough error information</span></div>
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment"> may be converted to this error. */</span></div>
<div class="line"><a name="l00053"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba5f02c0e431162618ab422d27fd39dd08"> 53</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba5f02c0e431162618ab422d27fd39dd08">GRPC_STATUS_UNKNOWN</a> = 2,</div>
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span> </div>
<div class="line"><a name="l00055"></a><span class="lineno"> 55</span>  <span class="comment">/* Client specified an invalid argument. Note that this differs</span></div>
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span> <span class="comment"> from FAILED_PRECONDITION. INVALID_ARGUMENT indicates arguments</span></div>
<div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="comment"> that are problematic regardless of the state of the system</span></div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span> <span class="comment"> (e.g., a malformed file name). */</span></div>
<div class="line"><a name="l00059"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba3dd64296110db7e7fafb1062b5587731"> 59</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba3dd64296110db7e7fafb1062b5587731">GRPC_STATUS_INVALID_ARGUMENT</a> = 3,</div>
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span> </div>
<div class="line"><a name="l00061"></a><span class="lineno"> 61</span>  <span class="comment">/* Deadline expired before operation could complete. For operations</span></div>
<div class="line"><a name="l00062"></a><span class="lineno"> 62</span> <span class="comment"> that change the state of the system, this error may be returned</span></div>
<div class="line"><a name="l00063"></a><span class="lineno"> 63</span> <span class="comment"> even if the operation has completed successfully. For example, a</span></div>
<div class="line"><a name="l00064"></a><span class="lineno"> 64</span> <span class="comment"> successful response from a server could have been delayed long</span></div>
<div class="line"><a name="l00065"></a><span class="lineno"> 65</span> <span class="comment"> enough for the deadline to expire. */</span></div>
<div class="line"><a name="l00066"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba5451711361db6b8d8e80be30cbb1a208"> 66</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba5451711361db6b8d8e80be30cbb1a208">GRPC_STATUS_DEADLINE_EXCEEDED</a> = 4,</div>
<div class="line"><a name="l00067"></a><span class="lineno"> 67</span> </div>
<div class="line"><a name="l00068"></a><span class="lineno"> 68</span>  <span class="comment">/* Some requested entity (e.g., file or directory) was not found. */</span></div>
<div class="line"><a name="l00069"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108ebafdf14cb6f2da868d76b209ac490c14e2"> 69</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108ebafdf14cb6f2da868d76b209ac490c14e2">GRPC_STATUS_NOT_FOUND</a> = 5,</div>
<div class="line"><a name="l00070"></a><span class="lineno"> 70</span> </div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span>  <span class="comment">/* Some entity that we attempted to create (e.g., file or directory)</span></div>
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span> <span class="comment"> already exists. */</span></div>
<div class="line"><a name="l00073"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108ebad357565db8655b6635fae96a11c4009b"> 73</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108ebad357565db8655b6635fae96a11c4009b">GRPC_STATUS_ALREADY_EXISTS</a> = 6,</div>
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span> </div>
<div class="line"><a name="l00075"></a><span class="lineno"> 75</span>  <span class="comment">/* The caller does not have permission to execute the specified</span></div>
<div class="line"><a name="l00076"></a><span class="lineno"> 76</span> <span class="comment"> operation. PERMISSION_DENIED must not be used for rejections</span></div>
<div class="line"><a name="l00077"></a><span class="lineno"> 77</span> <span class="comment"> caused by exhausting some resource (use RESOURCE_EXHAUSTED</span></div>
<div class="line"><a name="l00078"></a><span class="lineno"> 78</span> <span class="comment"> instead for those errors). PERMISSION_DENIED must not be</span></div>
<div class="line"><a name="l00079"></a><span class="lineno"> 79</span> <span class="comment"> used if the caller can not be identified (use UNAUTHENTICATED</span></div>
<div class="line"><a name="l00080"></a><span class="lineno"> 80</span> <span class="comment"> instead for those errors). */</span></div>
<div class="line"><a name="l00081"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba4149925007957bf1a04184d88e8293f4"> 81</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba4149925007957bf1a04184d88e8293f4">GRPC_STATUS_PERMISSION_DENIED</a> = 7,</div>
<div class="line"><a name="l00082"></a><span class="lineno"> 82</span> </div>
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span>  <span class="comment">/* The request does not have valid authentication credentials for the</span></div>
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span> <span class="comment"> operation. */</span></div>
<div class="line"><a name="l00085"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba1a6fd47361ad9298879dd8760ca1a0cb"> 85</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba1a6fd47361ad9298879dd8760ca1a0cb">GRPC_STATUS_UNAUTHENTICATED</a> = 16,</div>
<div class="line"><a name="l00086"></a><span class="lineno"> 86</span> </div>
<div class="line"><a name="l00087"></a><span class="lineno"> 87</span>  <span class="comment">/* Some resource has been exhausted, perhaps a per-user quota, or</span></div>
<div class="line"><a name="l00088"></a><span class="lineno"> 88</span> <span class="comment"> perhaps the entire file system is out of space. */</span></div>
<div class="line"><a name="l00089"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108ebab1a76cb91e6992f6f7a31a7fe862e0e9"> 89</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108ebab1a76cb91e6992f6f7a31a7fe862e0e9">GRPC_STATUS_RESOURCE_EXHAUSTED</a> = 8,</div>
<div class="line"><a name="l00090"></a><span class="lineno"> 90</span> </div>
<div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  <span class="comment">/* Operation was rejected because the system is not in a state</span></div>
<div class="line"><a name="l00092"></a><span class="lineno"> 92</span> <span class="comment"> required for the operation's execution. For example, directory</span></div>
<div class="line"><a name="l00093"></a><span class="lineno"> 93</span> <span class="comment"> to be deleted may be non-empty, an rmdir operation is applied to</span></div>
<div class="line"><a name="l00094"></a><span class="lineno"> 94</span> <span class="comment"> a non-directory, etc.</span></div>
<div class="line"><a name="l00095"></a><span class="lineno"> 95</span> <span class="comment"></span></div>
<div class="line"><a name="l00096"></a><span class="lineno"> 96</span> <span class="comment"> A litmus test that may help a service implementor in deciding</span></div>
<div class="line"><a name="l00097"></a><span class="lineno"> 97</span> <span class="comment"> between FAILED_PRECONDITION, ABORTED, and UNAVAILABLE:</span></div>
<div class="line"><a name="l00098"></a><span class="lineno"> 98</span> <span class="comment"> (a) Use UNAVAILABLE if the client can retry just the failing call.</span></div>
<div class="line"><a name="l00099"></a><span class="lineno"> 99</span> <span class="comment"> (b) Use ABORTED if the client should retry at a higher-level</span></div>
<div class="line"><a name="l00100"></a><span class="lineno"> 100</span> <span class="comment"> (e.g., restarting a read-modify-write sequence).</span></div>
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span> <span class="comment"> (c) Use FAILED_PRECONDITION if the client should not retry until</span></div>
<div class="line"><a name="l00102"></a><span class="lineno"> 102</span> <span class="comment"> the system state has been explicitly fixed. E.g., if an "rmdir"</span></div>
<div class="line"><a name="l00103"></a><span class="lineno"> 103</span> <span class="comment"> fails because the directory is non-empty, FAILED_PRECONDITION</span></div>
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span> <span class="comment"> should be returned since the client should not retry unless</span></div>
<div class="line"><a name="l00105"></a><span class="lineno"> 105</span> <span class="comment"> they have first fixed up the directory by deleting files from it.</span></div>
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span> <span class="comment"> (d) Use FAILED_PRECONDITION if the client performs conditional</span></div>
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span> <span class="comment"> REST Get/Update/Delete on a resource and the resource on the</span></div>
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span> <span class="comment"> server does not match the condition. E.g., conflicting</span></div>
<div class="line"><a name="l00109"></a><span class="lineno"> 109</span> <span class="comment"> read-modify-write on the same resource. */</span></div>
<div class="line"><a name="l00110"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba503abd183544b43a83bc01d999adda5f"> 110</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba503abd183544b43a83bc01d999adda5f">GRPC_STATUS_FAILED_PRECONDITION</a> = 9,</div>
<div class="line"><a name="l00111"></a><span class="lineno"> 111</span> </div>
<div class="line"><a name="l00112"></a><span class="lineno"> 112</span>  <span class="comment">/* The operation was aborted, typically due to a concurrency issue</span></div>
<div class="line"><a name="l00113"></a><span class="lineno"> 113</span> <span class="comment"> like sequencer check failures, transaction aborts, etc.</span></div>
<div class="line"><a name="l00114"></a><span class="lineno"> 114</span> <span class="comment"></span></div>
<div class="line"><a name="l00115"></a><span class="lineno"> 115</span> <span class="comment"> See litmus test above for deciding between FAILED_PRECONDITION,</span></div>
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span> <span class="comment"> ABORTED, and UNAVAILABLE. */</span></div>
<div class="line"><a name="l00117"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba3570bc43d5eb08c95a7f4c24c13010d9"> 117</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba3570bc43d5eb08c95a7f4c24c13010d9">GRPC_STATUS_ABORTED</a> = 10,</div>
<div class="line"><a name="l00118"></a><span class="lineno"> 118</span> </div>
<div class="line"><a name="l00119"></a><span class="lineno"> 119</span>  <span class="comment">/* Operation was attempted past the valid range. E.g., seeking or</span></div>
<div class="line"><a name="l00120"></a><span class="lineno"> 120</span> <span class="comment"> reading past end of file.</span></div>
<div class="line"><a name="l00121"></a><span class="lineno"> 121</span> <span class="comment"></span></div>
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span> <span class="comment"> Unlike INVALID_ARGUMENT, this error indicates a problem that may</span></div>
<div class="line"><a name="l00123"></a><span class="lineno"> 123</span> <span class="comment"> be fixed if the system state changes. For example, a 32-bit file</span></div>
<div class="line"><a name="l00124"></a><span class="lineno"> 124</span> <span class="comment"> system will generate INVALID_ARGUMENT if asked to read at an</span></div>
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span> <span class="comment"> offset that is not in the range [0,2^32-1], but it will generate</span></div>
<div class="line"><a name="l00126"></a><span class="lineno"> 126</span> <span class="comment"> OUT_OF_RANGE if asked to read from an offset past the current</span></div>
<div class="line"><a name="l00127"></a><span class="lineno"> 127</span> <span class="comment"> file size.</span></div>
<div class="line"><a name="l00128"></a><span class="lineno"> 128</span> <span class="comment"></span></div>
<div class="line"><a name="l00129"></a><span class="lineno"> 129</span> <span class="comment"> There is a fair bit of overlap between FAILED_PRECONDITION and</span></div>
<div class="line"><a name="l00130"></a><span class="lineno"> 130</span> <span class="comment"> OUT_OF_RANGE. We recommend using OUT_OF_RANGE (the more specific</span></div>
<div class="line"><a name="l00131"></a><span class="lineno"> 131</span> <span class="comment"> error) when it applies so that callers who are iterating through</span></div>
<div class="line"><a name="l00132"></a><span class="lineno"> 132</span> <span class="comment"> a space can easily look for an OUT_OF_RANGE error to detect when</span></div>
<div class="line"><a name="l00133"></a><span class="lineno"> 133</span> <span class="comment"> they are done. */</span></div>
<div class="line"><a name="l00134"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108ebacd0d05ab2f0af48b0f535c3dd0816d9b"> 134</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108ebacd0d05ab2f0af48b0f535c3dd0816d9b">GRPC_STATUS_OUT_OF_RANGE</a> = 11,</div>
<div class="line"><a name="l00135"></a><span class="lineno"> 135</span> </div>
<div class="line"><a name="l00136"></a><span class="lineno"> 136</span>  <span class="comment">/* Operation is not implemented or not supported/enabled in this service. */</span></div>
<div class="line"><a name="l00137"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba6912537b4dfd1030f50ff2f5448f1bc2"> 137</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba6912537b4dfd1030f50ff2f5448f1bc2">GRPC_STATUS_UNIMPLEMENTED</a> = 12,</div>
<div class="line"><a name="l00138"></a><span class="lineno"> 138</span> </div>
<div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  <span class="comment">/* Internal errors. Means some invariants expected by underlying</span></div>
<div class="line"><a name="l00140"></a><span class="lineno"> 140</span> <span class="comment"> system has been broken. If you see one of these errors,</span></div>
<div class="line"><a name="l00141"></a><span class="lineno"> 141</span> <span class="comment"> something is very broken. */</span></div>
<div class="line"><a name="l00142"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108ebae648dab84c58ef5b1cfeea35867c4520"> 142</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108ebae648dab84c58ef5b1cfeea35867c4520">GRPC_STATUS_INTERNAL</a> = 13,</div>
<div class="line"><a name="l00143"></a><span class="lineno"> 143</span> </div>
<div class="line"><a name="l00144"></a><span class="lineno"> 144</span>  <span class="comment">/* The service is currently unavailable. This is a most likely a</span></div>
<div class="line"><a name="l00145"></a><span class="lineno"> 145</span> <span class="comment"> transient condition and may be corrected by retrying with</span></div>
<div class="line"><a name="l00146"></a><span class="lineno"> 146</span> <span class="comment"> a backoff.</span></div>
<div class="line"><a name="l00147"></a><span class="lineno"> 147</span> <span class="comment"></span></div>
<div class="line"><a name="l00148"></a><span class="lineno"> 148</span> <span class="comment"> See litmus test above for deciding between FAILED_PRECONDITION,</span></div>
<div class="line"><a name="l00149"></a><span class="lineno"> 149</span> <span class="comment"> ABORTED, and UNAVAILABLE. */</span></div>
<div class="line"><a name="l00150"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108ebaad91b67998cb5df7bc6821e362189e79"> 150</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108ebaad91b67998cb5df7bc6821e362189e79">GRPC_STATUS_UNAVAILABLE</a> = 14,</div>
<div class="line"><a name="l00151"></a><span class="lineno"> 151</span> </div>
<div class="line"><a name="l00152"></a><span class="lineno"> 152</span>  <span class="comment">/* Unrecoverable data loss or corruption. */</span></div>
<div class="line"><a name="l00153"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba275db05856f4af884c48e86440414db7"> 153</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108eba275db05856f4af884c48e86440414db7">GRPC_STATUS_DATA_LOSS</a> = 15,</div>
<div class="line"><a name="l00154"></a><span class="lineno"> 154</span> </div>
<div class="line"><a name="l00155"></a><span class="lineno"> 155</span>  <span class="comment">/* Force users to include a default branch: */</span></div>
<div class="line"><a name="l00156"></a><span class="lineno"><a class="line" href="status_8h.html#a35ab2a68917eb836de84cb23253108ebab924d4c4c646bdb3130162b8e359dd96"> 156</a></span>  <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108ebab924d4c4c646bdb3130162b8e359dd96">GRPC_STATUS__DO_NOT_USE</a> = -1</div>
<div class="line"><a name="l00157"></a><span class="lineno"> 157</span> } <a class="code" href="status_8h.html#a35ab2a68917eb836de84cb23253108eb">grpc_status_code</a>;</div>
<div class="line"><a name="l00158"></a><span class="lineno"> 158</span> </div>
<div class="line"><a name="l00159"></a><span class="lineno"> 159</span> <span class="preprocessor">#ifdef __cplusplus</span></div>
<div class="line"><a name="l00160"></a><span class="lineno"> 160</span> <span class="preprocessor"></span>}</div>
<div class="line"><a name="l00161"></a><span class="lineno"> 161</span> <span class="preprocessor">#endif</span></div>
<div class="line"><a name="l00162"></a><span class="lineno"> 162</span> <span class="preprocessor"></span></div>
<div class="line"><a name="l00163"></a><span class="lineno"> 163</span> <span class="preprocessor">#endif </span><span class="comment">/* GRPC_STATUS_H */</span><span class="preprocessor"></span></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108ebad357565db8655b6635fae96a11c4009b"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108ebad357565db8655b6635fae96a11c4009b">GRPC_STATUS_ALREADY_EXISTS</a></div><div class="ttdef"><b>Definition:</b> status.h:73</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108eba4149925007957bf1a04184d88e8293f4"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108eba4149925007957bf1a04184d88e8293f4">GRPC_STATUS_PERMISSION_DENIED</a></div><div class="ttdef"><b>Definition:</b> status.h:81</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108eba30e6e0c37df1389dd4c460a53f831038"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108eba30e6e0c37df1389dd4c460a53f831038">GRPC_STATUS_CANCELLED</a></div><div class="ttdef"><b>Definition:</b> status.h:46</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108ebafdf14cb6f2da868d76b209ac490c14e2"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108ebafdf14cb6f2da868d76b209ac490c14e2">GRPC_STATUS_NOT_FOUND</a></div><div class="ttdef"><b>Definition:</b> status.h:69</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108eba3570bc43d5eb08c95a7f4c24c13010d9"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108eba3570bc43d5eb08c95a7f4c24c13010d9">GRPC_STATUS_ABORTED</a></div><div class="ttdef"><b>Definition:</b> status.h:117</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108eba5f02c0e431162618ab422d27fd39dd08"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108eba5f02c0e431162618ab422d27fd39dd08">GRPC_STATUS_UNKNOWN</a></div><div class="ttdef"><b>Definition:</b> status.h:53</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108eba5451711361db6b8d8e80be30cbb1a208"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108eba5451711361db6b8d8e80be30cbb1a208">GRPC_STATUS_DEADLINE_EXCEEDED</a></div><div class="ttdef"><b>Definition:</b> status.h:66</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108eba275db05856f4af884c48e86440414db7"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108eba275db05856f4af884c48e86440414db7">GRPC_STATUS_DATA_LOSS</a></div><div class="ttdef"><b>Definition:</b> status.h:153</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108eba6912537b4dfd1030f50ff2f5448f1bc2"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108eba6912537b4dfd1030f50ff2f5448f1bc2">GRPC_STATUS_UNIMPLEMENTED</a></div><div class="ttdef"><b>Definition:</b> status.h:137</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108ebab924d4c4c646bdb3130162b8e359dd96"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108ebab924d4c4c646bdb3130162b8e359dd96">GRPC_STATUS__DO_NOT_USE</a></div><div class="ttdef"><b>Definition:</b> status.h:156</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108eba503abd183544b43a83bc01d999adda5f"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108eba503abd183544b43a83bc01d999adda5f">GRPC_STATUS_FAILED_PRECONDITION</a></div><div class="ttdef"><b>Definition:</b> status.h:110</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108eba1a6fd47361ad9298879dd8760ca1a0cb"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108eba1a6fd47361ad9298879dd8760ca1a0cb">GRPC_STATUS_UNAUTHENTICATED</a></div><div class="ttdef"><b>Definition:</b> status.h:85</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108ebacd0d05ab2f0af48b0f535c3dd0816d9b"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108ebacd0d05ab2f0af48b0f535c3dd0816d9b">GRPC_STATUS_OUT_OF_RANGE</a></div><div class="ttdef"><b>Definition:</b> status.h:134</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108ebae648dab84c58ef5b1cfeea35867c4520"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108ebae648dab84c58ef5b1cfeea35867c4520">GRPC_STATUS_INTERNAL</a></div><div class="ttdef"><b>Definition:</b> status.h:142</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108ebaad91b67998cb5df7bc6821e362189e79"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108ebaad91b67998cb5df7bc6821e362189e79">GRPC_STATUS_UNAVAILABLE</a></div><div class="ttdef"><b>Definition:</b> status.h:150</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108ebab1a76cb91e6992f6f7a31a7fe862e0e9"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108ebab1a76cb91e6992f6f7a31a7fe862e0e9">GRPC_STATUS_RESOURCE_EXHAUSTED</a></div><div class="ttdef"><b>Definition:</b> status.h:89</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108eb"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108eb">grpc_status_code</a></div><div class="ttdeci">grpc_status_code</div><div class="ttdef"><b>Definition:</b> status.h:41</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108eba3dd64296110db7e7fafb1062b5587731"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108eba3dd64296110db7e7fafb1062b5587731">GRPC_STATUS_INVALID_ARGUMENT</a></div><div class="ttdef"><b>Definition:</b> status.h:59</div></div>
<div class="ttc" id="status_8h_html_a35ab2a68917eb836de84cb23253108eba9da5601150b267ab5509d151fa7df201"><div class="ttname"><a href="status_8h.html#a35ab2a68917eb836de84cb23253108eba9da5601150b267ab5509d151fa7df201">GRPC_STATUS_OK</a></div><div class="ttdef"><b>Definition:</b> status.h:43</div></div>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Thu Sep 3 2015 09:44:11 for GRPC Core by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.6
</small></address>
</body>
</html>
|
