xref: /aosp_15_r20/external/perfetto/include/perfetto/public/pb_decoder.h (revision 6dbdd20afdafa5e3ca9b8809fa73465d530080dc)
1*6dbdd20aSAndroid Build Coastguard Worker /*
2*6dbdd20aSAndroid Build Coastguard Worker  * Copyright (C) 2023 The Android Open Source Project
3*6dbdd20aSAndroid Build Coastguard Worker  *
4*6dbdd20aSAndroid Build Coastguard Worker  * Licensed under the Apache License, Version 2.0 (the "License");
5*6dbdd20aSAndroid Build Coastguard Worker  * you may not use this file except in compliance with the License.
6*6dbdd20aSAndroid Build Coastguard Worker  * You may obtain a copy of the License at
7*6dbdd20aSAndroid Build Coastguard Worker  *
8*6dbdd20aSAndroid Build Coastguard Worker  *      http://www.apache.org/licenses/LICENSE-2.0
9*6dbdd20aSAndroid Build Coastguard Worker  *
10*6dbdd20aSAndroid Build Coastguard Worker  * Unless required by applicable law or agreed to in writing, software
11*6dbdd20aSAndroid Build Coastguard Worker  * distributed under the License is distributed on an "AS IS" BASIS,
12*6dbdd20aSAndroid Build Coastguard Worker  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13*6dbdd20aSAndroid Build Coastguard Worker  * See the License for the specific language governing permissions and
14*6dbdd20aSAndroid Build Coastguard Worker  * limitations under the License.
15*6dbdd20aSAndroid Build Coastguard Worker  */
16*6dbdd20aSAndroid Build Coastguard Worker 
17*6dbdd20aSAndroid Build Coastguard Worker #ifndef INCLUDE_PERFETTO_PUBLIC_PB_DECODER_H_
18*6dbdd20aSAndroid Build Coastguard Worker #define INCLUDE_PERFETTO_PUBLIC_PB_DECODER_H_
19*6dbdd20aSAndroid Build Coastguard Worker 
20*6dbdd20aSAndroid Build Coastguard Worker #include "perfetto/public/abi/pb_decoder_abi.h"
21*6dbdd20aSAndroid Build Coastguard Worker #include "perfetto/public/compiler.h"
22*6dbdd20aSAndroid Build Coastguard Worker #include "perfetto/public/pb_utils.h"
23*6dbdd20aSAndroid Build Coastguard Worker 
24*6dbdd20aSAndroid Build Coastguard Worker // Iterator for parsing protobuf messages.
25*6dbdd20aSAndroid Build Coastguard Worker //
26*6dbdd20aSAndroid Build Coastguard Worker // Example usage:
27*6dbdd20aSAndroid Build Coastguard Worker //
28*6dbdd20aSAndroid Build Coastguard Worker // const char* msg_buf = ...
29*6dbdd20aSAndroid Build Coastguard Worker // size_t msg_size = ...
30*6dbdd20aSAndroid Build Coastguard Worker //
31*6dbdd20aSAndroid Build Coastguard Worker // for (struct PerfettoPbDecoderIterator it =
32*6dbdd20aSAndroid Build Coastguard Worker //          PerfettoPbDecoderIterateBegin(msg_buf, msg_size);
33*6dbdd20aSAndroid Build Coastguard Worker //      it.field.status == PERFETTO_PB_DECODER_OK;
34*6dbdd20aSAndroid Build Coastguard Worker //      PerfettoPbDecoderIterateNext(&it)) {
35*6dbdd20aSAndroid Build Coastguard Worker //   // Do something with it.field
36*6dbdd20aSAndroid Build Coastguard Worker // }
37*6dbdd20aSAndroid Build Coastguard Worker struct PerfettoPbDecoderIterator {
38*6dbdd20aSAndroid Build Coastguard Worker   struct PerfettoPbDecoder decoder;
39*6dbdd20aSAndroid Build Coastguard Worker   struct PerfettoPbDecoderField field;
40*6dbdd20aSAndroid Build Coastguard Worker };
41*6dbdd20aSAndroid Build Coastguard Worker 
PerfettoPbDecoderIterateBegin(const void * start,size_t size)42*6dbdd20aSAndroid Build Coastguard Worker static inline struct PerfettoPbDecoderIterator PerfettoPbDecoderIterateBegin(
43*6dbdd20aSAndroid Build Coastguard Worker     const void* start,
44*6dbdd20aSAndroid Build Coastguard Worker     size_t size) {
45*6dbdd20aSAndroid Build Coastguard Worker   struct PerfettoPbDecoderIterator ret;
46*6dbdd20aSAndroid Build Coastguard Worker   ret.decoder.read_ptr = PERFETTO_REINTERPRET_CAST(const uint8_t*, start);
47*6dbdd20aSAndroid Build Coastguard Worker   ret.decoder.end_ptr = PERFETTO_REINTERPRET_CAST(const uint8_t*, start) + size;
48*6dbdd20aSAndroid Build Coastguard Worker   ret.field = PerfettoPbDecoderParseField(&ret.decoder);
49*6dbdd20aSAndroid Build Coastguard Worker   return ret;
50*6dbdd20aSAndroid Build Coastguard Worker }
51*6dbdd20aSAndroid Build Coastguard Worker 
52*6dbdd20aSAndroid Build Coastguard Worker static inline struct PerfettoPbDecoderIterator
PerfettoPbDecoderIterateNestedBegin(struct PerfettoPbDecoderDelimitedField val)53*6dbdd20aSAndroid Build Coastguard Worker PerfettoPbDecoderIterateNestedBegin(
54*6dbdd20aSAndroid Build Coastguard Worker     struct PerfettoPbDecoderDelimitedField val) {
55*6dbdd20aSAndroid Build Coastguard Worker   struct PerfettoPbDecoderIterator ret;
56*6dbdd20aSAndroid Build Coastguard Worker   ret.decoder.read_ptr = val.start;
57*6dbdd20aSAndroid Build Coastguard Worker   ret.decoder.end_ptr = val.start + val.len;
58*6dbdd20aSAndroid Build Coastguard Worker   ret.field = PerfettoPbDecoderParseField(&ret.decoder);
59*6dbdd20aSAndroid Build Coastguard Worker   return ret;
60*6dbdd20aSAndroid Build Coastguard Worker }
61*6dbdd20aSAndroid Build Coastguard Worker 
PerfettoPbDecoderIterateNext(struct PerfettoPbDecoderIterator * iterator)62*6dbdd20aSAndroid Build Coastguard Worker static inline void PerfettoPbDecoderIterateNext(
63*6dbdd20aSAndroid Build Coastguard Worker     struct PerfettoPbDecoderIterator* iterator) {
64*6dbdd20aSAndroid Build Coastguard Worker   iterator->field = PerfettoPbDecoderParseField(&iterator->decoder);
65*6dbdd20aSAndroid Build Coastguard Worker }
66*6dbdd20aSAndroid Build Coastguard Worker 
PerfettoPbDecoderFieldGetUint32(const PerfettoPbDecoderField * field,uint32_t * out)67*6dbdd20aSAndroid Build Coastguard Worker static inline bool PerfettoPbDecoderFieldGetUint32(
68*6dbdd20aSAndroid Build Coastguard Worker     const PerfettoPbDecoderField* field,
69*6dbdd20aSAndroid Build Coastguard Worker     uint32_t* out) {
70*6dbdd20aSAndroid Build Coastguard Worker   switch (field->wire_type) {
71*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_VARINT:
72*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_FIXED64:
73*6dbdd20aSAndroid Build Coastguard Worker       *out = PERFETTO_STATIC_CAST(uint32_t, field->value.integer64);
74*6dbdd20aSAndroid Build Coastguard Worker       return true;
75*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_FIXED32:
76*6dbdd20aSAndroid Build Coastguard Worker       *out = field->value.integer32;
77*6dbdd20aSAndroid Build Coastguard Worker       return true;
78*6dbdd20aSAndroid Build Coastguard Worker   }
79*6dbdd20aSAndroid Build Coastguard Worker   return false;
80*6dbdd20aSAndroid Build Coastguard Worker }
81*6dbdd20aSAndroid Build Coastguard Worker 
PerfettoPbDecoderFieldGetInt32(const PerfettoPbDecoderField * field,int32_t * out)82*6dbdd20aSAndroid Build Coastguard Worker static inline bool PerfettoPbDecoderFieldGetInt32(
83*6dbdd20aSAndroid Build Coastguard Worker     const PerfettoPbDecoderField* field,
84*6dbdd20aSAndroid Build Coastguard Worker     int32_t* out) {
85*6dbdd20aSAndroid Build Coastguard Worker   switch (field->wire_type) {
86*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_VARINT:
87*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_FIXED64:
88*6dbdd20aSAndroid Build Coastguard Worker       *out = PERFETTO_STATIC_CAST(int32_t, field->value.integer64);
89*6dbdd20aSAndroid Build Coastguard Worker       return true;
90*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_FIXED32:
91*6dbdd20aSAndroid Build Coastguard Worker       *out = PERFETTO_STATIC_CAST(int32_t, field->value.integer32);
92*6dbdd20aSAndroid Build Coastguard Worker       return true;
93*6dbdd20aSAndroid Build Coastguard Worker   }
94*6dbdd20aSAndroid Build Coastguard Worker   return false;
95*6dbdd20aSAndroid Build Coastguard Worker }
96*6dbdd20aSAndroid Build Coastguard Worker 
PerfettoPbDecoderFieldGetUint64(const PerfettoPbDecoderField * field,uint64_t * out)97*6dbdd20aSAndroid Build Coastguard Worker static inline bool PerfettoPbDecoderFieldGetUint64(
98*6dbdd20aSAndroid Build Coastguard Worker     const PerfettoPbDecoderField* field,
99*6dbdd20aSAndroid Build Coastguard Worker     uint64_t* out) {
100*6dbdd20aSAndroid Build Coastguard Worker   switch (field->wire_type) {
101*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_VARINT:
102*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_FIXED64:
103*6dbdd20aSAndroid Build Coastguard Worker       *out = field->value.integer64;
104*6dbdd20aSAndroid Build Coastguard Worker       return true;
105*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_FIXED32:
106*6dbdd20aSAndroid Build Coastguard Worker       *out = field->value.integer32;
107*6dbdd20aSAndroid Build Coastguard Worker       return true;
108*6dbdd20aSAndroid Build Coastguard Worker   }
109*6dbdd20aSAndroid Build Coastguard Worker   return false;
110*6dbdd20aSAndroid Build Coastguard Worker }
111*6dbdd20aSAndroid Build Coastguard Worker 
PerfettoPbDecoderFieldGetInt64(const PerfettoPbDecoderField * field,int64_t * out)112*6dbdd20aSAndroid Build Coastguard Worker static inline bool PerfettoPbDecoderFieldGetInt64(
113*6dbdd20aSAndroid Build Coastguard Worker     const PerfettoPbDecoderField* field,
114*6dbdd20aSAndroid Build Coastguard Worker     int64_t* out) {
115*6dbdd20aSAndroid Build Coastguard Worker   switch (field->wire_type) {
116*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_VARINT:
117*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_FIXED64:
118*6dbdd20aSAndroid Build Coastguard Worker       *out = PERFETTO_STATIC_CAST(int64_t, field->value.integer64);
119*6dbdd20aSAndroid Build Coastguard Worker       return true;
120*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_FIXED32:
121*6dbdd20aSAndroid Build Coastguard Worker       *out = PERFETTO_STATIC_CAST(int64_t, field->value.integer32);
122*6dbdd20aSAndroid Build Coastguard Worker       return true;
123*6dbdd20aSAndroid Build Coastguard Worker   }
124*6dbdd20aSAndroid Build Coastguard Worker   return false;
125*6dbdd20aSAndroid Build Coastguard Worker }
126*6dbdd20aSAndroid Build Coastguard Worker 
PerfettoPbDecoderFieldGetBool(const PerfettoPbDecoderField * field,bool * out)127*6dbdd20aSAndroid Build Coastguard Worker static inline bool PerfettoPbDecoderFieldGetBool(
128*6dbdd20aSAndroid Build Coastguard Worker     const PerfettoPbDecoderField* field,
129*6dbdd20aSAndroid Build Coastguard Worker     bool* out) {
130*6dbdd20aSAndroid Build Coastguard Worker   switch (field->wire_type) {
131*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_VARINT:
132*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_FIXED64:
133*6dbdd20aSAndroid Build Coastguard Worker       *out = field->value.integer64 != 0;
134*6dbdd20aSAndroid Build Coastguard Worker       return true;
135*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_FIXED32:
136*6dbdd20aSAndroid Build Coastguard Worker       *out = field->value.integer32 != 0;
137*6dbdd20aSAndroid Build Coastguard Worker       return true;
138*6dbdd20aSAndroid Build Coastguard Worker   }
139*6dbdd20aSAndroid Build Coastguard Worker   return false;
140*6dbdd20aSAndroid Build Coastguard Worker }
141*6dbdd20aSAndroid Build Coastguard Worker 
PerfettoPbDecoderFieldGetFloat(const PerfettoPbDecoderField * field,float * out)142*6dbdd20aSAndroid Build Coastguard Worker static inline bool PerfettoPbDecoderFieldGetFloat(
143*6dbdd20aSAndroid Build Coastguard Worker     const PerfettoPbDecoderField* field,
144*6dbdd20aSAndroid Build Coastguard Worker     float* out) {
145*6dbdd20aSAndroid Build Coastguard Worker   switch (field->wire_type) {
146*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_FIXED64:
147*6dbdd20aSAndroid Build Coastguard Worker       *out = PERFETTO_STATIC_CAST(float, field->value.double_val);
148*6dbdd20aSAndroid Build Coastguard Worker       return true;
149*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_FIXED32:
150*6dbdd20aSAndroid Build Coastguard Worker       *out = field->value.float_val;
151*6dbdd20aSAndroid Build Coastguard Worker       return true;
152*6dbdd20aSAndroid Build Coastguard Worker   }
153*6dbdd20aSAndroid Build Coastguard Worker   return false;
154*6dbdd20aSAndroid Build Coastguard Worker }
155*6dbdd20aSAndroid Build Coastguard Worker 
PerfettoPbDecoderFieldGetDouble(const PerfettoPbDecoderField * field,double * out)156*6dbdd20aSAndroid Build Coastguard Worker static inline bool PerfettoPbDecoderFieldGetDouble(
157*6dbdd20aSAndroid Build Coastguard Worker     const PerfettoPbDecoderField* field,
158*6dbdd20aSAndroid Build Coastguard Worker     double* out) {
159*6dbdd20aSAndroid Build Coastguard Worker   switch (field->wire_type) {
160*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_FIXED64:
161*6dbdd20aSAndroid Build Coastguard Worker       *out = field->value.double_val;
162*6dbdd20aSAndroid Build Coastguard Worker       return true;
163*6dbdd20aSAndroid Build Coastguard Worker     case PERFETTO_PB_WIRE_TYPE_FIXED32:
164*6dbdd20aSAndroid Build Coastguard Worker       *out = PERFETTO_STATIC_CAST(double, field->value.float_val);
165*6dbdd20aSAndroid Build Coastguard Worker       return true;
166*6dbdd20aSAndroid Build Coastguard Worker   }
167*6dbdd20aSAndroid Build Coastguard Worker   return false;
168*6dbdd20aSAndroid Build Coastguard Worker }
169*6dbdd20aSAndroid Build Coastguard Worker 
170*6dbdd20aSAndroid Build Coastguard Worker #endif  // INCLUDE_PERFETTO_PUBLIC_PB_DECODER_H_
171