[syslog-ng] Module development guide

[m at baha.mu]

> On Jan 23, 2016, at 21:23, Scheidler, Balázs <balazs.scheidler at balabit.com> wrote:
> 
> If you commit your code to a branch I can help with the basic skeleton of the parser/grammar


Thank you Balázs, my code is available here: https://github.com/falzm/syslog-ng/tree/f/curl-module/modules/curl

m.


> 
> On Jan 23, 2016 5:54 PM, "Marc Falzon" <m at baha.mu> wrote:
> I successfully generated a module template using the `create_plugin.sh` script, however I don't have the slightest idea on how to get started from here (I mean for the 'plugin glue', I can manage the cURL part)... The most problematic step for me is the whole parser/grammar thing, to which I believe to involve YACC/Bison parsing but I don't know how it works and it's too big of a learning curve for what I want to achieve at this point... Since the Gitbook doesn't provide any useful information on module development at the moment, is there any way to get me started on this topic? I'm not a developer (sysadmin), and trying to learn from existing module doesn't quite cut it.
> 
> Thank you,
> 
> m.
> 
> 
> On Friday 22 January 2016 at 11:35, Tibor Benke wrote:
> 
> > There is also a shell script which generates a basic destination skeleton. You can find its source on this brach: https://github.com/juhaszviktor/syslog-ng/tree/f/plugin-creator . Check the dev-utils/plugin_skeleton_creator directory and this commit for the usage: https://github.com/juhaszviktor/syslog-ng/commit/89361d4d1817560ce8c906209355f1b737a28010
> >
> > 2016-01-22 11:33 GMT+01:00 Marc Falzon <m at baha.mu (mailto:m at baha.mu)>:
> > > Hi Bazsi,
> > >
> > >
> > > On Friday 22 January 2016 at 11:28, Scheidler, Balázs wrote:
> > >
> > > > not really, but maybe I would read the "official" modules source code instead. and of course you can ask questions on the mailing list. :)
> > >
> > >
> > > Yes that's what I've started to do, but a proper documentation is preferable, saves time and avoid confusion ;)
> > >
> > > > if you want to create a destination, the easiest is to create a threaded destination, where the output is an independent thread, that can use a synchronous API. Of course this is going to be slower than using an asynchronous implementation, but that usually is good enough,
> > >
> > > Thank you for the hint. Given my use case (HTTP destination) I think I'm safe to go with an asynchronous implementation since each request is stateless, no connections/locks involved.
> > >
> > > m.
> > >
> > > >
> > > > On Fri, Jan 22, 2016 at 11:03 AM, Marc Falzon <m at baha.mu (mailto:m at baha.mu) (mailto:m at baha.mu)> wrote:
> > > > > Hi
> > > > >
> > > > > Is there any documentation on how to develop new syslog-ng module using the native C API, besides reading the incubator modules source code?
> > > > >
> > > > > Cheers,
> > > > >
> > > > > m.
> > > > >
> > > > >
> > > > > ______________________________________________________________________________
> > > > > Member info: https://lists.balabit.hu/mailman/listinfo/syslog-ng
> > > > > Documentation: http://www.balabit.com/support/documentation/?product=syslog-ng
> > > > > FAQ: http://www.balabit.com/wiki/syslog-ng-faq
> > > >
> > > >
> > > >
> > > > ______________________________________________________________________________
> > > > Member info: https://lists.balabit.hu/mailman/listinfo/syslog-ng
> > > > Documentation: http://www.balabit.com/support/documentation/?product=syslog-ng
> > > > FAQ: http://www.balabit.com/wiki/syslog-ng-faq
> > >
> > >
> > >
> > >
> > > ______________________________________________________________________________
> > > Member info: https://lists.balabit.hu/mailman/listinfo/syslog-ng
> > > Documentation: http://www.balabit.com/support/documentation/?product=syslog-ng
> > > FAQ: http://www.balabit.com/wiki/syslog-ng-faq
> >
> >
> > ______________________________________________________________________________
> > Member info: https://lists.balabit.hu/mailman/listinfo/syslog-ng
> > Documentation: http://www.balabit.com/support/documentation/?product=syslog-ng
> > FAQ: http://www.balabit.com/wiki/syslog-ng-faq
> 
> 
> 
> ______________________________________________________________________________
> Member info: https://lists.balabit.hu/mailman/listinfo/syslog-ng
> Documentation: http://www.balabit.com/support/documentation/?product=syslog-ng
> FAQ: http://www.balabit.com/wiki/syslog-ng-faq
> 
> ______________________________________________________________________________
> Member info: https://lists.balabit.hu/mailman/listinfo/syslog-ng
> Documentation: http://www.balabit.com/support/documentation/?product=syslog-ng
> FAQ: http://www.balabit.com/wiki/syslog-ng-faq
>