[sr-dev] RPC syntax

Olle E. Johansson oej at edvina.net
Wed Jan 9 19:37:40 CET 2013


While learning how to create RPC commands in Kamailio, I've came up with a few generic syntax questions that I would like YOUR input on.

When listing an object and reaching a value that's not set, should we print a string saying [NOT DEFINED] or something like that - or just nothing. Noticed that usrloc prints a message while I did not in htable, just the header and no value.

In most cases we deliver a response in a data structure, but in some cases we just print a one-line message as a response, like "on" or "denied". I am beginning to think that's not a good solution, but have used it in permissions and now in sipcapture. As I'm a copycat I must have gotten it from some other module, but can't remember which one.

So the questions are:
- when a data field in an object is empty - should we print a message or simply just leave it empty?
- should all answers be contained in a structure or is one-line text messages ok?

It is irritating developing clients where the server has variations in the syntax, so we want to define a policy here - or just refer me to an existing policy document that I have failed to find, remember or parse :-)

And no, it's not to late to change these bugs - if they are bugs - in git HEAD.

/O


More information about the sr-dev mailing list