carto
/
grpc


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326
							<!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/census.h File Reference</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
   &#160;<span id="projectnumber">4.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&#160;Page</span></a></li>
      <li><a href="pages.html"><span>Related&#160;Pages</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&#160;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&#160;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">&#160;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&#160;</span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark">&#160;</span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark">&#160;</span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark">&#160;</span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark">&#160;</span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark">&#160;</span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark">&#160;</span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark">&#160;</span>Macros</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(9)"><span class="SelectionMark">&#160;</span>Groups</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(10)"><span class="SelectionMark">&#160;</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_bda73758a0a4d8c0ff603a7983866e1c.html">include</a></li><li class="navelem"><a class="el" href="dir_8ae8e534eeef321a81935092729b7078.html">grpc</a></li>  </ul>
</div>
</div><!-- top -->
<div class="header">
  <div class="summary">
<a href="#nested-classes">Data Structures</a> &#124;
<a href="#define-members">Macros</a> &#124;
<a href="#typedef-members">Typedefs</a> &#124;
<a href="#enum-members">Enumerations</a> &#124;
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<div class="title">census.h File Reference</div>  </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><code>#include &lt;<a class="el" href="grpc_8h_source.html">grpc/grpc.h</a>&gt;</code><br/>
</div>
<p><a href="census_8h_source.html">Go to the source code of this file.</a></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="nested-classes"></a>
Data Structures</h2></td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structcensus__tag.html">census_tag</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft">&#160;</td><td class="mdescRight">A tag is a key:value pair.  <a href="structcensus__tag.html#details">More...</a><br/></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structcensus__context__status.html">census_context_status</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft">&#160;</td><td class="mdescRight">An instance of this structure is kept by every context, and records the basic information associated with the creation of that context.  <a href="structcensus__context__status.html#details">More...</a><br/></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structcensus__context__iterator.html">census_context_iterator</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft">&#160;</td><td class="mdescRight">Structure used for iterating over the tags in a context.  <a href="structcensus__context__iterator.html#details">More...</a><br/></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structcensus__timestamp.html">census_timestamp</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft">&#160;</td><td class="mdescRight">The concept of "operation" is a fundamental concept for Census.  <a href="structcensus__timestamp.html#details">More...</a><br/></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structcensus__rpc__name__info.html">census_rpc_name_info</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft">&#160;</td><td class="mdescRight">Represent functions to map RPC name ID to service/method names.  <a href="structcensus__rpc__name__info.html#details">More...</a><br/></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structcensus__trace__record.html">census_trace_record</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft">&#160;</td><td class="mdescRight">Trace record.  <a href="structcensus__trace__record.html#details">More...</a><br/></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">struct &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structcensus__value.html">census_value</a></td></tr>
<tr class="memdesc:"><td class="mdescLeft">&#160;</td><td class="mdescRight">A single value to be recorded comprises two parts: an ID for the particular resource and the value to be recorded against it.  <a href="structcensus__value.html#details">More...</a><br/></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="define-members"></a>
Macros</h2></td></tr>
<tr class="memitem:ac3fa459cd0c1621953c46b07bac2faa7"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#ac3fa459cd0c1621953c46b07bac2faa7">CENSUS_MAX_TAG_KV_LEN</a>&#160;&#160;&#160;255</td></tr>
<tr class="memdesc:ac3fa459cd0c1621953c46b07bac2faa7"><td class="mdescLeft">&#160;</td><td class="mdescRight">Maximum length of a tag's key or value.  <a href="#ac3fa459cd0c1621953c46b07bac2faa7">More...</a><br/></td></tr>
<tr class="separator:ac3fa459cd0c1621953c46b07bac2faa7"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a487ca94a4b349f1a7d3d28a21b154f4e"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a487ca94a4b349f1a7d3d28a21b154f4e">CENSUS_MAX_PROPAGATED_TAGS</a>&#160;&#160;&#160;255</td></tr>
<tr class="memdesc:a487ca94a4b349f1a7d3d28a21b154f4e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Maximum number of propagatable tags.  <a href="#a487ca94a4b349f1a7d3d28a21b154f4e">More...</a><br/></td></tr>
<tr class="separator:a487ca94a4b349f1a7d3d28a21b154f4e"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ac116a5843bd29f43a949c56ef5ae619a"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#ac116a5843bd29f43a949c56ef5ae619a">CENSUS_TAG_PROPAGATE</a>&#160;&#160;&#160;1 /** Tag should be propagated over RPC */</td></tr>
<tr class="memdesc:ac116a5843bd29f43a949c56ef5ae619a"><td class="mdescLeft">&#160;</td><td class="mdescRight">Tag flags.  <a href="#ac116a5843bd29f43a949c56ef5ae619a">More...</a><br/></td></tr>
<tr class="separator:ac116a5843bd29f43a949c56ef5ae619a"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ab3c3a66a8c2f392d4a14e75dc44e8931"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#ab3c3a66a8c2f392d4a14e75dc44e8931">CENSUS_TAG_STATS</a>&#160;&#160;&#160;2    /** Tag will be used for statistics aggregation */</td></tr>
<tr class="separator:ab3c3a66a8c2f392d4a14e75dc44e8931"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a070dd8c57a1a31ced0c7ead5a5910df7"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a070dd8c57a1a31ced0c7ead5a5910df7">CENSUS_TAG_RESERVED</a>&#160;&#160;&#160;4 /** Reserved for internal use. */</td></tr>
<tr class="separator:a070dd8c57a1a31ced0c7ead5a5910df7"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:afa3a818c132d55bb1f0afb7442d8f848"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#afa3a818c132d55bb1f0afb7442d8f848">CENSUS_TAG_IS_PROPAGATED</a>(flags)&#160;&#160;&#160;(flags &amp; <a class="el" href="census_8h.html#ac116a5843bd29f43a949c56ef5ae619a">CENSUS_TAG_PROPAGATE</a>)</td></tr>
<tr class="memdesc:afa3a818c132d55bb1f0afb7442d8f848"><td class="mdescLeft">&#160;</td><td class="mdescRight">Flag values 4,8,16,32,64,128 are reserved for future/internal use.  <a href="#afa3a818c132d55bb1f0afb7442d8f848">More...</a><br/></td></tr>
<tr class="separator:afa3a818c132d55bb1f0afb7442d8f848"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aaca94b54b685c481236dfb913fef8b4c"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#aaca94b54b685c481236dfb913fef8b4c">CENSUS_TAG_IS_STATS</a>(flags)&#160;&#160;&#160;(flags &amp; <a class="el" href="census_8h.html#ab3c3a66a8c2f392d4a14e75dc44e8931">CENSUS_TAG_STATS</a>)</td></tr>
<tr class="separator:aaca94b54b685c481236dfb913fef8b4c"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:acb35403ed23ba2615457fabaa0b430e7"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#acb35403ed23ba2615457fabaa0b430e7">CENSUS_TRACE_RECORD_START_OP</a>&#160;&#160;&#160;((uint32_t)0)</td></tr>
<tr class="separator:acb35403ed23ba2615457fabaa0b430e7"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a003fb5bda98c95408a21d3a47571a1e9"><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a003fb5bda98c95408a21d3a47571a1e9">CENSUS_TRACE_RECORD_END_OP</a>&#160;&#160;&#160;((uint32_t)1)</td></tr>
<tr class="separator:a003fb5bda98c95408a21d3a47571a1e9"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="typedef-members"></a>
Typedefs</h2></td></tr>
<tr class="memitem:a27fc8788690179599713226f1f054736"><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a></td></tr>
<tr class="memdesc:a27fc8788690179599713226f1f054736"><td class="mdescLeft">&#160;</td><td class="mdescRight">A Census Context is a handle used by Census to represent the current tracing and stats collection information.  <a href="#a27fc8788690179599713226f1f054736">More...</a><br/></td></tr>
<tr class="separator:a27fc8788690179599713226f1f054736"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr class="memitem:abe92e59c22481b0de3742673cbbb1bf8"><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#abe92e59c22481b0de3742673cbbb1bf8">census_features</a> { <br/>
&#160;&#160;<a class="el" href="census_8h.html#abe92e59c22481b0de3742673cbbb1bf8aac1986834f37851b8d899c4a08c8e3ab">CENSUS_FEATURE_NONE</a> = 0, 
<a class="el" href="census_8h.html#abe92e59c22481b0de3742673cbbb1bf8ab0722326e730113d5be97f643c3e6718">CENSUS_FEATURE_TRACING</a> = 1, 
<a class="el" href="census_8h.html#abe92e59c22481b0de3742673cbbb1bf8a84c772b868e53ee3487c7bfc8e8b2f1a">CENSUS_FEATURE_STATS</a> = 2, 
<a class="el" href="census_8h.html#abe92e59c22481b0de3742673cbbb1bf8a4808bff624e2377596b86a6f58ab04b5">CENSUS_FEATURE_CPU</a> = 4, 
<br/>
&#160;&#160;<a class="el" href="census_8h.html#abe92e59c22481b0de3742673cbbb1bf8aba96a94fb7af8cf1144ca14edc0b1f0c">CENSUS_FEATURE_ALL</a>
<br/>
 }</td></tr>
<tr class="memdesc:abe92e59c22481b0de3742673cbbb1bf8"><td class="mdescLeft">&#160;</td><td class="mdescRight">RPC-internal Census API's.  <a href="census_8h.html#abe92e59c22481b0de3742673cbbb1bf8">More...</a><br/></td></tr>
<tr class="separator:abe92e59c22481b0de3742673cbbb1bf8"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ad4ff7b1db813ee5318871121bb4281cc"><td class="memItemLeft" align="right" valign="top">enum &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#ad4ff7b1db813ee5318871121bb4281cc">census_trace_mask_values</a> { <a class="el" href="census_8h.html#ad4ff7b1db813ee5318871121bb4281cca21afa23a531e5d54e70d44ec3c18cfb3">CENSUS_TRACE_MASK_NONE</a> = 0, 
<a class="el" href="census_8h.html#ad4ff7b1db813ee5318871121bb4281ccaadcf28b76de06181051506c96996255a">CENSUS_TRACE_MASK_IS_SAMPLED</a> = 1
 }</td></tr>
<tr class="memdesc:ad4ff7b1db813ee5318871121bb4281cc"><td class="mdescLeft">&#160;</td><td class="mdescRight">Distributed traces can have a number of options.  <a href="census_8h.html#ad4ff7b1db813ee5318871121bb4281cc">More...</a><br/></td></tr>
<tr class="separator:ad4ff7b1db813ee5318871121bb4281cc"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:a850c1ca105245a514e76519d5edaad2c"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a850c1ca105245a514e76519d5edaad2c">census_initialize</a> (int features)</td></tr>
<tr class="memdesc:a850c1ca105245a514e76519d5edaad2c"><td class="mdescLeft">&#160;</td><td class="mdescRight">Shutdown and startup census subsystem.  <a href="#a850c1ca105245a514e76519d5edaad2c">More...</a><br/></td></tr>
<tr class="separator:a850c1ca105245a514e76519d5edaad2c"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ad21073b22ae5c30cad63a29340f54048"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#ad21073b22ae5c30cad63a29340f54048">census_shutdown</a> (void)</td></tr>
<tr class="separator:ad21073b22ae5c30cad63a29340f54048"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ae22d3c8dfe3bfac5e831b0135ff7a536"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#ae22d3c8dfe3bfac5e831b0135ff7a536">census_supported</a> (void)</td></tr>
<tr class="memdesc:ae22d3c8dfe3bfac5e831b0135ff7a536"><td class="mdescLeft">&#160;</td><td class="mdescRight">Return the features supported by the current census implementation (not all features will be available on all platforms).  <a href="#ae22d3c8dfe3bfac5e831b0135ff7a536">More...</a><br/></td></tr>
<tr class="separator:ae22d3c8dfe3bfac5e831b0135ff7a536"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a6964222b3c20833883d7d05ab6b6e67e"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a6964222b3c20833883d7d05ab6b6e67e">census_enabled</a> (void)</td></tr>
<tr class="memdesc:a6964222b3c20833883d7d05ab6b6e67e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Return the census features currently enabled.  <a href="#a6964222b3c20833883d7d05ab6b6e67e">More...</a><br/></td></tr>
<tr class="separator:a6964222b3c20833883d7d05ab6b6e67e"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a63289de665c241f31e9c32666310ec3a"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a63289de665c241f31e9c32666310ec3a">census_context_create</a> (const <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *base, const <a class="el" href="structcensus__tag.html">census_tag</a> *tags, int ntags, <a class="el" href="structcensus__context__status.html">census_context_status</a> const **status)</td></tr>
<tr class="memdesc:a63289de665c241f31e9c32666310ec3a"><td class="mdescLeft">&#160;</td><td class="mdescRight">Create a new context, adding and removing tags from an existing context.  <a href="#a63289de665c241f31e9c32666310ec3a">More...</a><br/></td></tr>
<tr class="separator:a63289de665c241f31e9c32666310ec3a"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a6e29f72138aac3eac75ef13a7bd25560"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a6e29f72138aac3eac75ef13a7bd25560">census_context_destroy</a> (<a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *context)</td></tr>
<tr class="memdesc:a6e29f72138aac3eac75ef13a7bd25560"><td class="mdescLeft">&#160;</td><td class="mdescRight">Destroy a context.  <a href="#a6e29f72138aac3eac75ef13a7bd25560">More...</a><br/></td></tr>
<tr class="separator:a6e29f72138aac3eac75ef13a7bd25560"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a12077dda197a10bf2198203eac1a348a"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> const <br class="typebreak"/>
<a class="el" href="structcensus__context__status.html">census_context_status</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a12077dda197a10bf2198203eac1a348a">census_context_get_status</a> (const <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *context)</td></tr>
<tr class="memdesc:a12077dda197a10bf2198203eac1a348a"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get a pointer to the original status from the context creation.  <a href="#a12077dda197a10bf2198203eac1a348a">More...</a><br/></td></tr>
<tr class="separator:a12077dda197a10bf2198203eac1a348a"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ac19f91fc3442073217752ce4abf5dfc4"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#ac19f91fc3442073217752ce4abf5dfc4">census_context_initialize_iterator</a> (const <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *context, <a class="el" href="structcensus__context__iterator.html">census_context_iterator</a> *iterator)</td></tr>
<tr class="memdesc:ac19f91fc3442073217752ce4abf5dfc4"><td class="mdescLeft">&#160;</td><td class="mdescRight">Initialize a census_tag_iterator.  <a href="#ac19f91fc3442073217752ce4abf5dfc4">More...</a><br/></td></tr>
<tr class="separator:ac19f91fc3442073217752ce4abf5dfc4"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a756d86b68b73a9ad9dacdfdaeb2a865c"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a756d86b68b73a9ad9dacdfdaeb2a865c">census_context_next_tag</a> (<a class="el" href="structcensus__context__iterator.html">census_context_iterator</a> *iterator, <a class="el" href="structcensus__tag.html">census_tag</a> *tag)</td></tr>
<tr class="memdesc:a756d86b68b73a9ad9dacdfdaeb2a865c"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get the contents of the "next" tag in the context.  <a href="#a756d86b68b73a9ad9dacdfdaeb2a865c">More...</a><br/></td></tr>
<tr class="separator:a756d86b68b73a9ad9dacdfdaeb2a865c"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a610c654980b00da26ed7b2becca79f94"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a610c654980b00da26ed7b2becca79f94">census_context_get_tag</a> (const <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *context, const char *key, <a class="el" href="structcensus__tag.html">census_tag</a> *tag)</td></tr>
<tr class="memdesc:a610c654980b00da26ed7b2becca79f94"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get a context tag by key.  <a href="#a610c654980b00da26ed7b2becca79f94">More...</a><br/></td></tr>
<tr class="separator:a610c654980b00da26ed7b2becca79f94"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a054424f7ca74d513c4dba55dd20d92f2"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> size_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a054424f7ca74d513c4dba55dd20d92f2">census_context_encode</a> (const <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *context, char *buffer, size_t buf_size)</td></tr>
<tr class="memdesc:a054424f7ca74d513c4dba55dd20d92f2"><td class="mdescLeft">&#160;</td><td class="mdescRight">Tag set encode/decode functionality.  <a href="#a054424f7ca74d513c4dba55dd20d92f2">More...</a><br/></td></tr>
<tr class="separator:a054424f7ca74d513c4dba55dd20d92f2"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aaccea127635aaf9200e776eff7c7ba5d"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#aaccea127635aaf9200e776eff7c7ba5d">census_context_decode</a> (const char *buffer, size_t size)</td></tr>
<tr class="memdesc:aaccea127635aaf9200e776eff7c7ba5d"><td class="mdescLeft">&#160;</td><td class="mdescRight">Decode context buffer encoded with <a class="el" href="census_8h.html#a054424f7ca74d513c4dba55dd20d92f2" title="Tag set encode/decode functionality. ">census_context_encode()</a>.  <a href="#aaccea127635aaf9200e776eff7c7ba5d">More...</a><br/></td></tr>
<tr class="separator:aaccea127635aaf9200e776eff7c7ba5d"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a2a2dfc973cd259d93b0901c8b32e8f34"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a2a2dfc973cd259d93b0901c8b32e8f34">census_trace_mask</a> (const <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *context)</td></tr>
<tr class="memdesc:a2a2dfc973cd259d93b0901c8b32e8f34"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get the current trace mask associated with this context.  <a href="#a2a2dfc973cd259d93b0901c8b32e8f34">More...</a><br/></td></tr>
<tr class="separator:a2a2dfc973cd259d93b0901c8b32e8f34"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a2088bf00a48a7a9b0a6e659fa5161ef9"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a2088bf00a48a7a9b0a6e659fa5161ef9">census_set_trace_mask</a> (int trace_mask)</td></tr>
<tr class="memdesc:a2088bf00a48a7a9b0a6e659fa5161ef9"><td class="mdescLeft">&#160;</td><td class="mdescRight">Set the trace mask associated with a context.  <a href="#a2088bf00a48a7a9b0a6e659fa5161ef9">More...</a><br/></td></tr>
<tr class="separator:a2088bf00a48a7a9b0a6e659fa5161ef9"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a57255eb87c6ade8ee6eb8856d3ecfc11"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> <a class="el" href="structcensus__timestamp.html">census_timestamp</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a57255eb87c6ade8ee6eb8856d3ecfc11">census_start_rpc_op_timestamp</a> (void)</td></tr>
<tr class="memdesc:a57255eb87c6ade8ee6eb8856d3ecfc11"><td class="mdescLeft">&#160;</td><td class="mdescRight">Mark the beginning of an RPC operation.  <a href="#a57255eb87c6ade8ee6eb8856d3ecfc11">More...</a><br/></td></tr>
<tr class="separator:a57255eb87c6ade8ee6eb8856d3ecfc11"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:abd6d5aa344819ec9d73c79b9fe6778dc"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#abd6d5aa344819ec9d73c79b9fe6778dc">census_start_client_rpc_op</a> (const <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *context, int64_t rpc_name_id, const <a class="el" href="structcensus__rpc__name__info.html">census_rpc_name_info</a> *rpc_name_info, const char *peer, int trace_mask, const <a class="el" href="structcensus__timestamp.html">census_timestamp</a> *start_time)</td></tr>
<tr class="memdesc:abd6d5aa344819ec9d73c79b9fe6778dc"><td class="mdescLeft">&#160;</td><td class="mdescRight">Start a client rpc operation.  <a href="#abd6d5aa344819ec9d73c79b9fe6778dc">More...</a><br/></td></tr>
<tr class="separator:abd6d5aa344819ec9d73c79b9fe6778dc"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ab20a8e42995181004f5fbc9a87e339d3"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#ab20a8e42995181004f5fbc9a87e339d3">census_set_rpc_client_peer</a> (<a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *context, const char *peer)</td></tr>
<tr class="memdesc:ab20a8e42995181004f5fbc9a87e339d3"><td class="mdescLeft">&#160;</td><td class="mdescRight">Add peer information to a context representing a client RPC operation.  <a href="#ab20a8e42995181004f5fbc9a87e339d3">More...</a><br/></td></tr>
<tr class="separator:ab20a8e42995181004f5fbc9a87e339d3"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a18e3c1cddf38f66a5e8cbf79d7084369"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a18e3c1cddf38f66a5e8cbf79d7084369">census_start_server_rpc_op</a> (const char *buffer, int64_t rpc_name_id, const <a class="el" href="structcensus__rpc__name__info.html">census_rpc_name_info</a> *rpc_name_info, const char *peer, int trace_mask, <a class="el" href="structcensus__timestamp.html">census_timestamp</a> *start_time)</td></tr>
<tr class="memdesc:a18e3c1cddf38f66a5e8cbf79d7084369"><td class="mdescLeft">&#160;</td><td class="mdescRight">Start a server RPC operation.  <a href="#a18e3c1cddf38f66a5e8cbf79d7084369">More...</a><br/></td></tr>
<tr class="separator:a18e3c1cddf38f66a5e8cbf79d7084369"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ae1536ef86b12a6904cb1de3a47f0ca1b"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#ae1536ef86b12a6904cb1de3a47f0ca1b">census_start_op</a> (<a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *context, const char *family, const char *name, int trace_mask)</td></tr>
<tr class="memdesc:ae1536ef86b12a6904cb1de3a47f0ca1b"><td class="mdescLeft">&#160;</td><td class="mdescRight">Start a new, non-RPC operation.  <a href="#ae1536ef86b12a6904cb1de3a47f0ca1b">More...</a><br/></td></tr>
<tr class="separator:ae1536ef86b12a6904cb1de3a47f0ca1b"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aee31ac081d81e46746025b06071f1f0e"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#aee31ac081d81e46746025b06071f1f0e">census_end_op</a> (<a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *context, int status)</td></tr>
<tr class="memdesc:aee31ac081d81e46746025b06071f1f0e"><td class="mdescLeft">&#160;</td><td class="mdescRight">End an operation started by any of the census_start_*_op*() calls.  <a href="#aee31ac081d81e46746025b06071f1f0e">More...</a><br/></td></tr>
<tr class="separator:aee31ac081d81e46746025b06071f1f0e"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aacf722bf9259354d1ab7a81a6c2fd666"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#aacf722bf9259354d1ab7a81a6c2fd666">census_trace_print</a> (<a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *context, uint32_t type, const char *buffer, size_t n)</td></tr>
<tr class="memdesc:aacf722bf9259354d1ab7a81a6c2fd666"><td class="mdescLeft">&#160;</td><td class="mdescRight">Insert a trace record into the trace stream.  <a href="#aacf722bf9259354d1ab7a81a6c2fd666">More...</a><br/></td></tr>
<tr class="separator:aacf722bf9259354d1ab7a81a6c2fd666"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ad78c02761da0d8a7a70bf4add263f91f"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#ad78c02761da0d8a7a70bf4add263f91f">census_trace_scan_start</a> (int consume)</td></tr>
<tr class="memdesc:ad78c02761da0d8a7a70bf4add263f91f"><td class="mdescLeft">&#160;</td><td class="mdescRight">Start a scan of existing trace records.  <a href="#ad78c02761da0d8a7a70bf4add263f91f">More...</a><br/></td></tr>
<tr class="separator:ad78c02761da0d8a7a70bf4add263f91f"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aeb5d22e80a87eabe9880f08c56e95bf1"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#aeb5d22e80a87eabe9880f08c56e95bf1">census_get_trace_record</a> (<a class="el" href="structcensus__trace__record.html">census_trace_record</a> *trace_record)</td></tr>
<tr class="memdesc:aeb5d22e80a87eabe9880f08c56e95bf1"><td class="mdescLeft">&#160;</td><td class="mdescRight">Get a trace record.  <a href="#aeb5d22e80a87eabe9880f08c56e95bf1">More...</a><br/></td></tr>
<tr class="separator:aeb5d22e80a87eabe9880f08c56e95bf1"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a22eb7df4c9b232d8962592d738007ecb"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a22eb7df4c9b232d8962592d738007ecb">census_trace_scan_end</a> ()</td></tr>
<tr class="memdesc:a22eb7df4c9b232d8962592d738007ecb"><td class="mdescLeft">&#160;</td><td class="mdescRight">End a scan previously started by <a class="el" href="census_8h.html#ad78c02761da0d8a7a70bf4add263f91f" title="Start a scan of existing trace records. ">census_trace_scan_start()</a>  <a href="#a22eb7df4c9b232d8962592d738007ecb">More...</a><br/></td></tr>
<tr class="separator:a22eb7df4c9b232d8962592d738007ecb"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a689ea02b5b0907f69ecb0baee371aa55"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a689ea02b5b0907f69ecb0baee371aa55">census_define_resource</a> (const uint8_t *resource_pb, size_t resource_pb_size)</td></tr>
<tr class="memdesc:a689ea02b5b0907f69ecb0baee371aa55"><td class="mdescLeft">&#160;</td><td class="mdescRight">Core stats collection API's.  <a href="#a689ea02b5b0907f69ecb0baee371aa55">More...</a><br/></td></tr>
<tr class="separator:a689ea02b5b0907f69ecb0baee371aa55"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ac68fd1dbb1767d8e080ec22f4767be89"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#ac68fd1dbb1767d8e080ec22f4767be89">census_delete_resource</a> (int32_t resource_id)</td></tr>
<tr class="memdesc:ac68fd1dbb1767d8e080ec22f4767be89"><td class="mdescLeft">&#160;</td><td class="mdescRight">Delete a resource created by <a class="el" href="census_8h.html#a689ea02b5b0907f69ecb0baee371aa55" title="Core stats collection API&#39;s. ">census_define_resource()</a>.  <a href="#ac68fd1dbb1767d8e080ec22f4767be89">More...</a><br/></td></tr>
<tr class="separator:ac68fd1dbb1767d8e080ec22f4767be89"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aeb7f7e4f427236d00446d2eb836c5252"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#aeb7f7e4f427236d00446d2eb836c5252">census_resource_id</a> (const char *name)</td></tr>
<tr class="memdesc:aeb7f7e4f427236d00446d2eb836c5252"><td class="mdescLeft">&#160;</td><td class="mdescRight">Determine the id of a resource, given its name.  <a href="#aeb7f7e4f427236d00446d2eb836c5252">More...</a><br/></td></tr>
<tr class="separator:aeb7f7e4f427236d00446d2eb836c5252"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a26acfcba7f6b3f2b86d0a7fdc45e32ba"><td class="memItemLeft" align="right" valign="top"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="census_8h.html#a26acfcba7f6b3f2b86d0a7fdc45e32ba">census_record_values</a> (<a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *context, <a class="el" href="structcensus__value.html">census_value</a> *values, size_t nvalues)</td></tr>
<tr class="memdesc:a26acfcba7f6b3f2b86d0a7fdc45e32ba"><td class="mdescLeft">&#160;</td><td class="mdescRight">Record new usage values against the given context.  <a href="#a26acfcba7f6b3f2b86d0a7fdc45e32ba">More...</a><br/></td></tr>
<tr class="separator:a26acfcba7f6b3f2b86d0a7fdc45e32ba"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<h2 class="groupheader">Macro Definition Documentation</h2>
<a class="anchor" id="a487ca94a4b349f1a7d3d28a21b154f4e"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define CENSUS_MAX_PROPAGATED_TAGS&#160;&#160;&#160;255</td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Maximum number of propagatable tags. </p>

</div>
</div>
<a class="anchor" id="ac3fa459cd0c1621953c46b07bac2faa7"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define CENSUS_MAX_TAG_KV_LEN&#160;&#160;&#160;255</td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Maximum length of a tag's key or value. </p>

</div>
</div>
<a class="anchor" id="afa3a818c132d55bb1f0afb7442d8f848"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define CENSUS_TAG_IS_PROPAGATED</td>
          <td>(</td>
          <td class="paramtype">&#160;</td>
          <td class="paramname">flags</td><td>)</td>
          <td>&#160;&#160;&#160;(flags &amp; <a class="el" href="census_8h.html#ac116a5843bd29f43a949c56ef5ae619a">CENSUS_TAG_PROPAGATE</a>)</td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Flag values 4,8,16,32,64,128 are reserved for future/internal use. </p>
<p>Clients should not use or rely on their values. </p>

</div>
</div>
<a class="anchor" id="aaca94b54b685c481236dfb913fef8b4c"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define CENSUS_TAG_IS_STATS</td>
          <td>(</td>
          <td class="paramtype">&#160;</td>
          <td class="paramname">flags</td><td>)</td>
          <td>&#160;&#160;&#160;(flags &amp; <a class="el" href="census_8h.html#ab3c3a66a8c2f392d4a14e75dc44e8931">CENSUS_TAG_STATS</a>)</td>
        </tr>
      </table>
</div><div class="memdoc">

</div>
</div>
<a class="anchor" id="ac116a5843bd29f43a949c56ef5ae619a"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define CENSUS_TAG_PROPAGATE&#160;&#160;&#160;1 /** Tag should be propagated over RPC */</td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Tag flags. </p>

</div>
</div>
<a class="anchor" id="a070dd8c57a1a31ced0c7ead5a5910df7"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define CENSUS_TAG_RESERVED&#160;&#160;&#160;4 /** Reserved for internal use. */</td>
        </tr>
      </table>
</div><div class="memdoc">

</div>
</div>
<a class="anchor" id="ab3c3a66a8c2f392d4a14e75dc44e8931"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define CENSUS_TAG_STATS&#160;&#160;&#160;2    /** Tag will be used for statistics aggregation */</td>
        </tr>
      </table>
</div><div class="memdoc">

</div>
</div>
<a class="anchor" id="a003fb5bda98c95408a21d3a47571a1e9"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define CENSUS_TRACE_RECORD_END_OP&#160;&#160;&#160;((uint32_t)1)</td>
        </tr>
      </table>
</div><div class="memdoc">

</div>
</div>
<a class="anchor" id="acb35403ed23ba2615457fabaa0b430e7"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define CENSUS_TRACE_RECORD_START_OP&#160;&#160;&#160;((uint32_t)0)</td>
        </tr>
      </table>
</div><div class="memdoc">

</div>
</div>
<h2 class="groupheader">Typedef Documentation</h2>
<a class="anchor" id="a27fc8788690179599713226f1f054736"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">typedef struct <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>A Census Context is a handle used by Census to represent the current tracing and stats collection information. </p>
<p>Contexts should be propagated across RPC's (this is the responsibility of the local RPC system). A context is typically used as the first argument to most census functions. Conceptually, they should be thought of as specific to a single RPC/thread. The user visible context representation is that of a collection of key:value string pairs, each of which is termed a 'tag'; these form the basis against which Census metrics will be recorded. Keys are unique within a context. </p>

</div>
</div>
<h2 class="groupheader">Enumeration Type Documentation</h2>
<a class="anchor" id="abe92e59c22481b0de3742673cbbb1bf8"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="census_8h.html#abe92e59c22481b0de3742673cbbb1bf8">census_features</a></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>RPC-internal Census API's. </p>
<p>These are designed to be generic enough that they can (ultimately) be used in many different RPC systems (with differing implementations). Identify census features that can be enabled via <a class="el" href="census_8h.html#a850c1ca105245a514e76519d5edaad2c" title="Shutdown and startup census subsystem. ">census_initialize()</a>. </p>
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><em><a class="anchor" id="abe92e59c22481b0de3742673cbbb1bf8aac1986834f37851b8d899c4a08c8e3ab"></a>CENSUS_FEATURE_NONE</em>&#160;</td><td class="fielddoc">
</td></tr>
<tr><td class="fieldname"><em><a class="anchor" id="abe92e59c22481b0de3742673cbbb1bf8ab0722326e730113d5be97f643c3e6718"></a>CENSUS_FEATURE_TRACING</em>&#160;</td><td class="fielddoc">
<p>Do not enable census. </p>
</td></tr>
<tr><td class="fieldname"><em><a class="anchor" id="abe92e59c22481b0de3742673cbbb1bf8a84c772b868e53ee3487c7bfc8e8b2f1a"></a>CENSUS_FEATURE_STATS</em>&#160;</td><td class="fielddoc">
<p>Enable census tracing. </p>
</td></tr>
<tr><td class="fieldname"><em><a class="anchor" id="abe92e59c22481b0de3742673cbbb1bf8a4808bff624e2377596b86a6f58ab04b5"></a>CENSUS_FEATURE_CPU</em>&#160;</td><td class="fielddoc">
<p>Enable Census stats collection. </p>
</td></tr>
<tr><td class="fieldname"><em><a class="anchor" id="abe92e59c22481b0de3742673cbbb1bf8aba96a94fb7af8cf1144ca14edc0b1f0c"></a>CENSUS_FEATURE_ALL</em>&#160;</td><td class="fielddoc">
<p>Enable Census CPU usage collection. </p>
</td></tr>
</table>

</div>
</div>
<a class="anchor" id="ad4ff7b1db813ee5318871121bb4281cc"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">enum <a class="el" href="census_8h.html#ad4ff7b1db813ee5318871121bb4281cc">census_trace_mask_values</a></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Distributed traces can have a number of options. </p>
<table class="fieldtable">
<tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><em><a class="anchor" id="ad4ff7b1db813ee5318871121bb4281cca21afa23a531e5d54e70d44ec3c18cfb3"></a>CENSUS_TRACE_MASK_NONE</em>&#160;</td><td class="fielddoc">
</td></tr>
<tr><td class="fieldname"><em><a class="anchor" id="ad4ff7b1db813ee5318871121bb4281ccaadcf28b76de06181051506c96996255a"></a>CENSUS_TRACE_MASK_IS_SAMPLED</em>&#160;</td><td class="fielddoc">
<p>Default, empty flags. </p>
</td></tr>
</table>

</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a class="anchor" id="a63289de665c241f31e9c32666310ec3a"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a>* census_context_create </td>
          <td>(</td>
          <td class="paramtype">const <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td>
          <td class="paramname"><em>base</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const <a class="el" href="structcensus__tag.html">census_tag</a> *&#160;</td>
          <td class="paramname"><em>tags</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>ntags</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structcensus__context__status.html">census_context_status</a> const **&#160;</td>
          <td class="paramname"><em>status</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Create a new context, adding and removing tags from an existing context. </p>
<p>This will copy all tags from the 'tags' input, so it is recommended to add as many tags in a single operation as is practical for the client. </p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">base</td><td>Base context to build upon. Can be NULL. </td></tr>
    <tr><td class="paramname">tags</td><td>A set of tags to be added/changed/deleted. Tags with keys that are in 'tags', but not 'base', are added to the context. Keys that are in both 'tags' and 'base' will have their value/flags modified. Tags with keys in both, but with NULL values, will be deleted from the context. Tags with invalid (too long or short) keys or values will be ignored. If adding a tag will result in more than CENSUS_MAX_PROPAGATED_TAGS in either binary or non-binary tags, they will be ignored, as will deletions of tags that don't exist. </td></tr>
    <tr><td class="paramname">ntags</td><td>number of tags in 'tags' </td></tr>
    <tr><td class="paramname">status</td><td>If not NULL, will return a pointer to a <a class="el" href="structcensus__context__status.html" title="An instance of this structure is kept by every context, and records the basic information associated ...">census_context_status</a> structure containing information about the new context and status of the tags used in its creation. </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A new, valid census_context. </dd></dl>

</div>
</div>
<a class="anchor" id="aaccea127635aaf9200e776eff7c7ba5d"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a>* census_context_decode </td>
          <td>(</td>
          <td class="paramtype">const char *&#160;</td>
          <td class="paramname"><em>buffer</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">size_t&#160;</td>
          <td class="paramname"><em>size</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Decode context buffer encoded with <a class="el" href="census_8h.html#a054424f7ca74d513c4dba55dd20d92f2" title="Tag set encode/decode functionality. ">census_context_encode()</a>. </p>
<p>Returns NULL if there is an error in parsing either buffer. </p>

</div>
</div>
<a class="anchor" id="a6e29f72138aac3eac75ef13a7bd25560"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void census_context_destroy </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td>
          <td class="paramname"><em>context</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Destroy a context. </p>
<p>Once this function has been called, the context cannot be reused. </p>

</div>
</div>
<a class="anchor" id="a054424f7ca74d513c4dba55dd20d92f2"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> size_t census_context_encode </td>
          <td>(</td>
          <td class="paramtype">const <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td>
          <td class="paramname"><em>context</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">char *&#160;</td>
          <td class="paramname"><em>buffer</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">size_t&#160;</td>
          <td class="paramname"><em>buf_size</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Tag set encode/decode functionality. </p>
<p>These functions are intended for use by RPC systems only, for purposes of transmitting/receiving contexts. Encode a context into a buffer. </p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">context</td><td>context to be encoded </td></tr>
    <tr><td class="paramname">buffer</td><td>buffer into which the context will be encoded. </td></tr>
    <tr><td class="paramname">buf_size</td><td>number of available bytes in buffer. </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The number of buffer bytes consumed for the encoded context, or zero if the buffer was of insufficient size. </dd></dl>

</div>
</div>
<a class="anchor" id="a12077dda197a10bf2198203eac1a348a"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> const <a class="el" href="structcensus__context__status.html">census_context_status</a>* census_context_get_status </td>
          <td>(</td>
          <td class="paramtype">const <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td>
          <td class="paramname"><em>context</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Get a pointer to the original status from the context creation. </p>

</div>
</div>
<a class="anchor" id="a610c654980b00da26ed7b2becca79f94"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int census_context_get_tag </td>
          <td>(</td>
          <td class="paramtype">const <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td>
          <td class="paramname"><em>context</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&#160;</td>
          <td class="paramname"><em>key</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structcensus__tag.html">census_tag</a> *&#160;</td>
          <td class="paramname"><em>tag</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Get a context tag by key. </p>
<p>Returns 0 if the key is not present. </p>

</div>
</div>
<a class="anchor" id="ac19f91fc3442073217752ce4abf5dfc4"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void census_context_initialize_iterator </td>
          <td>(</td>
          <td class="paramtype">const <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td>
          <td class="paramname"><em>context</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structcensus__context__iterator.html">census_context_iterator</a> *&#160;</td>
          <td class="paramname"><em>iterator</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Initialize a census_tag_iterator. </p>
<p>Must be called before first use. </p>

</div>
</div>
<a class="anchor" id="a756d86b68b73a9ad9dacdfdaeb2a865c"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int census_context_next_tag </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structcensus__context__iterator.html">census_context_iterator</a> *&#160;</td>
          <td class="paramname"><em>iterator</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structcensus__tag.html">census_tag</a> *&#160;</td>
          <td class="paramname"><em>tag</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Get the contents of the "next" tag in the context. </p>
<p>If there are no more tags, returns 0 (and 'tag' contents will be unchanged), otherwise returns 1. </p>

</div>
</div>
<a class="anchor" id="a689ea02b5b0907f69ecb0baee371aa55"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int32_t census_define_resource </td>
          <td>(</td>
          <td class="paramtype">const uint8_t *&#160;</td>
          <td class="paramname"><em>resource_pb</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">size_t&#160;</td>
          <td class="paramname"><em>resource_pb_size</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Core stats collection API's. </p>
<p>The following concepts are used: Resource: Users record measurements for a single resource. Examples include RPC latency, CPU seconds consumed, and bytes transmitted. Aggregation: An aggregation of a set of measurements. Census supports the following aggregation types: Distribution - statistical distribution information, used for recording average, standard deviation etc. Can include a histogram. Interval - a count of events that happen in a rolling time window. View: A view is a combination of a Resource, a set of tag keys and an Aggregation. When a measurement for a Resource matches the View tags, it is recorded (for each unique set of tag values) using the Aggregation type. Each resource can have an arbitrary number of views by which it will be broken down.</p>
<p>Census uses protos to define each of the above, and output results. This ensures unification across the different language and runtime implementations. The proto definitions can be found in src/proto/census. Define a new resource. <code>resource_pb</code> should contain an encoded Resource protobuf, <code>resource_pb_size</code> being the size of the buffer. Returns a -ve value on error, or a positive (&gt;= 0) resource id (for use in <a class="el" href="census_8h.html#ac68fd1dbb1767d8e080ec22f4767be89" title="Delete a resource created by census_define_resource(). ">census_delete_resource()</a> and <a class="el" href="census_8h.html#a26acfcba7f6b3f2b86d0a7fdc45e32ba" title="Record new usage values against the given context. ">census_record_values()</a>). In order to be valid, a resource must have a name, and at least one numerator in its unit type. The resource name must be unique, and an error will be returned if it is not. </p>

</div>
</div>
<a class="anchor" id="ac68fd1dbb1767d8e080ec22f4767be89"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void census_delete_resource </td>
          <td>(</td>
          <td class="paramtype">int32_t&#160;</td>
          <td class="paramname"><em>resource_id</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Delete a resource created by <a class="el" href="census_8h.html#a689ea02b5b0907f69ecb0baee371aa55" title="Core stats collection API&#39;s. ">census_define_resource()</a>. </p>

</div>
</div>
<a class="anchor" id="a6964222b3c20833883d7d05ab6b6e67e"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int census_enabled </td>
          <td>(</td>
          <td class="paramtype">void&#160;</td>
          <td class="paramname"></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Return the census features currently enabled. </p>

</div>
</div>
<a class="anchor" id="aee31ac081d81e46746025b06071f1f0e"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void census_end_op </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td>
          <td class="paramname"><em>context</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>status</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>End an operation started by any of the census_start_*_op*() calls. </p>
<p>The context used in this call will no longer be valid once this function completes.</p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">context</td><td>Context associated with operation which is ending. </td></tr>
    <tr><td class="paramname">status</td><td>status associated with the operation. Not interpreted by census. </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="aeb5d22e80a87eabe9880f08c56e95bf1"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int census_get_trace_record </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="structcensus__trace__record.html">census_trace_record</a> *&#160;</td>
          <td class="paramname"><em>trace_record</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Get a trace record. </p>
<p>The data pointed to by the trace buffer is guaranteed stable until the next <a class="el" href="census_8h.html#aeb5d22e80a87eabe9880f08c56e95bf1" title="Get a trace record. ">census_get_trace_record()</a> call (if the consume argument to census_trace_scan_start was non-zero) or <a class="el" href="census_8h.html#a22eb7df4c9b232d8962592d738007ecb" title="End a scan previously started by census_trace_scan_start() ">census_trace_scan_end()</a> is called (otherwise). </p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">trace_record</td><td>structure that will be filled in with oldest trace record. </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>-1 if an error occurred (e.g. no previous call to <a class="el" href="census_8h.html#ad78c02761da0d8a7a70bf4add263f91f" title="Start a scan of existing trace records. ">census_trace_scan_start()</a>), 0 if there is no more trace data (and trace_record will not be modified) or 1 otherwise. </dd></dl>

</div>
</div>
<a class="anchor" id="a850c1ca105245a514e76519d5edaad2c"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int census_initialize </td>
          <td>(</td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>features</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Shutdown and startup census subsystem. </p>
<p>The 'features' argument should be the OR (|) of census_features values. If census fails to initialize, then <a class="el" href="census_8h.html#a850c1ca105245a514e76519d5edaad2c" title="Shutdown and startup census subsystem. ">census_initialize()</a> will return -1, otherwise the set of enabled features (which may be smaller than that provided in the <code>features</code> argument, see <a class="el" href="census_8h.html#ae22d3c8dfe3bfac5e831b0135ff7a536" title="Return the features supported by the current census implementation (not all features will be availabl...">census_supported()</a>) is returned. It is an error to call <a class="el" href="census_8h.html#a850c1ca105245a514e76519d5edaad2c" title="Shutdown and startup census subsystem. ">census_initialize()</a> more than once (without an intervening <a class="el" href="census_8h.html#ad21073b22ae5c30cad63a29340f54048">census_shutdown()</a>). These functions are not thread-safe. </p>

</div>
</div>
<a class="anchor" id="a26acfcba7f6b3f2b86d0a7fdc45e32ba"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void census_record_values </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td>
          <td class="paramname"><em>context</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structcensus__value.html">census_value</a> *&#160;</td>
          <td class="paramname"><em>values</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">size_t&#160;</td>
          <td class="paramname"><em>nvalues</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Record new usage values against the given context. </p>

</div>
</div>
<a class="anchor" id="aeb7f7e4f427236d00446d2eb836c5252"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int32_t census_resource_id </td>
          <td>(</td>
          <td class="paramtype">const char *&#160;</td>
          <td class="paramname"><em>name</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Determine the id of a resource, given its name. </p>
<p>returns -1 if the resource does not exist. </p>

</div>
</div>
<a class="anchor" id="ab20a8e42995181004f5fbc9a87e339d3"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void census_set_rpc_client_peer </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td>
          <td class="paramname"><em>context</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&#160;</td>
          <td class="paramname"><em>peer</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Add peer information to a context representing a client RPC operation. </p>

</div>
</div>
<a class="anchor" id="a2088bf00a48a7a9b0a6e659fa5161ef9"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void census_set_trace_mask </td>
          <td>(</td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>trace_mask</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Set the trace mask associated with a context. </p>

</div>
</div>
<a class="anchor" id="ad21073b22ae5c30cad63a29340f54048"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void census_shutdown </td>
          <td>(</td>
          <td class="paramtype">void&#160;</td>
          <td class="paramname"></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

</div>
</div>
<a class="anchor" id="abd6d5aa344819ec9d73c79b9fe6778dc"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a>* census_start_client_rpc_op </td>
          <td>(</td>
          <td class="paramtype">const <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td>
          <td class="paramname"><em>context</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int64_t&#160;</td>
          <td class="paramname"><em>rpc_name_id</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const <a class="el" href="structcensus__rpc__name__info.html">census_rpc_name_info</a> *&#160;</td>
          <td class="paramname"><em>rpc_name_info</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&#160;</td>
          <td class="paramname"><em>peer</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>trace_mask</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const <a class="el" href="structcensus__timestamp.html">census_timestamp</a> *&#160;</td>
          <td class="paramname"><em>start_time</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Start a client rpc operation. </p>
<p>This function should be called as early in the client RPC path as possible. This function will create a new context. If the context argument is non-null, then the new context will inherit all its properties, with the following changes:</p>
<ul>
<li>create a new operation ID for the new context, marking it as a child of the previous operation.</li>
<li>use the new RPC path and peer information for tracing and stats collection purposes, rather than those from the original context</li>
</ul>
<p>If the context argument is NULL, then a new root context is created. This is particularly important for tracing purposes (the trace spans generated will be unassociated with any other trace spans, except those downstream). The trace_mask will be used for tracing operations associated with the new context.</p>
<p>In some RPC systems (e.g. where load balancing is used), peer information may not be available at the time the operation starts. In this case, use a NULL value for peer, and set it later using the <a class="el" href="census_8h.html#ab20a8e42995181004f5fbc9a87e339d3" title="Add peer information to a context representing a client RPC operation. ">census_set_rpc_client_peer()</a> function.</p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">context</td><td>The parent context. Can be NULL. </td></tr>
    <tr><td class="paramname">rpc_name_id</td><td>The rpc name identifier to be associated with this RPC. </td></tr>
    <tr><td class="paramname">rpc_name_info</td><td>Used to decode rpc_name_id. </td></tr>
    <tr><td class="paramname">peer</td><td>RPC peer. If not available at the time, NULL can be used, and a later <a class="el" href="census_8h.html#ab20a8e42995181004f5fbc9a87e339d3" title="Add peer information to a context representing a client RPC operation. ">census_set_rpc_client_peer()</a> call made. </td></tr>
    <tr><td class="paramname">trace_mask</td><td>An OR of census_trace_mask_values values. Only used in the creation of a new root context (context == NULL). </td></tr>
    <tr><td class="paramname">start_time</td><td>A timestamp returned from <a class="el" href="census_8h.html#a57255eb87c6ade8ee6eb8856d3ecfc11" title="Mark the beginning of an RPC operation. ">census_start_rpc_op_timestamp()</a>. Can be NULL. Used to set the true time the operation begins.</td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A new census context. </dd></dl>

</div>
</div>
<a class="anchor" id="ae1536ef86b12a6904cb1de3a47f0ca1b"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a>* census_start_op </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td>
          <td class="paramname"><em>context</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&#160;</td>
          <td class="paramname"><em>family</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&#160;</td>
          <td class="paramname"><em>name</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>trace_mask</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Start a new, non-RPC operation. </p>
<p>In general, this function works very similarly to census_start_client_rpc_op, with the primary difference being the replacement of host/path information with the more generic family/name tags. If the context argument is non-null, then the new context will inherit all its properties, with the following changes:</p>
<ul>
<li>create a new operation ID for the new context, marking it as a child of the previous operation.</li>
<li>use the family and name information for tracing and stats collection purposes, rather than those from the original context</li>
</ul>
<p>If the context argument is NULL, then a new root context is created. This is particularly important for tracing purposes (the trace spans generated will be unassociated with any other trace spans, except those downstream). The trace_mask will be used for tracing operations associated with the new context.</p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">context</td><td>The base context. Can be NULL. </td></tr>
    <tr><td class="paramname">family</td><td>Family name to associate with the trace </td></tr>
    <tr><td class="paramname">name</td><td>Name within family to associate with traces/stats </td></tr>
    <tr><td class="paramname">trace_mask</td><td>An OR of census_trace_mask_values values. Only used if context is NULL.</td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A new census context. </dd></dl>

</div>
</div>
<a class="anchor" id="a57255eb87c6ade8ee6eb8856d3ecfc11"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> <a class="el" href="structcensus__timestamp.html">census_timestamp</a> census_start_rpc_op_timestamp </td>
          <td>(</td>
          <td class="paramtype">void&#160;</td>
          <td class="paramname"></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Mark the beginning of an RPC operation. </p>
<p>The information required to call the functions to record the start of RPC operations (both client and server) may not be callable at the true start time of the operation, due to information not being available (e.g. the census context data will not be available in a server RPC until at least initial metadata has been processed). To ensure correct CPU accounting and latency recording, RPC systems can call this function to get the timestamp of operation beginning. This can later be used as an argument to census_start_{client,server}_rpc_op(). NB: for correct CPU accounting, the system must guarantee that the same thread is used for all request processing after this function is called.</p>
<dl class="section return"><dt>Returns</dt><dd>A timestamp representing the operation start time. </dd></dl>

</div>
</div>
<a class="anchor" id="a18e3c1cddf38f66a5e8cbf79d7084369"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a>* census_start_server_rpc_op </td>
          <td>(</td>
          <td class="paramtype">const char *&#160;</td>
          <td class="paramname"><em>buffer</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int64_t&#160;</td>
          <td class="paramname"><em>rpc_name_id</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const <a class="el" href="structcensus__rpc__name__info.html">census_rpc_name_info</a> *&#160;</td>
          <td class="paramname"><em>rpc_name_info</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&#160;</td>
          <td class="paramname"><em>peer</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>trace_mask</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="structcensus__timestamp.html">census_timestamp</a> *&#160;</td>
          <td class="paramname"><em>start_time</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Start a server RPC operation. </p>
<p>Returns a new context to be used in future census calls. If buffer is non-NULL, then the buffer contents should represent the client context, as generated by census_context_serialize(). If buffer is NULL, a new root context is created.</p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">buffer</td><td>Buffer containing bytes output from census_context_serialize(). </td></tr>
    <tr><td class="paramname">rpc_name_id</td><td>The rpc name identifier to be associated with this RPC. </td></tr>
    <tr><td class="paramname">rpc_name_info</td><td>Used to decode rpc_name_id. </td></tr>
    <tr><td class="paramname">peer</td><td>RPC peer. </td></tr>
    <tr><td class="paramname">trace_mask</td><td>An OR of census_trace_mask_values values. Only used in the creation of a new root context (buffer == NULL). </td></tr>
    <tr><td class="paramname">start_time</td><td>A timestamp returned from <a class="el" href="census_8h.html#a57255eb87c6ade8ee6eb8856d3ecfc11" title="Mark the beginning of an RPC operation. ">census_start_rpc_op_timestamp()</a>. Can be NULL. Used to set the true time the operation begins.</td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>A new census context. </dd></dl>

</div>
</div>
<a class="anchor" id="ae22d3c8dfe3bfac5e831b0135ff7a536"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int census_supported </td>
          <td>(</td>
          <td class="paramtype">void&#160;</td>
          <td class="paramname"></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Return the features supported by the current census implementation (not all features will be available on all platforms). </p>

</div>
</div>
<a class="anchor" id="a2a2dfc973cd259d93b0901c8b32e8f34"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int census_trace_mask </td>
          <td>(</td>
          <td class="paramtype">const <a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td>
          <td class="paramname"><em>context</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Get the current trace mask associated with this context. </p>
<p>The value returned will be the logical OR of census_trace_mask_values values. </p>

</div>
</div>
<a class="anchor" id="aacf722bf9259354d1ab7a81a6c2fd666"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void census_trace_print </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="census_8h.html#a27fc8788690179599713226f1f054736">census_context</a> *&#160;</td>
          <td class="paramname"><em>context</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">uint32_t&#160;</td>
          <td class="paramname"><em>type</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const char *&#160;</td>
          <td class="paramname"><em>buffer</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">size_t&#160;</td>
          <td class="paramname"><em>n</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Insert a trace record into the trace stream. </p>
<p>The record consists of an arbitrary size buffer, the size of which is provided in 'n'. </p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">context</td><td>Trace context </td></tr>
    <tr><td class="paramname">type</td><td>User-defined type to associate with trace entry. </td></tr>
    <tr><td class="paramname">buffer</td><td>Pointer to buffer to use </td></tr>
    <tr><td class="paramname">n</td><td>Number of bytes in buffer </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a22eb7df4c9b232d8962592d738007ecb"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> void census_trace_scan_end </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>End a scan previously started by <a class="el" href="census_8h.html#ad78c02761da0d8a7a70bf4add263f91f" title="Start a scan of existing trace records. ">census_trace_scan_start()</a> </p>

</div>
</div>
<a class="anchor" id="ad78c02761da0d8a7a70bf4add263f91f"></a>
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="el" href="impl_2codegen_2port__platform_8h.html#a3f6006f19ae6445e4a42f9d16b720ad7">CENSUSAPI</a> int census_trace_scan_start </td>
          <td>(</td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>consume</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div><div class="memdoc">

<p>Start a scan of existing trace records. </p>
<p>While a scan is ongoing, addition of new trace records will be blocked if the underlying trace buffers fill up, so trace processing systems should endeavor to complete reading as soon as possible. </p>
<dl class="params"><dt>Parameters</dt><dd>
  <table class="params">
    <tr><td class="paramname">consume</td><td>if non-zero, indicates that reading records also "consumes" the previously read record - i.e. releases space in the trace log while scanning is ongoing. </td></tr>
  </table>
  </dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>0 on success, non-zero on failure (e.g. if a scan is already ongoing) </dd></dl>

</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Wed Jun 21 2017 14:13:07 for GRPC Core by &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.6
</small></address>
</body>
</html>