Fork me on GitHub
Loading...
Searching...
No Matches
utils.h
Go to the documentation of this file.
1
12#ifndef JANUS_UTILS_H
13#define JANUS_UTILS_H
14
15#include <stdint.h>
16#include <glib.h>
17#include <jansson.h>
18
19#define JANUS_JSON_STRING JSON_STRING
20#define JANUS_JSON_INTEGER JSON_INTEGER
21#define JANUS_JSON_OBJECT JSON_OBJECT
22#define JANUS_JSON_ARRAY JSON_ARRAY
23/* Use JANUS_JSON_BOOL instead of the non-existing JSON_BOOLEAN */
24#define JANUS_JSON_BOOL JSON_TRUE
25#define JANUS_JSON_PARAM_REQUIRED 1
26#define JANUS_JSON_PARAM_POSITIVE 2
27#define JANUS_JSON_PARAM_NONEMPTY 4
28
30 const gchar *name;
31 json_type jtype;
32 unsigned int flags;
33};
34
38gint64 janus_get_monotonic_time(void);
39
43gint64 janus_get_real_time(void);
44
51char *janus_string_replace(char *message, const char *old_string, const char *new_string) G_GNUC_WARN_UNUSED_RESULT;
52
58size_t janus_strlcat(char *dest, const char *src, size_t dest_size);
59
68int janus_strlcat_fast(char *dest, const char *src, size_t dest_size, size_t *offset);
69
73gboolean janus_is_true(const char *value);
74
79gboolean janus_strcmp_const_time(const void *str1, const void *str2);
80
85guint32 janus_random_uint32(void);
86
93guint64 janus_random_uint64_full(void);
94
107guint64 janus_random_uint64(void);
108
113char *janus_random_uuid(void);
114
122guint64 *janus_uint64_dup(guint64 num);
123
128guint64 janus_uint64_hash(guint64 num);
129
135int janus_string_to_uint8(const char *str, uint8_t *num);
136
142int janus_string_to_uint16(const char *str, uint16_t *num);
143
149int janus_string_to_uint32(const char *str, uint32_t *num);
150
154
155typedef gsize janus_flags;
156
159void janus_flags_reset(janus_flags *flags);
160
164void janus_flags_set(janus_flags *flags, gsize flag);
165
169void janus_flags_clear(janus_flags *flags, gsize flag);
170
175gboolean janus_flags_is_set(janus_flags *flags, gsize flag);
177
183int janus_mkdir(const char *dir, mode_t mode);
184
190gchar *janus_make_absolute_path(const gchar *base_dir, const gchar *path);
191
196int janus_get_codec_pt(const char *sdp, const char *codec);
197
202const char *janus_get_codec_from_pt(const char *sdp, int pt);
203
207int janus_pidfile_create(const char *file);
208
211int janus_pidfile_remove(void);
212
216void janus_protected_folder_add(const char *folder);
217
221gboolean janus_is_folder_protected(const char *path);
222
225
231void janus_get_json_type_name(int jtype, unsigned int flags, char *type_name);
232
238gboolean janus_json_is_valid(json_t *val, json_type jtype, unsigned int flags);
239
250#define JANUS_VALIDATE_JSON_OBJECT_FORMAT(missing_format, invalid_format, obj, params, error_code, error_cause, log_error, missing_code, invalid_code) \
251 do { \
252 error_code = 0; \
253 unsigned int i; \
254 for(i = 0; i < sizeof(params) / sizeof(struct janus_json_parameter); i++) { \
255 json_t *val = json_object_get(obj, params[i].name); \
256 if(!val) { \
257 if((params[i].flags & JANUS_JSON_PARAM_REQUIRED) != 0) { \
258 error_code = (missing_code); \
259 if(log_error) \
260 JANUS_LOG(LOG_ERR, missing_format "\n", params[i].name); \
261 if(error_cause != NULL) \
262 g_snprintf(error_cause, sizeof(error_cause), missing_format, params[i].name); \
263 break; \
264 } \
265 continue; \
266 } \
267 if(!janus_json_is_valid(val, params[i].jtype, params[i].flags)) { \
268 error_code = (invalid_code); \
269 char type_name[20]; \
270 janus_get_json_type_name(params[i].jtype, params[i].flags, type_name); \
271 if(log_error) \
272 JANUS_LOG(LOG_ERR, invalid_format "\n", params[i].name, type_name); \
273 if(error_cause != NULL) \
274 g_snprintf(error_cause, sizeof(error_cause), invalid_format, params[i].name, type_name); \
275 break; \
276 } \
277 } \
278 } while(0)
279
288#define JANUS_VALIDATE_JSON_OBJECT(obj, params, error_code, error_cause, log_error, missing_code, invalid_code) \
289 JANUS_VALIDATE_JSON_OBJECT_FORMAT("Missing mandatory element (%s)", "Invalid element type (%s should be %s)", obj, params, error_code, error_cause, log_error, missing_code, invalid_code)
290
300#define JANUS_CHECK_SECRET(secret, obj, member, error_code, error_cause, missing_code, invalid_code, unauthorized_code) \
301 do { \
302 if (secret) { \
303 static struct janus_json_parameter secret_parameters[] = { \
304 {member, JSON_STRING, JANUS_JSON_PARAM_REQUIRED} \
305 }; \
306 JANUS_VALIDATE_JSON_OBJECT(obj, secret_parameters, error_code, error_cause, TRUE, missing_code, invalid_code); \
307 if(error_code == 0 && !janus_strcmp_const_time((secret), json_string_value(json_object_get(obj, member)))) { \
308 error_code = (unauthorized_code); \
309 JANUS_LOG(LOG_ERR, "Unauthorized (wrong %s)\n", member); \
310 if(error_cause != NULL) \
311 g_snprintf(error_cause, sizeof(error_cause), "Unauthorized (wrong %s)", member); \
312 } \
313 } \
314 } while(0)
315
320gboolean janus_vp8_is_keyframe(const char *buffer, int len);
321
326gboolean janus_vp9_is_keyframe(const char *buffer, int len);
327
336gboolean janus_h264_is_keyframe(const char *buffer, int len);
337
342gboolean janus_h264_is_i_frame(const char *buffer, int len);
343
348gboolean janus_h264_is_b_frame(const char *buffer, int len);
349
354gboolean janus_av1_is_keyframe(const char *buffer, int len);
355
360gboolean janus_h265_is_keyframe(const char *buffer, int len);
361
367
371
382int janus_vp8_parse_descriptor(char *buffer, int len,
383 gboolean *m, uint16_t *picid, uint8_t *tl0picidx, uint8_t *tid, uint8_t *y, uint8_t *keyidx);
384
390void janus_vp8_simulcast_descriptor_update(char *buffer, int len, janus_vp8_simulcast_context *context, gboolean switched);
391
393typedef struct janus_vp9_svc_info {
395 uint8_t fbit, pbit, dbit, ubit, bbit, ebit;
397
404int janus_vp9_parse_svc(char *buffer, int len, gboolean *found, janus_vp9_svc_info *info);
405
407typedef struct janus_red_block {
408 uint8_t pt;
409 uint32_t ts_offset;
410 uint8_t *data;
411 uint16_t length;
418GList *janus_red_parse_blocks(char *buffer, int len);
424int janus_red_pack_blocks(char *buffer, int len, GList *blocks);
430int janus_red_replace_block_pt(char *buffer, int len, int pt);
431
437guint32 janus_push_bits(guint32 word, size_t num, guint32 val);
438
444void janus_set1(guint8 *data, size_t i, guint8 val);
445
451void janus_set2(guint8 *data, size_t i, guint32 val);
452
458void janus_set3(guint8 *data, size_t i, guint32 val);
459
465void janus_set4(guint8 *data, size_t i, guint32 val);
466
467/* \brief Helpers to read a bit from a bitstream
468 * @param[in] base Pointer to the start of the bitstream
469 * @param[in] offset Offset in bits from the start
470 * @returns The value of the bit */
471uint8_t janus_bitstream_getbit(uint8_t *base, uint32_t offset);
472/* \brief Helpers to read agroup of bits from a bitstream
473 * @param[in] base Pointer to the start of the bitstream
474 * @param[in] num The number of bits to read
475 * @param[in] offset Offset in bits from the start
476 * @returns The value of the bits */
477uint32_t janus_bitstream_getbits(uint8_t *base, uint8_t num, uint32_t *offset);
478
489size_t janus_gzip_compress(int compression, char *text, size_t tlen, char *compressed, size_t zlen);
490
491#endif
struct json_t json_t
Definition: plugin.h:236
Definition: utils.h:29
json_type jtype
Definition: utils.h:31
const gchar * name
Definition: utils.h:30
unsigned int flags
Definition: utils.h:32
Helper struct to address a specific RED block.
Definition: utils.h:407
uint16_t length
Definition: utils.h:411
uint8_t * data
Definition: utils.h:410
uint8_t pt
Definition: utils.h:408
uint32_t ts_offset
Definition: utils.h:409
VP8 simulcasting context, in order to make sure SSRC changes result in coherent picid/temporal level ...
Definition: utils.h:363
uint16_t last_picid
Definition: utils.h:364
uint8_t base_tlzi
Definition: utils.h:365
uint8_t last_tlzi
Definition: utils.h:365
uint8_t base_tlzi_prev
Definition: utils.h:365
uint16_t base_picid
Definition: utils.h:364
uint16_t base_picid_prev
Definition: utils.h:364
VP9 SVC info, as parsed from a payload descriptor.
Definition: utils.h:393
int temporal_layer
Definition: utils.h:394
uint8_t dbit
Definition: utils.h:395
uint8_t pbit
Definition: utils.h:395
uint8_t ebit
Definition: utils.h:395
int spatial_layer
Definition: utils.h:394
uint8_t bbit
Definition: utils.h:395
uint8_t fbit
Definition: utils.h:395
uint8_t ubit
Definition: utils.h:395
gboolean janus_av1_is_keyframe(const char *buffer, int len)
Helper method to check if an AV1 frame is a keyframe or not.
Definition: utils.c:903
guint64 janus_random_uint64(void)
Helper to generate random 52 bit unsigned integers.
Definition: utils.c:92
gsize janus_flags
Janus flags container.
Definition: utils.h:155
gboolean janus_vp8_is_keyframe(const char *buffer, int len)
Helper method to check if a VP8 frame is a keyframe or not.
Definition: utils.c:698
void janus_set4(guint8 *data, size_t i, guint32 val)
Helper method to set four bytes at a memory position.
Definition: utils.c:1394
gboolean janus_h264_is_keyframe(const char *buffer, int len)
Helper method to check if an H.264 frame is a keyframe or not.
Definition: utils.c:891
size_t janus_gzip_compress(int compression, char *text, size_t tlen, char *compressed, size_t zlen)
Helper method to compress a string to gzip (using zlib)
Definition: utils.c:1415
guint32 janus_random_uint32(void)
Helper to generate random 32-bit unsigned integers (useful for SSRCs, etc.)
Definition: utils.c:74
char * janus_string_replace(char *message, const char *old_string, const char *new_string) G_GNUC_WARN_UNUSED_RESULT
Helper to replace strings.
Definition: utils.c:204
int janus_string_to_uint16(const char *str, uint16_t *num)
Helper method to convert a string to a uint16_t.
Definition: utils.c:158
gboolean janus_json_is_valid(json_t *val, json_type jtype, unsigned int flags)
Checks whether the JSON value matches the type and constraint.
Definition: utils.c:658
int janus_mkdir(const char *dir, mode_t mode)
Helper to create a new directory, and recursively create parent directories if needed.
Definition: utils.c:303
int janus_string_to_uint32(const char *str, uint32_t *num)
Helper method to convert a string to a uint32_t.
Definition: utils.c:168
void janus_set2(guint8 *data, size_t i, guint32 val)
Helper method to set two bytes at a memory position.
Definition: utils.c:1383
int janus_string_to_uint8(const char *str, uint8_t *num)
Helper method to convert a string to a uint8_t.
Definition: utils.c:148
gboolean janus_h264_is_i_frame(const char *buffer, int len)
Helper method to check if an H.264 frame contains an I-Frame or not.
Definition: utils.c:895
void janus_vp8_simulcast_context_reset(janus_vp8_simulcast_context *context)
Set (or reset) the context fields to their default values.
Definition: utils.c:1033
void janus_vp8_simulcast_descriptor_update(char *buffer, int len, janus_vp8_simulcast_context *context, gboolean switched)
Use the context info to update the RTP header of a packet, if needed.
Definition: utils.c:1045
char * janus_random_uuid(void)
Helper to generate random UUIDs (needed by some plugins) Warning: this will fall back to a non-crypto...
Definition: utils.c:96
guint64 janus_uint64_hash(guint64 num)
Helper to hash a guint64 number to another guint64 number.
Definition: utils.c:141
gint64 janus_get_real_time(void)
Helper to retrieve the system real time, as Glib's g_get_real_time may not be available (only since 2...
Definition: utils.c:40
int janus_pidfile_remove(void)
Unlock and remove a previously created PID file.
Definition: utils.c:550
const char * janus_get_codec_from_pt(const char *sdp, int pt)
Ugly and dirty helper to quickly get the codec associated with a payload type in an SDP.
Definition: utils.c:446
void janus_set3(guint8 *data, size_t i, guint32 val)
Helper method to set three bytes at a memory position.
Definition: utils.c:1388
int janus_vp9_parse_svc(char *buffer, int len, gboolean *found, janus_vp9_svc_info *info)
Helper method to parse a VP9 payload descriptor for SVC-related info (e.g., when SVC is enabled)
Definition: utils.c:1078
gint64 janus_get_monotonic_time(void)
Helper to retrieve the system monotonic time, as Glib's g_get_monotonic_time may not be available (on...
Definition: utils.c:34
GList * janus_red_parse_blocks(char *buffer, int len)
Helper method to parse an RTP payload to return a list of RED blocks.
Definition: utils.c:1220
size_t janus_strlcat(char *dest, const char *src, size_t dest_size)
Helper method to concatenate strings and log an error if truncation occured.
Definition: utils.c:275
int janus_get_codec_pt(const char *sdp, const char *codec)
Ugly and dirty helper to quickly get the payload type associated with a codec in an SDP.
Definition: utils.c:340
void janus_protected_folder_add(const char *folder)
Add a folder to the protected list (meaning we won't create files there, like recordings or pcap dump...
Definition: utils.c:570
gboolean janus_is_true(const char *value)
Helper to parse yes/no|true/false configuration values.
Definition: utils.c:46
void janus_flags_reset(janus_flags *flags)
Janus flags reset method.
Definition: utils.c:178
guint64 * janus_uint64_dup(guint64 num)
Helper to generate an allocated copy of a guint64 number.
Definition: utils.c:135
guint32 janus_push_bits(guint32 word, size_t num, guint32 val)
Helper method to push individual bits at the end of a word.
Definition: utils.c:1373
int janus_red_pack_blocks(char *buffer, int len, GList *blocks)
Helper method to pack multiple buffers in a RED payload.
Definition: utils.c:1302
void janus_get_json_type_name(int jtype, unsigned int flags, char *type_name)
Creates a string describing the JSON type and constraint.
Definition: utils.c:618
void janus_flags_clear(janus_flags *flags, gsize flag)
Janus flags clear method.
Definition: utils.c:189
gboolean janus_h265_is_keyframe(const char *buffer, int len)
Helper method to check if an H.265 frame is a keyframe or not.
Definition: utils.c:914
gboolean janus_vp9_is_keyframe(const char *buffer, int len)
Helper method to check if a VP9 frame is a keyframe or not.
Definition: utils.c:774
gboolean janus_is_folder_protected(const char *path)
Check if the path points to a protected folder.
Definition: utils.c:578
void janus_protected_folders_clear(void)
Cleanup the list of protected folder.
Definition: utils.c:611
uint32_t janus_bitstream_getbits(uint8_t *base, uint8_t num, uint32_t *offset)
Definition: utils.c:1405
void janus_flags_set(janus_flags *flags, gsize flag)
Janus flags set method.
Definition: utils.c:183
void janus_set1(guint8 *data, size_t i, guint8 val)
Helper method to set one byte at a memory position.
Definition: utils.c:1379
gboolean janus_flags_is_set(janus_flags *flags, gsize flag)
Janus flags check method.
Definition: utils.c:195
int janus_pidfile_create(const char *file)
Create and lock a PID file.
Definition: utils.c:511
int janus_vp8_parse_descriptor(char *buffer, int len, gboolean *m, uint16_t *picid, uint8_t *tl0picidx, uint8_t *tid, uint8_t *y, uint8_t *keyidx)
Helper method to parse a VP8 payload descriptor for useful info (e.g., when simulcasting)
Definition: utils.c:930
gchar * janus_make_absolute_path(const gchar *base_dir, const gchar *path)
Helper to convert path relative to base_dir to absolute path. If path already represents absolute pat...
Definition: utils.c:330
gboolean janus_strcmp_const_time(const void *str1, const void *str2)
Helper to compare strings in constant time.
Definition: utils.c:50
gboolean janus_h264_is_b_frame(const char *buffer, int len)
Helper method to check if an H.264 frame contains a B-Frame or not.
Definition: utils.c:899
int janus_strlcat_fast(char *dest, const char *src, size_t dest_size, size_t *offset)
Alternative helper method to concatenate strings and log an error if truncation occured,...
Definition: utils.c:282
guint64 janus_random_uint64_full(void)
Helper to generate random 64-bit unsigned integers.
Definition: utils.c:83
int janus_red_replace_block_pt(char *buffer, int len, int pt)
Helper method to overwrite all RTP payload types in RED blocks.
Definition: utils.c:1348
uint8_t janus_bitstream_getbit(uint8_t *base, uint32_t offset)
Definition: utils.c:1401