Changes between Version 9 and Version 13 of Ticket #257


Ignore:
Timestamp:
07/30/12 13:50:44 (12 years ago)
Author:
ph3-der-loewe
Comment:

The current interface doesn't allow access to the plugin's parameter handle (if any). The function prototype needs to be changed for this. I updated the description with an idea for me.

I keep the version as it should be fixed within this version. This should be considered an objection against the current pre-release (1.0beta4-pr0).

Legend:

Unmodified
Added
Removed
Modified

  • Ticket #257

    • Property Status changed from new to reopened
    • Property Version changed from current to 1.0beta4
    • Property Owner set to ph3-der-loewe

  • Ticket #257 – Description

    v9 v13  
    3232=== The function type === 
    3333The function type above is a pointer to a function with the following arguments: 
    34 ||= Argument =||= Type =||= Description =|| 
    35 ||client      ||int     ||The client ID  || 
    36 ||vio         ||struct roar_vio_calls * ||The VIO Object the client is connected to || 
    37 ||obuffer     ||struct roar_buffer ** ||The Output buffer (see above) || 
    38 ||userdata    ||void **               ||Pointer for the protocol to store per-client private data|| 
    39 ||para        ||const struct roar_keyval * ||Parameter array passed to the protocol. This is per listen socket. Can be NULL. || 
    40 ||paralen     ||ssize_t               ||This is the length of para. Is -1 if para is NULL. Can be -1 if para is not NULL (in this case para ends with a key set to NULL). || 
     34||= Argument  =||= Type =||= Description =|| 
     35||client       ||int     ||The client ID  || 
     36||vio          ||struct roar_vio_calls * ||The VIO Object the client is connected to || 
     37||obuffer      ||struct roar_buffer ** ||The Output buffer (see above) || 
     38||userdata     ||void **               ||Pointer for the protocol to store per-client private data|| 
     39||protopara    ||const struct roar_keyval * ||Parameter array passed to the protocol. This is per listen socket. Can be NULL. || 
     40||protoparalen ||ssize_t               ||This is the length of para. Is -1 if para is NULL. Can be -1 if para is not NULL (in this case para ends with a key set to NULL). || 
     41||pluginpara   ||struct roar_dl_librarypara * ||This is the parameter object for the current plugin if any. If no such object is existing or this is not a plugin based implementation the parameter object is NULL. The refcount is set in a way that the function does not need to care expect of they store the object in some storage with a lifetime other than the scope of the function. In this case they need to ref it before and unref when deleting the pointer from that storage. || 
    4142 
    4243When the client is forcefully disconnected by the protocol and obuffer is not NULL it is undefined whether the data is flushed to the client or just discarded.