Fork me on GitHub
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 /* Use JANUS_JSON_BOOL instead of the non-existing JSON_BOOLEAN */
23 #define JANUS_JSON_BOOL JSON_TRUE
24 #define JANUS_JSON_PARAM_REQUIRED 1
25 #define JANUS_JSON_PARAM_POSITIVE 2
26 #define JANUS_JSON_PARAM_NONEMPTY 4
27 
29  const gchar *name;
30  json_type jtype;
31  unsigned int flags;
32 };
33 
37 gint64 janus_get_monotonic_time(void);
38 
42 gint64 janus_get_real_time(void);
43 
50 char *janus_string_replace(char *message, const char *old_string, const char *new_string) G_GNUC_WARN_UNUSED_RESULT;
51 
55 gboolean janus_is_true(const char *value);
56 
61 gboolean janus_strcmp_const_time(const void *str1, const void *str2);
62 
66 guint32 janus_random_uint32(void);
67 
70 guint64 janus_random_uint64(void);
71 
74 char *janus_random_uuid(void);
75 
83 guint64 *janus_uint64_dup(guint64 num);
84 
89 guint64 janus_uint64_hash(guint64 num);
90 
96 int janus_string_to_uint8(const char *str, uint8_t *num);
97 
103 int janus_string_to_uint16(const char *str, uint16_t *num);
104 
110 int janus_string_to_uint32(const char *str, uint32_t *num);
111 
114 
116 typedef gsize janus_flags;
117 
120 void janus_flags_reset(janus_flags *flags);
121 
125 void janus_flags_set(janus_flags *flags, gsize flag);
126 
130 void janus_flags_clear(janus_flags *flags, gsize flag);
131 
136 gboolean janus_flags_is_set(janus_flags *flags, gsize flag);
138 
144 int janus_mkdir(const char *dir, mode_t mode);
145 
150 int janus_get_codec_pt(const char *sdp, const char *codec);
151 
156 const char *janus_get_codec_from_pt(const char *sdp, int pt);
157 
161 int janus_pidfile_create(const char *file);
162 
165 int janus_pidfile_remove(void);
166 
170 void janus_protected_folder_add(const char *folder);
171 
175 gboolean janus_is_folder_protected(const char *path);
176 
179 
185 void janus_get_json_type_name(int jtype, unsigned int flags, char *type_name);
186 
192 gboolean janus_json_is_valid(json_t *val, json_type jtype, unsigned int flags);
193 
204 #define JANUS_VALIDATE_JSON_OBJECT_FORMAT(missing_format, invalid_format, obj, params, error_code, error_cause, log_error, missing_code, invalid_code) \
205  do { \
206  error_code = 0; \
207  unsigned int i; \
208  for(i = 0; i < sizeof(params) / sizeof(struct janus_json_parameter); i++) { \
209  json_t *val = json_object_get(obj, params[i].name); \
210  if(!val) { \
211  if((params[i].flags & JANUS_JSON_PARAM_REQUIRED) != 0) { \
212  error_code = (missing_code); \
213  if(log_error) \
214  JANUS_LOG(LOG_ERR, missing_format "\n", params[i].name); \
215  if(error_cause != NULL) \
216  g_snprintf(error_cause, sizeof(error_cause), missing_format, params[i].name); \
217  break; \
218  } \
219  continue; \
220  } \
221  if(!janus_json_is_valid(val, params[i].jtype, params[i].flags)) { \
222  error_code = (invalid_code); \
223  char type_name[20]; \
224  janus_get_json_type_name(params[i].jtype, params[i].flags, type_name); \
225  if(log_error) \
226  JANUS_LOG(LOG_ERR, invalid_format "\n", params[i].name, type_name); \
227  if(error_cause != NULL) \
228  g_snprintf(error_cause, sizeof(error_cause), invalid_format, params[i].name, type_name); \
229  break; \
230  } \
231  } \
232  } while(0)
233 
242 #define JANUS_VALIDATE_JSON_OBJECT(obj, params, error_code, error_cause, log_error, missing_code, invalid_code) \
243  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)
244 
254 #define JANUS_CHECK_SECRET(secret, obj, member, error_code, error_cause, missing_code, invalid_code, unauthorized_code) \
255  do { \
256  if (secret) { \
257  static struct janus_json_parameter secret_parameters[] = { \
258  {member, JSON_STRING, JANUS_JSON_PARAM_REQUIRED} \
259  }; \
260  JANUS_VALIDATE_JSON_OBJECT(obj, secret_parameters, error_code, error_cause, TRUE, missing_code, invalid_code); \
261  if(error_code == 0 && !janus_strcmp_const_time((secret), json_string_value(json_object_get(obj, member)))) { \
262  error_code = (unauthorized_code); \
263  JANUS_LOG(LOG_ERR, "Unauthorized (wrong %s)\n", member); \
264  if(error_cause != NULL) \
265  g_snprintf(error_cause, sizeof(error_cause), "Unauthorized (wrong %s)", member); \
266  } \
267  } \
268  } while(0)
269 
274 gboolean janus_vp8_is_keyframe(const char *buffer, int len);
275 
280 gboolean janus_vp9_is_keyframe(const char *buffer, int len);
281 
286 gboolean janus_h264_is_keyframe(const char *buffer, int len);
287 
293 gboolean janus_av1_is_keyframe(const char *buffer, int len);
294 
300 gboolean janus_h265_is_keyframe(const char *buffer, int len);
301 
307 
311 
321 int janus_vp8_parse_descriptor(char *buffer, int len,
322  uint16_t *picid, uint8_t *tl0picidx, uint8_t *tid, uint8_t *y, uint8_t *keyidx);
323 
329 void janus_vp8_simulcast_descriptor_update(char *buffer, int len, janus_vp8_simulcast_context *context, gboolean switched);
330 
332 typedef struct janus_vp9_svc_info {
334  uint8_t fbit, pbit, dbit, ubit, bbit, ebit;
336 
343 int janus_vp9_parse_svc(char *buffer, int len, gboolean *found, janus_vp9_svc_info *info);
344 
350 guint32 janus_push_bits(guint32 word, size_t num, guint32 val);
351 
357 void janus_set1(guint8 *data, size_t i, guint8 val);
358 
364 void janus_set2(guint8 *data, size_t i, guint32 val);
365 
371 void janus_set3(guint8 *data, size_t i, guint32 val);
372 
378 void janus_set4(guint8 *data, size_t i, guint32 val);
379 
390 size_t janus_gzip_compress(int compression, char *text, size_t tlen, char *compressed, size_t zlen);
391 
392 #endif
janus_is_true
gboolean janus_is_true(const char *value)
Helper to parse yes/no|true/false configuration values.
Definition: utils.c:45
janus_vp8_simulcast_context
VP8 simulcasting context, in order to make sure SSRC changes result in coherent picid/temporal level ...
Definition: utils.h:303
janus_set4
void janus_set4(guint8 *data, size_t i, guint32 val)
Helper method to set four bytes at a memory position.
Definition: utils.c:1159
janus_pidfile_remove
int janus_pidfile_remove(void)
Unlock and remove a previously created PID file.
Definition: utils.c:494
janus_vp8_simulcast_descriptor_update
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:974
janus_uint64_hash
guint64 janus_uint64_hash(guint64 num)
Helper to hash a guint64 number to another guint64 number.
Definition: utils.c:138
janus_vp8_simulcast_context::base_picid
uint16_t base_picid
Definition: utils.h:304
janus_flags_set
void janus_flags_set(janus_flags *flags, gsize flag)
Janus flags set method.
Definition: utils.c:180
janus_vp9_svc_info::temporal_layer
int temporal_layer
Definition: utils.h:333
janus_pidfile_create
int janus_pidfile_create(const char *file)
Create and lock a PID file.
Definition: utils.c:455
janus_vp8_simulcast_context
struct janus_vp8_simulcast_context janus_vp8_simulcast_context
VP8 simulcasting context, in order to make sure SSRC changes result in coherent picid/temporal level ...
janus_get_monotonic_time
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:33
janus_gzip_compress
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:1167
janus_set3
void janus_set3(guint8 *data, size_t i, guint32 val)
Helper method to set three bytes at a memory position.
Definition: utils.c:1153
janus_json_parameter::name
const gchar * name
Definition: utils.h:29
janus_json_is_valid
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:602
janus_flags_is_set
gboolean janus_flags_is_set(janus_flags *flags, gsize flag)
Janus flags check method.
Definition: utils.c:192
janus_vp9_svc_info::spatial_layer
int spatial_layer
Definition: utils.h:333
janus_string_replace
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:201
janus_json_parameter
Definition: utils.h:28
janus_uint64_dup
guint64 * janus_uint64_dup(guint64 num)
Helper to generate an allocated copy of a guint64 number.
Definition: utils.c:132
janus_string_to_uint8
int janus_string_to_uint8(const char *str, uint8_t *num)
Helper method to convert a string to a uint8_t.
Definition: utils.c:145
janus_random_uint64
guint64 janus_random_uint64(void)
Helper to generate random 64-bit unsigned integers (useful for Janus IDs)
Definition: utils.c:77
janus_vp9_is_keyframe
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:718
janus_vp8_parse_descriptor
int janus_vp8_parse_descriptor(char *buffer, int len, 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:861
janus_vp9_svc_info::pbit
uint8_t pbit
Definition: utils.h:334
janus_h265_is_keyframe
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:846
janus_protected_folders_clear
void janus_protected_folders_clear(void)
Cleanup the list of protected folder.
Definition: utils.c:555
janus_vp8_simulcast_context_reset
void janus_vp8_simulcast_context_reset(janus_vp8_simulcast_context *context)
Set (or reset) the context fields to their default values.
Definition: utils.c:962
janus_vp8_simulcast_context::last_tlzi
uint8_t last_tlzi
Definition: utils.h:305
janus_mkdir
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:272
janus_json_parameter::jtype
json_type jtype
Definition: utils.h:30
janus_vp9_svc_info::ebit
uint8_t ebit
Definition: utils.h:334
janus_string_to_uint32
int janus_string_to_uint32(const char *str, uint32_t *num)
Helper method to convert a string to a uint32_t.
Definition: utils.c:165
janus_get_real_time
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:39
janus_random_uint32
guint32 janus_random_uint32(void)
Helper to generate random 32-bit unsigned integers (useful for SSRCs, etc.)
Definition: utils.c:73
janus_protected_folder_add
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:514
json_t
struct json_t json_t
Definition: plugin.h:236
janus_flags
gsize janus_flags
Janus flags container.
Definition: utils.h:116
janus_get_json_type_name
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:562
janus_get_codec_pt
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:299
janus_get_codec_from_pt
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:396
janus_string_to_uint16
int janus_string_to_uint16(const char *str, uint16_t *num)
Helper method to convert a string to a uint16_t.
Definition: utils.c:155
janus_vp9_svc_info::dbit
uint8_t dbit
Definition: utils.h:334
janus_vp9_svc_info
struct janus_vp9_svc_info janus_vp9_svc_info
VP9 SVC info, as parsed from a payload descriptor.
janus_vp9_svc_info::bbit
uint8_t bbit
Definition: utils.h:334
janus_vp9_svc_info::ubit
uint8_t ubit
Definition: utils.h:334
janus_vp9_parse_svc
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:999
janus_vp9_svc_info
VP9 SVC info, as parsed from a payload descriptor.
Definition: utils.h:332
janus_flags_clear
void janus_flags_clear(janus_flags *flags, gsize flag)
Janus flags clear method.
Definition: utils.c:186
janus_vp8_is_keyframe
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:642
janus_set2
void janus_set2(guint8 *data, size_t i, guint32 val)
Helper method to set two bytes at a memory position.
Definition: utils.c:1148
janus_is_folder_protected
gboolean janus_is_folder_protected(const char *path)
Check if the path points to a protected folder.
Definition: utils.c:522
janus_h264_is_keyframe
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:802
janus_strcmp_const_time
gboolean janus_strcmp_const_time(const void *str1, const void *str2)
Helper to compare strings in constant time.
Definition: utils.c:49
janus_flags_reset
void janus_flags_reset(janus_flags *flags)
Janus flags reset method.
Definition: utils.c:175
janus_vp8_simulcast_context::base_tlzi_prev
uint8_t base_tlzi_prev
Definition: utils.h:305
janus_vp9_svc_info::fbit
uint8_t fbit
Definition: utils.h:334
janus_vp8_simulcast_context::last_picid
uint16_t last_picid
Definition: utils.h:304
janus_vp8_simulcast_context::base_picid_prev
uint16_t base_picid_prev
Definition: utils.h:304
janus_json_parameter::flags
unsigned int flags
Definition: utils.h:31
janus_vp8_simulcast_context::base_tlzi
uint8_t base_tlzi
Definition: utils.h:305
janus_av1_is_keyframe
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:835
janus_push_bits
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:1140
janus_random_uuid
char * janus_random_uuid(void)
Helper to generate random UUIDs (needed by some plugins)
Definition: utils.c:93
janus_set1
void janus_set1(guint8 *data, size_t i, guint8 val)
Helper method to set one byte at a memory position.
Definition: utils.c:1144