i have missed those in the past as well.

ok benno@

Rob Pierce([email protected]) on 2018.07.25 16:04:44 -0400:
> Add a few macros in use but currently missing from the man page.
> 
> ok?
> 
> Index: event.3
> ===================================================================
> RCS file: /cvs/src/lib/libevent/event.3,v
> retrieving revision 1.53
> diff -u -p -r1.53 event.3
> --- event.3   29 Jun 2017 01:25:59 -0000      1.53
> +++ event.3   25 Jul 2018 20:00:44 -0000
> @@ -67,7 +67,9 @@
>  .Nm bufferevent_read ,
>  .Nm bufferevent_enable ,
>  .Nm bufferevent_disable ,
> -.Nm bufferevent_settimeout
> +.Nm bufferevent_settimeout ,
> +.Nm EVBUFFER_INPUT ,
> +.Nm EVBUFFER_OUTPUT
>  .Nd execute a function when a specific event occurs
>  .Sh SYNOPSIS
>  .In sys/time.h
> @@ -154,6 +156,10 @@
>  .Fn "bufferevent_disable" "struct bufferevent *bufev" "short event"
>  .Ft void
>  .Fn "bufferevent_settimeout" "struct bufferevent *bufev" "int timeout_read" 
> "int timeout_write"
> +.Ft "struct evbuffer *"
> +.Fn "EVBUFFER_INPUT" "struct bufferevent *bufev"
> +.Ft "struct evbuffer *"
> +.Fn "EVBUFFER_OUTPUT" "struct bufferevent *bufev"
>  .Sh DESCRIPTION
>  The
>  .Nm event
> @@ -507,6 +513,17 @@ If multiple bases are in use,
>  .Fn bufferevent_base_set
>  must be called before
>  enabling the bufferevent for the first time.
> +.Pp
> +The
> +.Fn EVBUFFER_INPUT
> +and
> +.Fn EVBUFFER_OUTPUT
> +macros return a pointer to evbuffer
> +.Fa input
> +and
> +.Fa output
> +respectively for the specified bufferevent
> +.Fa bufev .
>  .Sh ADDITIONAL NOTES
>  It is possible to disable support for
>  .Va kqueue , poll
> 
> Index: evbuffer_new.3
> ===================================================================
> RCS file: /cvs/src/lib/libevent/evbuffer_new.3,v
> retrieving revision 1.13
> diff -u -p -r1.13 evbuffer_new.3
> --- evbuffer_new.3    1 Aug 2017 14:57:03 -0000       1.13
> +++ evbuffer_new.3    25 Jul 2018 20:00:48 -0000
> @@ -33,7 +33,8 @@
>  .Nm evbuffer_find ,
>  .Nm evbuffer_readline ,
>  .Nm evbuffer_readln ,
> -.Nm EVBUFFER_LENGTH
> +.Nm EVBUFFER_LENGTH ,
> +.Nm EVBUFFER_DATA
>  .Nd libevent utility API for buffered input/output
>  .Sh SYNOPSIS
>  .In event.h
> @@ -77,6 +78,8 @@
>  .Fc
>  .Ft size_t
>  .Fn "EVBUFFER_LENGTH" "const struct evbuffer *buf"
> +.Ft "u_char *"
> +.Fn "EVBUFFER_DATA" "const struct evbuffer *buf"
>  .Sh DESCRIPTION
>  The evbuffer API provides an implementation of buffering for use with
>  libevent.
> @@ -259,6 +262,11 @@ on failure.
>  .Pp
>  .Fn EVBUFFER_LENGTH
>  returns the number of bytes available in the evbuffer.
> +.Pp
> +.Fn EVBUFFER_DATA
> +returns a pointer to the evbuffer
> +.Fa buf
> +on success.
>  .Sh SEE ALSO
>  .Xr errno 2 ,
>  .Xr event 3 ,
> 

Reply via email to